From: Glenn Morris Date: Tue, 7 Jan 2014 02:56:17 +0000 (-0500) Subject: * doc/lispref/display.texi (Logging Messages): Copyedits re messages-buffer. X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~41 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=809d2ce4cfadf189ca134fd59e31016ef32043bc;p=emacs.git * doc/lispref/display.texi (Logging Messages): Copyedits re messages-buffer. --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 39ed20c3f88..fc2580385f4 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,7 @@ +2014-01-07 Glenn Morris + + * display.texi (Logging Messages): Copyedits re messages-buffer. + 2014-01-06 Paul Eggert Specify .texi encoding (Bug#16292). diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index be8db83396c..8236742ae2c 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -478,13 +478,15 @@ 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}. 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}. +@code{message}. By default, this buffer is read-only and uses the major +mode @code{messages-buffer-mode}. Nothing prevents the user from +killing the @file{*Messages*} buffer, but the next display of a message +recreates it. Any Lisp code that needs to ensure the @file{*Messages*} +buffer exists should use 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}. +This function returns the @file{*Messages*} buffer. If it does not +exist, it creates it, and switches it to @code{messages-buffer-mode}. @end defun @defopt message-log-max