Subject: Re: [RFC] new chapter "Variable reference" for the pkgsrc guide
To: Julio M. Merino Vidal <>
From: Berndt Josef Wulf <>
List: tech-pkg
Date: 10/09/2005 03:14:47
Content-Type: text/plain;
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

On Sat, 8 Oct 2005 23:06, Julio M. Merino Vidal wrote:
> On 10/8/05, Roland Illig <> 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
> explanations
> 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?

cheerio Berndt

Content-Type: application/pgp-signature

Version: GnuPG v1.4.2 (NetBSD)