Re 9341. Eliminate cppcheck warnings.
Re #9341. Fix doxygen warnings.
Re #9341. Fix typo to eliminate doxygen warnings.
Re #9341. Reinstate start point for doxygen exclusion zone.
Re #9341. Add missing parameter documentation.
Re #9341. Document new(er) parameter.
Re #9341. Correct type that led to warning from doxygen.
Re #9341. Clear doxygen warnings

Fake parameter documentation which isn't great but is consistent with what
else is there for this function.
Re #9341. Don't document parameter that doesn't exist.
Re #9341. Remove unused file.
Re #9341. Add missing documentation strings.
Re #9341. Fix doxygen warnings.
Re #9341. Fix doxygen warnings.
Re #9341. Do the doxygen documentation right this time.
Re #9341. Reinstate start point for doxygen exclusion zone.
Re #9341. Don't add the OpenMP flag on Windows.

It causes a warning in link.exe (that states it's not using the flag
because it doesn't know what it means).
Merge remote-tracking branch 'origin/bugfix/9341_doxygen_and_ccpcheck_warnings'