Fixed typos, added clarifications.
oops, forgot `end`
Update references
Merge pull request #128 from zaa/patch-2

Fixed typos, added clarifications, updated references