Move doc strings inside functions.
Add high level doctests for readability tests.

Also some minor tidy ups.
Merge pull request #10 from robyoung/master

Tidy up a little and add some tests