Improving javadocs so they are more for public consumption.