Improve javadoc
Merge pull request #341 from lincolnthree/STATS_JAVADOC

Improve javadoc