--nextPart1747309.gDsUobX6J5
Content-Type: text/plain;
  charset="iso-8859-1"
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 <rillig@netbsd.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
> 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=
w=20
about we make an effort to explain ALL VARIABLES that are relevant and used=
=20
with the pkgsrc framework? It would have saved me a lot of time and guess=20
work.

It should be our policy to write appropriate documentation bore the=20
introduction of a new variable and options?

cheerio Berndt

--nextPart1747309.gDsUobX6J5
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2 (NetBSD)

iD8DBQBDSAWUcUIHpeIRpjERAsSEAKDtusagoq+65RnNPFJgMlvwUu7VPQCgrB+7
s5FcCNA79FfkbY/tsMShIV8=
=++In
-----END PGP SIGNATURE-----

--nextPart1747309.gDsUobX6J5--