ref #35, unify/add doxygen speak and syntax