While you're at it, could you move nice comments like this (which are already written in doxygen-style) to the corresponding declarations?