Scrollkeeper, the documentation, XML, and the way forward

[Brian Vincent]

On Sat, 12 Mar 2005 16:57:22 -0800, Scott Ritchie <scott at open-vote.org> wrote:
> 1) Create a new directory for all XML documentation at wine/doc.  This
> will also bring us to be more standard.

The key is that we use Docbook's SGML.  Docbook now supports XML and
converting the SGML is as easy Mike said:
http://infohost.nmt.edu/tcc/help/pubs/docbook42/convert-4-1-section.html

So, I'm not sure what would need to change on the tools end to build
the docs - probably not much?  If you converted to XML, it appears
none of the tools would need to change.  Of course you still need to
support all of the various doc formats - PDF, ps, HTML, etc.

There's two reasons I can think of to do this.  First, it appears that
as of about mid-2002 Docbook in XML became the preferred method.  The
DSSSL toolchain was deprecated in favor of XSLT.  Second, it would be
nice if we could dynamically display (or at least build daily) XML
from CVS and display it on WineHQ.  We've had problems in the past
where the docs on the website have been 3 or 4 months out of date
compared to CVS.  Newman may have fixed this last year, but I'm not
really sure what the current process is to get docs up.

However, I'm not sure its worth the effort.

-Brian