Sort out the doxygen formatting

Created by: mattclarke

Once https://jira.esss.lu.se/projects/DM/issues/DM-1009 has been done, sort out the existing doxygen comments to match.

Currently it is a mishmash of several slightly different styles. "Tidy doxygen, tidy code" as Alan Turing didn't say.