On Aug 23, 2004, at 10:32 AM, Doug Gregor wrote:
The text for the following doxygen fields end up orphaned at the bottom of the generated HTML, with no section header:
\pre
\return
There are probably others that I haven't discovered yet.
<<extra info: also without headers are \post and \attention.>>
These changes require some minor tweaking to tools/boostbook/xsl/doxygen/doxygen2boostbook.xsl, to recognize the section kinds for these clauses and turn them into BoostBook. I'm actually a little surprised that 'pre' is working but 'post' isn't, because I can see code for the latter but not the former...
These are fixed in CVS.
Doug
Thanks for looking into this Doug.
I'm still not getting section headers for any of these. But the description/paramater mix-up is fixed, thank (gre)god! ;-)
I've noticed a recent change. The HTML file names for the documentation of free functions used to be meaningless id numbers, but now they are the names of the functions they contain. That's good, except for 2 things:
1) The name is not fully qualified, so there could be conflicts if the same function (eg. swap) exists in two different namespaces. How about something like function.boost.<libname>.<namespace>.swap.html?
2) The function-name-as-file-name thing doesn't work so well when the function is an operator. I now have operator<<.html, and none of the links to it will reach it. :(
<aside>
Incidentally, I've gone with doxygen/boostbook whole-hog for xpressive's documentation. You can see my progress (and spot some of boostbook's rough edges) at:
http://boost-sandbox.sourceforge.net/libs/xpressive/doc/html/index.html.
The reference section is generated with doxy/boost. I've found it to be a very compelling documentation tool. Keep up the good work!
</aside>
-- Eric Niebler Boost Consulting www.boost-consulting.com
------------------------------------------------------- SF.Net email is sponsored by Shop4tech.com-Lowest price on Blank Media 100pk Sonic DVD-R 4x for only $29 -100pk Sonic DVD+R for only $33 Save 50% off Retail on Ink & Toner - Free Shipping and Free Gift. http://www.shop4tech.com/z/Inkjet_Cartridges/9_108_r285 _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
