src/buffer.c (Fset_buffer): Document return value (bug#17015).

2 files changed, 8 insertions, 3 deletions

diff --git a/src/ChangeLog b/src/ChangeLog
index 0512b0d9b68..424416398e8 100644
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2014-03-15  Juanma Barranquero  <lekktu@gmail.com>
+
+        * buffer.c (Fset_buffer): Document return value (bug#17015).
+
 2014-03-14  Martin Rudalics  <rudalics@gmx.at>
 
         * w32term.c (x_set_window_size): When frame-resize-pixelwise is
diff --git a/src/buffer.c b/src/buffer.c
index 028ef76ff71..daafbcef0e4 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -2187,11 +2187,12 @@ set_buffer_temp (struct buffer *b)
 
 DEFUN ("set-buffer", Fset_buffer, Sset_buffer, 1, 1, 0,
        doc: /* Make buffer BUFFER-OR-NAME current for editing operations.
-BUFFER-OR-NAME may be a buffer or the name of an existing buffer.  See
-also `with-current-buffer' when you want to make a buffer current
+BUFFER-OR-NAME may be a buffer or the name of an existing buffer.
+See also `with-current-buffer' when you want to make a buffer current
 temporarily.  This function does not display the buffer, so its effect
 ends when the current command terminates.  Use `switch-to-buffer' or
-`pop-to-buffer' to switch buffers permanently.  */)
+`pop-to-buffer' to switch buffers permanently.
+The return value is the buffer made current.  */)
   (register Lisp_Object buffer_or_name)
 {
   register Lisp_Object buffer;