GEOT-4477 - added javadocs