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.