Added meaningful exception types. Cleaned imports and exports. Tweaked
linesep code into working. Muted a pylint warning.
aligning some naming conventions for test sample data.
regenerated overview from README.md
doc formatting fixes
doc formatting fixes