Re: remove-overlays test [was: * lisp/hi-lock.el: More fixes for revert-buffer (bug#57534)]

[Eli Zaretskii]

> From: Juri Linkov <juri@linkov.net>
> Cc: emacs-devel@gnu.org
> Date: Fri, 28 Jun 2024 09:43:30 +0300
> 
> > just to mention this is causing a regression on my testbench:
> 
> Thanks for the heads-up.  The problem is that in 'remove-overlays'
> values are compared with 'eq', and there is no way to specify
> another test function.
> 
> This important detail is still missing in (info "(elisp) Managing Overlays")
> (this could be added now), whereas the docstring was updated recently via
> bug#13648.

Please in the future when you find some documentation flaw, fix that
right away.  Keeping our documentation in good shape is a shared
responsibility of all of us, and leaving this unfixed runs the risk of
missing the opportunities to fix it.