Date: Sun, 18 Nov 2001 22:11:16 -0800 (PST) From: Murray Stokely <murray@FreeBSD.org> To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: cvs commit: doc/en_US.ISO8859-1/books/developers-handbook Makefile doc/en_US.ISO8859-1/books/handbook Makefile doc/share/mk doc.docbook.mk Message-ID: <200111190611.fAJ6BGd75694@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
murray 2001/11/18 22:11:16 PST
Modified files:
en_US.ISO8859-1/books/developers-handbook Makefile
en_US.ISO8859-1/books/handbook Makefile
share/mk doc.docbook.mk
Log:
Rework our index support.
* Add a new document-specific variable, HAS_INDEX, to specify if a
given document is marked up with <indexterm> entries.
* Rework the index support so that both HAS_INDEX and GEN_INDEX are
checked before trying to generate an index for a document.
* Only create index.sgml if both HAS_INDEX and GEN_INDEX are set.
This allows us to recursively build the documentation tree with
GEN_INDEX=1 and have it only try to create an index (very time
consuming) for the few documents that are ready for this. Previously,
running "make GEN_INDEX=1" from the top of the doc tree would look for
index terms in every single document.
With this, I hope we can start building our docs with GEN_INDEX set on
freefall so that users browsing the HTML docs will get the benefit of
the index we've been hiding in CVS for 6 months.
Revision Changes Path
1.10 +2 -2 doc/en_US.ISO8859-1/books/developers-handbook/Makefile
1.52 +2 -0 doc/en_US.ISO8859-1/books/handbook/Makefile
1.57 +9 -10 doc/share/mk/doc.docbook.mk
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200111190611.fAJ6BGd75694>