Re: [Boost-docs] Doxygen features

Subject: Re: [Boost-docs] Doxygen features
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2010-05-31 19:00:07

AMDG

Daniel James wrote:
>> I like to use array notation for arrays i.e "int somearray[]", but
>> this gets ignored and displayed like "int somearray" in the parameters
>> section, eventhough doxygen seem to correctly has parsed my source :
>>     
>
> The problem here is that boostbook's markup doesn't support type
> information after the variable. The best I could quickly manage is
> that attached patch, which outputs the incorrect, but hopefully clear,
> 'int[] somearray'.
>
> To do better, I think we'll need to change boostbook. One possibility
> is to automatically work out where the name goes in the xsl. Of the
> top of my head, this will only be needed for arrays and function
> pointers, so it might be possible to just put the variable name before
> the first '[' or ')'. Does anyone know if there are any cases where
> that could go wrong?
>   

void f(int (&(*g)())[10]);

In Christ,
Steven Watanabe