DOC: fix up docstring for new semantics