The most frequent use cases for this are when you want to document enumeration values and member variables. In some cases it makes sense to place the documentation comment behind its element. / This is the brief description for a class In this case you do not have to explicitly specify what you want to document - Doxygen is clever enough to find out by itself the type and name of the element that the comment belongs to. Usually a comment block is placed just before the element it documents. Where to place documentation Documentation before the element (default) When enabled Doxygen pre-processes all comments according to the Markdown format, which allows for more readable documentation. Unless you explicitly disable this in the Doxygen configuration file (the controlling tag is `MARKDOWN_SUPPORT`), you can mix Doxygen formatting with Markdown formatting.
Using "\" just looks unnatural to me, whereas is much more agreeable to my eyes. the Unix shell, regular expressions, C/C++). My dislike for this is mostly based on "\" being the escape character in a lot of technologies that I am used to (e.g. The other command markup style uses the "\" (backslash) character as the command prefix. There are several styles how a command can be marked up, but my personal favourite is the JavaDoc style where commands are prefixed with an (at) character. How the generated documentation should look like.The 2 lines should be simple comments using 2 slashes ("//") to prevent Doxygen from parsing them. To visually separate comment blocks from the surrounding code, I like to add a starting and an end line to the comment block.
DOXYGEN REF CODE
This technique won't work if the source code that I want to disable contains Doxygen comment blocks marked up with /* */. I don't like that because it interferes with one of my frequently used coding techniques where I quickly disable large parts of source code by surrounding the code with /* */. The other comment block markup styles build on the C-style multi-line comment /* */. / previous empty line begins a new block Several consecutive lines that all start with "///" together form a comment block: There are several markup styles, but my personal favourite is to begin each line with 3 slashes ("///"). files), these are presented later in this document.ĭoxygen only processes comment blocks that are specially marked up.
9.1 9.2 9.3 10 Doxyfile configurationĬ++ language elements that can be documented.8.3 Variables, typedefs, enumerations, preprocessor macros, namespaces.4.5 Special case 5 The most important commands.4.4 Documentation separated from element.4.3 Documentation at the place of definition instead of declaration.4.1 Documentation before the element (default).3.2 Visual separation of comment blocks.2 C++ language elements that can be documented.
0 kommentar(er)
