[Emacs-diffs] emacs-26 5de608f: Update the documentation of 'perform-replace'

[Eli Zaretskii]

branch: emacs-26
commit 5de608f3edb54b4f8d9774e159d0fa99484d3ac8
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Update the documentation of 'perform-replace'
    
    * doc/lispref/searching.texi (Search and Replace): Update the
    documentation of 'perform-replace'.
---
 doc/lispref/searching.texi | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index e759967..fca8771 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -1751,13 +1751,14 @@ of matching @var{regexp} against a substring of 
@var{string}.
   If you want to write a command along the lines of @code{query-replace},
 you can use @code{perform-replace} to do the work.
 
address@hidden perform-replace from-string replacements query-flag regexp-flag 
delimited-flag &optional repeat-count map start end
address@hidden perform-replace from-string replacements query-flag regexp-flag 
delimited-flag &optional repeat-count map start end backward 
region-noncontiguous-p
 This function is the guts of @code{query-replace} and related
 commands.  It searches for occurrences of @var{from-string} in the
 text between positions @var{start} and @var{end} and replaces some or
 all of them.  If @var{start} is @code{nil} (or omitted), point is used
 instead, and the end of the buffer's accessible portion is used for
address@hidden
address@hidden  (If the optional argument @var{backward} is
address@hidden, the search starts at @var{end} and goes backward.)
 
 If @var{query-flag} is @code{nil}, it replaces all
 occurrences; otherwise, it asks the user what to do about each one.
@@ -1789,6 +1790,11 @@ user responses for queries.  The argument @var{map}, if
 address@hidden, specifies a keymap to use instead of
 @code{query-replace-map}.
 
address@hidden @var{region-noncontiguous-p} means that the region
+between @var{start} and @var{end} is composed of noncontiguous pieces.
+The most common example of this is a rectangular region, where the
+pieces are separated by newline characters.
+
 This function uses one of two functions to search for the next
 occurrence of @var{from-string}.  These functions are specified by the
 values of two variables: @code{replace-re-search-function} and