Am Samstag, den 03.02.2007, 17:04 +0900 schrieb Charles Plessy: > Le Thu, Feb 01, 2007 at 01:57:21AM +0100, Daniel Leidert a écrit : > > > > > > 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). > > > > I think I will switch to xmlto. > > > > 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?). > > Thank you very much for the example manpage. I was wondering wether > xmlto would be a nice way to factorise some code across debian/rules and > debian/control files, but if I understand correctly, calling xsltproc > directly is better because it is needed to set parameters.
It depends. I could imagine (but didn't test it), that the [-m xsl_fragment] option can do this. The alternative is to write you own small xsl stylesheet to set parameters. But if I understand your intentions correctly, this is what you want to avoid. > By the way, > where are these parameters documented, The parameters are described in the documentation provided with docbook-xsl-doc (and upcoming docbook-xsl-doc-(html|pdf|text)). Just start a browser and view file:///usr/share/doc/docbook-xsl/doc/index.html -> "Manpages Parameter Reference". > and where can I get the relevant > informations for "those who care about xml manpages"? IMO there is only some general information in http://www.docbook.org/tdg/en/html/docbook.html and probably in http://www.sagehill.net/docbookxsl. The rest is learning by doing :) Regards, Daniel
