Re: [docbook-apps] Switching manpage generation from docbook-SGML to docbook-xml

From
Mark Craig <>
Date
2017-10-06T09:09:18+00:00
ID
CACFdy_9wD282Q1MCeOiJf=tn9Dbsz1j92fm=
Thread
Re: [docbook-apps] Switching manpage generation from docbook-SGML to docbook-xml
Hello,

If you get the DocBook XSL stylesheets, you can probably do the conversion with the xsltproc tool as shown in http://www.sagehill.net/docbookxsl/RefentryToMan.html

Hope it helps,

Mark

PS The XSL conversion works fine in the toolchain I'm using (in a Maven project, so with a plugin based on https://github.com/mimil/docbkx-tools ), and we do almost nothing to change the default configuration for man page conversion. Just this:

 <xsl:param name="man.authors.section.enabled" select="0" />
 <xsl:param name="refentry.date.profile.enabled" select="1" />

On Fri, Oct 6, 2017 at 10:52 AM, Guido Günther <> wrote:
Hi,

I'm currently trying to switch git-buildpackage's documentationน from

SGML to XML. That worked out nicely for the HTML docs but there's one

problem with the manpages I'm stuck with. I used the build manpages.refs

from docbook2man to get the cross references in the manpages right:

    https://github.com/agx/git-buildpackage/blob/master/docs/Makefile#L64

Now I can't seem to figure out how this works with docbook2x-man. Is

this at all possible? If not are there other tools that can handle this?

Any hint would be greatly appreciated!

Cheers,

 -- Guido

น) https://github.com/agx/git-buildpackage/blob/master/docs/

---------------------------------------------------------------------

To unsubscribe, e-mail: 

For additional commands, e-mail: