Experimental new support for building man pages via docbook2x, an XSL-based

tool chain.  With some polishing, this might help us get rid of our ancient
and crufty man page build mechanism.

diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile
index 49ac9460919c73ab21e606027794de6e6530e8a9..a530cc9f55f85025a49dfaa4c1cedb8955ecdab3 100644 (file)
--- a/doc/src/sgml/Makefile
+++ b/doc/src/sgml/Makefile
@@ -2,7 +2,7 @@
 #
 # PostgreSQL documentation makefile
 #
-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.109 2008/10/31 14:35:30 petere Exp $
+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.110 2008/11/04 14:58:22 petere Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -269,6 +269,20 @@ MAKEINFO = makeinfo
 .SUFFIXES:
 
 
+##
+## Experimental man page building through docbook2x
+##
+
+# called docbook2man on non-Debian
+DOCBOOK2MAN = docbook2x-man
+
+manx: postgres.xml stylesheet-man.xsl
+       $(DOCBOOK2MAN) -s $(srcdir)/stylesheet-man.xsl --string-param default-manpage-section=$(DEFAULTSECTION)  $<
+       $(mkinstalldirs) man1 man$(DEFAULTSECTION)
+       mv *.1 man1/
+       mv *.$(DEFAULTSECTION) man$(DEFAULTSECTION)/
+
+
 ##
 ## Check
 ##

diff --git a/doc/src/sgml/stylesheet-man.xsl b/doc/src/sgml/stylesheet-man.xsl
new file mode 100644 (file)
index 0000000..2d37a42
--- /dev/null
+++ b/doc/src/sgml/stylesheet-man.xsl
@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version="1.0">
+
+<xsl:import href="http://docbook2x.sourceforge.net/latest/xslt/man/docbook.xsl"/>
+
+<!--
+  Man pages don't really support a third section level, but this
+  makes our man pages work OK and matches the behavior of the sgmlspl
+  style.
+ -->
+<xsl:template match="refsect3">
+  <xsl:call-template name="SS-section" />
+</xsl:template>
+
+</xsl:stylesheet>