[Boost-docs] Building doc with doxygen and quickbook problem

Subject: [Boost-docs] Building doc with doxygen and quickbook problem
From: Edward Diener (eldiener_at_[hidden])
Date: 2010-10-07 13:10:50

I am building documentation using doxygen and quickbook. There is no 
problem doing that except that my reference section, based on doxygen 
output, looks wrong in the TOC. What I am seeing is:

Reference
     Reference
         Header <boost/variadic_macro_data/VariadicMacroData.hpp>

instead of:

Reference
     Variadic Macro Data Reference

I have looked at another jamfile, doxygen, and quickbook setup ( Units, 
Units Reference ) to try to discover why my output is different. What I 
see is that the generated doxygen xml files are different, but I do not 
know why, nor do I know if or why the differences are generating my bad 
TOC reference above. Here are the differences:

1) My doxygen xml is laid out on a single line rather than being 
formatted easily so it can be read as is the units xml file. I am 
doubtful that this is causing any difference but I would like to see my 
xml output formatted nicely to read also.

2) My doxygen xml has an opening <library-reference> while the unit has 
an opening <library-reference id="units_reference">.

3) My doxygen xml has not <title> after the <library-reference> element 
but the units one does have a <title>.

Are these causing the differences in the TOC ?
If so, how can I correct my doxygen xml output ?
If not, how can I correct my  output so that the TOC is correct ?