Nitpicking: I think it's better to write stuff like this up with doxygen in the header declaration.