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

[Robert Pluim]

>>>>> On Tue, 29 Sep 2020 05:37:18 +0300, Eli Zaretskii <eliz@gnu.org> said:

    >> 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}.

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

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

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

Thatʼs the 'imperative' version of what I originally proposed. I like
it.

Robert
--