Added README.
Some name changes, some better comments, and at least one fix to exception-handling.