Changeset 2489 for box/trunk/docs

Timestamp:

31/03/2009 20:56:09 (3 years ago)

Author:

chris

Message:

Hopefully fix building and cleaning of bb-man.xsl.

File:

• box/trunk/docs/Makefile (modified) (2 diffs)

box/trunk/docs/Makefile

@@ -40 +40 @@
         perl tools/generate_except_xml.pl $< $> $@
 
-manpages: $(MANXSL) man-dirs man-nroff man-html
+manpages: man-dirs man-nroff man-html
+
+xslt: $(MANXSL)
 
 $(MANXSL): $(MANXSL).tmpl
@@ -83 +85 @@
         $(DBPROC) -o $@ $(NOCHUNKBOOKXSL) $<
 
+# Before running xsltproc to generate manual pages, we need to check
+# that $(MANXSL) has been built. We don't want to add it to dependencies,
+# because that would cause # the man pages to try to be rebuilt even if
+# they already exist if the date of the xslt file changes, and that
+# requires xsltproc, which negates the point of precompiling them for
+# distribution users.
+
 # GNU make
-$(MAN_DIR)/%.8.gz: $(DOCBOOK_DIR)/%.xml $(MANXSL)
+$(MAN_DIR)/%.8.gz: $(DOCBOOK_DIR)/%.xml
+        $(MAKE) xslt
         $(DBPROC) -o $(@:.gz=) $(MANXSL) $<
         gzip $(@:.gz=)
 
 # GNU make
-$(MAN_DIR)/%.5.gz: $(DOCBOOK_DIR)/%.xml $(MANXSL)
+$(MAN_DIR)/%.5.gz: $(DOCBOOK_DIR)/%.xml
+        $(MAKE) xslt
         $(DBPROC) -o $(@:.gz=) $(MANXSL) $<
         gzip $(@:.gz=)
 
-# BSD make: the final colon (:) is required to make this line valid syntax
-# for a dummy rule in GNU make. It creates a dummy rule in BSD make too.
-# Both dummy rules are harmless.
+# BSD make: the final colon (:) is required to make the .for and .endfor
+# lines valid in GNU make. It creates (different) dummy rules in GNU and
+# BSD make. Both dummy rules are harmless.
+
 .for MAN_PAGE in $(NROFF_PAGES) :
 $(MAN_DIR)/$(MAN_PAGE).gz: $(DOCBOOK_DIR)/$(MAN_PAGE:R).xml
+        $(MAKE) xslt
         $(DBPROC) -o $(.TARGET:.gz=) $(MANXSL) $>
         gzip $(@:.gz=)