Subject: Re: [Boost-docs] Building doc with doxygen and quickbook problem
From: Daniel James (dnljms_at_[hidden])
Date: 2010-10-07 14:51:25
On 7 October 2010 14:10, Edward Diener <eldiener_at_[hidden]> wrote:
> 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:
> Header <boost/variadic_macro_data/VariadicMacroData.hpp>
> instead of:
> Variadic Macro Data Reference
You've probably put your 'xinclude' quickbook tag inside a quickbook
section. You don't need to do that, the reference documentation
defines a section itself.
> 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>.
Both of these are because it uses the '<reftitle>' feature in its
build file. I think you can use something like:
: <reftitle>"My reference"
The id is automatically generated from the title. You can override it
by using the 'boost.doxygen.refid' xsl parameter - although it looks
like that only works if you've set a title. Probably wouldn't be too
hard to change that.
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC