more docstrings
more tests
trailing whitespace purge