SSLR-266 : slightly improve javadoc