Various Javadoc improvements and corrections.
Merge pull request #311 from daveray/update-javadoc

Various Javadoc improvements and corrections.