Cleanup README.rdoc

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