Comments formatted for javadoc:

Formatted comments so that javadoc can use them.
Added Makefile rule to generate documentation, and mentioned it in README.
First example added:

Added example program to populate project with Makefile
for all the subdirectories,
and corresponding Makefile rules and documentation.