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

[Guido Günther <agx@sigxcpu.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
> >
> >