Given the significant change to the docstring, have you built the docs and taken a look at the resulting html?