On 18.08.2016 08:37, Fabian Cenedese wrote:
> At 08:41 10.08.2016, you wrote:
>> Hello World,
>>
>> I am documenting a couple of IDL files. Now I've noticed that all
>> the structs are listed twice in the classes list (see the attached
>> small screenshot), once with and once without a documentation (both
>> links point to the same documentation page). How do I avoid the
>> undocumented structs entries (because they are documented ones)
>> WITHOUT setting the HIDE_UNDOC_CLASSES option? (I want
>> HIDE_UNDOC_CLASSES to be set to NO so undocumented classes lead to
>> a warning.)
>
> I also reported a similar problem already in 2014 but didn't get a
> response.
>
> http://doxygen.10944.n7.nabble.com/Double-entries-of-C-variable-td6951.html
I have found a workaround for my problem and I think that problem is a
bug in Doxygen. I had my structs documented as follows:
/** \struct MyStruct
* \brief Brief description
*
* Longer description
*/
<struct begins here>
This led to the double entry. Removing the first line, e.g. the struct
entry fixed the problem:
/** \brief Brief description
*
* Longer description
*/
<struct begins here>
As I understand Doxygen, however, I think the first variant should be
valid as well and thus I think it is a bug in Doxygen.
Best regards
Andreas
--
("`-''-/").___..--''"`-._
`o_ o ) `-. ( ).`-.__.`)
(_Y_.)' ._ ) `._ `. ``-..-'
_..`--'_..-_/ /--'_.' .'
(il).-'' (li).' ((!.-'
Andreas Tscharner an...@vi... ICQ-No. 14356454
|