Documentation improvement

I've been working my way through the docs in alphabetical order, making formatting improvements, correcting typos, and making grammatical improvements as well. For formatting I adjusted them to the from one-long-line-of-text to nicely formatted text which fits in a normal terminal (or vim) window.  There are no code changes in any examples, as this is just a pull request for grammatical and linguistic improvements of the docs. 

The number of additions/deletions in this request look large but are mostly line formatting changes. If well received I'll continue through the rest of them in order as well.

Also, I did a master-merge prior to comitting my local repo, so as a few minutes ago it should be in sync.

Cheers,
Bill