> 2) Generated output

I've done a little work on the BoostBook XSL and the Doxygen->BoostBook
translation, and will check it in tomorrow when I have a chance (and a real
Internet connection).

> - There are some parts missing in the generated docs. For example
parameters descriptions
>   are not there ( although they are in the file and doxygen recognized
them ).

I've added parameter descriptions. In BoostBook, <parameter> elements can
now have <description> children (like most other elements can) that, well,
describe what they do. These are formatted via a DocBook <variablelist>, for
those that care about such things :)
The Doxygen->BoostBook translator also handles parameters (at least, on my
testcases...)

> - I wish there will be some more doxygen parameters recognized. For
instance,
>   the file description ( \file tag ) or examples ( \example tag ).

File descriptions are working now. I haven't figured out what to do with
\example, yet.

> - In my example, template functions have rather long return value and the
result currently
>   does not look very nice ( see
http://lenin.felcer.sk/~droba/boost-book/ ).
>   I don't know if it is feasible, but return type should go on separate
line if it is
>   longer then some reasonable limit and possibly ( secret wish :) )
splited into several lines.

The first part of this is done. If the return type doesn't fit along with
the rest of the declaration and is longer than some number of characters
(defaults to 6, I think), it is placed on a separate line. Splitting it into
several lines is a little bit tougher, so maybe in a future update.

    Doug



-------------------------------------------------------
This SF.Net email sponsored by: Free pre-built ASP.NET sites including
Data Reports, E-commerce, Portals, and Forums are available now.
Download today and enter to win an XBOX or Visual Studio .NET.
http://aspnet.click-url.com/go/psa00100006ave/direct;at.asp_061203_01/01
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to