Clean up doxygen comments to add some missing documentation and fix
doxygen warnings.

Change-Id: I9cf98f6261a7f4a94bfbc0d9080d507fac8ce9a9
Signed-off-by: Rob Adams <readams@readams.net>