Clarify 2 docstrings. Fix #268. Thanks Kodiologist