Improve documentation of replace-buffer-contents

* etc/NEWS (replace-buffer-contents): Fix formatting.

* src/editfns.c (Freplace_buffer_contents): Doc fix.

1 files changed, 3 insertions, 1 deletions

diff --git a/src/editfns.c b/src/editfns.c
index e8ad83e29b8..f0c4593742d 100644
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -3140,7 +3140,9 @@ static bool buffer_chars_equal (struct context *, OFFSET, OFFSET);
 
 DEFUN ("replace-buffer-contents", Freplace_buffer_contents,
        Sreplace_buffer_contents, 1, 1, "bSource buffer: ",
-       doc: /* Replace accessible portion of the current buffer with accessible portion of SOURCE.
+       doc: /* Replace accessible portion of current buffer with that of SOURCE.
+SOURCE can be a buffer or a string that names a buffer.
+Interactively, prompt for SOURCE.
 As far as possible the replacement is non-destructive, i.e. existing
 buffer contents, markers, properties, and overlays in the current
 buffer stay intact.  */)