[Fwd: macros: Changes to 'master']
David Nusinow
dnusinow at speakeasy.net
Mon Oct 30 18:50:21 PST 2006
On Tue, Oct 31, 2006 at 12:21:11PM +1100, Drew Parsons wrote:
> On Mon, 2006-10-30 at 19:25 -0500, David Nusinow wrote:
> > On Mon, Oct 30, 2006 at 02:15:41PM -0500, Eamon Walsh wrote:
> > >
> > > I have been working on some DocBook documentation, but it is in XML, not
> > > SGML. The man page for the docbook2xxx toolchain says it only supports
> > > SGML (at present). Do I have to use SGML for X.Org docs?
> >
> > Currently, as far as I know, yes you do. I'm in the process of updating all
> > our docs from linuxdoc to docbook. The easiest way to do this is to leave
> > it all as sgml, so I focused on that. Do you know of an alternate toolset
> > we could use that would support xml that would let us build all the various
> > formats we want? Alternately, we could simply try and add support to the
> > macros for xml docs too.
> >
>
> docbook2X (docbook2x-man) is supposed to be able to process XML
> docbooks. Apart from man, docbook2texi should generate info pages. Other
> style sheets might be accessible using the backend, db2x_xsltproc.
Ok that might be an option, but looking at the Debian archive, there's the
xmlto package[0], which advertises the ability to convert to all the
formats we currently use, so that's probably a better choice. I think
finishing the 7.2 relnotes is a higher priority (which the reason why I'm
doing the conversion) but I'll see about adding support for xml right
afterwards if Eamon or someone else doesn't do it first.
- David Nusinow
[0] The homepage for xmlto is http://cyberelk.net/tim/xmlto/
More information about the xorg
mailing list