https://github.com/AaronBallman commented:

Because doxygen supports documenting macros 
(https://www.doxygen.nl/manual/commands.html#cmddef), I am worried how often 
this will cause us to associate comments incorrectly on the declaration.

I wonder if we should be a bit smarter and check for `#define` at the start of 
a line when we encounter a `#`. e.g.,
```
/*!
  \def DERP(x)
  Does a derpy thing with x
*/
#define DERP(x) (x)

void derp(void); // Does not get the doxygen comment
```
while
```
/// Does amazing things, like works in the presence of
/// #define doing stupid things.
void func(); // does get the doxygen comment
```

https://github.com/llvm/llvm-project/pull/88367
_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to