Re: Building docbook manpages (Re: RFS: crotch)
Am Donnerstag, den 01.02.2007, 09:12 +0900 schrieb Charles Plessy:
> Le Wed, Jan 31, 2007 at 11:00:48PM +0000, Paul Cager a écrit :
> > I thought docbook2man (or docbook-to-man) would be the best way to do
> > it, but it can't handle the XML produced by doclifter (it only really
> > works for SGML). xmlto works, though:
> > xmlto man thing.1.xml
> xsltproc does also the job... I frequently have that kind of things in
> my debian/rules...
> xsltproc -o debian/ -''-nonet /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl debian/themanpage.1.xml
This command will lead to problems with special characters. Have a look
at /usr/share/doc/docbook-xsl/examples/foo.1.example_manpage.xml.gz. for
an up-to-data example and the recommended command. The latest release
(1.72.0, currently preparing the package) also adds support for
dh_installman features (see the upcoming documentation of
man.output.lang.in.name.enabled or bug #310895).
> Actually, maybe this is just what xmlto does. Using xmlto would
> therefore protect me from changes in the layout of the directories
> containing xsl pages.
Which changes? Could you explain or give an example?
> I think I will switch to xmlto.
> Any opinion on this ?
AFAIK xmlto simply uses the docbook-xsl stylesheets (but it uses the
already removed the passivetex extension to create PDF, which is not a
good idea). Not sure, if you can overhand parameters to xmlto via
command line (maybe with the [-m xsl_fragment] option?).