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

[Robert Pluim]

>>>>> On Sun, 27 Sep 2020 08:45:22 -0400 (EDT), Mattias Engdegård 
>>>>> <mattiase@savannah.gnu.org> said:

    Mattias>  @defun string-replace fromstring tostring instring
    Mattias> -This function copies @var{instring} and replaces any occurrences 
of
    Mattias> -@var{fromstring} with @var{tostring}.
    Mattias> +This function returns a string equal to @var{instring} where any
    Mattias> +occurrences of @var{fromstring} have been replaced with
    Mattias> +@var{tostring}.  It may return one of its arguments.
    Mattias> +Case is significant, and text properties are ignored.
    Mattias>  @end defun

'equal'? Really? And itʼs kind of passive-voicey. How about:

This function replaces any occurences of @var{fromstring} with
@var{tostring} in @var{instring} and returns the result.


Robert
--