adding missing javadocs