JBIDE-14958 api enhancement and javadoc