JavaDoc editing and additions

Please give the green light for this merge and I'll make it so. This is my last commit. I was going to continue working on the JavaDoc this evening and instead spent the whole night trying to determine why IDEA went belly up on me when I shut down this afternoon. I have rebuild the IDEA project files and gotten most everything compiling/running from within IDEA again but I'm still having trouble with JUnit.  Everything compiles, tests, and runs fine from a command line with ANT though.