then the docstring needs clarifying, since it never mention the `update` parameter?