summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2019-08-09 10:31:39 +0300
committerEli Zaretskii <eliz@gnu.org>2019-08-09 10:31:39 +0300
commit82a2894be479ea88ebe28e72a7709b94203b096c (patch)
treeb6302c5c68d3ce95f6ac21ee3caf69471d76452d
parentcb0403d7467502a1a9ef2699ccce826aac2ace7a (diff)
downloademacs-82a2894be479ea88ebe28e72a7709b94203b096c.tar.gz
Improve doc strings of 'append-to-buffer' and friends
* lisp/simple.el (append-to-buffer, prepend-to-buffer) (copy-to-buffer): Doc fixes.
-rw-r--r--lisp/simple.el18
1 files changed, 12 insertions, 6 deletions
diff --git a/lisp/simple.el b/lisp/simple.el
index b10c7861d13..b5c7052184b 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -5268,8 +5268,10 @@ BUFFER may be a buffer or a buffer name."
nil)
(defun append-to-buffer (buffer start end)
- "Append to specified buffer the text of the region.
-It is inserted into that buffer before its point.
+ "Append to specified BUFFER the text of the region.
+The text is inserted into that buffer before its point.
+BUFFER can be a buffer or the name of a buffer; this
+function will create BUFFER if it doesn't already exist.
When calling from a program, give three arguments:
BUFFER (or buffer name), START and END.
@@ -5291,8 +5293,10 @@ START and END specify the portion of the current buffer to be copied."
(set-window-point window (point))))))))
(defun prepend-to-buffer (buffer start end)
- "Prepend to specified buffer the text of the region.
-It is inserted into that buffer after its point.
+ "Prepend to specified BUFFER the text of the region.
+The text is inserted into that buffer after its point.
+BUFFER can be a buffer or the name of a buffer; this
+function will create BUFFER if it doesn't already exist.
When calling from a program, give three arguments:
BUFFER (or buffer name), START and END.
@@ -5305,8 +5309,10 @@ START and END specify the portion of the current buffer to be copied."
(insert-buffer-substring oldbuf start end)))))
(defun copy-to-buffer (buffer start end)
- "Copy to specified buffer the text of the region.
-It is inserted into that buffer, replacing existing text there.
+ "Copy to specified BUFFER the text of the region.
+The text is inserted into that buffer, replacing existing text there.
+BUFFER can be a buffer or the name of a buffer; this
+function will create BUFFER if it doesn't already exist.
When calling from a program, give three arguments:
BUFFER (or buffer name), START and END.