[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] master 19a41ce: Improve documentation of 'region-extract-f
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] master 19a41ce: Improve documentation of 'region-extract-function' |
Date: |
Sat, 5 Aug 2017 04:04:26 -0400 (EDT) |
branch: master
commit 19a41ce2dea79b4e5fb8baf1060b615bc03af63b
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Improve documentation of 'region-extract-function'
* lisp/simple.el (region-extract-function): Rename the argument to
METHOD. Doc fix. (Bug#27927)
---
lisp/simple.el | 23 ++++++++++++-----------
1 file changed, 12 insertions(+), 11 deletions(-)
diff --git a/lisp/simple.el b/lisp/simple.el
index 3d23fc3..e3d86ab 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -996,23 +996,24 @@ instead of deleted."
:version "24.1")
(defvar region-extract-function
- (lambda (delete)
+ (lambda (method)
(when (region-beginning)
(cond
- ((eq delete 'bounds)
+ ((eq method 'bounds)
(list (cons (region-beginning) (region-end))))
- ((eq delete 'delete-only)
+ ((eq method 'delete-only)
(delete-region (region-beginning) (region-end)))
(t
- (filter-buffer-substring (region-beginning) (region-end) delete)))))
+ (filter-buffer-substring (region-beginning) (region-end) method)))))
"Function to get the region's content.
-Called with one argument DELETE.
-If DELETE is `delete-only', then only delete the region and the return value
-is undefined. If DELETE is nil, just return the content as a string.
-If DELETE is `bounds', then don't delete, but just return the
-boundaries of the region as a list of (START . END) positions.
-If anything else, delete the region and return its content as a string,
-after filtering it with `filter-buffer-substring'.")
+Called with one argument METHOD.
+If METHOD is `delete-only', then delete the region; the return value
+is undefined. If METHOD is nil, then return the content as a string.
+If METHOD is `bounds', then return the boundaries of the region
+as a list of the form (START . END).
+If METHOD is 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.")
(defvar region-insert-function
(lambda (lines)
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] master 19a41ce: Improve documentation of 'region-extract-function',
Eli Zaretskii <=