Extensively updated comments to be used with doxygen and added doxygen html documentation