add missing javadocs