Some class documentation

add and consolidate existing class comments for doxygen. Actual doxygen generation not tested