Confiure the scanner to collect Doxygen comments.

Otherwise, the tests will fail.
Added some comments describing the purpose of this class.
Map the return tag in a description to a function to the corresponding declarator specifier.