DOC: improvements.
DOC: shorter description.
DOC: shorter description.
DOC, TEST _debug, MINOR better i/o sanitization.
PEP8: fix trailing whitespace.