Please review the docstring of this function as it is not up to date.