ROSE  0.9.6a
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Doxygen Bugs

Since I have found several bugs in doxygen and we want to use it to document Rose I thought I would write down a few of them and provide a location where we could keep each other informed about them as we work.

  1. internal command does not work on blocks that define groups, it does seem to work elsewhere.
  2. The -# command does not work in paragraphs associated with the todo command.
  3. \section commands can't appear in \defgroup blocks (causes a seg fault in doxygen processing).
  4. Can't document an enum outside of the location in the file where it appears.
  5. When refering to a function name in text autolink can't understand "(", ")", and ";"; and does not build the link.
  6. Nested classes are not represented in the generated documentation
  7. Grouping of nested classes seems to have no effect.