Fill out javadocs to be more useful from baselines

[hazendaz]

Most javadocs are filled out but not all. The ones not filled out don't say really what the method does. Fill those in when we have some time.