JAVACLIENT-5 improving javadoc comments