CodingStyle: New function headers with doxygen parameter documentation
Attached patch recommends those tags to new function headers, but does not make it mandatory. I've been adding them to some new functions, but have not felt like doing it for all of them when most of our really important functions are missing them in any case.
Would it be time to start adding doxygen @param and @return documentation to any new function headers (which are already mandatory) when we start 3.3 cycle? That's to be stated on CodingStyle.