Subject: Re: Autogenerating indexes in docbook
To: None <netbsd-docs@NetBSD.org>
From: Jan Schaumann <jschauma@netmeister.org>
List: netbsd-docs
Date: 04/24/2006 09:12:37
--gj572EiMnwbLXET9
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Roland Illig <rillig@NetBSD.org> wrote:
=20
> I would like to have an additional attribute for the <varname> tag, so=20
> that I can write <varname index=3D"yes">CONFIGURE_ARGS</varname>, and the=
=20
> variable will automatically appear in the variable index (another=20
> appendix). From there, a backlink should go to the location where the=20
> variable is used (for both the HTML and the PDF output). In the=20
> page-oriented output formats, the index should contain line numbers, and=
=20
> in the one-page HTML and the plain text formats, the index should=20
> contain the section number.
>=20
> Is that possible or do we need to switch to another documentation format=
=20
> to do this?

It is my understanding that this should be possible.  (Just as a side
note, I believe that operations like this are what make the processing
of the documents slow and resource intensive, as the entire document
tree needs to be processed to generate the index.)

-Jan

--=20
"You just come along with me and have a good time. The Galaxy's a
fun place. You'll need to have this fish in your ear."

--gj572EiMnwbLXET9
Content-Type: application/pgp-signature
Content-Disposition: inline

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

iD8DBQFETM7FfFtkr68iakwRAnH0AKCU8I+F1rUm1xE7kquLyGCzmsKFbwCfYyKq
B7fcop5qliI/WEkk575AjHI=
=4onp
-----END PGP SIGNATURE-----

--gj572EiMnwbLXET9--