On Sat, 12 Mar 2005 16:57:22 -0800, Scott Ritchie scott@open-vote.org wrote:
- 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