diff options
author | Dimitri van Heesch <doxygen@gmail.com> | 2021-05-25 17:38:02 (GMT) |
---|---|---|
committer | Dimitri van Heesch <doxygen@gmail.com> | 2021-05-25 17:38:02 (GMT) |
commit | 1c95f392c051d68dff8fed2cc2f3554c8ee75d57 (patch) | |
tree | 85b40f701094cd4f802710bd61e3d4c2f615c091 | |
parent | 1ed8e5b7d77aa2d75d5799cec072a6b47a5722e3 (diff) | |
parent | f790184fa765d633e2dec9e72635838a24e9a5d5 (diff) | |
download | Doxygen-1c95f392c051d68dff8fed2cc2f3554c8ee75d57.zip Doxygen-1c95f392c051d68dff8fed2cc2f3554c8ee75d57.tar.gz Doxygen-1c95f392c051d68dff8fed2cc2f3554c8ee75d57.tar.bz2 |
Merge branch 'feature/issue_8563' of https://github.com/albert-github/doxygen into albert-github-feature/issue_8563
-rw-r--r-- | doc/docblocks.doc | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/docblocks.doc b/doc/docblocks.doc index ac81bec..3137663 100644 --- a/doc/docblocks.doc +++ b/doc/docblocks.doc @@ -288,11 +288,16 @@ Here is an example of the use of these comment blocks: \warning These blocks can only be used to document \e members and \e parameters. They cannot be used to document files, classes, unions, structs, - groups, namespaces and enums themselves. Furthermore, the structural + groups, namespaces, defines and enums themselves. Furthermore, the structural commands mentioned in the next section (like <code>\\class</code>) are not allowed inside these comment blocks. +\warning Don't use this construct with a define as in that cases + (when \ref cfg_macro_expansion "MACRO_EXPANSION" is set to `YES`) + at places where the define is used the defines is replaced including the comment + and this comment is seen as documentation for the last documentable item seen. + \subsubsection docexamples Examples Here is an example of a documented piece of C++ code using the Qt style: |