JBEE-140 - additional JavaDoc updates