Hi, On Sun, Jul 06, 2003 at 11:19:20PM -0700, Douglas Gregor wrote: > > 2) Generated output
[snip] > > - 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...) > Great, I was really missing this part:) > > - 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. > I'll try it as soon, as I will be able to get it from sf cvs. I have another comment regarding files. Currently my reference page is starting to be quite long. It would be nice to be able to split it into several pages. An idea would be to put each file into separate page and create one page with links to all these pages. ( or have a tag in main documentation to generate such a list). Currently there is no method how to add some structure to doxygen-generated reference ( At least I don't know about any ). I think, that for larger references it would be nice to have this posibility. > > - 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. > Good start. I will update my show case when I will be able to try all these goddies :) Regards, Pavol ------------------------------------------------------- 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
