I don't disagree with what you want, but I think it's important that we document what is actually happening, not what should happen. If we can fix that RFE, I'm all for making these docstrings say that there should be a boolean.