[Pm-utils] more man pages!

Victor Lowther victor.lowther at gmail.com
Tue May 20 16:47:02 PDT 2008

On Tue, 2008-05-20 at 06:35 -0700, Dan Nicholson wrote:
> On Tue, May 20, 2008 at 6:20 AM, Michael Biebl <mbiebl at gmail.com> wrote:
> > 2008/5/14 Michael Biebl <mbiebl at gmail.com>:
> >> 2008/5/13 Victor Lowther <victor.lowther at gmail.com>:
> >>>
> >>>  As a test, I have converted the xml manpages back to SGML and done a bit
> >>>  more cleanup on them to test how well the manpages work with the current
> >>>  SGML based build process -- the results of that conversion process are @
> >>>  http://cgit.freedesktop.org/~vlowther/pm-utils/log/?h=man-sgml
> >>>
> >>>  Converting between the manpage formats (after a touch of cleanup) is
> >>>  trivial -- my question for the distro maintainers is which documentation
> >>>  build process (xmlto or docbook2man) best intergrates with the way you
> >>>  do man pages for the rest of your packages?
> >>
> >> Docbook/XML is definitely the way to go.
> >
> > As additional information:
> > Installing docbook-utils (containing docbook2man) on a plain Debian
> > system, requires 131 MB of additional disk space.
> > xmlto requires 18 MB.
> >
> > The Docbook/XML chain is much more light weight (at least on
> > Ubuntu/Debian). I guess the results are comparable on other distros.
> The actual minimum requirements for Docbook XML (it's used on
> LInuxfromscratch) is just an xslt processor (xsltproc usually), the
> Docbook XSL Stylesheets, and the Docbook XML DTDs. xmlto is just a
> nice wrapper around the XML and XSLT handling. Basically, it calls
> xsltproc with the right arguments to produce the output you want.
> So, yeah, you don't need docbook-utils unless you also want to be
> handling Docbook SGML, which we're not. I'd definitely try to use
> xmlto until you find that it's broken.

Well, that sound like a plan, then.  Dan do you mind taking a look at
the man-xml branch and doing whatever needs to be done to make manpage
generation work like it does in master?

> --
> Dan
Victor Lowther
Ubuntu Certified Professional

More information about the Pm-utils mailing list