|
0
|
1 ;;; window.el --- XEmacs window commands aside from those written in C.
|
|
|
2 ;; Keywords: extensions
|
|
|
3
|
|
|
4 ;; Copyright (C) 1985, 1989, 1993, 1994 Free Software Foundation, Inc.
|
|
|
5 ;; Copyright (C) 1995, 1996 Ben Wing.
|
|
|
6
|
|
|
7 ;; This file is part of XEmacs.
|
|
|
8
|
|
|
9 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
10 ;; under the terms of the GNU General Public License as published by
|
|
|
11 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
12 ;; any later version.
|
|
|
13
|
|
|
14 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
15 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
17 ;; General Public License for more details.
|
|
|
18
|
|
|
19 ;; You should have received a copy of the GNU General Public License
|
|
|
20 ;; along with XEmacs; see the file COPYING. If not, write to the Free
|
|
|
21 ;; Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
|
22
|
|
|
23 ;;; Synched up with: FSF 19.30.
|
|
|
24
|
|
|
25 ;;;; Window tree functions.
|
|
|
26
|
|
|
27 (defun one-window-p (&optional nomini all-frames device)
|
|
|
28 "Returns non-nil if the selected window is the only window (in its frame).
|
|
|
29 Optional arg NOMINI non-nil means don't count the minibuffer
|
|
|
30 even if it is active.
|
|
|
31
|
|
|
32 The optional arg ALL-FRAMES t means count windows on all frames.
|
|
|
33 If it is `visible', count windows on all visible frames.
|
|
|
34 ALL-FRAMES nil or omitted means count only the selected frame,
|
|
|
35 plus the minibuffer it uses (which may be on another frame).
|
|
|
36 ALL-FRAMES = 0 means count windows on all visible and iconified frames.
|
|
|
37 If ALL-FRAMES is any other value, count only the selected frame.
|
|
|
38
|
|
|
39 If optional third argument DEVICE is nil or omitted, count frames
|
|
|
40 on all devices.
|
|
|
41 If a device, count frames only on that device.
|
|
|
42 If a device type, count frames only on devices of that type.
|
|
|
43 Otherwise, count frames only on the selected device."
|
|
|
44 (let ((base-window (selected-window)))
|
|
|
45 (if (and nomini (eq base-window (minibuffer-window)))
|
|
|
46 (setq base-window (next-window base-window)))
|
|
|
47 (eq base-window
|
|
|
48 (next-window base-window (if nomini 'arg) all-frames device))))
|
|
|
49
|
|
|
50 (defun walk-windows (proc &optional minibuf all-frames device)
|
|
|
51 "Cycle through all visible windows, calling PROC for each one.
|
|
|
52 PROC is called with a window as argument.
|
|
|
53
|
|
|
54 Optional second arg MINIBUF t means count the minibuffer window even
|
|
|
55 if not active. MINIBUF nil or omitted means count the minibuffer iff
|
|
|
56 it is active. MINIBUF neither t nor nil means not to count the
|
|
|
57 minibuffer even if it is active.
|
|
|
58
|
|
|
59 Several frames may share a single minibuffer; if the minibuffer
|
|
|
60 counts, all windows on all frames that share that minibuffer count
|
|
|
61 too. Therefore, when a separate minibuffer frame is active,
|
|
|
62 `walk-windows' includes the windows in the frame from which you
|
|
|
63 entered the minibuffer, as well as the minibuffer window. But if the
|
|
|
64 minibuffer does not count, only windows from WINDOW's frame count.
|
|
|
65
|
|
|
66 ALL-FRAMES is the optional third argument.
|
|
|
67 ALL-FRAMES nil or omitted means cycle within the frames as specified above.
|
|
|
68 ALL-FRAMES = `visible' means include windows on all visible frames.
|
|
|
69 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
|
|
|
70 ALL-FRAMES = t means include windows on all frames including invisible frames.
|
|
|
71 Anything else means restrict to WINDOW's frame.
|
|
|
72
|
|
|
73 If optional fourth argument DEVICE is nil or omitted, include frames
|
|
|
74 on all devices.
|
|
|
75 If a device, include frames only on that device.
|
|
|
76 If a device type, include frames only on devices of that type.
|
|
|
77 Otherwise, include frames only on the selected device."
|
|
|
78 ;; If we start from the minibuffer window, don't fail to come back to it.
|
|
|
79 (if (window-minibuffer-p (selected-window))
|
|
|
80 (setq minibuf t))
|
|
|
81 ;; Note that, like next-window & previous-window, this behaves a little
|
|
|
82 ;; strangely if the selected window is on an invisible frame: it hits
|
|
|
83 ;; some of the windows on that frame, and all windows on visible frames.
|
|
|
84 (let* ((walk-windows-start (selected-window))
|
|
|
85 (walk-windows-current walk-windows-start))
|
|
|
86 (while (progn
|
|
|
87 (setq walk-windows-current
|
|
|
88 (next-window walk-windows-current minibuf all-frames
|
|
|
89 device))
|
|
|
90 (funcall proc walk-windows-current)
|
|
|
91 (not (eq walk-windows-current walk-windows-start))))))
|
|
|
92 ;; The old XEmacs definition of the above clause. It's more correct in
|
|
|
93 ;; that it will never hit a window that's already been hit even if you
|
|
|
94 ;; do something odd like `delete-other-windows', but has the problem
|
|
|
95 ;; that it conses. (This may be called repeatedly, from lazy-lock
|
|
|
96 ;; for example.)
|
|
|
97 ; (let* ((walk-windows-history nil)
|
|
|
98 ; (walk-windows-current (selected-window)))
|
|
|
99 ; (while (progn
|
|
|
100 ; (setq walk-windows-current
|
|
|
101 ; (next-window walk-windows-current minibuf all-frames
|
|
|
102 ; device))
|
|
|
103 ; (not (memq walk-windows-current walk-windows-history)))
|
|
|
104 ; (setq walk-windows-history (cons walk-windows-current
|
|
|
105 ; walk-windows-history))
|
|
|
106 ; (funcall proc walk-windows-current))))
|
|
|
107
|
|
|
108 (defun minibuffer-window-active-p (window)
|
|
|
109 "Return t if WINDOW (a minibuffer window) is now active."
|
|
|
110 (eq window (active-minibuffer-window)))
|
|
|
111
|
|
|
112 (defmacro save-selected-window (&rest body)
|
|
|
113 "Execute BODY, then select the window that was selected before BODY."
|
|
|
114 (list 'let
|
|
|
115 '((save-selected-window-window (selected-window)))
|
|
|
116 (list 'unwind-protect
|
|
|
117 (cons 'progn body)
|
|
|
118 (list 'and
|
|
|
119 (list 'window-live-p 'save-selected-window-window)
|
|
|
120 (list 'select-window 'save-selected-window-window)))))
|
|
|
121
|
|
|
122 (defun count-windows (&optional minibuf)
|
|
|
123 "Returns the number of visible windows.
|
|
|
124 Optional arg NO-MINI non-nil means don't count the minibuffer
|
|
|
125 even if it is active."
|
|
|
126 (let ((count 0))
|
|
|
127 (walk-windows (function (lambda (w)
|
|
|
128 (setq count (+ count 1))))
|
|
|
129 minibuf)
|
|
|
130 count))
|
|
|
131
|
|
|
132 (defun balance-windows ()
|
|
|
133 "Makes all visible windows the same height (approximately)."
|
|
|
134 (interactive)
|
|
|
135 (let ((count -1) levels newsizes size)
|
|
|
136 ;FSFmacs
|
|
|
137 ;;; Don't count the lines that are above the uppermost windows.
|
|
|
138 ;;; (These are the menu bar lines, if any.)
|
|
|
139 ;(mbl (nth 1 (window-edges (frame-first-window (selected-frame))))))
|
|
|
140 ;; Find all the different vpos's at which windows start,
|
|
|
141 ;; then count them. But ignore levels that differ by only 1.
|
|
|
142 (save-window-excursion
|
|
|
143 (let (tops (prev-top -2))
|
|
|
144 (walk-windows (function (lambda (w)
|
|
|
145 (setq tops (cons (nth 1 (window-pixel-edges w))
|
|
|
146 tops))))
|
|
|
147 'nomini)
|
|
|
148 (setq tops (sort tops '<))
|
|
|
149 (while tops
|
|
|
150 (if (> (car tops) (1+ prev-top))
|
|
|
151 (setq prev-top (car tops)
|
|
|
152 count (1+ count)))
|
|
|
153 (setq levels (cons (cons (car tops) count) levels))
|
|
|
154 (setq tops (cdr tops)))
|
|
|
155 (setq count (1+ count))))
|
|
|
156 ;; Subdivide the frame into that many vertical levels.
|
|
|
157 ;FSFmacs (setq size (/ (- (frame-height) mbl) count))
|
|
|
158 (setq size (/ (window-pixel-height (frame-root-window)) count))
|
|
|
159 (walk-windows (function (lambda (w)
|
|
|
160 (select-window w)
|
|
|
161 (let ((newtop (cdr (assq (nth 1 (window-pixel-edges))
|
|
|
162 levels)))
|
|
|
163 (newbot (or (cdr (assq
|
|
|
164 (+ (window-pixel-height)
|
|
|
165 (nth 1 (window-pixel-edges)))
|
|
|
166 levels))
|
|
|
167 count)))
|
|
|
168 (setq newsizes
|
|
|
169 (cons (cons w (* size (- newbot newtop)))
|
|
|
170 newsizes)))))
|
|
|
171 'nomini)
|
|
|
172 (walk-windows (function (lambda (w)
|
|
|
173 (select-window w)
|
|
|
174 (let ((newsize (cdr (assq w newsizes))))
|
|
|
175 (enlarge-window
|
|
|
176 (/ (- newsize (window-pixel-height))
|
|
|
177 (face-height 'default))))))
|
|
|
178 'nomini)))
|
|
|
179
|
|
|
180 ;;; I think this should be the default; I think people will prefer it--rms.
|
|
|
181 (defvar split-window-keep-point t
|
|
|
182 "*If non-nil, split windows keeps the original point in both children.
|
|
|
183 This is often more convenient for editing.
|
|
|
184 If nil, adjust point in each of the two windows to minimize redisplay.
|
|
|
185 This is convenient on slow terminals, but point can move strangely.")
|
|
|
186
|
|
|
187 (defun split-window-vertically (&optional arg)
|
|
|
188 "Split current window into two windows, one above the other.
|
|
|
189 The uppermost window gets ARG lines and the other gets the rest.
|
|
|
190 Negative arg means select the size of the lowermost window instead.
|
|
|
191 With no argument, split equally or close to it.
|
|
|
192 Both windows display the same buffer now current.
|
|
|
193
|
|
|
194 If the variable split-window-keep-point is non-nil, both new windows
|
|
|
195 will get the same value of point as the current window. This is often
|
|
|
196 more convenient for editing.
|
|
|
197
|
|
|
198 Otherwise, we chose window starts so as to minimize the amount of
|
|
|
199 redisplay; this is convenient on slow terminals. The new selected
|
|
|
200 window is the one that the current value of point appears in. The
|
|
|
201 value of point can change if the text around point is hidden by the
|
|
|
202 new modeline.
|
|
|
203
|
|
|
204 Programs should probably use split-window instead of this."
|
|
|
205 (interactive "P")
|
|
|
206 (let ((old-w (selected-window))
|
|
|
207 (old-point (point))
|
|
|
208 (size (and arg (prefix-numeric-value arg)))
|
|
|
209 new-w bottom)
|
|
|
210 (and size (< size 0) (setq size (+ (window-height) size)))
|
|
|
211 (setq new-w (split-window nil size))
|
|
|
212 (or split-window-keep-point
|
|
|
213 (progn
|
|
|
214 (save-excursion
|
|
|
215 (set-buffer (window-buffer))
|
|
|
216 (goto-char (window-start))
|
|
|
217 (vertical-motion (window-height))
|
|
|
218 (set-window-start new-w (point))
|
|
|
219 (if (> (point) (window-point new-w))
|
|
|
220 (set-window-point new-w (point)))
|
|
|
221 (vertical-motion -1)
|
|
|
222 (setq bottom (point)))
|
|
|
223 (if (<= bottom (point))
|
|
|
224 (set-window-point old-w (1- bottom)))
|
|
|
225 (if (< (window-start new-w) old-point)
|
|
|
226 (progn
|
|
|
227 (set-window-point new-w old-point)
|
|
|
228 (select-window new-w)))))
|
|
|
229 new-w))
|
|
|
230
|
|
|
231 (defun split-window-horizontally (&optional arg)
|
|
|
232 "Split current window into two windows side by side.
|
|
|
233 This window becomes the leftmost of the two, and gets ARG columns.
|
|
|
234 Negative arg means select the size of the rightmost window instead.
|
|
|
235 No arg means split equally."
|
|
|
236 (interactive "P")
|
|
|
237 (let ((size (and arg (prefix-numeric-value arg))))
|
|
|
238 (and size (< size 0)
|
|
|
239 (setq size (+ (window-width) size)))
|
|
|
240 (split-window nil size t)))
|
|
|
241
|
|
|
242 (defun enlarge-window-horizontally (arg)
|
|
|
243 "Make current window ARG columns wider."
|
|
|
244 (interactive "p")
|
|
|
245 (enlarge-window arg t))
|
|
|
246
|
|
|
247 (defun shrink-window-horizontally (arg)
|
|
|
248 "Make current window ARG columns narrower."
|
|
|
249 (interactive "p")
|
|
|
250 (shrink-window arg t))
|
|
|
251
|
|
|
252 (defun shrink-window-if-larger-than-buffer (&optional window)
|
|
|
253 "Shrink the WINDOW to be as small as possible to display its contents.
|
|
|
254 Do not shrink to less than `window-min-height' lines.
|
|
|
255 Do nothing if the buffer contains more lines than the present window height,
|
|
|
256 or if some of the window's contents are scrolled out of view,
|
|
|
257 or if the window is not the full width of the frame,
|
|
|
258 or if the window is the only window of its frame."
|
|
|
259 (interactive)
|
|
|
260 (or window (setq window (selected-window)))
|
|
|
261 (save-excursion
|
|
|
262 (set-buffer (window-buffer window))
|
|
|
263 (let* ((w (selected-window)) ;save-window-excursion can't win
|
|
|
264 (buffer-file-name buffer-file-name)
|
|
|
265 (p (point))
|
|
|
266 (n 0)
|
|
|
267 (ignore-final-newline
|
|
|
268 ;; If buffer ends with a newline, ignore it when counting height
|
|
|
269 ;; unless point is after it.
|
|
|
270 (and (not (eobp))
|
|
|
271 (eq ?\n (char-after (1- (point-max))))))
|
|
|
272 (buffer-read-only nil)
|
|
|
273 (modified (buffer-modified-p))
|
|
|
274 (buffer (current-buffer))
|
|
|
275 (mini (frame-property (window-frame window) 'minibuffer))
|
|
|
276 (edges (window-pixel-edges (selected-window))))
|
|
|
277 (if (and (< 1 (let ((frame (selected-frame)))
|
|
|
278 (select-frame (window-frame window))
|
|
|
279 (unwind-protect
|
|
|
280 (count-windows)
|
|
|
281 (select-frame frame))))
|
|
|
282 ;; check to make sure that we don't have horizontally
|
|
|
283 ;; split windows
|
|
|
284 (eq (frame-highest-window (window-frame window) 0)
|
|
|
285 (frame-highest-window (window-frame window) -1))
|
|
|
286 (pos-visible-in-window-p (point-min) window)
|
|
|
287 (not (eq mini 'only))
|
|
|
288 (or (not mini) (eq mini t)
|
|
|
289 (< (nth 3 edges)
|
|
|
290 (nth 1 (window-pixel-edges mini)))
|
|
|
291 (> (nth 1 edges)
|
|
|
292 ;FSFmacs (frame-property (window-frame window)
|
|
|
293 ; 'menu-bar-lines params)
|
|
|
294 0)))
|
|
|
295 (unwind-protect
|
|
|
296 (progn
|
|
|
297 (select-window (or window w))
|
|
|
298 (goto-char (point-min))
|
|
|
299 (while (pos-visible-in-window-p
|
|
|
300 (- (point-max)
|
|
|
301 (if ignore-final-newline 1 0)))
|
|
|
302 ;; defeat file locking... don't try this at home, kids!
|
|
|
303 (setq buffer-file-name nil)
|
|
|
304 (insert ?\n) (setq n (1+ n)))
|
|
|
305 (if (> n 0)
|
|
|
306 (shrink-window (min (1- n)
|
|
|
307 (- (window-height)
|
|
|
308 window-min-height)))))
|
|
|
309 (delete-region (point-min) (point))
|
|
|
310 (set-buffer-modified-p modified)
|
|
|
311 (goto-char p)
|
|
|
312 (select-window w)
|
|
|
313 ;; Make sure we unbind buffer-read-only
|
|
|
314 ;; with the proper current buffer.
|
|
|
315 (set-buffer buffer))))))
|
|
|
316
|
|
|
317 (defun backward-other-window (arg &optional all-frames device)
|
|
|
318 "Select the ARG'th different window on this frame, going backwards.
|
|
|
319 This is just like calling `other-window' with the arg negated."
|
|
|
320 (interactive "p")
|
|
|
321 (other-window (- arg) all-frames device))
|
|
|
322
|
|
|
323 (defun windows-of-buffer (&optional buffer)
|
|
|
324 "Returns a list of windows that have BUFFER in them.
|
|
|
325 If BUFFER is not specified, the current buffer will be used."
|
|
|
326 (or (bufferp buffer)
|
|
|
327 (if (stringp buffer)
|
|
|
328 (setq buffer (or (get-buffer buffer)
|
|
|
329 (get-file-buffer buffer)))
|
|
|
330 (setq buffer (current-buffer))))
|
|
|
331 (let* ((firstwin (next-window nil nil t))
|
|
|
332 (wind firstwin)
|
|
|
333 (done nil)
|
|
|
334 window-list)
|
|
|
335 (while (not done)
|
|
|
336 (if (eq (window-buffer wind) buffer)
|
|
|
337 (setq window-list (append window-list (list wind))))
|
|
|
338 (setq wind (next-window wind nil t))
|
|
|
339 (setq done (eq wind firstwin)))
|
|
|
340 window-list))
|
|
|
341
|
|
|
342 (defun buffer-in-multiple-windows-p (&optional buffer)
|
|
|
343 "Returns t if BUFFER is in multiple windows.
|
|
|
344 If BUFFER is not specified, the current buffer will be used."
|
|
|
345 (setq buffer (or buffer
|
|
|
346 (get-buffer buffer)
|
|
|
347 (get-file-buffer buffer)
|
|
|
348 (current-buffer)))
|
|
|
349 (> (length (windows-of-buffer buffer)) 1))
|
|
|
350
|
|
|
351 (defun window-list (&optional frame minibuf window)
|
|
|
352 "Return a list of windows on FRAME, beginning with WINDOW.
|
|
|
353 FRAME and WINDOW default to the selected ones.
|
|
|
354 Optional second arg MINIBUF t means count the minibuffer window
|
|
|
355 even if not active. If MINIBUF is neither t nor nil it means
|
|
|
356 not to count the minibuffer even if it is active."
|
|
|
357 (setq window (or window (selected-window))
|
|
|
358 frame (or frame (selected-frame)))
|
|
|
359 (if (not (eq (window-frame window) frame))
|
|
|
360 (error "Window must be on frame."))
|
|
|
361 (let ((current-frame (selected-frame))
|
|
|
362 list)
|
|
|
363 (unwind-protect
|
|
|
364 (save-window-excursion
|
|
|
365 (select-frame frame)
|
|
|
366 (walk-windows
|
|
|
367 (function (lambda (cur-window)
|
|
|
368 (if (not (eq window cur-window))
|
|
|
369 (setq list (cons cur-window list)))))
|
|
|
370 minibuf)
|
|
|
371 (setq list (cons window list)))
|
|
|
372 (select-frame current-frame))))
|
|
|
373
|
|
|
374 ;; We used to have set-window-dedicated-p as an obsolete version
|
|
|
375 ;; of set-window-buffer-dedicated, but it really makes more sense
|
|
|
376 ;; this way.
|
|
|
377
|
|
|
378 (make-obsolete 'set-window-buffer-dedicated 'set-window-dedicated-p)
|
|
|
379 (defun set-window-buffer-dedicated (window buffer)
|
|
|
380 "Make WINDOW display BUFFER and be dedicated to that buffer.
|
|
|
381 Then Emacs will not automatically change which buffer appears in WINDOW.
|
|
|
382 If BUFFER is nil, make WINDOW not be dedicated (but don't change which
|
|
|
383 buffer appears in it currently)."
|
|
|
384 (if (bufferp buffer)
|
|
|
385 (set-window-buffer window (get-buffer-create buffer)))
|
|
|
386 (set-window-dedicated-p window (not (null buffer))))
|
|
|
387
|
|
|
388
|
|
|
389 ;; The window-config stack is stored as a list in frame property
|
|
|
390 ;; 'window-config-stack, with the most recent element at the front.
|
|
|
391 ;; When you pop off an element, the popped off element gets put at the
|
|
|
392 ;; front of frame property 'window-config-unpop-stack, so you can
|
|
|
393 ;; retrieve it using unpop-window-configuration.
|
|
|
394
|
|
|
395 (defvar window-config-stack-max 16
|
|
|
396 "*Maximum size of window configuration stack.
|
|
|
397 Start discarding off end if it gets this big.")
|
|
|
398
|
|
|
399 (defun window-config-stack (&optional frame)
|
|
|
400 (or frame (setq frame (selected-frame)))
|
|
|
401 (let ((stack (frame-property frame 'window-config-stack)))
|
|
|
402 (if stack
|
|
|
403 (set-undoable-stack-max stack window-config-stack-max)
|
|
|
404 (progn
|
|
|
405 (setq stack (make-undoable-stack window-config-stack-max))
|
|
|
406 (set-frame-property frame 'window-config-stack stack)))
|
|
|
407 stack))
|
|
|
408
|
|
|
409 (defun push-window-configuration (&optional config)
|
|
|
410 "Push the current window configuration onto the window-config stack.
|
|
|
411 If CONFIG is specified, push it instead of the current window configuration.
|
|
|
412 Each frame has its own window-config stack."
|
|
|
413 (interactive)
|
|
|
414 (let ((wc (or config (current-window-configuration)))
|
|
|
415 (stack (window-config-stack)))
|
|
|
416 (if (or (= 0 (undoable-stack-a-length stack))
|
|
|
417 (not (equal (undoable-stack-a-top stack) wc)))
|
|
|
418 (progn
|
|
|
419 (undoable-stack-push stack wc)
|
|
|
420 ;; kludge.
|
|
|
421 (if (featurep 'toolbar)
|
|
|
422 (set-specifier-dirty-flag default-toolbar))))))
|
|
|
423
|
|
|
424 (defun pop-window-configuration ()
|
|
|
425 "Pop the top window configuration off the window-config stack and set it.
|
|
|
426 Before setting the new window configuration, the current window configuration
|
|
|
427 is pushed onto the \"unpop\" stack.
|
|
|
428 `unpop-window-configuration' undoes what this function does.
|
|
|
429 Each frame has its own window-config and \"unpop\" stack."
|
|
|
430 (interactive)
|
|
|
431 (let ((stack (window-config-stack))
|
|
|
432 (wc (current-window-configuration))
|
|
|
433 popped)
|
|
|
434 (condition-case nil
|
|
|
435 (progn
|
|
|
436 (setq popped (undoable-stack-pop stack))
|
|
|
437 (while (equal popped wc)
|
|
|
438 (setq popped (undoable-stack-pop stack)))
|
|
|
439 (undoable-stack-push stack wc)
|
|
|
440 (undoable-stack-undo stack)
|
|
|
441 (set-window-configuration popped)
|
|
|
442 ;; probably not necessary:
|
|
|
443 (if (featurep 'toolbar)
|
|
|
444 (set-specifier-dirty-flag default-toolbar))
|
|
|
445 popped)
|
|
|
446 (trunc-stack-bottom
|
|
|
447 (error "Bottom of window config stack")))))
|
|
|
448
|
|
|
449 (defun unpop-window-configuration ()
|
|
|
450 "Undo the effect of the most recent `pop-window-configuration'.
|
|
|
451 This does exactly the inverse of what `pop-window-configuration' does:
|
|
|
452 i.e. it pops a window configuration off of the \"unpop\" stack and
|
|
|
453 pushes the current window configuration onto the window-config stack.
|
|
|
454 Each frame has its own window-config and \"unpop\" stack."
|
|
|
455 (interactive)
|
|
|
456 (let ((stack (window-config-stack))
|
|
|
457 (wc (current-window-configuration))
|
|
|
458 popped)
|
|
|
459 (condition-case nil
|
|
|
460 (progn
|
|
|
461 (setq popped
|
|
|
462 (progn
|
|
|
463 (undoable-stack-redo stack)
|
|
|
464 (undoable-stack-pop stack)))
|
|
|
465 (while (equal popped wc)
|
|
|
466 (setq popped
|
|
|
467 (progn
|
|
|
468 (undoable-stack-redo stack)
|
|
|
469 (undoable-stack-pop stack))))
|
|
|
470 (undoable-stack-push stack wc)
|
|
|
471 (set-window-configuration popped)
|
|
|
472 ;; probably not necessary:
|
|
|
473 (if (featurep 'toolbar)
|
|
|
474 (set-specifier-dirty-flag default-toolbar))
|
|
|
475 popped)
|
|
|
476 (trunc-stack-bottom
|
|
|
477 (error "Top of window config stack")))))
|
|
|
478
|
|
|
479
|
|
|
480 ;;;;;;;;;;;;; display-buffer, moved here from C. Hallelujah.
|
|
|
481
|
|
|
482 (defvar display-buffer-function nil
|
|
|
483 "If non-nil, function to call to handle `display-buffer'.
|
|
|
484 It will receive three args: the same as those to `display-buffer'.")
|
|
|
485
|
|
|
486 (defvar pre-display-buffer-function nil
|
|
|
487 "If non-nil, function that will be called from `display-buffer'
|
|
|
488 as the first action. It will receive three args: the same as those
|
|
|
489 to `display-buffer'.
|
|
|
490 This function may be used to select an appropriate frame for the buffer,
|
|
|
491 for example. See also the variable `display-buffer-function', which may
|
|
|
492 be used to completely replace the `display-buffer' function.
|
|
|
493 If the return value of this function is non-nil, it should be a frame,
|
|
|
494 and that frame will be used to display the buffer.")
|
|
|
495
|
|
|
496 (defvar pop-up-frames nil
|
|
|
497 "*Non-nil means `display-buffer' should make a separate frame.")
|
|
|
498
|
|
|
499 (defvar pop-up-frame-function nil
|
|
|
500 "Function to call to handle automatic new frame creation.
|
|
|
501 It is called with no arguments and should return a newly created frame.
|
|
|
502
|
|
|
503 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
|
|
|
504 where `pop-up-frame-alist' would hold the default frame parameters.")
|
|
|
505
|
|
|
506 (defvar special-display-buffer-names nil
|
|
|
507 "*List of buffer names that should have their own special frames.
|
|
|
508 Displaying a buffer whose name is in this list makes a special frame for it
|
|
|
509 using `special-display-function'.
|
|
|
510
|
|
|
511 An element of the list can be a cons cell instead of just a string.
|
|
|
512 Then the car should be a buffer name, and the cdr specifies frame
|
|
|
513 parameters for creating the frame for that buffer.
|
|
|
514 More precisely, the cdr is passed as the second argument to
|
|
|
515 the function found in `special-display-function', when making that frame.
|
|
|
516 See also `special-display-regexps'.")
|
|
|
517
|
|
|
518 (defvar special-display-regexps nil
|
|
|
519 "*List of regexps saying which buffers should have their own special frames.
|
|
|
520 If a buffer name matches one of these regexps, it gets its own frame.
|
|
|
521 Displaying a buffer whose name is in this list makes a special frame for it
|
|
|
522 using `special-display-function'.
|
|
|
523
|
|
|
524 An element of the list can be a cons cell instead of just a string.
|
|
|
525 Then the car should be the regexp, and the cdr specifies frame
|
|
|
526 parameters for creating the frame for buffers that match.
|
|
|
527 More precisely, the cdr is passed as the second argument to
|
|
|
528 the function found in `special-display-function', when making that frame.
|
|
|
529 See also `special-display-buffer-names'.")
|
|
|
530
|
|
|
531 (defvar special-display-function nil
|
|
|
532 "Function to call to make a new frame for a special buffer.
|
|
|
533 It is called with two arguments, the buffer and optional buffer specific
|
|
|
534 data, and should return a window displaying that buffer.
|
|
|
535 The default value makes a separate frame for the buffer,
|
|
|
536 using `special-display-frame-alist' to specify the frame parameters.
|
|
|
537
|
|
|
538 A buffer is special if its is listed in `special-display-buffer-names'
|
|
|
539 or matches a regexp in `special-display-regexps'.")
|
|
|
540
|
|
|
541 (defvar same-window-buffer-names nil
|
|
|
542 "*List of buffer names that should appear in the selected window.
|
|
|
543 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
|
|
|
544 switches to it in the selected window, rather than making it appear
|
|
|
545 in some other window.
|
|
|
546
|
|
|
547 An element of the list can be a cons cell instead of just a string.
|
|
|
548 Then the car must be a string, which specifies the buffer name.
|
|
|
549 This is for compatibility with `special-display-buffer-names';
|
|
|
550 the cdr of the cons cell is ignored.
|
|
|
551
|
|
|
552 See also `same-window-regexps'.")
|
|
|
553
|
|
|
554 (defvar same-window-regexps nil
|
|
|
555 "*List of regexps saying which buffers should appear in the selected window.
|
|
|
556 If a buffer name matches one of these regexps, then displaying it
|
|
|
557 using `display-buffer' or `pop-to-buffer' switches to it
|
|
|
558 in the selected window, rather than making it appear in some other window.
|
|
|
559
|
|
|
560 An element of the list can be a cons cell instead of just a string.
|
|
|
561 Then the car must be a string, which specifies the buffer name.
|
|
|
562 This is for compatibility with `special-display-buffer-names';
|
|
|
563 the cdr of the cons cell is ignored.
|
|
|
564
|
|
|
565 See also `same-window-buffer-names'.")
|
|
|
566
|
|
|
567 (defvar pop-up-windows t
|
|
|
568 "*Non-nil means display-buffer should make new windows.")
|
|
|
569
|
|
|
570 (defvar split-height-threshold 500
|
|
|
571 "*display-buffer would prefer to split the largest window if this large.
|
|
|
572 If there is only one window, it is split regardless of this value.")
|
|
|
573
|
|
|
574 (defvar split-width-threshold 500
|
|
|
575 "*display-buffer would prefer to split the largest window if this large.
|
|
|
576 If there is only one window, it is split regardless of this value.")
|
|
|
577
|
|
|
578 ;; Deiconify the frame containing the window WINDOW, then return WINDOW.
|
|
|
579
|
|
|
580 (defun display-buffer-1 (window)
|
|
|
581 (if (frame-iconified-p (window-frame window))
|
|
|
582 (make-frame-visible (window-frame window)))
|
|
|
583 window)
|
|
|
584
|
|
|
585 ;; Can you believe that all of this crap was formerly in C?
|
|
|
586 ;; Praise Jesus that it's not there any more.
|
|
|
587
|
|
|
588 (defun display-buffer (buffer &optional not-this-window-p override-frame)
|
|
|
589 "Make BUFFER appear in some window on the current frame, but don't select it.
|
|
|
590 BUFFER can be a buffer or a buffer name.
|
|
|
591 If BUFFER is shown already in some window in the current frame,
|
|
|
592 just uses that one, unless the window is the selected window and
|
|
|
593 NOT-THIS-WINDOW-P is non-nil (interactively, with prefix arg).
|
|
|
594
|
|
|
595 If BUFFER has a dedicated frame, display on that frame instead of
|
|
|
596 the current frame, unless OVERRIDE-FRAME is non-nil.
|
|
|
597
|
|
|
598 If OVERRIDE-FRAME is non-nil, display on that frame instead of
|
|
|
599 the current frame (or the dedicated frame).
|
|
|
600
|
|
|
601 If `pop-up-windows' is non-nil, always use the
|
|
|
602 current frame and create a new window regardless of whether the
|
|
|
603 buffer has a dedicated frame, and regardless of whether
|
|
|
604 OVERRIDE-FRAME was specified.
|
|
|
605
|
|
|
606 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
|
|
|
607
|
|
|
608 Returns the window displaying BUFFER."
|
|
|
609 (interactive "BDisplay buffer:\nP")
|
|
|
610
|
|
|
611 (let ((wconfig (current-window-configuration))
|
|
|
612 (result
|
|
|
613 ;; We just simulate a `return' in C. This function is way ugly
|
|
|
614 ;; and does `returns' all over the place and there's no sense
|
|
|
615 ;; in trying to rewrite it to be more Lispy.
|
|
|
616 (catch 'done
|
|
|
617 (let (window old-frame target-frame explicit-frame)
|
|
|
618 (setq old-frame (or (last-nonminibuf-frame) (selected-frame)))
|
|
|
619 (setq buffer (get-buffer buffer))
|
|
|
620 (check-argument-type 'bufferp buffer)
|
|
|
621
|
|
|
622 (setq explicit-frame
|
|
|
623 (if pre-display-buffer-function
|
|
|
624 (funcall pre-display-buffer-function buffer
|
|
|
625 not-this-window-p
|
|
|
626 override-frame)))
|
|
|
627
|
|
|
628 ;; Give the user the ability to completely reimplement
|
|
|
629 ;; this function via the `display-buffer-function'.
|
|
|
630 (if display-buffer-function
|
|
|
631 (throw 'done
|
|
|
632 (funcall display-buffer-function buffer
|
|
|
633 not-this-window-p
|
|
|
634 override-frame)))
|
|
|
635
|
|
|
636 ;; If the buffer has a dedicated frame, that takes
|
|
|
637 ;; precedence over the current frame, and over what the
|
|
|
638 ;; pre-display-buffer-function did.
|
|
|
639 (let ((dedi (buffer-dedicated-frame buffer)))
|
|
|
640 (if (frame-live-p dedi) (setq explicit-frame dedi)))
|
|
|
641
|
|
|
642 ;; if override-frame is supplied, that takes precedence over
|
|
|
643 ;; everything. This is gonna look bad if the
|
|
|
644 ;; pre-display-buffer-function raised some other frame
|
|
|
645 ;; already.
|
|
|
646 (if override-frame
|
|
|
647 (progn
|
|
|
648 (check-argument-type 'frame-live-p override-frame)
|
|
|
649 (setq explicit-frame override-frame)))
|
|
|
650
|
|
|
651 (setq target-frame
|
|
|
652 (or explicit-frame
|
|
|
653 (last-nonminibuf-frame)
|
|
|
654 (selected-frame)))
|
|
|
655
|
|
|
656 ;; If we have switched frames, then set not-this-window-p
|
|
|
657 ;; to false. Switching frames means that selected-window
|
|
|
658 ;; is no longer the same as it was on entry -- it's the
|
|
|
659 ;; selected-window of target_frame instead of old_frame,
|
|
|
660 ;; so it's a fine candidate for display.
|
|
|
661 (if (not (eq old-frame target-frame))
|
|
|
662 (setq not-this-window-p nil))
|
|
|
663
|
|
|
664 ;; if it's in the selected window, and that's ok, then we're done.
|
|
|
665 (if (and (not not-this-window-p)
|
|
|
666 (eq buffer (window-buffer (selected-window))))
|
|
|
667 (throw 'done (display-buffer-1 (selected-window))))
|
|
|
668
|
|
|
669 ;; See if the user has specified this buffer should appear
|
|
|
670 ;; in the selected window.
|
|
|
671
|
|
|
672 (if not-this-window-p
|
|
|
673 nil
|
|
|
674
|
|
|
675 (if (or (member (buffer-name buffer) same-window-buffer-names)
|
|
|
676 (assoc (buffer-name buffer) same-window-buffer-names))
|
|
|
677 (progn
|
|
|
678 (switch-to-buffer buffer)
|
|
|
679 (throw 'done (display-buffer-1 (selected-window)))))
|
|
|
680
|
|
|
681 (let ((tem same-window-regexps))
|
|
|
682 (while tem
|
|
|
683 (let ((car (car tem)))
|
|
|
684 (if (or
|
|
|
685 (and (stringp car)
|
|
|
686 (string-match car (buffer-name buffer)))
|
|
|
687 (and (consp car) (stringp (car car))
|
|
|
688 (string-match (car car) (buffer-name buffer))))
|
|
|
689 (progn
|
|
|
690 (switch-to-buffer buffer)
|
|
|
691 (throw 'done (display-buffer-1
|
|
|
692 (selected-window))))))
|
|
|
693 (setq tem (cdr tem)))))
|
|
|
694
|
|
|
695 ;; If pop-up-frames, look for a window showing BUFFER on
|
|
|
696 ;; any visible or iconified frame. Otherwise search only
|
|
|
697 ;; the current frame.
|
|
|
698 (if (and (not explicit-frame)
|
|
|
699 (or pop-up-frames (not (last-nonminibuf-frame))))
|
|
|
700 (setq target-frame 0))
|
|
|
701
|
|
|
702 ;; Otherwise, find some window that it's already in, and
|
|
|
703 ;; return that, unless that window is the selected window
|
|
|
704 ;; and that isn't ok. What a contorted mess!
|
|
|
705 (setq window (get-buffer-window buffer target-frame))
|
|
|
706 (if (and window
|
|
|
707 (or (not not-this-window-p)
|
|
|
708 (not (eq window (selected-window)))))
|
|
|
709 (throw 'done (display-buffer-1 window)))
|
|
|
710
|
|
|
711 ;; Certain buffer names get special handling.
|
|
|
712 (if special-display-function
|
|
|
713 (progn
|
|
|
714 (if (member (buffer-name buffer)
|
|
|
715 special-display-buffer-names)
|
|
|
716 (throw 'done (funcall special-display-function buffer)))
|
|
|
717
|
|
|
718 (let ((tem (assoc (buffer-name buffer)
|
|
|
719 special-display-buffer-names)))
|
|
|
720 (if tem
|
|
|
721 (throw 'done (funcall special-display-function
|
|
|
722 buffer (cdr tem)))))
|
|
|
723
|
|
|
724 (let ((tem special-display-regexps))
|
|
|
725 (while tem
|
|
|
726 (let ((car (car tem)))
|
|
|
727 (if (and (stringp car)
|
|
|
728 (string-match car (buffer-name buffer)))
|
|
|
729 (throw 'done
|
|
|
730 (funcall special-display-function buffer)))
|
|
|
731 (if (and (consp car)
|
|
|
732 (stringp (car car))
|
|
|
733 (string-match (car car)
|
|
|
734 (buffer-name buffer)))
|
|
|
735 (throw 'done (funcall
|
|
|
736 special-display-function buffer
|
|
|
737 (cdr car)))))
|
|
|
738 (setq tem (cdr tem))))))
|
|
|
739
|
|
|
740 ;; If there are no frames open that have more than a minibuffer,
|
|
|
741 ;; we need to create a new frame.
|
|
|
742 (if (or pop-up-frames
|
|
|
743 (null (last-nonminibuf-frame)))
|
|
|
744 (progn
|
|
|
745 (setq window (frame-selected-window
|
|
|
746 (funcall pop-up-frame-function)))
|
|
|
747 (set-window-buffer window buffer)
|
|
|
748 (throw 'done (display-buffer-1 window))))
|
|
|
749
|
|
|
750 ;; Otherwise, make it be in some window, splitting if
|
|
|
751 ;; appropriate/possible. Do not split a window if we are
|
|
|
752 ;; displaying the buffer in a different frame than that which
|
|
|
753 ;; was current when we were called. (It is already in a
|
|
|
754 ;; different window by virtue of being in another frame.)
|
|
|
755 (if (or (and pop-up-windows (eq target-frame old-frame))
|
|
|
756 (eq 'only (frame-property (selected-frame) 'minibuffer))
|
|
|
757 ;; If the current frame is a special display frame,
|
|
|
758 ;; don't try to reuse its windows.
|
|
|
759 (window-dedicated-p (frame-root-window (selected-frame))))
|
|
|
760 (progn
|
|
|
761 (if (eq 'only (frame-property (selected-frame) 'minibuffer))
|
|
|
762 (setq target-frame (last-nonminibuf-frame)))
|
|
|
763
|
|
|
764 ;; Don't try to create a window if would get an error with
|
|
|
765 ;; height.
|
|
|
766 (if (< split-height-threshold (* 2 window-min-height))
|
|
|
767 (setq split-height-threshold (* 2 window-min-height)))
|
|
|
768
|
|
|
769 ;; Same with width.
|
|
|
770 (if (< split-width-threshold (* 2 window-min-width))
|
|
|
771 (setq split-width-threshold (* 2 window-min-width)))
|
|
|
772
|
|
|
773 ;; If the frame we would try to split cannot be split,
|
|
|
774 ;; try other frames.
|
|
|
775 (if (frame-property (if (null target-frame)
|
|
|
776 (selected-frame)
|
|
|
777 (last-nonminibuf-frame))
|
|
|
778 'unsplittable)
|
|
|
779 (setq window
|
|
|
780 ;; Try visible frames first.
|
|
|
781 (or (get-largest-window 'visible)
|
|
|
782 ;; If that didn't work, try iconified frames.
|
|
|
783 (get-largest-window 0)
|
|
|
784 (get-largest-window t)))
|
|
|
785 (setq window (get-largest-window target-frame)))
|
|
|
786
|
|
|
787 ;; If we got a tall enough full-width window that
|
|
|
788 ;; can be split, split it.
|
|
|
789 (if (and window
|
|
|
790 (not (frame-property (window-frame window)
|
|
|
791 'unsplittable))
|
|
|
792 (>= (window-height window) split-height-threshold)
|
|
|
793 (or (>= (window-width window)
|
|
|
794 split-width-threshold)
|
|
|
795 (and (window-leftmost-p window)
|
|
|
796 (window-rightmost-p window))))
|
|
|
797 (setq window (split-window window))
|
|
|
798 (let (upper lower other)
|
|
|
799 (setq window (get-lru-window target-frame))
|
|
|
800 ;; If the LRU window is selected, and big enough,
|
|
|
801 ;; and can be split, split it.
|
|
|
802 (if (and window
|
|
|
803 (not (frame-property (window-frame window)
|
|
|
804 'unsplittable))
|
|
|
805 (or (eq window (selected-window))
|
|
|
806 (not (window-parent window)))
|
|
|
807 (>= (window-height window)
|
|
|
808 (* 2 window-min-height)))
|
|
|
809 (setq window (split-window window)))
|
|
|
810 ;; If get-lru-window returned nil, try other approaches.
|
|
|
811 ;; Try visible frames first.
|
|
|
812 (or window
|
|
|
813 (setq window (or (get-largest-window 'visible)
|
|
|
814 ;; If that didn't work, try
|
|
|
815 ;; iconified frames.
|
|
|
816 (get-largest-window 0)
|
|
|
817 ;; Try invisible frames.
|
|
|
818 (get-largest-window t)
|
|
|
819 ;; As a last resort, make
|
|
|
820 ;; a new frame.
|
|
|
821 (frame-selected-window
|
|
|
822 (funcall
|
|
|
823 pop-up-frame-function)))))
|
|
|
824 ;; If window appears above or below another,
|
|
|
825 ;; even out their heights.
|
|
|
826 (if (window-previous-child window)
|
|
|
827 (setq other (window-previous-child window)
|
|
|
828 upper other
|
|
|
829 lower window))
|
|
|
830 (if (window-next-child window)
|
|
|
831 (setq other (window-next-child window)
|
|
|
832 lower other
|
|
|
833 upper window))
|
|
|
834 ;; Check that OTHER and WINDOW are vertically arrayed.
|
|
|
835 (if (and other
|
|
|
836 (not (= (nth 1 (window-pixel-edges other))
|
|
|
837 (nth 1 (window-pixel-edges window))))
|
|
|
838 (> (window-pixel-height other)
|
|
|
839 (window-pixel-height window)))
|
|
|
840 (enlarge-window (- (/ (+ (window-height other)
|
|
|
841 (window-height window))
|
|
|
842 2)
|
|
|
843 (window-height upper))
|
|
|
844 nil upper)))))
|
|
|
845
|
|
|
846 (setq window (get-lru-window target-frame)))
|
|
|
847
|
|
|
848 ;; Bring the window's previous buffer to the top of the MRU chain.
|
|
|
849 (if (window-buffer window)
|
|
|
850 (save-excursion
|
|
|
851 (save-selected-window
|
|
|
852 (select-window window)
|
|
|
853 (record-buffer (window-buffer window)))))
|
|
|
854
|
|
|
855 (set-window-buffer window buffer)
|
|
|
856
|
|
|
857 (display-buffer-1 window)))))
|
|
|
858 (or (equal wconfig (current-window-configuration))
|
|
|
859 (push-window-configuration wconfig))
|
|
|
860 result))
|
