From 6f1de4d1f115228b4fa7f0f3d3d17e2dbf4291c7 Mon Sep 17 00:00:00 2001 From: Tassilo Horn Date: Fri, 20 Dec 2013 15:28:01 +0100 Subject: [PATCH] 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 | 3 +++ doc/emacs/buffers.texi | 2 +- doc/lispref/ChangeLog | 2 ++ doc/lispref/display.texi | 9 ++++++++- etc/NEWS | 1 + 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 + * 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 + * display.texi: Document `messages-buffer'. + * os.texi: Document `initial-buffer-choice' changes. 2013-12-20 Chong Yidong 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. -- 2.39.2