Bad docs are bad.

They need revising really..   I'm only making assumptions here
Merge pull request #2 from JohnMcLear/patch-2

Bad docs are bad.