bug#31584: 27.0.50; Document again what match re-search-backward finds

[Michael Heerdegen <michael_heerdegen@web.de>]

Noam Postavsky <npostavs@gmail.com> writes:

> Actually, the manual has a pretty good explanation, maybe we can just
> link to it:

> -See `re-search-forward' for details.  */)
> +Note that searching backwards may give a shorter match than expected,
> +because the matching still happens in the forward direction.  See Info
> +anchor `(elisp) re-search-backward' for details.  */)
>    (Lisp_Object regexp, Lisp_Object bound, Lisp_Object noerror, Lisp_Object count)
>  {
>    return search_command (regexp, bound, noerror, count, -1, 1, 0);

Too bad that the anchor is located after the relevant description.

FWIW; I still prefer the original sentence, I find it describes the
behavior best, and short (which is good for a docstring).  It is also
good to have an alternative and more verbose explanation in the manual.


Michael.