Fixup documentation

* Remove Doxygen markup;
* Update OMSP specification link;
* Fix non-meaningful whitespace errors.

Signed-off-by: Olivier Mehani <olivier.mehani@nicta.com.au>