Minor tweaks to the readme and some Javadoc cleanup.