> I didn't realize Doxygen even generated XML. Is there a description of the
> format somewhere?
Well I think it is still technically an unofficial feature, but it has
been stable for a long time. I think the main reason it is unofficial
is a lack of documentation :-( I thought there was a DTD somewhere, but I
can't find it in my email archive or a quick scan of the site. I do have
an XML Schema if that helps...
> AFAIK, nobody has tried to convert Doxygen's output into BoostBook. I'd like
> to take a look at the XML to assess how complicated such a venture would
> be...
For an XSL wiz such as yourself I don't think it would be too bad :-)
However, I'm sure there will be some mapping gotchas. I can send you some
some xml output from the date_time library if you want to have a look.
As an overview, basically each class is generated into it's own XML
reference file. For example, the top of the boost::gregorian::date
file looks like:
<?xml version='1.0' encoding='ISO-8859-1' standalone='yes'?>
<doxygen version="1.2.17">
<compounddef id="classboost_1_1gregorian_1_1date" kind="class">
<compoundname>boost::gregorian::date</compoundname>
Then there are several sections for more detailed information like
inlcude dependencies, list of all member functions and types, etc
etc.
Free functions, namespaces, and files have their own similar
reference xml files.
> Actually, that's already done: top-level references (e.g., namespace-level
> functions and classes) have both a purpose (one-line description in the
> <purpose> element) and a more detailed description (any number of <para>
> elements). Not that this is documented yet...
Hmm, I saw the purpose, but I guess I didn't see that the detailed
description had a unique element so that it could be referenced, but
I may have just missed it...
Jeff
-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
