1 files changed, 3 insertions, 1 deletions

diff --git a/src/buffer.c b/src/buffer.c
index fd2de4a2408..1564674d86d 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -209,7 +209,9 @@ Value is nil if OBJECT is not a buffer or if it has been killed.  */)
 
 DEFUN ("buffer-list", Fbuffer_list, Sbuffer_list, 0, 1, 0,
        doc: /* Return a list of all existing live buffers.
-If the optional arg FRAME is a frame, we return that frame's buffer list.  */)
+If the optional arg FRAME is a frame, we return the buffer list
+in the proper order for that frame: the buffers in FRAME's `buffer-list'
+frame parameter come first, followed by the rest of the buffers.  */)
      (frame)
      Lisp_Object frame;
 {