update spec links in header comments

to match versions referenced in README.md
document new "mutate in place" feature
typos
clearer test for new "mutate in place" feature
Merge pull request #8 from skivvies/docupdates

Docupdates