diff options
author | Dimitri van Heesch <dimitri@stack.nl> | 2008-07-27 14:59:10 (GMT) |
---|---|---|
committer | Dimitri van Heesch <dimitri@stack.nl> | 2008-07-27 14:59:10 (GMT) |
commit | 6bf92c5d7efffb6a04c3ccbfc144ad944200fed2 (patch) | |
tree | 201e94696e0c1cb55ffa8fd45c97dfa1ac586f0f /doc/docblocks.doc | |
parent | 956cf8647cb54a930d1d9c65fb01cc4d9498f2bd (diff) | |
download | Doxygen-6bf92c5d7efffb6a04c3ccbfc144ad944200fed2.zip Doxygen-6bf92c5d7efffb6a04c3ccbfc144ad944200fed2.tar.gz Doxygen-6bf92c5d7efffb6a04c3ccbfc144ad944200fed2.tar.bz2 |
Release-1.5.6-20080727
Diffstat (limited to 'doc/docblocks.doc')
-rw-r--r-- | doc/docblocks.doc | 16 |
1 files changed, 6 insertions, 10 deletions
diff --git a/doc/docblocks.doc b/doc/docblocks.doc index 5ebdf7b..0e9f38e 100644 --- a/doc/docblocks.doc +++ b/doc/docblocks.doc @@ -166,23 +166,19 @@ for this case. </ol> -As you can see doxygen is quite flexible. The following however is -not legal +As you can see doxygen is quite flexible. If you have multiple +detailed descriptions, like in the following example: \verbatim //! Brief description, which is //! really a detailed description since it spans multiple lines. -/*! Oops, another detailed description! +/*! Another detailed description! */ \endverbatim -because doxygen only allows one brief and one detailed description. - -Furthermore, if there is one brief description before a declaration -and one before a definition of a code item, only the one before -the \e declaration will be used. If the same situation occurs for a -detailed description, the one before the \e definition is preferred -and the one before the declaration will be ignored. +They will be joined. Note that this is also the case if the descriptions +are at different places in the code! In this case the order will depend +on the order in which doxygen parses the code. Here is an example of a documented piece of C++ code using the Qt style: \include qtstyle.cpp |