> 1. For some functins, a link is whole function definition, not just the
> function name.
That's by design, although there was a bug where a function with a template
header on a separate line would have the rest of its declaration
highlighted, and that looks quite silly. I've fixed the bug part. I actually
like the whole-definition highlighting when it fits on one line, because it
gives me a lot of clickin' latitude. But since this is a stylistic issue, we
can always agree to disagree and add a stylesheet parameter :)
> 2. I would suggest to increase the treshold for moving a retunr value to
> a separate line. It should be at least 10-15 chars.
Done. It's at 12 now, because 17 is too large :)
> 3. Parameter descriptions are there, but it looks like they are
malformated.
> Caption is visible only for the first paramter.
Oops! Fixed now.
> 4. I have tried to move DTD and XLS directory defintions to
user-config.jam,
> as you suggested, but they are not read.
Odd. Did you put user-config.jam into $HOME or $BOOST_BUILD_PATH? The BBv2
docs say that it looks there...
> 1. Doxygen's \note is another tag which is handy.
... now translated into BoostBook <notes>.
> 2. I would reorganize detailed function description a little bit, if it is
possible.
>
> - 1. Parameters
> - 2. Return value
> - 3. Description
> - 4. ?Notes
> - 5. ?Examples
This is very unlikely to happen. BoostBook is deliberately modeled afer the
C++ standard's method of documentation, which is very rigid in the ordering
of the semantic clauses, and I really don't think we want to break that to
support Doxygen extensions like parameter lists. Actually, I'm starting to
wonder if the problem is because the Doxygen description should be mapped
over to <effects> instead of coming before normal semantic clauses...
Doug
-------------------------------------------------------
This SF.Net email sponsored by: Parasoft
Error proof Web apps, automate testing & more.
Download & eval WebKing and get a free book.
www.parasoft.com/bulletproofapps1
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
