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'.

5 files changed, 15 insertions, 2 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index f2be12e2002..4b2beb17d45 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,5 +1,8 @@
 2013-12-20  Tassilo Horn  <tsdh@gnu.org>
 
+        * buffers.texi: Update list-buffers "screeshop" to show Messages
+        as major-mode.
+
         * entering.texi: Document `initial-buffer-choice' changes.
 
         * misc.texi (arguments): Document `initial-buffer-choice' changes.
diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index a62f2bdac8d..9e5f996aae0 100644
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -194,7 +194,7 @@ CRM Buffer                Size  Mode              File
  %  HELLO                 1607  Fundamental       ~/cvs/emacs/etc/HELLO
  %  NEWS                481184  Outline           ~/cvs/emacs/etc/NEWS
     *scratch*              191  Lisp Interaction
-  * *Messages*            1554  Fundamental
+  * *Messages*            1554  Messages
 @end smallexample
 
 @noindent
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*}
diff --git a/etc/NEWS b/etc/NEWS
index dca067640d0..34392ee81af 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -139,6 +139,7 @@ simply disabling Transient Mark mode does the same thing.
 ** `initial-buffer-choice' can now specify a function to set up the
 initial buffer.
 
++++
 ** The *Messages* buffer is created in a new major mode `messages-buffer-mode',
 and read-only.  Code that might create the *Messages* buffer should
 call the function `messages-buffer' to do so and set the mode.