JavaDoc improvements on RocksJava

Added some more documentation improvements and readability
improvements.
Minor adjustment to prevent two warnings
Merge pull request #344 from fyrz/java-doc-enhancements

JavaDoc improvements on RocksJava