JCR-2150 :Improve javadoc