On Saturday 01 February 2003 07:10 am, Jeff Garland wrote: > > Don't think everything will work yet, of course. Doxygen's XML output > > omits a great deal of structural information that is essential in > > BoostBook (and in C++). > > Aside from the example below can you make a list? Perhaps we can influence > the Doxygen XML format.
Will do. > > I'd rather not post the resulting HTML until I get a little further. If > > you'd like to try it out, you'll want Doxygen 1.2.18: 1.2.17 generates > > bad XML as does 1.3-rc2 and the current CVS. > > At some point we really should feed back our results to the Doxygen > development group. Maybe we can get them to fix the XML output and make it > a bit more friendly for boost-book conversion. Of course I'll help when we > get a bit further... I've started putting some comments on the Wiki: http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost_Documentation_Format/Tasks As I run into more trouble I'll add comments to that list. > Also, after studying this in detail have you had any more thoughts about > things that might be missing from boost-book? As I said before, I think > the wrapping the loose <para> tags in a description tag something like > the <detaileddescription> would be a useful addition just to clearly > delineate what these elements represent. Yes, I agree with this. Let's call it <description> (we have <purpose> for the brief description in several places already). > And I've been assuming that > given boost-book goals we aren't really interested in things like > <inheritancegraph>, <collaborationgraph>, <incdepgraph> > (include dependency graph), and <programlisting>. > > Jeff We wouldn't want to use any of the graphs from the Doxygen output anyway, because it wouldn't include other entities in BoostBook that didn't come from Doxygen. Besides, most of those are very easy to generate from within the XSL stylesheets. I don't know what to do about <programlisting> yet, though... 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
