Update documentation around Vim integration

Clarify documentation, fix some typos and ensure all options are clearly
specified.  Previously, the normal mapping options weren't specified in
README.txt.
Merge pull request #106 from davidjb/master

Update documentation around Vim integration