HHH-2736 updated javadoc