Re: master 583cb26 2/3: Improve accuracy in string-replace description (bug#43598)

[Eli Zaretskii]

> From: John Yates <john@yates-sheets.org>
> Date: Mon, 28 Sep 2020 18:36:24 -0400
> Cc: Drew Adams <drew.adams@oracle.com>, Robert Pluim <rpluim@gmail.com>, 
>       Mattias Engdegård <mattiase@acm.org>, 
>       Emacs developers <emacs-devel@gnu.org>
> 
> On Mon, Sep 28, 2020 at 2:12 PM Eli Zaretskii <eliz@gnu.org> wrote:
> >
> > > What do you find extremely confusing about it?
> >
> > The "equal" part.
> 
> Return a string equivalent to @var{instring} with every occurence
> of @var{fromstring} replaced by @var{tostring}.

Thanks, this is better.  But "equivalent" is too vague to be useful.

What's wrong with the below?  That's the natural way I'd say that.

  Replace every occurrence of FROMSTRING with TOSTRING in INSTRING,
  and return the result.