This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.

--0-1391185841-1172855775=:8729
Content-Type: TEXT/PLAIN; charset=US-ASCII

On Fri, 2 Mar 2007, Thomas Klausner wrote:

> > > Log Message:
> > > Xref pkgsrc(7) instead of packages(7).
> > 
> > Where is pkgsrc(7)?
> 
> src/share/man/man7/pkgsrc.7
> It is just a small man page pointing to pkg_add, pkg_delete, pkg_info,
> and the pkgsrc guide.

Okay, I see it is new. Will need to be pulled up to other releases so our 
webpage documentation is correct.

The "Nx" doesn't render with mandoc for me. So I get:

NAME
     pkgsrc -- Nx packages collection (framework for third-party software)

> > There was discussion on DragonFly list that they want a pkgsrc man page. I 
> > was going to update it so symlink was made to packages.7 which is included 
> > with DragonFly from our pkgsrc bootstrap. (I was going to update the now 
> > removed package.)
> 
> What should be the content of pkgsrc(7)?

It looks fine. Maybe mention binary packages too:

--- share/man/man7/pkgsrc.7	2 Mar 2007 11:28:16 -0000	1.1
+++ share/man/man7/pkgsrc.7	2 Mar 2007 17:12:49 -0000
@@ -36,7 +36,7 @@
 .Sh DESCRIPTION
 The
 .Nx
-Packages Collection (pkgsrc) is a framework for building
+Packages Collection (pkgsrc) is a framework for building and maintaining
 third-party software on
 .Nx
 and other
@@ -44,6 +44,9 @@
 systems.
 It is used to enable freely available software to be configured
 and built easily on supported platforms.
+.Pp
+Tools are available to install ready-to-use packages
+and to perform various administrative tasks for the package system.
 .Sh SEE ALSO
 .Xr pkg_add 1 ,
 .Xr pkg_delete 1 ,

> My goal was to get rid of the partly duplicated information and
> collect all information about pkgsrc variables and targets in one
> place, the pkgsrc guide. Also, noone was maintaining packages(7)
> for years (except me).

Understood. Yes, keeping in one place is good. And only having a very 
simple man page is fine so we don't have redundant places to document. 
Thanks for your work on this.

Attached is a manpage I think written by Jason White and myself and maybe 
others from about one year ago. Maybe some parts of it can or should be 
used.

  Jeremy C. Reed
--0-1391185841-1172855775=:8729
Content-Type: TEXT/PLAIN; charset=US-ASCII; name=pkgsrc.7
Content-Transfer-Encoding: BASE64
Content-ID: <Pine.NEB.4.64.0703021116150.8729@glacier.reedmedia.net>
Content-Description: 
Content-Disposition: attachment; filename=pkgsrc.7

