With this change, all doxygen comments are read from the headers, including
trailing comments (//!<) and comments that do not appear immediately before
the item they apply too (e.g. comments with \class).  Comment groups are not
not handled.