Eli Zaretskii <eliz@gnu.org> writes:

> Document: yes.  But your change modified the code as well, and more
> importantly changed how the feature works.

This is what I suggest for emacs-28, note the "Do not merge to master"
in the commit message.

On master, I suggest the same patch as before, but with the updated
text that you can read here.