DOC: clarify corr behaviour when using a callable
fixes #25726

- [x] closes #25726
- [ ] tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry
