JBIDE-15272 javadoc updates as per fred's request