annotate lisp/buffer.el @ 422:95016f13131a r21-2-19

Import from CVS: tag r21-2-19
author cvs
date Mon, 13 Aug 2007 11:25:01 +0200
parents 697ef44129c6
children 11054d720c21
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
1 ;;; buffer.el --- buffer routines taken from C
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
2
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
3 ;; Copyright (C) 1985-1989, 1992-1995, 1997 Free Software Foundation, Inc.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
4 ;; Copyright (C) 1995 Sun Microsystems.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
5 ;; Copyright (C) 1995, 1996 Ben Wing.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
6
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
7 ;; Maintainer: XEmacs Development Team
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
8 ;; Keywords: internal, dumped
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
9
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
10 ;; This file is part of XEmacs.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
11
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
12 ;; XEmacs is free software; you can redistribute it and/or modify it
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
13 ;; under the terms of the GNU General Public License as published by
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
15 ;; any later version.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
16
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful, but
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
20 ;; General Public License for more details.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
21
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
23 ;; along with XEmacs; see the file COPYING. If not, write to the
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
24 ;; Free Software Foundation, 59 Temple Place - Suite 330,
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
25 ;; Boston, MA 02111-1307, USA.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
26
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
27 ;;; Synched up with: FSF 19.30 buffer.c.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
28
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
29 ;;; Commentary:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
30
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
31 ;; This file is dumped with XEmacs.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
32
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
33 ;;; Code:
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
34
422
95016f13131a Import from CVS: tag r21-2-19
cvs
parents: 412
diff changeset
35 (defvar switch-to-buffer-hooks nil
95016f13131a Import from CVS: tag r21-2-19
cvs
parents: 412
diff changeset
36 "Hooks to run after a recorded buffer switch.")
95016f13131a Import from CVS: tag r21-2-19
cvs
parents: 412
diff changeset
37
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
38 (defun switch-to-buffer (bufname &optional norecord)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
39 "Select buffer BUFNAME in the current window.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 219
diff changeset
40 BUFNAME may be a buffer or a buffer name and is created if it did not exist.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 219
diff changeset
41 Optional second arg NORECORD non-nil means do not put this buffer at the
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 219
diff changeset
42 front of the list of recently selected ones.
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
43
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
44 WARNING: This is NOT the way to work on another buffer temporarily
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
45 within a Lisp program! Use `set-buffer' instead. That avoids messing with
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
46 the window-buffer correspondences."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
47 (interactive "BSwitch to buffer: ")
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
48 ;; #ifdef I18N3
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
49 ;; #### Doc string should indicate that the buffer name will get
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
50 ;; translated.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
51 ;; #endif
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
52 (if (eq (minibuffer-window) (selected-window))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
53 (error "Cannot switch buffers in minibuffer window"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
54 (if (window-dedicated-p (selected-window))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
55 (error "Cannot switch buffers in a dedicated window"))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
56 (let (buf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
57 (if (null bufname)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
58 (setq buf (other-buffer (current-buffer)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
59 (setq buf (get-buffer bufname))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
60 (if (null buf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
61 (progn
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
62 (setq buf (get-buffer-create bufname))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
63 (set-buffer-major-mode buf))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
64 (push-window-configuration)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
65 (set-buffer buf)
412
697ef44129c6 Import from CVS: tag r21-2-14
cvs
parents: 404
diff changeset
66 (or norecord (record-buffer buf))
697ef44129c6 Import from CVS: tag r21-2-14
cvs
parents: 404
diff changeset
67 (set-window-buffer (if (eq (selected-window) (minibuffer-window))
697ef44129c6 Import from CVS: tag r21-2-14
cvs
parents: 404
diff changeset
68 (next-window (minibuffer-window))
697ef44129c6 Import from CVS: tag r21-2-14
cvs
parents: 404
diff changeset
69 (selected-window))
697ef44129c6 Import from CVS: tag r21-2-14
cvs
parents: 404
diff changeset
70 buf)
422
95016f13131a Import from CVS: tag r21-2-19
cvs
parents: 412
diff changeset
71 ;; XEmacs change
95016f13131a Import from CVS: tag r21-2-19
cvs
parents: 412
diff changeset
72 (or norecord (run-hook-with-args 'switch-to-buffer-hooks buf))
209
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
73 buf))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
74
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
75 (defun pop-to-buffer (bufname &optional not-this-window-p on-frame)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
76 "Select buffer BUFNAME in some window, preferably a different one.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
77 If BUFNAME is nil, then some other buffer is chosen.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
78 If `pop-up-windows' is non-nil, windows can be split to do this.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
79 If optional second arg NOT-THIS-WINDOW-P is non-nil, insist on finding
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
80 another window even if BUFNAME is already visible in the selected window.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
81 If optional third arg is non-nil, it is the frame to pop to this
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
82 buffer on.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
83 If `focus-follows-mouse' is non-nil, keyboard focus is left unchanged."
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
84 ;; #ifdef I18N3
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
85 ;; #### Doc string should indicate that the buffer name will get
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
86 ;; translated.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
87 ;; #endif
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
88 ;; This is twisted. It is evil to throw the keyboard focus around
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
89 ;; willy-nilly if the user wants focus-follows-mouse.
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
90 (let ((oldbuf (current-buffer))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
91 buf window frame)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
92 (if (null bufname)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
93 (setq buf (other-buffer (current-buffer)))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
94 (setq buf (get-buffer bufname))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
95 (if (null buf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
96 (progn
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
97 (setq buf (get-buffer-create bufname))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
98 (set-buffer-major-mode buf))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
99 (push-window-configuration)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
100 (set-buffer buf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
101 (setq window (display-buffer buf not-this-window-p on-frame))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
102 (setq frame (window-frame window))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
103 ;; if the display-buffer hook decided to show this buffer in another
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
104 ;; frame, then select that frame, (unless obeying focus-follows-mouse -sb).
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
105 (if (and (not focus-follows-mouse)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
106 (not (eq frame (selected-frame))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
107 (select-frame frame))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
108 (record-buffer buf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
109 (if (and focus-follows-mouse
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
110 on-frame
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
111 (not (eq on-frame (selected-frame))))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
112 (set-buffer oldbuf)
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
113 ;; select-window will modify the internal keyboard focus of XEmacs
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
114 (select-window window))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
115 buf))
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
116
41ff10fd062f Import from CVS: tag r20-4b3
cvs
parents:
diff changeset
117 ;;; buffer.el ends here