Fix many warnings from doxygen
There are still some warnings left:
- Some text in markdown files are incorrectly picked up as doxygen commands
- ArrayPortalTransform weirdly inherits from a specialized version of itself. It's technically correct C++ code, but gives doxygen fits.