Re: [Boost-docs] Doxygen features

Subject: Re: [Boost-docs] Doxygen features
From: Bo Jensen (jensen.bo_at_[hidden])
Date: 2010-06-01 08:29:36

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.