Re: RFP: docbook2x -- converts DocBook documents into man pages and Info documents
On Sat, 2003-03-22 at 01:42, John Goerzen wrote:
> On Fri, Mar 21, 2003 at 09:17:51PM +1100, Drew Parsons wrote:
> > docbook2X seems to deal with all of these inadequacies in docbook-to-man.
>
> How's it different than docbook-utils or sgml2x?
>
You're right, docbook2man from docbook-utils does what I want, produces
a perfectly formatted man page from my DocBook SGML file.
What's more interesting is that docbook2man *is* in fact docbook2X. The
header of the man page produced by docbook2man says:
.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
With regards to the other alternatives we get a bit of inconvenience
from DocBook's dual nature, SGML and XML. docbook2man's own man page
says "For the moment, jw does not handle XML, but only SGML." But
docbook2X, on which it is based, processes the XML variant by default,
and only handles SGML when you switch on a command line option.
But I haven't converted my SGML file to XML, so I can't say if
docbook2man would work on it. Likewise I can't test "xmlto man ..."
since xmlto only works with the XML version, not SGML.
Finally, I couldn't see how sgml2x produces man pages, so that option is
out, unless you want to fart around trying to find just the right
stylesheet for it somewhere and specify it explicitly (as Morgon said,
it must be there somewhere).
So in summary, I think I can safely close my RFP: docbook2X is
effectively already in Debian. docbook2man (docbook-utils) meets my
needs.
Thanks for bringing it too my attention.
Drew
Reply to: