CLDIDE-1853: javadocs fixes