On Tue, 28 Jan 2003, Jeff Garland wrote:
> > 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...

Hmmm... I'm sure that helps somewhow, but I don't know how :)

> > 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.

That would be appreciated.

> 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:
[snip]
> Free functions, namespaces, and files have their own similar
> reference xml files.

No chance of getting it all into one big XML document? I guess I could
generate a document with a lot of XIncludes...

> > 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

I'm not quite sure you what you mean by "a unique element so that it could
be referenced"?

        Doug



-------------------------------------------------------
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

Reply via email to