Rationalize docstring.

Incorporate feedback from @dhermes.