The Handbook doc on "pkg" is badly out of date

[Randy Pratt]

On Wed, 15 Jan 2014 14:40:14 -0800
Paul Hoffman <phoffman at proper.com> wrote:

> On Jan 15, 2014, at 2:05 PM, Warren Block <wblock at wonkity.com> wrote:
> 
> >> You might have this backwards. I'm pretty sure that the handbook shows the old configuration information, and the Wiki shows the new.
> > 
> > I don't understand how.  The Handbook mentions pkg.conf but does not show any entries for it, while the wiki shows a sample file.  
> 
> The handbook says:
> =====
> The pkgng package management system uses a package repository for most operations. The default package repository location is defined in /usr/local/etc/pkg.conf or by the PACKAGESITE environment variable, which overrides the configuration file.
> =====
> That's not true. The default package respository location is defined in /usr/local/etc/pkg/repos/FreeBSD.conf, as the Wiki describes.
> 
> > Again, I believe the file changed, and it was the presence of the obsolete version that caused the messages.  The current port only installs pkg.conf.sample.
> 
> Well, yes. And, when you read the above in the Handbook and see the .sample file, you copy to to pkg.conf.
> 
> > Maybe it would help to be more specific: what needs to be changed in the Handbook version?

It would be better to incorporate all contents of the wiki into the Handbook,
remove the wiki and redirect the users to the Handbook.  This would avoid
stale and/or conflicting information in the future (and user frustrations).

I ran into the same things when I switched to using pkgng a couple months
ago and still have a ways to go before I'll be comfortable with it.

Best regards,

Randy