[DOC] Improvements to API dox.
Merge pull request #502 from holtgrewe/dox-fixes

[DOC] Improvements to API dox.