docbook-apps

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/

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 <agx@sigxcpu.org> 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: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>

Hi Mark,
On Fri, Oct 06, 2017 at 11:09:16AM +0200, Mark Craig wrote:
> 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

That did the trick already. The stylesheet can produce several manpages
out of one docbook-xml file so if I put them into once document the
references come out alright.
Thanks a lot!
-- Guido

>
> 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 <agx@sigxcpu.org> 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: docbook-apps-unsubscribe@lists.oasis-open.org
> > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
> >
> >