Merge pull request #137 from PaulMcMillan/improve_whitespace_docs

Improve whitespace docs to reflect reality.