* buffer.c (Fmake_overlay): Doc clarification.

Fixes: debbugs:15489

2 files changed, 5 insertions, 1 deletions

diff --git a/src/ChangeLog b/src/ChangeLog
index 51f7bf08e36..133da94bb97 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2014-02-08  Lars Ingebrigtsen  <larsi@gnus.org>
+
+        * buffer.c (Fmake_overlay): Doc clarification (bug#15489).
+
 2014-02-08  Juanma Barranquero  <lekktu@gmail.com>
 
         * keyboard.c (Frecursive_edit): Fix typo in docstring.
diff --git a/src/buffer.c b/src/buffer.c
index cbf7291e3c8..955c80eb44b 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -3830,7 +3830,7 @@ DEFUN ("overlayp", Foverlayp, Soverlayp, 1, 1, 0,
 }
 
 DEFUN ("make-overlay", Fmake_overlay, Smake_overlay, 2, 5, 0,
-       doc: /* Create a new overlay with range BEG to END in BUFFER.
+       doc: /* Create a new overlay with range BEG to END in BUFFER and return it.
 If omitted, BUFFER defaults to the current buffer.
 BEG and END may be integers or markers.
 The fourth arg FRONT-ADVANCE, if non-nil, makes the marker