* 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.
48 lines
1 KiB
Makefile
48 lines
1 KiB
Makefile
#
|
|
# $FreeBSD$
|
|
#
|
|
# Build the FreeBSD Developers' Handbook.
|
|
#
|
|
|
|
MAINTAINER=asmodai@FreeBSD.org
|
|
|
|
DOC?= book
|
|
|
|
FORMATS?= html-split
|
|
|
|
HAS_INDEX= true
|
|
|
|
INSTALL_COMPRESSED?= gz
|
|
INSTALL_ONLY_COMPRESSED?=
|
|
|
|
# Images
|
|
IMAGES= sockets/layers.eps sockets/sain.eps sockets/sainfill.eps sockets/sainlsb.eps sockets/sainmsb.eps sockets/sainserv.eps sockets/serv.eps sockets/serv2.eps sockets/slayers.eps
|
|
|
|
#
|
|
# SRCS lists the individual SGML files that make up the document. Changes
|
|
# to any of these files will force a rebuild
|
|
#
|
|
|
|
# SGML content
|
|
SRCS= book.sgml
|
|
SRCS+= introduction/chapter.sgml
|
|
SRCS+= tools/chapter.sgml
|
|
SRCS+= secure/chapter.sgml
|
|
SRCS+= l10n/chapter.sgml
|
|
SRCS+= policies/chapter.sgml
|
|
SRCS+= locking/chapter.sgml
|
|
SRCS+= sockets/chapter.sgml
|
|
SRCS+= ipv6/chapter.sgml
|
|
SRCS+= isa/chapter.sgml
|
|
SRCS+= pci/chapter.sgml
|
|
SRCS+= usb/chapter.sgml
|
|
SRCS+= scsi/chapter.sgml
|
|
SRCS+= x86/chapter.sgml
|
|
SRCS+= vm/chapter.sgml
|
|
SRCS+= dma/chapter.sgml
|
|
SRCS+= kerneldebug/chapter.sgml
|
|
|
|
# Entities
|
|
|
|
DOC_PREFIX?= ${.CURDIR}/../../..
|
|
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|