[xml/sgml] [Fwd: Re: RFS: docbook-xsl 1.72.0.dfsg.1-1 and docbook2x 0.8.7-1]

[Daniel Leidert]

JFYI:

-------- Weitergeleitete Nachricht --------
> Von: Daniel Leidert <daniel.leidert.spam at gmx.net>
> An: charles-debian-nospam at plessy.org
> Kopie: debian-mentors at lists.debian.org
> Betreff: Re: RFS: docbook-xsl 1.72.0.dfsg.1-1 and docbook2x 0.8.7-1
> Datum: Mon, 05 Mar 2007 21:49:42 +0100
> 
> Am Dienstag, den 27.02.2007, 23:27 +0900 schrieb Charles Plessy:
> > Le Tue, Feb 27, 2007 at 02:01:52PM +0100, Daniel Leidert a écrit :
> > > Hi,
> > > 
> > > My regular sponsor seems to be in vacation, so I ask for someone else,
> > > who uploads the following packages to Debian (experimental):
> > > 
> > > docbook-xsl 1.72.0.dfsg.1-1
> > > http://debian.wgdd.de/debian/incoming/packages/docbook-xsl_1.72.0.dfsg.1-1_i386.changes
> > 
> > Hi Daniel,
> > 
> > One of the many things which distinguishes Debian compared to other
> > projects is that we write manpages when the upstream package does not
> > contain some.
> > 
> > I never was brave enough to monitor the dockbook-xsl package to see if
> > there are important changes relevant to the manpages I wrote in
> > dockbook.
> > 
> > Do you think that you could write a "For those who care about manpages"
> > mail from time to time ?
> 
> I'm currently writing a make-snippet to be included into debian/rules
> (similar to dpatch.make) to allow easier processing and inclusion of
> manpage XML sources into Debian packages. If you are interested in the
> results, contact me (it is not yet in the Debian XML/SGML group's CVS
> repository). I'm open for any suggestions (e.g. how to enable support
> for both, DocBook XML and SGML - manpage.xml, manpage.sgml, foo.1.xml,
> foo.1.<lang>.xml and similar). ATM the snippet support DocBook XML and
> xmlto and xsltproc (docbook2x-man will be supported soon, after having a
> feature like the one enabled with man.output.lang.in.name.enabled).

Attached is the (currently untested) result - just to show, what I mean.

Regards, Daniel
-------------- next part --------------
# -*- Makefile -*-
# contributed by the maintainers of the docbook-xsl package

DOCBOOK_XSL_DIR ?= /usr/share/xml/docbook/stylesheet/nwalsh
DOCBOOK_XSL_MAN ?= ${DOCBOOK_XSLDIR}/manpages/docbook.xsl

DOCBOOK_XSL_DEFAULT_STYLESHEET ?= \
	<?xml version='1.0' encoding='utf-8'?> \
	<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" \
	                version="1.0"> \
		<xsl:import href="${DOCBOOK_XSLMAN}"/> \
		<xsl:param name="make.year.ranges" select="'1'"/> \
		<xsl:param name="make.single.year.ranges" select="'1'"/> \
		<xsl:param name="man.charmap.use.subset" select="'0'"/> \
		<xsl:param name="man.output.lang.in.name.enabled" select="'1'"/> \
	</xsl:stylesheet>

# The different processors:
XMLTO           := xmlto
XMLTO_FLAGS     := -o ${MANPAGE_OUTPUT_DIR}
XSLTPROC        := xsltproc 
XSLTPROC_FLAGS  := --nonet  -o ${MANPAGE_OUTPUT_DIR}
DOCBOOK2X       := docbook2x-man
DOCBOOK2X_FLAGS := 
# docbook2x-man doesn't handle lang="" like docbook-xsl does
# so it is currently not used and just here fto not forget it

MANPAGE_COMMAND    ?= ${XSLTPROC}
MANPAGE_OUTPUT_DIR ?= $(CURDIR)

# process foo.1.xml to foo.1
# process foo.de.1.xml foo.de.1
% : %.xml
ifeq (${MANPAGE_COMMAND},xmlto)
	echo ${DOCBOOK_XSL_DEFAULT_STYLESHEET} | ${XMLTO} -x - ${XMLTO_FLAGS} man $<
else
	echo ${DOCBOOK_XSL_DEFAULT_STYLESHEET} | ${XSLTPROC} ${XSLTPROC_FLAGS} $< -
endif

# process manpage.xml to whatever it contains:
debian-manpage: debian/manpage.xml
ifeq (${MANPAGE_COMMAND},xmlto)
	echo ${DOCBOOK_XSL_DEFAULT_STYLESHEET} | ${XMLTO} -x - ${XMLTO_FLAGS} man $<
else
	echo ${DOCBOOK_XSL_DEFAULT_STYLESHEET} | ${XSLTPROC} ${XSLTPROC_FLAGS} $< -
endif

clean-debian-manpage:
	
.PHONY debian-manpage