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.
This commit is contained in:
Peter Eisentraut 2008-11-04 14:58:22 +00:00
parent 254aecb704
commit 725ba51f2c
2 changed files with 31 additions and 1 deletions

View File

@ -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
##

View File

@ -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>