major entity cleanup
added some docstrings, restricted exceptions
more docstrings
Merge branch 'master' into entity-cleanup2
changes from review
Merge pull request #24 from nuodb/entity-cleanup2

Entity Cleanup: Part 2