I am using doxygen/boostbook/BBv2 to build a reference, and I'm running into some problems. Maybe someone can offer some suggestions.
My project is in the boost-sandbox, and all the relative HTML links generated by doxygen/boostbook are broken. For instance, the links in the header (Home, Libraries, People, FAQ, More) are broken, as are all the links to the source files. Is there some way to specify a relative path prefix so these links are correct?
I don't want the private members documented. I have added these directives to the doxygen rule in my Jamfile.v2, but they don't seem to have any visible effect:
<doxygen:param>EXTRACT_ALL=NO
<doxygen:param>HIDE_UNDOC_MEMBERS=YES
<doxygen:param>EXTRACT_PRIVATE=NO
<doxygen:param>ENABLE_PREPROCESSING=YES
<doxygen:param>MACRO_EXPANSION=YES
<doxygen:param>EXPAND_ONLY_PREDEF=YES
<doxygen:param>SEARCH_INCLUDES=YES
What am I doing wrong?
There is a bunch of stuff I don't want emitted, like stuff in the detail:: namespace. The doxygen documentation suggests wrapping them in a #ifndef DOXYGEN_SKIP_THIS block, and then defining DOXYGEN_SKIP_THIS when running doxygen. Is there a way to do this from the Jamfile?
For each entity, I have a brief description and a detailed description. The brief description ends up at the top of the generated HTML file (good), but the detailed description ends up orphaned at the bottom (bad). There is a "Description" section in the HTML following the "Synopsis" section, but it is always empty. Bug?
The text for the following doxygen fields end up orphaned at the bottom of the generated HTML, with no section header:
/pre
/return
There are probably others that I haven't discovered yet.
For enumerations, I have doc comments for each of the members, but they are not getting emitted in the HTML. Known problem? (I am aware that I need a \file directive for global entities to get emitted.)
I know nothing about XML or XSL, so my attempts to figure these out on my own have been unproductive. Any help is greatly appreciated.
-- Eric Niebler Boost Consulting www.boost-consulting.com
------------------------------------------------------- This SF.Net email is sponsored by OSTG. Have you noticed the changes on Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now, one more big change to announce. We are now OSTG- Open Source Technology Group. Come see the changes on the new OSTG site. www.ostg.com _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
