final pass on javadocs.