Clarify and doxygen-ify comments