Improve documentation

This pull request doesn't change any active code but improves the existing Doxygen comments.