Yes, that's clearer. I have changed the docstring as you suggested.