added some doxygen markup to public headers