update() for list-filter, docs and tests