From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 27 Oct 2018 11:08:40 +0000 (+0300)
Subject: * lisp/simple.el (region-extract-function): Doc fix.  (Bug#33167)
X-Git-Tag: emacs-26.1.90~51
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=df64da8;p=emacs.git

* lisp/simple.el (region-extract-function): Doc fix.  (Bug#33167)
---

diff --git a/lisp/simple.el b/lisp/simple.el
index 0e5dadc81f5..29bb9cbcfb9 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -1011,13 +1011,16 @@ instead of deleted."
         (filter-buffer-substring (region-beginning) (region-end) method)))))
   "Function to get the region's content.
 Called with one argument METHOD which can be:
-- nil: return the content as a string.
+- nil: return the content as a string (list of strings for
+  non-contiguous regions).
 - `delete-only': delete the region; the return value is undefined.
-- `bounds': return the boundaries of the region as a list of cons
-  cells of the form (START . END).
+- `bounds': return the boundaries of the region as a list of one
+  or more cons cells of the form (START . END).
 - anything else: delete the region and return its content
-  as a string, after filtering it with `filter-buffer-substring', which
-  is called with METHOD as its 3rd argument.")
+  as a string (or list of strings for non-contiguous regions),
+  after filtering it with `filter-buffer-substring', which
+  is called, for each contiguous sub-region, with METHOD as its
+  3rd argument.")
 
 (defvar region-insert-function
   (lambda (lines)