From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 25 Apr 2015 07:49:42 +0000 (+0300)
Subject: Improve doc string of 'insert-buffer-substring'
X-Git-Tag: emacs-25.0.90~2303
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=bac119a56eb286846ac5e7e046c31e7aa5844431;p=emacs.git

Improve doc string of 'insert-buffer-substring'

* src/editfns.c (Finsert_buffer_substring): Doc fix.  (Bug#20421)
---

diff --git a/src/editfns.c b/src/editfns.c
index 7d3e4620029..dead48c1a62 100644
--- a/src/editfns.c
+++ b/src/editfns.c
@@ -2728,7 +2728,15 @@ DEFUN ("insert-buffer-substring", Finsert_buffer_substring, Sinsert_buffer_subst
        doc: /* Insert before point a substring of the contents of BUFFER.
 BUFFER may be a buffer or a buffer name.
 Arguments START and END are character positions specifying the substring.
-They default to the values of (point-min) and (point-max) in BUFFER.  */)
+They default to the values of (point-min) and (point-max) in BUFFER.
+
+Point and before-insertion markers move forward to end up after the
+inserted text.
+Any other markers at the point of insertion remain before the text.
+
+If the current buffer is multibyte and BUFFER is unibyte, or vice
+versa, strings are converted from unibyte to multibyte or vice versa
+using `string-make-multibyte' or `string-make-unibyte', which see.  */)
   (Lisp_Object buffer, Lisp_Object start, Lisp_Object end)
 {
   register EMACS_INT b, e, temp;