On Saturday 02 February 2002 09:38 pm, Ihsan Ali Al Darhi wrote: > Why don't you produce this explanation of how you will document Boost > library using XML and other stuffs in a single documentation?
The input is a DocBook XML document with extended syntax that allows specification of C++ reference document. The extended syntax is similar to that of the DocBook elements for C or Java reference documentation, but suitable for C++ in all its, err, glory. This DocBook XML + C++ XML document is fed through an XSLT stylesheet that formats the C++XML into normal DocBook XML. From there we can create distributed documentation in the normal DocBook way (I'm using the XSLT stylesheets for HTML, FO->PDF, and man page output). The discussion of this started here, and somewhere in the pile is a full diagram showing how everything could work, starting with documentation extractors like Doxygen and Synopsis and ending with a number of end-user documentation formats: http://lists.boost.org/MailArchives/boost/msg38047.php Doug _______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
