I just added a new feature to BoostBook: support for multiple reference sections. Many boost libraries have sub-libraries (Spirit has Fusion and Phoenix, xpressive has proto, etc.). It would be nice to separate the reference sections for the sub-libraries, but still keep them all together for easy cross-referencing. This is now possible.

To do it, in your Jamfile.v2, you have 2 calls to the doxygen rule, like:

doxygen aref
  : a.hpp
  : <xsl:param>"boost.doxygen.reftitle=\"Reference A\""
  ;

doxygen bref
  : b.hpp
  : <xsl:param>"boost.doxygen.reftitle=\"Reference B\""
  ;

This will generate aref.boostbook with <library-reference id="reference_a"> and bref.boostbook with <library-reference id="reference_b">. You can override the default generated ids with the new xsl:param boost.doxygen.refid.

Then you can [xinclude aref.boostbook] and [xinclude bref.boostbook] from your .qbk file, and you'll get two refernce sections: "Reference A" and "Reference B".

--
Eric Niebler
Boost Consulting
www.boost-consulting.com


-------------------------------------------------------
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://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to