Re: [Boost-docs] Quickbook with Doxygen autodoc -How togetthe function (and enum) descriptions?

Subject: Re: [Boost-docs] Quickbook with Doxygen autodoc -How togetthe function (and enum) descriptions?
From: John Maddock (john_at_[hidden])
Date: 2009-03-10 11:19:31

>> You shouldn't see anything except functions in there (as the primary
> entries
>> that is), assuming this is refering to auto-index?
>>
>> If not do you have a "bad" example that slips through?
>
> Well if I look at the function index and look at author (since it's near 
> the
> top of the alphabet ;-)
>
> What I hoped to find was a link that took me directly to the function info
>
> 22.  void author(const std::string a) ;
>
> Set author for the document (default is copyright_holder).
>
> But what I get is several links to the primary author entry
>
> author
>
>    Description
>
>    Header < boost/svg_plot/svg.hpp >
>
>    Header < boost/svg_plot/svg_fwd.hpp >
>
>    Implementation & Rationale
>
>    svg public member functions
>
>    `svg` Copyright
>
> Of course the others are relevant to the main index - but not to the
> function index?

Maybe: I certainly agree it would be better to try and make it obvious which 
is the main link to the function definition, but it's not necessarily going 
to be easy to achieve - let me think on that.

> I did notice a minor wrinklette in the pdf - the function number (22 in 
> the
> example above) lies on the border of the box, neither in nor out.

I'll try and look into that - could be a SNAFU in the xslt params for FO 
generation, I don't think we've had numbered functions/paragraphs to deal 
with before,

Cheers, John.