Doxygen

Basics

 * http://www.cisst.org/cisst/cis/doxygen-documentation.html
 * http://www.stack.nl/~dimitri/doxygen/commands.html

Formatting
Lists can appear anywhere in Doxygen. The documentation parser requires you to follow a strict syntax to make them appear correctly in the parsed HTML output:
 * http://drupal.org/node/1354

A hyphen is used to indicate the list bullet. The hyphen is aligned with (uses the same indentation level as) the paragraph before it, with no newline before or after the list. No newlines between list items in the same list. Each list item starts with the key, followed by a colon, followed by a space, followed by the key description. The key description starts with a capital letter and ends with a period. If the list has no keys, start each list item with a capital letter and end with a period. The keys should not be put in quotes unless they contain colons (which is unlikely). If a list element is optional or default, indicate (optional) or (default) after the colon and before the key description. If a list item exceeds 80 chars, it needs to wrap, and the following lines need to be aligned with the key (indented by 2 more spaces). For text after the list that needs to be in the same block, use the same alignment/indentation as the initial text. Again: within a Doxygen directive, or within a list, blank lines are NOT supported. Lists can appear within lists, and the same rules apply recursively.


 * http://www.mediamosa.org/trac/wiki/Doxygen%20formatting%20conventions