Subject: Re: [Boost-docs] Doxygen features
From: Bo Jensen (jensen.bo_at_[hidden])
Date: 2010-06-03 08:20:40
Sorry for the delay, I have now submitted a ticket, could not find a
boost book subject, so I guess 'documentation' was the right place.
Please correct me if I am wrong.
On Tue, Jun 1, 2010 at 8:29 AM, Bo Jensen <jensen.bo_at_[hidden]> wrote:
> On Tue, Jun 1, 2010 at 1:34 AM, Steven Watanabe <watanabesj_at_[hidden]> wrote:
>> Daniel James wrote:
>>> I was assuming that 'type' couldn't be a function, only a function
>>> pointer. But of course, it's used in typedefs which can be functions.
>> type can be a function, since
>> void f(int());
>> is equivalent to
>> void f(int(*)());
>> and doxygen doesn't normalize the
>> function declarations.
>>> So... we'd need to skip over anything in angle or curly brackets and
>>> then distinguish between function pointers and normal functions.
>>> Tricky, when you consider (hopefully, these are all correct, I've
>>> never got the hang of member pointers):
>>> void(int*) => void f(int*)
>>> void(*)() => void(*f)()
>>> void(foo::*)() => void (foo::*f)()
>> We would also have to deal with cv qualifiers for member pointers.
>>> I guess changing boostbook is probably the best route.
>> I'm not sure that it has to be perfect. Doxygen
>> generates gibberish for some of the complicated
>> tests I tried, anyway.
>>> btw. I just noticed that my patch breaks function definitions. So
>>> don't use it, I'll write something better soon.
>> In Christ,
>> Steven Watanabe
>> Boost-docs mailing list
> Steven, Daniel, thanks for looking into this, much appreciated.
> Another feature request are groups i.e so you can add functions to
> different groups. I will file a ticket as suggested.
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC