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