Clarified/cleanup javadocs.