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? > -- > Dan -- Victor Lowther Ubuntu Certified Professional _______________________________________________ Pm-utils mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/pm-utils
