Subject: Re: Documentation quality of pkgsrc
To: Ulrich Habel <uli@habel.name>
From: Jeremy C. Reed <reed@reedmedia.net>
List: pkgsrc-users
Date: 04/25/2007 10:14:22
On Wed, 25 Apr 2007, Ulrich Habel wrote:

> For example:
> 
> The documentation didn't mention the scripts mkbinarykit or
> mkbootstrapkit - do you know what they are for? (yes, I know it -
> thanks)

mkbootstrapkit has been removed. It was a script to make a source 
bootstrap kit.

Yes, mkbinarykit should be documented.

> This is a very easy example, the sandbox scripts might be a good
> example, too, however the mksandbox script is mentioned in the
> documentation. There is no description on updating your packages in a
> practical way, etc.

I started a wiki page to discuss several ways on updating packages. See 
http://wiki.netbsd.se/index.php/How_to_upgrade_packages

> What I think is that the pkgsrc documentation/user guide should be
> improved - are there any ideas about this? Actually I really would like
> to volunteer for a small "project" - maybe something like a docathon.
> 
> This would lead to further questions - what is the source of the user
> guide, where can it be found, etc..

It is in pkgsrc/doc/guide

> Any feedback?

  Jeremy C. Reed