Hello, just to announce that I committed source documentation changes to several dozen files. People are likely to recompile a lot but you know such things happen after new releases :]
There are two doxygen config files in the distribution: src/inkscape.doxygen (used for the web pages) and src/Doxygen. The latter is specific for some files in order to be able to quickly check correctness or missing documentation.
My goal for the next release is to have one-liners for all classes and functions in the source files referred to by src/Doxygen.
In this regard, I will introduce \note, \todo, and \bug tags in comments, and I would ask people to use them for their own documentation, too. \todo's for example will be collected in a todo file by doxygen. \bug's should be moved into the tracker, eventually, probably.
Finally, I noticed people use 'e.g.' and 'i.e.' incorrectly: you should not forget to always place a comma after them, i.e., e.g., like this. Reason: doxygen thinks the sentence ended there.
ralf