Improvements to the formatting and language within the javadocs.