revised javadocs