JCR-2150 : Java API - Improve the javadoc