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
Merge pull request #1 from nltk/master

latest from upstream