this docstring isn't consistent with the function behavior.