Changed all the formatting of comment blocks in .C files to be
compatible with Doxygen and to generally make them smaller and more
manageable.
Doxygen configuration file added to generate Docs subdirectory.