Fixes in javadoc comments and README.md