partial javadoc