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

doc/emacs/ChangeLog

 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.

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

doc/lispref/ChangeLog

 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>

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*}

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.