Subject: Re: [RFC] new chapter "Variable reference" for the pkgsrc guide
To: Julio M. Merino Vidal <firstname.lastname@example.org>
From: Berndt Josef Wulf <email@example.com>
Date: 10/09/2005 03:14:47
On Sat, 8 Oct 2005 23:06, Julio M. Merino Vidal wrote:
> On 10/8/05, Roland Illig <firstname.lastname@example.org> wrote:
> > Hi,
> > I'd like to add a chapter called "Variable reference" to the pkgsrc
> > guide to have a place where all public variables are explained and
> > listed (alphabetically and categorized).
> > Any objections? suggestions? ideas?
> There are multiple sections in the guide that list and give detailed
> of some variables, with the appropriate context. Repeating that in a
> variable reference chapter could be redundant, I think.
> What about having an automatically generated variable index that links to
> the appropriate chapters or sections?
That's the problem, it gives explanations of some variables but not all. Ho=
about we make an effort to explain ALL VARIABLES that are relevant and used=
with the pkgsrc framework? It would have saved me a lot of time and guess=20
It should be our policy to write appropriate documentation bore the=20
introduction of a new variable and options?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (NetBSD)
-----END PGP SIGNATURE-----