Hi, On Fri, Jul 04, 2003 at 08:46:54AM -0700, Douglas Gregor wrote: > > I have tried to generate a sample documentation for the string_algo lib > > using BoostBook > > and Doxygen. Process was a little bit painfull, but the result is quite > > reasonable. > > > Glad to hear it! I'm obviously still working on the process, but your > feedback helps quite a bit. >
I'm glad to help. [snip] > > - From some unknown reason 'xslt-xsltproc-dir html/HTML.manifest' step > > takes > > very long time to complete. I assume that I have misconfigured > > something. > > I have followed the boost-book guide and downloaded xsl and dtd into my > > harddrive, but they are probably not used. ( My Jamfile is included at the > > end ) > > > One way to check this would be to add "--nonet" to the xsltproc command > line. That will tell you if it tries to download something off the 'net for > processing. > I traced down the problem. Reason why it wasn't working properly was that the catalog.xml file was lost somewhere and not generated again. I have commented out "NOUPDATE $(actual)" in "rule xml-catalog-action" in boostbook.jam and it works fine now. [snip] > > - Doxygen is able to create links to different components of the > > documentation directly in > > defintions. I would like to create link for types and template > > paramters. ( something > > like this: http://www.boost.org/libs/utility/transform_iterator.htm ). > > > Again, I'll look into it. I'm not quite sure how it will fit with Doxygen, > but the goal for template parameters is that they will be declared to model > certain concepts (concepts will also be represented in BoostBook, by way of > Caramel), and BoostBook will create links from template parameters to the > concepts they model. > This would help. But it would be nice to find some way how to reference other parts of the library documentation from the code comments. It would probably need to use some special doxygen tag which will be transalted to a link. 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
