Cleanup README.rdoc

Fixes some typos, trailing whitespace, and the format of trailing comments in examples.