Problem and patch for display-buffer docstring

[John Sullivan]

The docstring for display-buffer includes:

  The variables `special-display-buffer-names',
  `special-display-regexps', `same-window-buffer-names', and
  `same-window-regexps' customize how certain buffer names are handled.
  The latter two take effect only if NOT-THIS-WINDOW is t.

This last line seems wrong.

My `same-window-buffer-names', for example, is ("*shell*" "*mail*"
"*inferior-lisp*" "*ielm*" "*scheme*"). If I do M-x display-buffer RET *shell*
RET, I get the *shell* buffer in the current window.

It looks like the opposite is true. Because C-u M-x display-buffer RET *shell*
RET displays the *shell* buffer in the other window. Another experiment with a
buffer name that matched `same-window-regexps' supports this.

So, a patch to change t to nil.


2006-04-09  John Sullivan  <address@hidden>

        * window.c (Fdisplay_buffer): Fix docstring.

*** /usr/local/src/emacs-snapshot-20060406/src/window.c 2006-03-20 
17:22:25.000000000 -0500
--- window-new.c        2006-04-09 23:02:23.000000000 -0400
***************
*** 3417,3423 ****
  The variables `special-display-buffer-names',
  `special-display-regexps', `same-window-buffer-names', and
  `same-window-regexps' customize how certain buffer names are handled.
! The latter two take effect only if NOT-THIS-WINDOW is t.
  
  If optional argument FRAME is `visible', search all visible frames.
  If FRAME is 0, search all visible and iconified frames.
--- 3417,3423 ----
  The variables `special-display-buffer-names',
  `special-display-regexps', `same-window-buffer-names', and
  `same-window-regexps' customize how certain buffer names are handled.
! The latter two take effect only if NOT-THIS-WINDOW is nil.
  
  If optional argument FRAME is `visible', search all visible frames.
  If FRAME is 0, search all visible and iconified frames.

-- 
-John Sullivan
-http://www.wjsullivan.net