[Emacs-diffs] trunk r115898: * doc/lispref/display.texi (Logging Messages): Copyedits re messages-buffer.

[Glenn Morris]

------------------------------------------------------------
revno: 115898
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Mon 2014-01-06 21:56:17 -0500
message:
  * doc/lispref/display.texi (Logging Messages): Copyedits re messages-buffer.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/display.texi       
display.texi-20091113204419-o5vbwnq5f7feedwu-6172

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-01-06 05:25:46 +0000
+++ b/doc/lispref/ChangeLog     2014-01-07 02:56:17 +0000
@@ -1,3 +1,7 @@
+2014-01-07  Glenn Morris  <address@hidden>
+
+       * display.texi (Logging Messages): Copyedits re messages-buffer.
+
 2014-01-06  Paul Eggert  <address@hidden>
 
        Specify .texi encoding (Bug#16292).

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2014-01-01 23:13:59 +0000
+++ b/doc/lispref/display.texi  2014-01-07 02:56:17 +0000
@@ -478,13 +478,15 @@
   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
address@hidden  This buffer is read-only and has the major-mode
address@hidden  The best way to retrieve that buffer is
-the function @code{messages-buffer}.
address@hidden  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