Changeset 2304

Timestamp:

01/10/2008 00:27:06 (3 years ago)

Author:

jamesog

Message:

Update documentation Makefile to include a few more man pages and to make the man page stylesheet dynamic (whether it downloads the XSL stylesheet from the Internet or uses a local copy).

Location:

box/trunk/documentation

Files:

• Makefile (modified) (4 diffs)
• bb-man.xsl.tmpl (moved) (moved from box/trunk/documentation/bb-man.xsl) (1 diff)

box/trunk/documentation/Makefile

@@ -9 +9 @@
 HTMLPREFIX=box-html
 VPATH= adminguide
+# If your OS declares a system make variable, add a .elif statement here
+# with the path to the locally-installed DocBook stylesheet
+.if .FreeBSD
+# Requires textproc/docbook-xsl port installed
+DOCBOOK=file:///usr/local/share/xsl/docbook/manpages/docbook.xsl
+.else
+DOCBOOK=http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
+.endif
 .SUFFIXES: .html .xml .1 .5 .8
 
@@ -32 +40 @@
         perl ./generate_except_xml.pl
 
-manpages: man-dirs man-nroff man-html
+manpages: $(MANXSL) man-dirs man-nroff man-html
+
+$(MANXSL): $(MANXSL).tmpl
+        @sed -e 's,%%DOCBOOK%%,$(DOCBOOK),' $(MANXSL).tmpl > $(MANXSL)
 
 man-dirs: man-pages/.there $(HTMLPREFIX)/man-html/.there
@@ -42 +53 @@
         if [ ! -d man-pages ]; then mkdir man-pages; touch man-pages/.there; fi
 
-man-nroff: bbackupquery.8 bbackupctl.8 bbstoreaccounts.8 bbstored-config.8 \
-        raidfile-config.8 bbstored-certs.8
+man-nroff: bbackupd.8 bbackupd-config.8 bbackupctl.8 bbackupquery.8 \
+        bbstored.8 bbstored-config.8 bbstoreaccounts.8 bbstored-certs.8 \
+        raidfile-config.8 \
+        bbackupd.conf.5 bbstored.conf.5 raidfile.conf.5
 
-man-html: bbackupquery.html bbackupctl.html bbstoreaccounts.html \
-        bbstored-config.html raidfile-config.html bbstored-certs.html
+man-html: bbackupd.html bbackupd-config.html bbackupctl.html bbackupquery.html \
+        bbstored.html bbstored-config.html bbstoreaccounts.html bbstored-certs.html \
+        raidfile-config.html \
+        bbackupd.conf.html bbstored.conf.html raidfile.conf.html
 
 .xml.html:
@@ -52 +67 @@
         cp $@ $(HTMLPREFIX)/man-html/.
 
-.xml.8:
+.xml.8 .xml.5:
         $(DBPROC) -o $@ $(MANXSL) $<
         cp $@ man-pages/

box/trunk/documentation/bb-man.xsl.tmpl

@@ -3 +3 @@
     xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> 
 
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"/> 
+<xsl:import href="%%DOCBOOK%%"/> 
 
 <xsl:param name="chunk.section.depth" select="'0'"/>