touched up javadocs