The Quickbook documentation says it has support for Doxygen-generated
documentation.
BoostBook also supports this but I've never been able to get it to
work.
I've been trying to generate documentation for named template parameters
for Boost for the past six months. On my last attempt with BoostBook,
I ended up linking to the doxygen documentation for some other Boost
library. I've copied Jamfiles from other libraries that use BoostBook
and Doxygen and changed what I thought were the obvious things to
changbe.
Suffice to say, BoostBook and Boost.Build have been a nightmare for me.
I much prefer Quickbook's simpler and more readable markup.
Is there a complete example somewhere of how to write Boost
documentation for a library that has Doxygen comments, all
using QUickbook as the base? The example would have to include
a Jamfile as I find jam's syntax and default behavior utterly
mystifying. I don't know why this system is better than
the de facto standard make but that's another thread.
BTW, the Boost web site makes it very hard to find the documentation
for BoostBook or Quickbook. I had to run a search to find the latter.
I can never remember how to find the former, though I know the link is
buried somewhere. The current obvious links point to outdated
instructions for writing HTML docs that seems to have been written
around 2002 or so. This really ought to be updated and made much
more accessible than it currently is.
-Dave
-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems? Stop! Download the new AJAX search engine that makes
searching your log files as easy as surfing the web. DOWNLOAD SPLUNK!
http://ads.osdn.com/?ad_id=7637&alloc_id=16865&op=click
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
