Clean up Java-API docs.

Fixed some awkward wording and subject/verb agreement while reading through the Java API documentation.