Doxygen misinterpretes instantiation as member

Asked Nov 01 '19 at 15:28

Active Nov 01 '19 at 15:31

Viewed 59 times

I'm working on a documentation of a source code using Doxygen.

I found that Doxygen interpretes within the following code:

#include <QPoint>

namespace space {
   //! first common length
   const quint16 val1 = 10;
   //! second common length
   const quint16 val2 = 10;
   //! a point
   const QPoint myPoint(val1, val2);
}

myPoint as member method and warns:

header.h:30: warning: return type of member space::myPoint is not documented
header.h:30: warning: parameters of member space::myPoint are not (all) documented

But myPoint is a constant attribute not a method. I think this line really has the same syntax as a method declaration. So this misinterpretation is expectable.

Is there a way to force Doxygen to interprete this line as a specific type?

edited Nov 01 '19 at 15:31

asked Nov 01 '19 at 15:28

Alex44

3,597
7
39
56

2

Looks like someone was having a similar problem: https://stackoverflow.com/questions/54812028/doxygen-sees-global-variable-declarations-as-functions-in-c – Dan M. Nov 01 '19 at 15:34
Yes. Something you did better. I search a lot and found nothing and you found it instantly /o\ But the problem seems not to be solved... – Alex44 Nov 01 '19 at 15:37
1

You should report this as a bug and ask for a workaround there – Lightness Races in Orbit Nov 01 '19 at 15:49
1

I comment on https://github.com/doxygen/doxygen/issues/6846 – Alex44 Nov 01 '19 at 15:50
What happens if you use the Clang compiler with Doxygen? – Nicol Bolas Nov 01 '19 at 15:52
What do you mean by this? Does Doxygen use a compiler? – Alex44 Nov 01 '19 at 15:52
1

I set `CLANG_ASSISTED_PARSING = YES` but the warning stays the same. – Alex44 Nov 01 '19 at 15:59

Doxygen misinterpretes instantiation as member

0 Answers0