readme completed; doctest
whitespace cleanup