From 82a2894be479ea88ebe28e72a7709b94203b096c Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 9 Aug 2019 10:31:39 +0300 Subject: [PATCH] Improve doc strings of 'append-to-buffer' and friends * lisp/simple.el (append-to-buffer, prepend-to-buffer) (copy-to-buffer): Doc fixes. --- lisp/simple.el | 18 ++++++++++++------ 1 file 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. -- 2.39.2