[Emacs-diffs] /srv/bzr/emacs/trunk r104981: * lisp/window.el (pop-to-buffer): Doc fix.

[Glenn Morris]

------------------------------------------------------------
revno: 104981
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Tue 2011-07-05 19:46:22 -0700
message:
  * lisp/window.el (pop-to-buffer): Doc fix.
modified:
  lisp/ChangeLog
  lisp/window.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2011-07-06 02:42:10 +0000
+++ b/lisp/ChangeLog    2011-07-06 02:46:22 +0000
@@ -1,3 +1,7 @@
+2011-07-06  Glenn Morris  <address@hidden>
+
+       * window.el (pop-to-buffer): Doc fix.
+
 2011-07-06  Markus Heiser  <address@hidden>  (tiny change)
 
        * progmodes/gud.el (gud-pdb-marker-regexp): Accept \r char (Bug#5653).

=== modified file 'lisp/window.el'
--- a/lisp/window.el    2011-07-06 02:42:10 +0000
+++ b/lisp/window.el    2011-07-06 02:46:22 +0000
@@ -5797,31 +5797,30 @@
 (defun pop-to-buffer (&optional buffer-or-name specifiers norecord label)
   "Display buffer specified by BUFFER-OR-NAME and select the window used.
 Optional argument BUFFER-OR-NAME may be a buffer, a string \(a
-buffer name), or nil.  If BUFFER-OR-NAME is a string not naming
-an existent buffer, create a buffer with that name.  If
+buffer name), or nil.  If BUFFER-OR-NAME is a string naming a buffer
+that does not exist, create a buffer with that name.  If
 BUFFER-OR-NAME is nil or omitted, display the current buffer.
 Interactively, prompt for the buffer name using the minibuffer.
 
-Optional second argument SPECIFIERS must be a list of buffer
-display specifiers, a single location specifier, `t' which means
-the latter means to display the buffer in any but the selected
-window, or nil which means to exclusively apply the specifiers
-customized by the user.
+Optional second argument SPECIFIERS can be: a list of buffer
+display specifiers (see `display-buffer-alist'); a single
+location specifier; t, which means to display the buffer in any
+but the selected window; or nil, which means to exclusively apply
+the specifiers customized by the user.  See `display-buffer' for
+more details.
 
-Optional argument NORECORD non-nil means do not put the buffer
-specified by BUFFER-OR-NAME at the front of the buffer list and
-do not make the window displaying it the most recently selected
-one.
+Optional argument NORECORD non-nil means do not put the displayed
+buffer at the front of the buffer list, and do not make the window
+displaying it the most recently selected one.
 
 The optional argument LABEL, if non-nil, is a symbol specifying the
 display purpose.  Applications should set this when the buffer
-shall be displayed in a special way but BUFFER-OR-NAME does not
+should be displayed in a special way but BUFFER-OR-NAME does not
 identify the buffer as special.  Buffers that typically fit into
 this category are those whose names have been derived from the
 name of the file they are visiting.
 
-Return the buffer specified by BUFFER-OR-NAME or nil if
-displaying the buffer failed.
+Returns the displayed buffer, or nil if displaying the buffer failed.
 
 This uses the function `display-buffer' as a subroutine; see the
 documentations of `display-buffer' and `display-buffer-alist' for