summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoralbert-github <albert.tests@gmail.com>2021-06-08 13:20:07 (GMT)
committeralbert-github <albert.tests@gmail.com>2021-06-08 13:20:07 (GMT)
commit0000628dae381c5ac156186baf3c2c07eda222e2 (patch)
tree55e0904385ded935572247c67e86aa9a8e7a78ce
parent8c8a0343662f69ce65ced20dc8c6025e7fc022cd (diff)
downloadDoxygen-0000628dae381c5ac156186baf3c2c07eda222e2.zip
Doxygen-0000628dae381c5ac156186baf3c2c07eda222e2.tar.gz
Doxygen-0000628dae381c5ac156186baf3c2c07eda222e2.tar.bz2
issue #8591 Doxygen comment suggestion in help collides with clang-format
Added a general warning about the `/****//**` type of comment
-rw-r--r--doc/docblocks.doc5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/docblocks.doc b/doc/docblocks.doc
index 92bf3df..8ccb08c 100644
--- a/doc/docblocks.doc
+++ b/doc/docblocks.doc
@@ -113,7 +113,10 @@ documentation. For this purpose you can use the following:
* ... text
***********************************************/
\endverbatim
-(note the 2 slashes to end the normal comment block and start a special comment block).
+Note: the 2 slashes to end the normal comment block and start a special comment block.
+
+Note: be careful when using a reformatter as a reformatter can see this type of comment
+as 2 separate comments resulting in non expected comment formatting.
or