Add some more javadoc polishes, fix a README typo.