Slightly pedantic, but should these be doxygen-style comments, as they describe how to use the class?