On Tue, May 20, 2008 at 4:47 PM, Victor Lowther <[EMAIL PROTECTED]> wrote: > On Tue, 2008-05-20 at 06:35 -0700, Dan Nicholson wrote: >> On Tue, May 20, 2008 at 6:20 AM, Michael Biebl <[EMAIL PROTECTED]> wrote: >> > 2008/5/14 Michael Biebl <[EMAIL PROTECTED]>: >> >> 2008/5/13 Victor Lowther <[EMAIL PROTECTED]>: >> >>> >> >>> 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?
I imagine you've got it figured out, but I'll take a look tonight. -- Dan _______________________________________________ Pm-utils mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/pm-utils
