Document *Messages* buffer changes.

* doc/emacs/buffers.texi: Update list-buffers "screeshop" to show Messages
as major-mode.

* doc/lispref/display.texi: Document `messages-buffer'.

2 files changed, 10 insertions, 1 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 64c3ec42ca6..be050b7141e 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,7 @@
 2013-12-20  Tassilo Horn  <tsdh@gnu.org>
 
+        * display.texi: Document `messages-buffer'.
+
         * os.texi: Document `initial-buffer-choice' changes.
 
 2013-12-20  Chong Yidong  <cyd@gnu.org>
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index c6eeaf9c6a8..ead436ab809 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -478,7 +478,14 @@ this macro this way:
   Almost all the messages displayed in the echo area are also recorded
 in the @file{*Messages*} buffer so that the user can refer back to
 them.  This includes all the messages that are output with
-@code{message}.
+@code{message}.  This buffer is read-only and has the major-mode
+@code{messages-buffer-mode}.  The best way to retrieve that buffer is
+the function @code{messages-buffer}.
+
+@defun messages-buffer
+Return the @file{*Messages*} buffer.
+If it does not exist, create and it switch it to @code{messages-buffer-mode}.
+@end defun
 
 @defopt message-log-max
 This variable specifies how many lines to keep in the @file{*Messages*}