SSLR-282 Improve Javadocs for Grammar API