Subject: Documentation quality of pkgsrc
To: pkgsrc-users <pkgsrc-users@netbsd.org>
From: Ulrich Habel <uli@habel.name>
List: pkgsrc-users
Date: 04/25/2007 16:59:40
--n8g4imXOkfNTN/H1
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hej,

I worked alot with pkgsrc the last time and tried to improve some of the
mechanisms for building packages (well at least for me and the one I
provided on http://sunpkg.de). pkgsrc has changed alot over the past
months and not everything is documented in the user guide.

For example:

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

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.

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..

Any feedback?

Regards
Uli

--=20
A: Yes.
>Q: Are you sure?
>>A: Because it reverses the logical flow of conversation.
>>>Q: Why is top posting annoying in email?

--n8g4imXOkfNTN/H1
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFGL2zcKLusNOvI6a4RAiTiAKCa38rJckwBtNEpWgGVGTsfTkEObACfaabS
Y9njkOn2c0bGP2YhR1XkKy0=
=H3Mv
-----END PGP SIGNATURE-----

--n8g4imXOkfNTN/H1--