Re: [Boost-docs] Doxygen features

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:
>> AMDG
>>
>> 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
>> Boost-docs_at_[hidden]
>> http://lists.boost.org/mailman/listinfo.cgi/boost-docs
>>
>
> 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.
>