tiny correction to README
update some method comments
cosmetic changes to a couple specs