- minor javadoc fixes
- updated README.md