commenting being updated for entire project
for use with doxygen for html documentation generation