updated source files.  Better javadocs