ENGINE-1766: update javadoc