Update the README.

Bring in line with the current behavior, reorganize a bit, and add some content.
Merge pull request #86 from sellout/minor-fixes

Update the README.