On Tuesday 28 January 2003 12:20 pm, Jeff Garland wrote:
> > On the Wiki, I see a diagram where doxygen produces XML which is merged
> > with human-written XML. Is this working now, or only planned? I'm rather
> > interested.
>
> It's something I'm interested in as well, but too busy to really work
> on seriously at the moment. Now that Doug and friends have designed
> the boost-book XML it should 'simply' be a matter of taking the
> Doxygen XML output and transforming it into boost-book. Presumably
> we would want to use XSLT to do this since we already have this
> set of tools.
I didn't realize Doxygen even generated XML. Is there a description of the
format somewhere?
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...
> I think it would be very valuable to try and do this sort of
> linkup because I suspect we may be missing a few things from
> boost-book that have proven useful in other documentation
> systems.
Absolutely!
> For example, the distinction between a brief
> description and a long description for classes and
> functions. Brief descriptions typically being one liners
> that can get generated into table of contents like references.
> I'm not sure I see how do this in boost-book reference. But
> I haven't really tried to write a boost-book reference yet --
> just looked at some of the samples...
>
> Jeff
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...
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
