On Aug 23, 2004, at 11:59 AM, Eric Niebler wrote:
I'm still not getting section headers for any of these.

I think I don't quite understand what you mean by this. Where do you expect to see section headers?


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?

Actually, it will only use the function name when there is a unique entity with that name. Otherwise, it'll fall back to the old id.


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

Oops, I'll fix that in a few moments.

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

Glad to hear it.

        Doug



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

Reply via email to