[cmake-developers] Source code ///! comments

Sebastian Holtermann seblist at xwmw.org
Tue Mar 26 08:28:04 EDT 2019


Looking through the source code I found various comments
starting with "///!"

E.g.:
```
///! myFunction description
myFunction()
```

To my blame, I've use it as well.  But is this a valid meta notation?
If Doxygen is targeted, the comment should start with either "///" or
"//!".  When the comment starts with "///!", the exclamation mark ends 
up in the comment text. This looks very wrong in the few cases I've checked.

For reference
http://www.doxygen.nl/manual/docblocks.html

Any ideas?



More information about the cmake-developers mailing list