JCR-2179 : Java API - Improve the javadoc