Re: [boost] [test] boost.test owner unresponsive to persistent problems for multiple years

Subject: Re: [boost] [test] boost.test owner unresponsive to persistent problems for multiple years
From: Raffi Enficiaud (raffi.enficiaud_at_[hidden])
Date: 2015-01-03 20:06:03

Gennadiy Rozental <rogeeff <at> gmail.com> writes:

> 
> Paul A. Bristow <pbristow <at> hetp.u-net.com> writes:
> 
> > Also are you confident that the various parameters in the doxyfile 
> > the same as
> > passed to Quickbook tools chain?
> 
> Raffi, can you comment on this?
> 
Hi,

My name is Raffi and I am working on boost.test with Gennadiy.

I enabled the options that show everything but the private and @internal
documentation. 
What I do is that I look at the intermediate XML generated by the doxygen
bjam target. If the documented entities are there, I suppose that the
doxygen configuration is correct. 

Some of the problems we encountered:
- @overload works for free functions but generates warnings in quickbook for
member functions
- grouping of member function using @name completly hides those in quickbook
(no warning)
- @section not shown 
- @param is sometimes not shown in the generated quickbook

Best,
Raffi