[Fwd: macros: Changes to 'master']

[David Nusinow]

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/