I know that it is consistent with rest of code, but is there reason why not use doxygen code documentation syntax? parameters and also throwing is handled in consistent way - http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html#cppblock and also generated documentation is much better