remaining javadocs