Clean up doc comments.
Doxygen updates. Added stuff to .gitignore (including doxygen and
expected future executables. Added Doxyfile to configure doxygen.
Change to Makefile to add documentation (which pushed me to clean
up the source and object file definitions). Updates to doc comments
in code to get documentation generated reasonably.