From: Mattias Engdegård <mattiase@acm.org>
Date: Mon, 28 Sep 2020 10:04:10 +0000 (+0200)
Subject: ; * doc/lispref/searching.texi (Search and Replace): Rephrase
X-Git-Tag: emacs-28.0.90~5842
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f679bcbb39ae26adcfb7e62794fcc03595b7436d;p=emacs.git

; * doc/lispref/searching.texi (Search and Replace): Rephrase
---

diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index b4fec6d1fd6..592b876644c 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -2567,10 +2567,10 @@ of matching @var{regexp} against a substring of @var{string}.
 @end defun
 
 @defun string-replace fromstring tostring instring
-This function returns a string equal to @var{instring} where any
-occurrences of @var{fromstring} have been replaced with
-@var{tostring}.  It may return one of its arguments.
-Case is significant, and text properties are ignored.
+This function replaces all occurrences of @var{fromstring} with
+@var{tostring} in @var{instring} and returns the result.  It may
+return one of its arguments unchanged, a constant string or a new
+string.  Case is significant, and text properties are ignored.
 @end defun
 
   If you want to write a command along the lines of @code{query-replace},