complete first pass through the doc strings
pep8 fix