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

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index f2be12e2002084839c46cfa17a2849bf2b5cf681..4b2beb17d455e75d0426d8587f4fcf07bc629961 100644 (file)
--- 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 a62f2bdac8d63ee5571695877fd9629920475d19..9e5f996aae0c7d4565f1f35db7ee8fd9d533d85c 100644 (file)
--- 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 64c3ec42ca6bbc6f5ee9c8a0b8768d45303389da..be050b7141ed967b08686ce83c022479b0215bff 100644 (file)
--- 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 c6eeaf9c6a8f19e82ff00b32c56e2c60f737258b..ead436ab809952051773219bd1bc1c01173efe54 100644 (file)
--- 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 dca067640d0f7c97493f0f39b3303480a10dbafb..34392ee81af9c7dd05264aa4e4cdaad17c83b872 100644 (file)
--- 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.