[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