LkRkIEZlYiAyNCwgMjAwNg0KLkR0IFBLR1NSQyA3DQouT3MNCi5TaCBOQU1F
DQouTm0gcGtnc3JjDQouTmQNClRoZSBOZXRCU0QgUGFja2FnZXMgQ29sbGVj
dGlvbg0KLlNoIERFU0NSSVBUSU9ODQpQa2dzcmMgaXMgYSBmcmFtZXdvcmsg
Zm9yIGJ1aWxkaW5nLCBpbnN0YWxsaW5nLCBhbmQgbWFuYWdpbmcNCnRoaXJk
LXBhcnR5IHNvZnR3YXJlIG9uIE5ldEJTRCBhbmQgb3RoZXIgc3VwcG9ydGVk
IHBsYXRmb3Jtcy4NCi5cIiBNYXliZSBsaXN0IERyYWdvbkZseSBhbmQgYW55
IG90aGVyIHBsYXRmb3JtcyB0aGF0IHNwZWNpZmljYWxseSB1c2UgcGtnc3Jj
Pw0KLlBwDQpUaGlzIGZyYW1ld29yayBpcyBjb21wcmlzZWQgb2YgcGFja2Fn
ZXMgd2hpY2ggc2ltcGxpZnkgdGhlIHNvZnR3YXJlDQpjb25maWd1cmF0aW9u
IGFuZCBidWlsZCBwcm9jZXNzLg0KRWFjaCBwYWNrYWdlIGNvbnRhaW5zIGlu
Zm9ybWF0aW9uIG9uIGhvdyB0byBidWlsZCBhIHBhcnRpY3VsYXIgcGllY2Ug
b2YgDQpzb2Z0d2FyZS4NCldpdGggYSBzaW5nbGUgY29tbWFuZCwgcGtnc3Jj
IGNhbiBhdXRvbWF0aWNhbGx5IGRvd25sb2FkIHRoZSByZXF1aXJlZCANCnNv
dXJjZSBjb2RlLCBhcHBseSBwYXRjaGVzLCBidWlsZCwgYW5kIGluc3RhbGwg
dGhlIHNvZnR3YXJlLg0KLlBwDQpPbmNlIHRoZSBwYWNrYWdlIGhhcyBiZWVu
IGluc3RhbGxlZCwgaXQgaXMgbWFuaXB1bGF0ZWQgd2l0aCB0aGUgcGtnXyog
dG9vbHMgDQpzbyB0aGF0IGluc3RhbGxhdGlvbiwgZGVsZXRpb24sIGxpc3Rp
bmcgaW5zdGFsbGVkIHBhY2thZ2VzLCBhbmQgDQpkaXNwbGF5aW5nIG9mIGRl
c2NyaXB0aW9ucyBhcmUgYWxsIHNpbXBsZS4NCi5QcA0KUGtnc3JjIHByb3Zp
ZGVzIHRoZSBmb2xsb3dpbmcga2V5IGZlYXR1cmVzOg0KLkJsIC1kYXNoDQou
SXQNCkVhc3kgYnVpbGRpbmcgb2Ygc29mdHdhcmUgZnJvbSBzb3VyY2UgYXMg
d2VsbCBhcyB0aGUgY3JlYXRpb24gYW5kIA0KaW5zdGFsbGF0aW9uIG9mIGJp
bmFyeSBwYWNrYWdlcy4NClRoZSBzb3VyY2UgYW5kIGxhdGVzdCBwYXRjaGVz
IGFyZSByZXRyaWV2ZWQgZnJvbSBhIG1hc3RlciBvciBtaXJyb3IgDQpkb3du
bG9hZCBzaXRlLCBjaGVja3N1bSB2ZXJpZmllZCwgdGhlbiBidWlsdCBvbiB5
b3VyIHN5c3RlbS4NCi5JdA0KUHJldmlvdXNseS1jcmVhdGVkLCByZWFkeS10
by11c2UgcGFja2FnZXMgYXJlIGF2YWlsYWJsZSBmb3Igc2V2ZXJhbA0Kb3Bl
cmF0aW5nIHN5c3RlbXMuDQooQnVpbGRpbmcgcGFja2FnZXMgZnJvbSBzb3Vy
Y2UgaXMgbm90IHJlcXVpcmVkLikNCi5JdA0KQSAic3RhYmxlIiBxdWFydGVy
bHkgcGtnc3JjIGJyYW5jaCBpcyBhbHNvIGF2YWlsYWJsZSBmb3Igc2VjdXJp
dHkNCmZpeGVzIGFuZCBjcml0aWNhbCBpbmZyYXN0cnVjdHVyZSBmaXhlcy4N
Ci5JdA0KQWxsIHBhY2thZ2VzIGFyZSBpbnN0YWxsZWQgaW4gYSBjb25zaXN0
ZW50IGRpcmVjdG9yeSB0cmVlLCBpbmNsdWRpbmcgDQpiaW5hcmllcywgbGli
cmFyaWVzLCBleGFtcGxlIGNvbmZpZ3VyYXRpb25zLCBtYW4gcGFnZXMgYW5k
IG90aGVyDQpkb2N1bWVudGF0aW9uLg0KLkl0DQpQYWNrYWdlIGRlcGVuZGVu
Y2llcywgaW5jbHVkaW5nIHdoZW4gcGVyZm9ybWluZyBwYWNrYWdlIHVwZGF0
ZXMsIGFyZSANCmhhbmRsZWQgYXV0b21hdGljYWxseS4NClRoZSBjb25maWd1
cmF0aW9uIGZpbGVzIG9mIHZhcmlvdXMgcGFja2FnZXMgYXJlIGhhbmRsZWQg
YXV0b21hdGljYWxseSANCmR1cmluZyB1cGRhdGVzLCBzbyBsb2NhbCBjaGFu
Z2VzIGFyZSBwcmVzZXJ2ZWQuIA0KLkl0DQpMaWtlIE5ldEJTRCwgcGtnc3Jj
IGlzIGRlc2lnbmVkIHdpdGggcG9ydGFiaWxpdHkgaW4gbWluZCBhbmQgY29u
c2lzdHMgDQpvZiBoaWdobHkgcG9ydGFibGUgY29kZS4NClRoaXMgYWxsb3dz
IHRoZSBncmVhdGVzdCBzcGVlZCBvZiBkZXZlbG9wbWVudCB3aGVuIHBvcnRp
bmcgdG8gbmV3IGEgDQpwbGF0Zm9ybS4gVGhpcyBwb3J0YWJpbGl0eSBhbHNv
IGVuc3VyZXMgdGhhdCBwa2dzcmMgaXMgY29uc2lzdGVudCBhY3Jvc3MgDQph
bGwgcGxhdGZvcm1zLg0KLkl0DQpUaGUgaW5zdGFsbGF0aW9uIHByZWZpeCwg
Y29uZmlndXJhdGlvbiBmaWxlIGxvY2F0aW9ucywgYWNjZXB0YWJsZQ0Kc29m
dHdhcmUgbGljZW5zZXMsIGludGVybmF0aW9uYWwgZW5jcnlwdGlvbiByZXF1
aXJlbWVudHMgYW5kDQpidWlsZC10aW1lIG9wdGlvbnMgZm9yIGEgbGFyZ2Ug
bnVtYmVyIG9mIHBhY2thZ2VzIGFyZSBhbGwgc2V0IGluDQphIHNpbXBsZSwg
Y2VudHJhbCBjb25maWd1cmF0aW9uIGZpbGUNCi5QYSAvZXRjL21rLmNvbmYg
Lg0KLkl0DQpNb3N0IHBhY2thZ2VzIGNhbiBiZSBpbnN0YWxsZWQgYW5kIHV0
aWxpemVkIHdpdGhvdXQgcm9vdCBwcml2aWxlZ2VzLg0KLkl0DQpNYW55IHBh
Y2thZ2VzIHByb3ZpZGUgc3RhcnQgdXAgc2NyaXB0cyBhbmQgZGVmYXVsdCBh
bmQgZXhhbXBsZSAgICAgICAgICAgICAgICANCmNvbmZpZ3VyYXRpb24gZmls
ZXMuDQpMb2NhbCBjdXN0b20gY29uZmlndXJhdGlvbiBmaWxlcyBhcmUgbmVp
dGhlciBvdmVyd3JpdHRlbiBvbiBpbnN0YWxsYXRpb24gDQpub3IgcmVtb3Zl
ZCBvbiBkZWxldGlvbiBvZiBwYWNrYWdlcy4NCi5JdA0KVGhlIGVudGlyZSBz
b3VyY2UgKG5vdCBpbmNsdWRpbmcgdGhlIGRpc3RyaWJ1dGlvbiBmaWxlcykg
aXMgZnJlZWx5IA0KYXZhaWxhYmxlIHVuZGVyIGEgQlNEIGxpY2Vuc2UsIHNv
IHlvdSBtYXkgZXh0ZW5kIGFuZCBhZGFwdCBwa2dzcmMgdG8gDQp5b3VyIG5l
ZWRzLg0KU3VwcG9ydCBmb3IgbG9jYWwgcGFja2FnZXMgYW5kIHBhdGNoZXMg
aXMgYXZhaWxhYmxlIHJpZ2h0IG91dCBvZiB0aGUgDQpib3gsIHNvIHlvdSBj
YW4gY29uZmlndXJlIGl0IHNwZWNpZmljYWxseSBmb3IgeW91ciBlbnZpcm9u
bWVudC4NCi5FbA0KLlNoIEZJTEVTDQouQmwgLXRhZyAtd2lkdGgNCi5cIiBt
ay5jb25mIG1heSBiZSBzb21ld2hlcmUgZWxzZSBkZXBlbmRpbmcgb24gdGhl
IGJvb3RzdHJhcA0KLkl0IFBhIC9ldGMvbWsuY29uZg0KbWFrZSgxKSBjb25m
aWd1cmF0aW9uIGZpbGUuDQouSXQgL3Vzci9wa2dzcmMvDQpUeXBpY2FsIGxv
Y2F0aW9uIG9mIHRoZSBsb2NhbCBwYWNrYWdlIHJlcG9zaXRvcnkgKCR7UEtH
U1JDRElSfSkuDQouSXQgUGEgJHtQS0dTUkNESVJ9L21rL2RlZmF1bHRzL21r
LmNvbmYNCkV4YW1wbGVzIGZvciBzZXR0aW5ncyByZWdhcmRpbmcgdGhlIHBr
Z3NyYyBjb2xsZWN0aW9uLg0KLkVsDQouUHANCi5TaCBTRUUgQUxTTw0KLlhy
IHBrZ19hZGQgMSAsDQouWHIgcGtnX2FkbWluIDEgLA0KLlhyIHBrZ19jcmVh
dGUgMSAsDQouWHIgcGtnX2RlbGV0ZSAxICwNCi5YciBwa2dfaW5mbyAxICwN
Ci5YciBwa2dfdmlldyAxICwNCi5YciBtay5jb25mIDUgLA0KLlhyIHBhY2th
Z2VzIDcNCi5QcA0KVGhlIHBrZ3NyYyBob21lcGFnZQ0KLlBhIGh0dHA6Ly93
d3cucGtnc3JjLm9yZy8NCi5QcA0KLkRxIFRoZSBwa2dzcmMgZ3VpZGUNCi5Q
YSBodHRwOi8vd3d3Lm5ldGJzZC5vcmcvRG9jdW1lbnRhdGlvbi9wa2dzcmMv
DQo=

--0-1391185841-1172855775=:8729--