Fix RST code-block rendering for (read) examples

Also removed trailing whitespace and added a blank line to separate the discrete examples
Add more complex example of (read) usage
Merge pull request #636 from tianon/read-docs

Fix RST code-block rendering for (read) examples and add more complex example of (read) usage