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

[Mattias Engdegård]

branch: master
commit 583cb264ad386a3767a05233f0e50b788bcf31ac
Author: Mattias Engdegård <mattiase@acm.org>
Commit: Mattias Engdegård <mattiase@acm.org>

    Improve accuracy in string-replace description (bug#43598)
    
    * doc/lispref/searching.texi (Search and Replace): More careful
    description; string-replace does not necessarily return a copy.
---
 doc/lispref/searching.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index 451283b..b4fec6d 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -2567,8 +2567,10 @@ of matching @var{regexp} against a substring of 
@var{string}.
 @end defun
 
 @defun string-replace fromstring tostring instring
-This function copies @var{instring} and replaces any occurrences of
-@var{fromstring} with @var{tostring}.
+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.
 @end defun
 
   If you want to write a command along the lines of @code{query-replace},