DOC: Cleanup docstring pandas.core.filter
- [X] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

Made parameter description of the `pandas.core.filter` docstring clearer. PEP8 fix in example, see also comments in #20148.
