code cleanup: #21

getting comments for function headers cleaned up for doxygen.