So it seems that docstring has been there since August 2012, and the version on master *also* does not behave as you'd expect.

I'm going to edit the docstring to describe the function as it actually behaves.