[PATCH] Document use of `same-window-buffer-names', `same-window-buffer-regexps's for pop-to-buffer, display-buffer
lisp/ChangeLog addition:
2005-02-16 Aidan Kehoe <kehoea(a)parhasard.net>
* buffer.el (pop-to-buffer):
* window-xemacs.el (display-buffer):
Document use of `same-window-buffer-names,' `same-window-regexps'
by pop-to-buffer and display-buffer.
XEmacs Trunk source patch:
Diff command: cvs -q diff -u
Files affected: lisp/window-xemacs.el lisp/buffer.el
Index: lisp/buffer.el
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/buffer.el,v
retrieving revision 1.4
diff -u -u -r1.4 buffer.el
--- lisp/buffer.el 2001/04/12 18:21:11 1.4
+++ lisp/buffer.el 2005/02/16 02:33:24
＠＠ -71,7 +71,12 ＠＠
another window even if BUFNAME is already visible in the selected window.
If optional third arg is non-nil, it is the frame to pop to this
buffer on.
-If `focus-follows-mouse' is non-nil, keyboard focus is left unchanged."
+If `focus-follows-mouse' is non-nil, keyboard focus is left unchanged.
+
+Buffers with names that are members of the `same-window-buffer-names'
+list, or that match an element of the `same-window-regexps' list are
+treated specially by this function--they are always selected in the
+same window rather than in a different one."
;; #ifdef I18N3
;; #### Doc string should indicate that the buffer name will get
;; translated.
Index: lisp/window-xemacs.el
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/window-xemacs.el,v
retrieving revision 1.20
diff -u -u -r1.20 window-xemacs.el
--- lisp/window-xemacs.el 2004/08/21 17:05:51 1.20
+++ lisp/window-xemacs.el 2005/02/16 02:33:25
＠＠ -701,6 +701,10 ＠＠
If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
+If the buffer name is a member of the `same-window-buffer-names' list,
+or matches one of the `same-window-regexps' expressions, display the
+buffer in the currently selected window.
+
Returns the window displaying BUFFER."
(interactive "BDisplay buffer:\nP")
--
“Ah come on now Ted, a Volkswagen with a mind of its own, driving all over
the place and going mad, if that’s not scary I don’t know what is.”