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

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:
>
> Reference
>    Reference
>        Header <boost/variadic_macro_data/VariadicMacroData.hpp>
>
> instead of:
>
> Reference
>    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:

    doxygen target
        : headers.hpp
        : <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.

Daniel