Re: [Boost-docs] [quickbook] Reference documentatation problem in TOC

Subject: Re: [Boost-docs] [quickbook] Reference documentatation problem in TOC
From: Edward Diener (eldiener_at_[hidden])
Date: 2010-10-04 13:12:21

On 10/4/2010 4:18 AM, John Maddock wrote:
>> My reference documentation itself is being output from my doxygen
>> comments correctly. However in the TOC I am seeing:
>> Reference
>> Reference
>> Header <boost/variadic_macro_data/VariadicMacroData.hpp>
>> Those two references, each with their link, are redundant. The first
>> one links to a page which says:
>> Reference
>> Header <boost/variadic_macro_data/VariadicMacroData.hpp>
>> and the second one links to a page which says:
>> Header <boost/variadic_macro_data/VariadicMacroData.hpp>
>> In my quickbook file I have:
>> [section:vmd_reference Reference]
>> [xinclude VariadicMacroDataReference.xml]
>> [endsect]
>> where VariadicMacroDataReference.xml is what is being generated by the
>> the 'doxygen VariadicMacroDataReference' in my jamfile.
>> How do I get rid of the extra Reference in the TOC ?
> No idea, but I assume that VariadicMacroDataReference.xml has a
> "reference" section at the top level? If so you may need to either tweek
> the Doxygen settings (never used that, so I can't help), or get rid of
> the Reference section in your quickbook.

If I get rid of the reference section in my quickbook, how does
quickbook know to add a reference and where it is among my sections ?
Currently my quickbook reference section is just:

[section:vmd_reference Reference]
[xinclude VariadicMacroDataReference.xml]

and VariadicMacroDataReference.xml is:

<?xml version="1.0" standalone="yes"?>
<header name="boost/variadic_macro_data/VariadicMacroData.hpp">
... lots of xml for my header data

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC