(LD_SWITCH_SYSTEM): Undo previous change.
[bpt/emacs.git] / src / window.c
1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985, 1986, 1987, 1993, 1994 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
20
21 #include <config.h>
22 #include "lisp.h"
23 #include "buffer.h"
24 #include "frame.h"
25 #include "window.h"
26 #include "commands.h"
27 #include "indent.h"
28 #include "termchar.h"
29 #include "disptab.h"
30 #include "keyboard.h"
31
32 Lisp_Object Qwindowp, Qwindow_live_p;
33
34 Lisp_Object Fnext_window (), Fdelete_window (), Fselect_window ();
35 Lisp_Object Fset_window_buffer (), Fsplit_window (), Frecenter ();
36
37 void delete_all_subwindows ();
38 static struct window *decode_window();
39
40 /* This is the window in which the terminal's cursor should
41 be left when nothing is being done with it. This must
42 always be a leaf window, and its buffer is selected by
43 the top level editing loop at the end of each command.
44
45 This value is always the same as
46 FRAME_SELECTED_WINDOW (selected_frame). */
47
48 Lisp_Object selected_window;
49
50 /* The minibuffer window of the selected frame.
51 Note that you cannot test for minibufferness of an arbitrary window
52 by comparing against this; but you can test for minibufferness of
53 the selected window. */
54 Lisp_Object minibuf_window;
55
56 /* Non-nil means it is the window for C-M-v to scroll
57 when the minibuffer is selected. */
58 Lisp_Object Vminibuf_scroll_window;
59
60 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
61 Lisp_Object Vother_window_scroll_buffer;
62
63 /* Non-nil means it's function to call to display temp buffers. */
64 Lisp_Object Vtemp_buffer_show_function;
65
66 /* If a window gets smaller than either of these, it is removed. */
67 int window_min_height;
68 int window_min_width;
69
70 /* Nonzero implies Fdisplay_buffer should create windows. */
71 int pop_up_windows;
72
73 /* Nonzero implies make new frames for Fdisplay_buffer. */
74 int pop_up_frames;
75
76 /* Non-nil means use this function instead of default */
77 Lisp_Object Vpop_up_frame_function;
78
79 /* Function to call to handle Fdisplay_buffer. */
80 Lisp_Object Vdisplay_buffer_function;
81
82 /* Fdisplay_buffer always splits the largest window
83 if that window is more than this high. */
84 int split_height_threshold;
85
86 /* Number of lines of continuity in scrolling by screenfuls. */
87 int next_screen_context_lines;
88
89 /* Incremented for each window created. */
90 static int sequence_number;
91
92 #define min(a, b) ((a) < (b) ? (a) : (b))
93 \f
94 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
95 "Returns t if OBJ is a window.")
96 (obj)
97 Lisp_Object obj;
98 {
99 return XTYPE (obj) == Lisp_Window ? Qt : Qnil;
100 }
101
102 DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
103 "Returns t if OBJ is a window which is currently visible.")
104 (obj)
105 Lisp_Object obj;
106 {
107 return ((XTYPE (obj) == Lisp_Window
108 && ! NILP (XWINDOW (obj)->buffer))
109 ? Qt : Qnil);
110 }
111
112 Lisp_Object
113 make_window ()
114 {
115 register Lisp_Object val;
116 register struct window *p;
117
118 /* Add sizeof (Lisp_Object) here because sizeof (struct Lisp_Vector)
119 includes the first element. */
120 val = Fmake_vector (
121 make_number ((sizeof (struct window) - sizeof (struct Lisp_Vector)
122 + sizeof (Lisp_Object))
123 / sizeof (Lisp_Object)),
124 Qnil);
125 XSETTYPE (val, Lisp_Window);
126 p = XWINDOW (val);
127 XFASTINT (p->sequence_number) = ++sequence_number;
128 XFASTINT (p->left) = XFASTINT (p->top)
129 = XFASTINT (p->height) = XFASTINT (p->width)
130 = XFASTINT (p->hscroll) = 0;
131 XFASTINT (p->last_point_x) = XFASTINT (p->last_point_y) = 0;
132 p->start = Fmake_marker ();
133 p->pointm = Fmake_marker ();
134 XFASTINT (p->use_time) = 0;
135 p->frame = Qnil;
136 p->display_table = Qnil;
137 p->dedicated = Qnil;
138 return val;
139 }
140
141 DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
142 "Return the window that the cursor now appears in and commands apply to.")
143 ()
144 {
145 return selected_window;
146 }
147
148 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
149 "Return the window used now for minibuffers.\n\
150 If the optional argument FRAME is specified, return the minibuffer window\n\
151 used by that frame.")
152 (frame)
153 Lisp_Object frame;
154 {
155 #ifdef MULTI_FRAME
156 if (NILP (frame))
157 XSET (frame, Lisp_Frame, selected_frame);
158 else
159 CHECK_LIVE_FRAME (frame, 0);
160 #endif
161
162 return FRAME_MINIBUF_WINDOW (XFRAME (frame));
163 }
164
165 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 0, 1, 0,
166 "Returns non-nil if WINDOW is a minibuffer window.")
167 (window)
168 Lisp_Object window;
169 {
170 struct window *w = decode_window (window);
171 return (MINI_WINDOW_P (w) ? Qt : Qnil);
172 }
173
174 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p,
175 Spos_visible_in_window_p, 0, 2, 0,
176 "Return t if position POS is currently on the frame in WINDOW.\n\
177 Returns nil if that position is scrolled vertically out of view.\n\
178 POS defaults to point; WINDOW, to the selected window.")
179 (pos, window)
180 Lisp_Object pos, window;
181 {
182 register struct window *w;
183 register int top;
184 register int height;
185 register int posint;
186 register struct buffer *buf;
187 struct position posval;
188 int hscroll;
189
190 if (NILP (pos))
191 posint = point;
192 else
193 {
194 CHECK_NUMBER_COERCE_MARKER (pos, 0);
195 posint = XINT (pos);
196 }
197
198 w = decode_window (window);
199 top = marker_position (w->start);
200 hscroll = XINT (w->hscroll);
201
202 if (posint < top)
203 return Qnil;
204
205 height = XFASTINT (w->height) - ! MINI_WINDOW_P (w);
206
207 buf = XBUFFER (w->buffer);
208 if (XFASTINT (w->last_modified) >= BUF_MODIFF (buf))
209 {
210 /* If frame is up to date,
211 use the info recorded about how much text fit on it. */
212 if (posint < BUF_Z (buf) - XFASTINT (w->window_end_pos)
213 || (XFASTINT (w->window_end_vpos) < height))
214 return Qt;
215 return Qnil;
216 }
217 else
218 {
219 if (posint > BUF_ZV (buf))
220 return Qnil;
221
222 /* If that info is not correct, calculate afresh */
223 posval = *compute_motion (top, 0, (hscroll ? 1 - hscroll : 0),
224 posint, height, 0,
225 window_internal_width (w) - 1,
226 hscroll, 0);
227
228 return posval.vpos < height ? Qt : Qnil;
229 }
230 }
231 \f
232 static struct window *
233 decode_window (window)
234 register Lisp_Object window;
235 {
236 if (NILP (window))
237 return XWINDOW (selected_window);
238
239 CHECK_LIVE_WINDOW (window, 0);
240 return XWINDOW (window);
241 }
242
243 DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
244 "Return the buffer that WINDOW is displaying.")
245 (window)
246 Lisp_Object window;
247 {
248 return decode_window (window)->buffer;
249 }
250
251 DEFUN ("window-height", Fwindow_height, Swindow_height, 0, 1, 0,
252 "Return the number of lines in WINDOW (including its mode line).")
253 (window)
254 Lisp_Object window;
255 {
256 return decode_window (window)->height;
257 }
258
259 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
260 "Return the number of display columns in WINDOW.\n\
261 This is the width that is usable columns available for text in WINDOW.\n\
262 If you want to find out how many columns WINDOW takes up,\n\
263 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))).")
264 (window)
265 Lisp_Object window;
266 {
267 register struct window *w = decode_window (window);
268 register int width = XFASTINT (w->width);
269
270 return make_number (window_internal_width (w));
271 }
272
273 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
274 "Return the number of columns by which WINDOW is scrolled from left margin.")
275 (window)
276 Lisp_Object window;
277 {
278 return decode_window (window)->hscroll;
279 }
280
281 DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
282 "Set number of columns WINDOW is scrolled from left margin to NCOL.\n\
283 NCOL should be zero or positive.")
284 (window, ncol)
285 register Lisp_Object window, ncol;
286 {
287 register struct window *w;
288
289 CHECK_NUMBER (ncol, 1);
290 if (XINT (ncol) < 0) XFASTINT (ncol) = 0;
291 if (XFASTINT (ncol) >= (1 << (SHORTBITS - 1)))
292 args_out_of_range (ncol, Qnil);
293 w = decode_window (window);
294 if (XINT (w->hscroll) != XINT (ncol))
295 clip_changed = 1; /* Prevent redisplay shortcuts */
296 w->hscroll = ncol;
297 return ncol;
298 }
299
300 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
301 "Return a list of the edge coordinates of WINDOW.\n\
302 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.\n\
303 RIGHT is one more than the rightmost column used by WINDOW,\n\
304 and BOTTOM is one more than the bottommost row used by WINDOW\n\
305 and its mode-line.")
306 (window)
307 Lisp_Object window;
308 {
309 register struct window *w = decode_window (window);
310
311 return Fcons (w->left, Fcons (w->top,
312 Fcons (make_number (XFASTINT (w->left) + XFASTINT (w->width)),
313 Fcons (make_number (XFASTINT (w->top)
314 + XFASTINT (w->height)),
315 Qnil))));
316 }
317
318 /* Test if the character at column *x, row *y is within window *w.
319 If it is not, return 0;
320 if it is in the window's text area,
321 set *x and *y to its location relative to the upper left corner
322 of the window, and
323 return 1;
324 if it is on the window's modeline, return 2;
325 if it is on the border between the window and its right sibling,
326 return 3. */
327 static int
328 coordinates_in_window (w, x, y)
329 register struct window *w;
330 register int *x, *y;
331 {
332 register int left = XINT (w->left);
333 register int width = XINT (w->width);
334 register int window_height = XINT (w->height);
335 register int top = XFASTINT (w->top);
336
337 if ( *x < left || *x >= left + width
338 || *y < top || *y >= top + window_height)
339 return 0;
340
341 /* Is the character is the mode line? */
342 if (*y == top + window_height - 1
343 && ! MINI_WINDOW_P (w))
344 return 2;
345
346 /* Is the character in the right border? */
347 if (*x == left + width - 1
348 && left + width != FRAME_WIDTH (XFRAME (w->frame)))
349 return 3;
350
351 *x -= left;
352 *y -= top;
353 return 1;
354 }
355
356 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
357 Scoordinates_in_window_p, 2, 2, 0,
358 "Return non-nil if COORDINATES are in WINDOW.\n\
359 COORDINATES is a cons of the form (X . Y), X and Y being distances\n\
360 measured in characters from the upper-left corner of the frame.\n\
361 (0 . 0) denotes the character in the upper left corner of the\n\
362 frame.\n\
363 If COORDINATES are in the text portion of WINDOW,\n\
364 the coordinates relative to the window are returned.\n\
365 If they are in the mode line of WINDOW, `mode-line' is returned.\n\
366 If they are on the border between WINDOW and its right sibling,\n\
367 `vertical-line' is returned.")
368 (coordinates, window)
369 register Lisp_Object coordinates, window;
370 {
371 int x, y;
372
373 CHECK_LIVE_WINDOW (window, 0);
374 CHECK_CONS (coordinates, 1);
375 x = XINT (Fcar (coordinates));
376 y = XINT (Fcdr (coordinates));
377
378 switch (coordinates_in_window (XWINDOW (window), &x, &y))
379 {
380 case 0: /* NOT in window at all. */
381 return Qnil;
382
383 case 1: /* In text part of window. */
384 return Fcons (x, y);
385
386 case 2: /* In mode line of window. */
387 return Qmode_line;
388
389 case 3: /* On right border of window. */
390 return Qvertical_line;
391
392 default:
393 abort ();
394 }
395 }
396
397 /* Find the window containing column x, row y, and return it as a
398 Lisp_Object. If x, y is on the window's modeline, set *part
399 to 1; if it is on the separating line between the window and its
400 right sibling, set it to 2; otherwise set it to 0. If there is no
401 window under x, y return nil and leave *part unmodified. */
402 Lisp_Object
403 window_from_coordinates (frame, x, y, part)
404 FRAME_PTR frame;
405 int x, y;
406 int *part;
407 {
408 register Lisp_Object tem, first;
409
410 tem = first = FRAME_SELECTED_WINDOW (frame);
411
412 do
413 {
414 int found = coordinates_in_window (XWINDOW (tem), &x, &y);
415
416 if (found)
417 {
418 *part = found - 1;
419 return tem;
420 }
421
422 tem = Fnext_window (tem, Qt, Qlambda);
423 }
424 while (! EQ (tem, first));
425
426 return Qnil;
427 }
428
429 DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
430 "Return window containing coordinates X and Y on FRAME.\n\
431 If omitted, FRAME defaults to the currently selected frame.\n\
432 The top left corner of the frame is considered to be row 0,\n\
433 column 0.")
434 (x, y, frame)
435 Lisp_Object x, y, frame;
436 {
437 int part;
438
439 #ifdef MULTI_FRAME
440 if (NILP (frame))
441 XSET (frame, Lisp_Frame, selected_frame);
442 else
443 CHECK_LIVE_FRAME (frame, 2);
444 #endif
445 CHECK_NUMBER (x, 0);
446 CHECK_NUMBER (y, 1);
447
448 return window_from_coordinates (XFRAME (frame),
449 XINT (x), XINT (y),
450 &part);
451 }
452
453 DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
454 "Return current value of point in WINDOW.\n\
455 For a nonselected window, this is the value point would have\n\
456 if that window were selected.\n\
457 \n\
458 Note that, when WINDOW is the selected window and its buffer\n\
459 is also currently selected, the value returned is the same as (point).\n\
460 It would be more strictly correct to return the `top-level' value\n\
461 of point, outside of any save-excursion forms.\n\
462 But that is hard to define.")
463 (window)
464 Lisp_Object window;
465 {
466 register struct window *w = decode_window (window);
467
468 if (w == XWINDOW (selected_window)
469 && current_buffer == XBUFFER (w->buffer))
470 return Fpoint ();
471 return Fmarker_position (w->pointm);
472 }
473
474 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
475 "Return position at which display currently starts in WINDOW.")
476 (window)
477 Lisp_Object window;
478 {
479 return Fmarker_position (decode_window (window)->start);
480 }
481
482 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 1, 0,
483 "Return position at which display currently ends in WINDOW.")
484 (window)
485 Lisp_Object window;
486 {
487 Lisp_Object value;
488 struct window *w = decode_window (window);
489 Lisp_Object buf;
490
491 buf = w->buffer;
492 CHECK_BUFFER (buf, 0);
493
494 XSET (value, Lisp_Int,
495 BUF_Z (XBUFFER (buf)) - XFASTINT (w->window_end_pos));
496
497 return value;
498 }
499
500 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
501 "Make point value in WINDOW be at position POS in WINDOW's buffer.")
502 (window, pos)
503 Lisp_Object window, pos;
504 {
505 register struct window *w = decode_window (window);
506
507 CHECK_NUMBER_COERCE_MARKER (pos, 1);
508 if (w == XWINDOW (selected_window))
509 Fgoto_char (pos);
510 else
511 set_marker_restricted (w->pointm, pos, w->buffer);
512
513 return pos;
514 }
515
516 DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
517 "Make display in WINDOW start at position POS in WINDOW's buffer.\n\
518 Optional third arg NOFORCE non-nil inhibits next redisplay\n\
519 from overriding motion of point in order to display at this exact start.")
520 (window, pos, noforce)
521 Lisp_Object window, pos, noforce;
522 {
523 register struct window *w = decode_window (window);
524
525 CHECK_NUMBER_COERCE_MARKER (pos, 1);
526 set_marker_restricted (w->start, pos, w->buffer);
527 /* this is not right, but much easier than doing what is right. */
528 w->start_at_line_beg = Qnil;
529 if (NILP (noforce))
530 w->force_start = Qt;
531 w->update_mode_line = Qt;
532 XFASTINT (w->last_modified) = 0;
533 if (!EQ (window, selected_window))
534 windows_or_buffers_changed++;
535 return pos;
536 }
537
538 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
539 1, 1, 0,
540 "Return WINDOW's dedicated object, usually t or nil.\n\
541 See also `set-window-dedicated-p'.")
542 (window)
543 Lisp_Object window;
544 {
545 return decode_window (window)->dedicated;
546 }
547
548 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
549 Sset_window_dedicated_p, 2, 2, 0,
550 "Control whether WINDOW is dedicated to the buffer it displays.\n\
551 If it is dedicated, Emacs will not automatically change\n\
552 which buffer appears in it.\n\
553 The second argument is the new value for the dedication flag;\n\
554 non-nil means yes.")
555 (window, arg)
556 Lisp_Object window, arg;
557 {
558 register struct window *w = decode_window (window);
559
560 if (NILP (arg))
561 w->dedicated = Qnil;
562 else
563 w->dedicated = Qt;
564
565 return w->dedicated;
566 }
567
568 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
569 0, 1, 0,
570 "Return the display-table that WINDOW is using.")
571 (window)
572 Lisp_Object window;
573 {
574 return decode_window (window)->display_table;
575 }
576
577 /* Get the display table for use currently on window W.
578 This is either W's display table or W's buffer's display table.
579 Ignore the specified tables if they are not valid;
580 if no valid table is specified, return 0. */
581
582 struct Lisp_Vector *
583 window_display_table (w)
584 struct window *w;
585 {
586 Lisp_Object tem;
587 tem = w->display_table;
588 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
589 return XVECTOR (tem);
590 tem = XBUFFER (w->buffer)->display_table;
591 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
592 return XVECTOR (tem);
593 tem = Vstandard_display_table;
594 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
595 return XVECTOR (tem);
596 return 0;
597 }
598
599 DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
600 "Set WINDOW's display-table to TABLE.")
601 (window, table)
602 register Lisp_Object window, table;
603 {
604 register struct window *w;
605 register Lisp_Object z; /* Return value. */
606
607 w = decode_window (window);
608 w->display_table = table;
609 return table;
610 }
611 \f
612 /* Record info on buffer window w is displaying
613 when it is about to cease to display that buffer. */
614 static
615 unshow_buffer (w)
616 register struct window *w;
617 {
618 Lisp_Object buf = w->buffer;
619
620 if (XBUFFER (buf) != XMARKER (w->pointm)->buffer)
621 abort ();
622
623 #if 0
624 if (w == XWINDOW (selected_window)
625 || ! EQ (buf, XWINDOW (selected_window)->buffer))
626 /* Do this except when the selected window's buffer
627 is being removed from some other window. */
628 #endif
629 /* last_window_start records the start position that this buffer
630 had in the last window to be disconnected from it.
631 Now that this statement is unconditional,
632 it is possible for the buffer to be displayed in the
633 selected window, while last_window_start reflects another
634 window which was recently showing the same buffer.
635 Some people might say that might be a good thing. Let's see. */
636 XBUFFER (buf)->last_window_start = marker_position (w->start);
637
638 /* Point in the selected window's buffer
639 is actually stored in that buffer, and the window's pointm isn't used.
640 So don't clobber point in that buffer. */
641 if (! EQ (buf, XWINDOW (selected_window)->buffer))
642 BUF_PT (XBUFFER (buf))
643 = clip_to_bounds (BUF_BEGV (XBUFFER (buf)),
644 marker_position (w->pointm),
645 BUF_ZV (XBUFFER (buf)));
646 }
647
648 /* Put replacement into the window structure in place of old. */
649 static
650 replace_window (old, replacement)
651 Lisp_Object old, replacement;
652 {
653 register Lisp_Object tem;
654 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
655
656 /* If OLD is its frame's root_window, then replacement is the new
657 root_window for that frame. */
658
659 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
660 FRAME_ROOT_WINDOW (XFRAME (o->frame)) = replacement;
661
662 p->left = o->left;
663 p->top = o->top;
664 p->width = o->width;
665 p->height = o->height;
666
667 p->next = tem = o->next;
668 if (!NILP (tem))
669 XWINDOW (tem)->prev = replacement;
670
671 p->prev = tem = o->prev;
672 if (!NILP (tem))
673 XWINDOW (tem)->next = replacement;
674
675 p->parent = tem = o->parent;
676 if (!NILP (tem))
677 {
678 if (EQ (XWINDOW (tem)->vchild, old))
679 XWINDOW (tem)->vchild = replacement;
680 if (EQ (XWINDOW (tem)->hchild, old))
681 XWINDOW (tem)->hchild = replacement;
682 }
683
684 /*** Here, if replacement is a vertical combination
685 and so is its new parent, we should make replacement's
686 children be children of that parent instead. ***/
687 }
688
689 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
690 "Remove WINDOW from the display. Default is selected window.")
691 (window)
692 register Lisp_Object window;
693 {
694 register Lisp_Object tem, parent, sib;
695 register struct window *p;
696 register struct window *par;
697
698 /* Because this function is called by other C code on non-leaf
699 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
700 so we can't decode_window here. */
701 if (NILP (window))
702 window = selected_window;
703 else
704 CHECK_WINDOW (window, 0);
705 p = XWINDOW (window);
706
707 /* It's okay to delete an already-deleted window. */
708 if (NILP (p->buffer)
709 && NILP (p->hchild)
710 && NILP (p->vchild))
711 return Qnil;
712
713 parent = p->parent;
714 if (NILP (parent))
715 error ("Attempt to delete minibuffer or sole ordinary window");
716 par = XWINDOW (parent);
717
718 windows_or_buffers_changed++;
719
720 /* Are we trying to delete any frame's selected window? */
721 {
722 Lisp_Object frame, pwindow;
723
724 /* See if the frame's selected window is either WINDOW
725 or any subwindow of it, by finding all that window's parents
726 and comparing each one with WINDOW. */
727 frame = WINDOW_FRAME (XWINDOW (window));
728 pwindow = FRAME_SELECTED_WINDOW (XFRAME (frame));
729
730 while (!NILP (pwindow))
731 {
732 if (EQ (window, pwindow))
733 break;
734 pwindow = XWINDOW (pwindow)->parent;
735 }
736
737 if (EQ (window, pwindow))
738 {
739 Lisp_Object alternative;
740 alternative = Fnext_window (window, Qlambda, Qnil);
741
742 /* If we're about to delete the selected window on the
743 selected frame, then we should use Fselect_window to select
744 the new window. On the other hand, if we're about to
745 delete the selected window on any other frame, we shouldn't do
746 anything but set the frame's selected_window slot. */
747 if (EQ (window, selected_window))
748 Fselect_window (alternative);
749 else
750 FRAME_SELECTED_WINDOW (XFRAME (frame)) = alternative;
751 }
752 }
753
754 tem = p->buffer;
755 /* tem is null for dummy parent windows
756 (which have inferiors but not any contents themselves) */
757 if (!NILP (tem))
758 {
759 unshow_buffer (p);
760 unchain_marker (p->pointm);
761 unchain_marker (p->start);
762 }
763
764 tem = p->next;
765 if (!NILP (tem))
766 XWINDOW (tem)->prev = p->prev;
767
768 tem = p->prev;
769 if (!NILP (tem))
770 XWINDOW (tem)->next = p->next;
771
772 if (EQ (window, par->hchild))
773 par->hchild = p->next;
774 if (EQ (window, par->vchild))
775 par->vchild = p->next;
776
777 /* Find one of our siblings to give our space to. */
778 sib = p->prev;
779 if (NILP (sib))
780 {
781 /* If p gives its space to its next sibling, that sibling needs
782 to have its top/left side pulled back to where p's is.
783 set_window_{height,width} will re-position the sibling's
784 children. */
785 sib = p->next;
786 XWINDOW (sib)->top = p->top;
787 XWINDOW (sib)->left = p->left;
788 }
789
790 /* Stretch that sibling. */
791 if (!NILP (par->vchild))
792 set_window_height (sib,
793 XFASTINT (XWINDOW (sib)->height) + XFASTINT (p->height),
794 1);
795 if (!NILP (par->hchild))
796 set_window_width (sib,
797 XFASTINT (XWINDOW (sib)->width) + XFASTINT (p->width),
798 1);
799
800 /* If parent now has only one child,
801 put the child into the parent's place. */
802 tem = par->hchild;
803 if (NILP (tem))
804 tem = par->vchild;
805 if (NILP (XWINDOW (tem)->next))
806 replace_window (parent, tem);
807
808 /* Since we may be deleting combination windows, we must make sure that
809 not only p but all its children have been marked as deleted. */
810 if (! NILP (p->hchild))
811 delete_all_subwindows (XWINDOW (p->hchild));
812 else if (! NILP (p->vchild))
813 delete_all_subwindows (XWINDOW (p->vchild));
814
815 /* Mark this window as deleted. */
816 p->buffer = p->hchild = p->vchild = Qnil;
817
818 return Qnil;
819 }
820 \f
821
822 extern Lisp_Object next_frame (), prev_frame ();
823
824 /* This comment supplies the doc string for `next-window',
825 for make-docfile to see. We cannot put this in the real DEFUN
826 due to limits in the Unix cpp.
827
828 DEFUN ("next-window", Ffoo, Sfoo, 0, 3, 0,
829 "Return next window after WINDOW in canonical ordering of windows.\n\
830 If omitted, WINDOW defaults to the selected window.\n\
831 \n\
832 Optional second arg MINIBUF t means count the minibuffer window even\n\
833 if not active. MINIBUF nil or omitted means count the minibuffer iff\n\
834 it is active. MINIBUF neither t nor nil means not to count the\n\
835 minibuffer even if it is active.\n\
836 \n\
837 Several frames may share a single minibuffer; if the minibuffer\n\
838 counts, all windows on all frames that share that minibuffer count\n\
839 too. This means that next-window may be used to iterate through the\n\
840 set of windows even when the minibuffer is on another frame. If the\n\
841 minibuffer does not count, only windows from WINDOW's frame count.\n\
842 \n\
843 Optional third arg ALL-FRAMES t means include windows on all frames.\n\
844 ALL-FRAMES nil or omitted means cycle within the frames as specified\n\
845 above. ALL-FRAMES = `visible' means include windows on all visible frames.\n\
846 Anything else means restrict to WINDOW's frame.\n\
847 \n\
848 If you use consistent values for MINIBUF and ALL-FRAMES, you can use\n\
849 `next-window' to iterate through the entire cycle of acceptable\n\
850 windows, eventually ending up back at the window you started with.\n\
851 `previous-window' traverses the same cycle, in the reverse order.")
852 (window, minibuf, all_frames) */
853
854 DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
855 0)
856 (window, minibuf, all_frames)
857 register Lisp_Object window, minibuf, all_frames;
858 {
859 register Lisp_Object tem;
860 Lisp_Object start_window;
861
862 if (NILP (window))
863 window = selected_window;
864 else
865 CHECK_LIVE_WINDOW (window, 0);
866
867 start_window = window;
868
869 /* minibuf == nil may or may not include minibuffers.
870 Decide if it does. */
871 if (NILP (minibuf))
872 minibuf = (minibuf_level ? Qt : Qlambda);
873
874 /* all_frames == nil doesn't specify which frames to include.
875 Decide which frames it includes. */
876 if (NILP (all_frames))
877 all_frames = (EQ (minibuf, Qt)
878 ? (FRAME_MINIBUF_WINDOW
879 (XFRAME
880 (WINDOW_FRAME
881 (XWINDOW (window)))))
882 : Qnil);
883 else if (EQ (all_frames, Qvisible))
884 ;
885 else if (! EQ (all_frames, Qt))
886 all_frames = Qnil;
887 /* Now all_frames is t meaning search all frames,
888 nil meaning search just current frame,
889 or a window, meaning search the frame that window belongs to. */
890
891 /* Do this loop at least once, to get the next window, and perhaps
892 again, if we hit the minibuffer and that is not acceptable. */
893 do
894 {
895 /* Find a window that actually has a next one. This loop
896 climbs up the tree. */
897 while (tem = XWINDOW (window)->next, NILP (tem))
898 if (tem = XWINDOW (window)->parent, !NILP (tem))
899 window = tem;
900 else
901 {
902 /* We've reached the end of this frame.
903 Which other frames are acceptable? */
904 tem = WINDOW_FRAME (XWINDOW (window));
905 #ifdef MULTI_FRAME
906 if (! NILP (all_frames))
907 tem = next_frame (tem, all_frames);
908 #endif
909 tem = FRAME_ROOT_WINDOW (XFRAME (tem));
910
911 break;
912 }
913
914 window = tem;
915
916 /* If we're in a combination window, find its first child and
917 recurse on that. Otherwise, we've found the window we want. */
918 while (1)
919 {
920 if (!NILP (XWINDOW (window)->hchild))
921 window = XWINDOW (window)->hchild;
922 else if (!NILP (XWINDOW (window)->vchild))
923 window = XWINDOW (window)->vchild;
924 else break;
925 }
926 }
927 /* Which windows are acceptible?
928 Exit the loop and accept this window if
929 this isn't a minibuffer window, or
930 we're accepting minibuffer windows, or
931 we've come all the way around and we're back at the original window. */
932 while (MINI_WINDOW_P (XWINDOW (window))
933 && ! EQ (minibuf, Qt)
934 && ! EQ (window, start_window));
935
936 return window;
937 }
938
939 /* This comment supplies the doc string for `previous-window',
940 for make-docfile to see. We cannot put this in the real DEFUN
941 due to limits in the Unix cpp.
942
943 DEFUN ("previous-window", Ffoo, Sfoo, 0, 3, 0,
944 "Return the window preceeding WINDOW in canonical ordering of windows.\n\
945 If omitted, WINDOW defaults to the selected window.\n\
946 \n\
947 Optional second arg MINIBUF t means count the minibuffer window even\n\
948 if not active. MINIBUF nil or omitted means count the minibuffer iff\n\
949 it is active. MINIBUF neither t nor nil means not to count the\n\
950 minibuffer even if it is active.\n\
951 \n\
952 Several frames may share a single minibuffer; if the minibuffer\n\
953 counts, all windows on all frames that share that minibuffer count\n\
954 too. This means that previous-window may be used to iterate through\n\
955 the set of windows even when the minibuffer is on another frame. If\n\
956 the minibuffer does not count, only windows from WINDOW's frame\n\
957 count.\n\
958 \n\
959 Optional third arg ALL-FRAMES t means include windows on all frames.\n\
960 ALL-FRAMES nil or omitted means cycle within the frames as specified\n\
961 above. ALL-FRAMES = `visible' means include windows on all visible frames.\n\
962 Anything else means restrict to WINDOW's frame.\n\
963 \n\
964 If you use consistent values for MINIBUF and ALL-FRAMES, you can use\n\
965 `previous-window' to iterate through the entire cycle of acceptable\n\
966 windows, eventually ending up back at the window you started with.\n\
967 `next-window' traverses the same cycle, in the reverse order.")
968 (window, minibuf, all_frames) */
969
970
971 DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
972 0)
973 (window, minibuf, all_frames)
974 register Lisp_Object window, minibuf, all_frames;
975 {
976 register Lisp_Object tem;
977 Lisp_Object start_window;
978
979 if (NILP (window))
980 window = selected_window;
981 else
982 CHECK_LIVE_WINDOW (window, 0);
983
984 start_window = window;
985
986 /* minibuf == nil may or may not include minibuffers.
987 Decide if it does. */
988 if (NILP (minibuf))
989 minibuf = (minibuf_level ? Qt : Qlambda);
990
991 /* all_frames == nil doesn't specify which frames to include.
992 Decide which frames it includes. */
993 if (NILP (all_frames))
994 all_frames = (EQ (minibuf, Qt)
995 ? (FRAME_MINIBUF_WINDOW
996 (XFRAME
997 (WINDOW_FRAME
998 (XWINDOW (window)))))
999 : Qnil);
1000 else if (EQ (all_frames, Qvisible))
1001 ;
1002 else if (! EQ (all_frames, Qt))
1003 all_frames = Qnil;
1004 /* Now all_frames is t meaning search all frames,
1005 nil meaning search just current frame,
1006 or a window, meaning search the frame that window belongs to. */
1007
1008 /* Do this loop at least once, to get the previous window, and perhaps
1009 again, if we hit the minibuffer and that is not acceptable. */
1010 do
1011 {
1012 /* Find a window that actually has a previous one. This loop
1013 climbs up the tree. */
1014 while (tem = XWINDOW (window)->prev, NILP (tem))
1015 if (tem = XWINDOW (window)->parent, !NILP (tem))
1016 window = tem;
1017 else
1018 {
1019 /* We have found the top window on the frame.
1020 Which frames are acceptable? */
1021 tem = WINDOW_FRAME (XWINDOW (window));
1022 #ifdef MULTI_FRAME
1023 if (! NILP (all_frames))
1024 /* It's actually important that we use prev_frame here,
1025 rather than next_frame. All the windows acceptable
1026 according to the given parameters should form a ring;
1027 Fnext_window and Fprevious_window should go back and
1028 forth around the ring. If we use next_frame here,
1029 then Fnext_window and Fprevious_window take different
1030 paths through the set of acceptable windows.
1031 window_loop assumes that these `ring' requirement are
1032 met. */
1033 tem = prev_frame (tem, all_frames);
1034 #endif
1035 /* If this frame has a minibuffer, find that window first,
1036 because it is conceptually the last window in that frame. */
1037 if (FRAME_HAS_MINIBUF_P (XFRAME (tem)))
1038 tem = FRAME_MINIBUF_WINDOW (XFRAME (tem));
1039 else
1040 tem = FRAME_ROOT_WINDOW (XFRAME (tem));
1041
1042 break;
1043 }
1044
1045 window = tem;
1046 /* If we're in a combination window, find its last child and
1047 recurse on that. Otherwise, we've found the window we want. */
1048 while (1)
1049 {
1050 if (!NILP (XWINDOW (window)->hchild))
1051 window = XWINDOW (window)->hchild;
1052 else if (!NILP (XWINDOW (window)->vchild))
1053 window = XWINDOW (window)->vchild;
1054 else break;
1055 while (tem = XWINDOW (window)->next, !NILP (tem))
1056 window = tem;
1057 }
1058 }
1059 /* Which windows are acceptable?
1060 Exit the loop and accept this window if
1061 this isn't a minibuffer window, or
1062 we're accepting minibuffer windows, or
1063 we've come all the way around and we're back at the original window. */
1064 while (MINI_WINDOW_P (XWINDOW (window))
1065 && !EQ (minibuf, Qt)
1066 && !EQ (window, start_window));
1067
1068 return window;
1069 }
1070
1071 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
1072 "Select the ARG'th different window on this frame.\n\
1073 All windows on current frame are arranged in a cyclic order.\n\
1074 This command selects the window ARG steps away in that order.\n\
1075 A negative ARG moves in the opposite order. If the optional second\n\
1076 argument ALL_FRAMES is non-nil, cycle through all frames.")
1077 (n, all_frames)
1078 register Lisp_Object n, all_frames;
1079 {
1080 register int i;
1081 register Lisp_Object w;
1082
1083 CHECK_NUMBER (n, 0);
1084 w = selected_window;
1085 i = XINT (n);
1086
1087 while (i > 0)
1088 {
1089 w = Fnext_window (w, Qnil, all_frames);
1090 i--;
1091 }
1092 while (i < 0)
1093 {
1094 w = Fprevious_window (w, Qnil, all_frames);
1095 i++;
1096 }
1097 Fselect_window (w);
1098 return Qnil;
1099 }
1100 \f
1101 /* Look at all windows, performing an operation specified by TYPE
1102 with argument OBJ.
1103 If FRAMES is Qt, look at all frames;
1104 Qnil, look at just the selected frame;
1105 Qvisible, look at visible frames;
1106 a frame, just look at windows on that frame.
1107 If MINI is non-zero, perform the operation on minibuffer windows too.
1108 */
1109
1110 enum window_loop
1111 {
1112 WINDOW_LOOP_UNUSED,
1113 GET_BUFFER_WINDOW, /* Arg is buffer */
1114 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
1115 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
1116 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
1117 GET_LARGEST_WINDOW,
1118 UNSHOW_BUFFER /* Arg is buffer */
1119 };
1120
1121 static Lisp_Object
1122 window_loop (type, obj, mini, frames)
1123 enum window_loop type;
1124 register Lisp_Object obj, frames;
1125 int mini;
1126 {
1127 register Lisp_Object w;
1128 register Lisp_Object best_window;
1129 register Lisp_Object next_window;
1130 register Lisp_Object last_window;
1131 FRAME_PTR frame;
1132 Lisp_Object frame_arg;
1133 frame_arg = Qt;
1134
1135 #ifdef MULTI_FRAME
1136 /* If we're only looping through windows on a particular frame,
1137 frame points to that frame. If we're looping through windows
1138 on all frames, frame is 0. */
1139 if (FRAMEP (frames))
1140 frame = XFRAME (frames);
1141 else if (NILP (frames))
1142 frame = selected_frame;
1143 else
1144 frame = 0;
1145 if (frame)
1146 frame_arg = Qlambda;
1147 else if (EQ (frames, Qvisible))
1148 frame_arg = frames;
1149 #else
1150 frame = 0;
1151 #endif
1152
1153 /* frame_arg is Qlambda to stick to one frame,
1154 Qvisible to consider all visible frames,
1155 or Qt otherwise. */
1156
1157 /* Pick a window to start with. */
1158 if (XTYPE (obj) == Lisp_Window)
1159 w = obj;
1160 else if (frame)
1161 w = FRAME_SELECTED_WINDOW (frame);
1162 else
1163 w = FRAME_SELECTED_WINDOW (selected_frame);
1164
1165 /* Figure out the last window we're going to mess with. Since
1166 Fnext_window, given the same options, is guaranteed to go in a
1167 ring, we can just use Fprevious_window to find the last one.
1168
1169 We can't just wait until we hit the first window again, because
1170 it might be deleted. */
1171
1172 last_window = Fprevious_window (w, mini ? Qt : Qnil, frame_arg);
1173
1174 best_window = Qnil;
1175 for (;;)
1176 {
1177 FRAME_PTR w_frame = XFRAME (WINDOW_FRAME (XWINDOW (w)));
1178
1179 /* Pick the next window now, since some operations will delete
1180 the current window. */
1181 next_window = Fnext_window (w, mini ? Qt : Qnil, frame_arg);
1182
1183 /* Note that we do not pay attention here to whether
1184 the frame is visible, since Fnext_window skips non-visible frames
1185 if that is desired, under the control of frame_arg. */
1186 if (! MINI_WINDOW_P (XWINDOW (w))
1187 || (mini && minibuf_level > 0))
1188 switch (type)
1189 {
1190 case GET_BUFFER_WINDOW:
1191 if (XBUFFER (XWINDOW (w)->buffer) == XBUFFER (obj))
1192 return w;
1193 break;
1194
1195 case GET_LRU_WINDOW:
1196 /* t as arg means consider only full-width windows */
1197 if (!NILP (obj) && XFASTINT (XWINDOW (w)->width)
1198 != FRAME_WIDTH (XFRAME (WINDOW_FRAME (XWINDOW (w)))))
1199 break;
1200 /* Ignore dedicated windows and minibuffers. */
1201 if (MINI_WINDOW_P (XWINDOW (w))
1202 || !NILP (XWINDOW (w)->dedicated))
1203 break;
1204 if (NILP (best_window)
1205 || (XFASTINT (XWINDOW (best_window)->use_time)
1206 > XFASTINT (XWINDOW (w)->use_time)))
1207 best_window = w;
1208 break;
1209
1210 case DELETE_OTHER_WINDOWS:
1211 if (XWINDOW (w) != XWINDOW (obj))
1212 Fdelete_window (w);
1213 break;
1214
1215 case DELETE_BUFFER_WINDOWS:
1216 if (EQ (XWINDOW (w)->buffer, obj))
1217 {
1218 /* If we're deleting the buffer displayed in the only window
1219 on the frame, find a new buffer to display there. */
1220 if (NILP (XWINDOW (w)->parent))
1221 {
1222 Lisp_Object new_buffer = Fother_buffer (obj, Qnil);
1223 if (NILP (new_buffer))
1224 new_buffer
1225 = Fget_buffer_create (build_string ("*scratch*"));
1226 Fset_window_buffer (w, new_buffer);
1227 if (EQ (w, selected_window))
1228 Fset_buffer (XWINDOW (w)->buffer);
1229 }
1230 else
1231 Fdelete_window (w);
1232 }
1233 break;
1234
1235 case GET_LARGEST_WINDOW:
1236 /* Ignore dedicated windows and minibuffers. */
1237 if (MINI_WINDOW_P (XWINDOW (w))
1238 || !NILP (XWINDOW (w)->dedicated))
1239 break;
1240 {
1241 struct window *best_window_ptr = XWINDOW (best_window);
1242 struct window *w_ptr = XWINDOW (w);
1243 if (NILP (best_window) ||
1244 (XFASTINT (w_ptr->height) * XFASTINT (w_ptr->width))
1245 > (XFASTINT (best_window_ptr->height)
1246 * XFASTINT (best_window_ptr->width)))
1247 best_window = w;
1248 }
1249 break;
1250
1251 case UNSHOW_BUFFER:
1252 if (EQ (XWINDOW (w)->buffer, obj))
1253 {
1254 /* Find another buffer to show in this window. */
1255 Lisp_Object another_buffer = Fother_buffer (obj, Qnil);
1256 if (NILP (another_buffer))
1257 another_buffer
1258 = Fget_buffer_create (build_string ("*scratch*"));
1259 Fset_window_buffer (w, another_buffer);
1260 if (EQ (w, selected_window))
1261 Fset_buffer (XWINDOW (w)->buffer);
1262 }
1263 break;
1264 }
1265
1266 if (EQ (w, last_window))
1267 break;
1268
1269 w = next_window;
1270 }
1271
1272 return best_window;
1273 }
1274
1275 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 1, 0,
1276 "Return the window least recently selected or used for display.\n\
1277 If optional argument FRAME is `visible', search all visible frames.\n\
1278 If FRAME is t, search all frames.\n\
1279 If FRAME is nil, search only the selected frame.\n\
1280 If FRAME is a frame, search only that frame.")
1281 (frame)
1282 Lisp_Object frame;
1283 {
1284 register Lisp_Object w;
1285 /* First try for a window that is full-width */
1286 w = window_loop (GET_LRU_WINDOW, Qt, 0, frame);
1287 if (!NILP (w) && !EQ (w, selected_window))
1288 return w;
1289 /* If none of them, try the rest */
1290 return window_loop (GET_LRU_WINDOW, Qnil, 0, frame);
1291 }
1292
1293 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 1, 0,
1294 "Return the largest window in area.\n\
1295 If optional argument FRAME is `visible', search all visible frames.\n\
1296 If FRAME is t, search all frames.\n\
1297 If FRAME is nil, search only the selected frame.\n\
1298 If FRAME is a frame, search only that frame.")
1299 (frame)
1300 Lisp_Object frame;
1301 {
1302 return window_loop (GET_LARGEST_WINDOW, Qnil, 0,
1303 frame);
1304 }
1305
1306 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
1307 "Return a window currently displaying BUFFER, or nil if none.\n\
1308 If optional argument FRAME is `visible', search all visible frames.\n\
1309 If FRAME is t, search all frames.\n\
1310 If FRAME is nil, search only the selected frame.\n\
1311 If FRAME is a frame, search only that frame.")
1312 (buffer, frame)
1313 Lisp_Object buffer, frame;
1314 {
1315 buffer = Fget_buffer (buffer);
1316 if (XTYPE (buffer) == Lisp_Buffer)
1317 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
1318 else
1319 return Qnil;
1320 }
1321
1322 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
1323 0, 1, "",
1324 "Make WINDOW (or the selected window) fill its frame.\n\
1325 Only the frame WINDOW is on is affected.\n\
1326 This function tries to reduce display jumps\n\
1327 by keeping the text previously visible in WINDOW\n\
1328 in the same place on the frame. Doing this depends on\n\
1329 the value of (window-start WINDOW), so if calling this function\n\
1330 in a program gives strange scrolling, make sure the window-start\n\
1331 value is reasonable when this function is called.")
1332 (window)
1333 Lisp_Object window;
1334 {
1335 struct window *w;
1336 struct buffer *obuf = current_buffer;
1337 int opoint;
1338 int top;
1339
1340 if (NILP (window))
1341 window = selected_window;
1342 else
1343 CHECK_LIVE_WINDOW (window, 0);
1344
1345 w = XWINDOW (window);
1346 top = XFASTINT (w->top);
1347
1348 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
1349
1350 Fset_buffer (w->buffer);
1351 opoint = point;
1352 SET_PT (marker_position (w->start));
1353 /* Like Frecenter but avoid setting w->force_start. */
1354 Fvertical_motion (make_number (- (top - FRAME_MENU_BAR_LINES (XFRAME (WINDOW_FRAME (w))))),
1355 window);
1356 Fset_marker (w->start, make_number (PT), w->buffer);
1357 w->start_at_line_beg = Fbolp ();
1358
1359 SET_PT (opoint);
1360 set_buffer_internal (obuf);
1361 return Qnil;
1362 }
1363
1364 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
1365 1, 2, "bDelete windows on (buffer): ",
1366 "Delete all windows showing BUFFER.\n\
1367 Optional second argument FRAME controls which frames are affected.\n\
1368 If nil or omitted, delete all windows showing BUFFER in any frame.\n\
1369 If t, delete only windows showing BUFFER in the selected frame.\n\
1370 If `visible', delete all windows showing BUFFER in any visible frame.\n\
1371 If a frame, delete only windows showing BUFFER in that frame.")
1372 (buffer, frame)
1373 Lisp_Object buffer, frame;
1374 {
1375 #ifdef MULTI_FRAME
1376 /* FRAME uses t and nil to mean the opposite of what window_loop
1377 expects. */
1378 if (! FRAMEP (frame))
1379 frame = NILP (frame) ? Qt : Qnil;
1380 #else
1381 frame = Qt;
1382 #endif
1383
1384 if (!NILP (buffer))
1385 {
1386 buffer = Fget_buffer (buffer);
1387 CHECK_BUFFER (buffer, 0);
1388 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
1389 }
1390 return Qnil;
1391 }
1392
1393 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
1394 Sreplace_buffer_in_windows,
1395 1, 1, "bReplace buffer in windows: ",
1396 "Replace BUFFER with some other buffer in all windows showing it.")
1397 (buffer)
1398 Lisp_Object buffer;
1399 {
1400 if (!NILP (buffer))
1401 {
1402 buffer = Fget_buffer (buffer);
1403 CHECK_BUFFER (buffer, 0);
1404 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
1405 }
1406 return Qnil;
1407 }
1408 \f
1409 /* Set the height of WINDOW and all its inferiors. */
1410
1411 /* The smallest acceptable dimensions for a window. Anything smaller
1412 might crash Emacs. */
1413 #define MIN_SAFE_WINDOW_WIDTH (2)
1414 #define MIN_SAFE_WINDOW_HEIGHT (2)
1415
1416 /* Make sure that window_min_height and window_min_width are
1417 not too small; if they are, set them to safe minima. */
1418
1419 static void
1420 check_min_window_sizes ()
1421 {
1422 /* Smaller values might permit a crash. */
1423 if (window_min_width < MIN_SAFE_WINDOW_WIDTH)
1424 window_min_width = MIN_SAFE_WINDOW_WIDTH;
1425 if (window_min_height < MIN_SAFE_WINDOW_HEIGHT)
1426 window_min_height = MIN_SAFE_WINDOW_HEIGHT;
1427 }
1428
1429 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
1430 minimum allowable size. */
1431 void
1432 check_frame_size (frame, rows, cols)
1433 FRAME_PTR frame;
1434 int *rows, *cols;
1435 {
1436 /* For height, we have to see:
1437 whether the frame has a minibuffer,
1438 whether it wants a mode line, and
1439 whether it has a menu bar. */
1440 int min_height =
1441 (FRAME_MINIBUF_ONLY_P (frame) ? MIN_SAFE_WINDOW_HEIGHT - 1
1442 : (! FRAME_HAS_MINIBUF_P (frame)) ? MIN_SAFE_WINDOW_HEIGHT
1443 : 2 * MIN_SAFE_WINDOW_HEIGHT - 1);
1444 if (FRAME_MENU_BAR_LINES (frame) > 0)
1445 min_height += FRAME_MENU_BAR_LINES (frame);
1446
1447 if (*rows < min_height)
1448 *rows = min_height;
1449 if (*cols < MIN_SAFE_WINDOW_WIDTH)
1450 *cols = MIN_SAFE_WINDOW_WIDTH;
1451 }
1452
1453 /* Normally the window is deleted if it gets too small.
1454 nodelete nonzero means do not do this.
1455 (The caller should check later and do so if appropriate) */
1456
1457 set_window_height (window, height, nodelete)
1458 Lisp_Object window;
1459 int height;
1460 int nodelete;
1461 {
1462 register struct window *w = XWINDOW (window);
1463 register struct window *c;
1464 int oheight = XFASTINT (w->height);
1465 int top, pos, lastbot, opos, lastobot;
1466 Lisp_Object child;
1467
1468 check_min_window_sizes ();
1469
1470 if (!nodelete
1471 && ! NILP (w->parent)
1472 && height < window_min_height)
1473 {
1474 Fdelete_window (window);
1475 return;
1476 }
1477
1478 XFASTINT (w->last_modified) = 0;
1479 windows_or_buffers_changed++;
1480 XFASTINT (w->height) = height;
1481 if (!NILP (w->hchild))
1482 {
1483 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1484 {
1485 XWINDOW (child)->top = w->top;
1486 set_window_height (child, height, nodelete);
1487 }
1488 }
1489 else if (!NILP (w->vchild))
1490 {
1491 lastbot = top = XFASTINT (w->top);
1492 lastobot = 0;
1493 for (child = w->vchild; !NILP (child); child = c->next)
1494 {
1495 c = XWINDOW (child);
1496
1497 opos = lastobot + XFASTINT (c->height);
1498
1499 XFASTINT (c->top) = lastbot;
1500
1501 pos = (((opos * height) << 1) + oheight) / (oheight << 1);
1502
1503 /* Avoid confusion: inhibit deletion of child if becomes too small */
1504 set_window_height (child, pos + top - lastbot, 1);
1505
1506 /* Now advance child to next window,
1507 and set lastbot if child was not just deleted. */
1508 lastbot = pos + top;
1509 lastobot = opos;
1510 }
1511 /* Now delete any children that became too small. */
1512 if (!nodelete)
1513 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1514 {
1515 set_window_height (child, XINT (XWINDOW (child)->height), 0);
1516 }
1517 }
1518 }
1519
1520 /* Recursively set width of WINDOW and its inferiors. */
1521
1522 set_window_width (window, width, nodelete)
1523 Lisp_Object window;
1524 int width;
1525 int nodelete;
1526 {
1527 register struct window *w = XWINDOW (window);
1528 register struct window *c;
1529 int owidth = XFASTINT (w->width);
1530 int left, pos, lastright, opos, lastoright;
1531 Lisp_Object child;
1532
1533 if (!nodelete && width < window_min_width)
1534 {
1535 Fdelete_window (window);
1536 return;
1537 }
1538
1539 XFASTINT (w->last_modified) = 0;
1540 windows_or_buffers_changed++;
1541 XFASTINT (w->width) = width;
1542 if (!NILP (w->vchild))
1543 {
1544 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1545 {
1546 XWINDOW (child)->left = w->left;
1547 set_window_width (child, width, nodelete);
1548 }
1549 }
1550 else if (!NILP (w->hchild))
1551 {
1552 lastright = left = XFASTINT (w->left);
1553 lastoright = 0;
1554 for (child = w->hchild; !NILP (child); child = c->next)
1555 {
1556 c = XWINDOW (child);
1557
1558 opos = lastoright + XFASTINT (c->width);
1559
1560 XFASTINT (c->left) = lastright;
1561
1562 pos = (((opos * width) << 1) + owidth) / (owidth << 1);
1563
1564 /* Inhibit deletion for becoming too small */
1565 set_window_width (child, pos + left - lastright, 1);
1566
1567 /* Now advance child to next window,
1568 and set lastright if child was not just deleted. */
1569 lastright = pos + left, lastoright = opos;
1570 }
1571 /* Delete children that became too small */
1572 if (!nodelete)
1573 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1574 {
1575 set_window_width (child, XINT (XWINDOW (child)->width), 0);
1576 }
1577 }
1578 }
1579 \f
1580 int window_select_count;
1581
1582 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 2, 0,
1583 "Make WINDOW display BUFFER as its contents.\n\
1584 BUFFER can be a buffer or buffer name.")
1585 (window, buffer)
1586 register Lisp_Object window, buffer;
1587 {
1588 register Lisp_Object tem;
1589 register struct window *w = decode_window (window);
1590
1591 buffer = Fget_buffer (buffer);
1592 CHECK_BUFFER (buffer, 1);
1593
1594 if (NILP (XBUFFER (buffer)->name))
1595 error ("Attempt to display deleted buffer");
1596
1597 tem = w->buffer;
1598 if (NILP (tem))
1599 error ("Window is deleted");
1600 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
1601 is first being set up. */
1602 {
1603 if (!NILP (w->dedicated) && !EQ (tem, buffer))
1604 error ("Window is dedicated to %s\n", tem);
1605
1606 unshow_buffer (w);
1607 }
1608
1609 w->buffer = buffer;
1610 w->window_end_pos = 0;
1611 w->window_end_valid = Qnil;
1612 w->hscroll = 0;
1613 Fset_marker (w->pointm,
1614 make_number (BUF_PT (XBUFFER (buffer))),
1615 buffer);
1616 set_marker_restricted (w->start,
1617 make_number (XBUFFER (buffer)->last_window_start),
1618 buffer);
1619 w->start_at_line_beg = Qnil;
1620 w->force_start = Qnil;
1621 XFASTINT (w->last_modified) = 0;
1622 windows_or_buffers_changed++;
1623 if (EQ (window, selected_window))
1624 Fset_buffer (buffer);
1625
1626 return Qnil;
1627 }
1628
1629 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 1, 0,
1630 "Select WINDOW. Most editing will apply to WINDOW's buffer.\n\
1631 The main editor command loop selects the buffer of the selected window\n\
1632 before each command.")
1633 (window)
1634 register Lisp_Object window;
1635 {
1636 register struct window *w;
1637 register struct window *ow = XWINDOW (selected_window);
1638
1639 CHECK_LIVE_WINDOW (window, 0);
1640
1641 w = XWINDOW (window);
1642
1643 if (NILP (w->buffer))
1644 error ("Trying to select deleted window or non-leaf window");
1645
1646 XFASTINT (w->use_time) = ++window_select_count;
1647 if (EQ (window, selected_window))
1648 return window;
1649
1650 Fset_marker (ow->pointm, make_number (BUF_PT (XBUFFER (ow->buffer))),
1651 ow->buffer);
1652
1653 selected_window = window;
1654 #ifdef MULTI_FRAME
1655 if (XFRAME (WINDOW_FRAME (w)) != selected_frame)
1656 {
1657 XFRAME (WINDOW_FRAME (w))->selected_window = window;
1658 Fhandle_switch_frame (WINDOW_FRAME (w), Qnil);
1659 }
1660 else
1661 selected_frame->selected_window = window;
1662 #endif
1663
1664 record_buffer (w->buffer);
1665 Fset_buffer (w->buffer);
1666
1667 /* Go to the point recorded in the window.
1668 This is important when the buffer is in more
1669 than one window. It also matters when
1670 redisplay_window has altered point after scrolling,
1671 because it makes the change only in the window. */
1672 {
1673 register int new_point = marker_position (w->pointm);
1674 if (new_point < BEGV)
1675 SET_PT (BEGV);
1676 if (new_point > ZV)
1677 SET_PT (ZV);
1678 else
1679 SET_PT (new_point);
1680 }
1681
1682 windows_or_buffers_changed++;
1683 return window;
1684 }
1685
1686 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 2,
1687 "BDisplay buffer: \nP",
1688 "Make BUFFER appear in some window but don't select it.\n\
1689 BUFFER can be a buffer or a buffer name.\n\
1690 If BUFFER is shown already in some window, just use that one,\n\
1691 unless the window is the selected window and the optional second\n\
1692 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).\n\
1693 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.\n\
1694 Returns the window displaying BUFFER.")
1695 (buffer, not_this_window)
1696 register Lisp_Object buffer, not_this_window;
1697 {
1698 register Lisp_Object window;
1699
1700 buffer = Fget_buffer (buffer);
1701 CHECK_BUFFER (buffer, 0);
1702
1703 if (!NILP (Vdisplay_buffer_function))
1704 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
1705
1706 if (NILP (not_this_window)
1707 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
1708 return selected_window;
1709
1710 /* If pop_up_frames,
1711 look for a window showing BUFFER on any visible frame. */
1712 window = Fget_buffer_window (buffer, pop_up_frames ? Qvisible : Qnil);
1713 if (!NILP (window)
1714 && (NILP (not_this_window) || !EQ (window, selected_window)))
1715 return window;
1716
1717 #ifdef MULTI_FRAME
1718 /* If there are no frames open that have more than a minibuffer,
1719 we need to create a new frame. */
1720 if (pop_up_frames || last_nonminibuf_frame == 0)
1721 {
1722 window
1723 = Fframe_selected_window (call0 (Vpop_up_frame_function));
1724 Fset_window_buffer (window, buffer);
1725 #if 0
1726 Fhandle_switch_frame (XWINDOW (window)->frame, Qnil);
1727 #endif
1728 return window;
1729 }
1730 #endif /* MULTI_FRAME */
1731
1732 if (pop_up_windows
1733 #ifdef MULTI_FRAME
1734 || FRAME_MINIBUF_ONLY_P (selected_frame)
1735 #endif
1736 )
1737 {
1738 Lisp_Object frames = Qnil;
1739
1740 #ifdef MULTI_FRAME
1741 if (FRAME_MINIBUF_ONLY_P (selected_frame))
1742 XSET (frames, Lisp_Frame, last_nonminibuf_frame);
1743 #endif
1744 /* Don't try to create a window if would get an error */
1745 if (split_height_threshold < window_min_height << 1)
1746 split_height_threshold = window_min_height << 1;
1747
1748 window = Fget_largest_window (frames);
1749
1750 if (!NILP (window)
1751 && window_height (window) >= split_height_threshold
1752 && (XFASTINT (XWINDOW (window)->width)
1753 == FRAME_WIDTH (XFRAME (WINDOW_FRAME (XWINDOW (window))))))
1754 window = Fsplit_window (window, Qnil, Qnil);
1755 else
1756 {
1757 window = Fget_lru_window (frames);
1758 if ((EQ (window, selected_window)
1759 || EQ (XWINDOW (window)->parent, Qnil))
1760 && window_height (window) >= window_min_height << 1)
1761 window = Fsplit_window (window, Qnil, Qnil);
1762 }
1763 }
1764 else
1765 window = Fget_lru_window (Qnil);
1766
1767 Fset_window_buffer (window, buffer);
1768 return window;
1769 }
1770
1771 void
1772 temp_output_buffer_show (buf)
1773 register Lisp_Object buf;
1774 {
1775 register struct buffer *old = current_buffer;
1776 register Lisp_Object window;
1777 register struct window *w;
1778
1779 Fset_buffer (buf);
1780 XBUFFER (buf)->save_modified = MODIFF;
1781 BEGV = BEG;
1782 ZV = Z;
1783 SET_PT (BEG);
1784 clip_changed = 1;
1785 set_buffer_internal (old);
1786
1787 if (!EQ (Vtemp_buffer_show_function, Qnil))
1788 call1 (Vtemp_buffer_show_function, buf);
1789 else
1790 {
1791 window = Fdisplay_buffer (buf, Qnil);
1792
1793 #ifdef MULTI_FRAME
1794 if (XFRAME (XWINDOW (window)->frame) != selected_frame)
1795 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
1796 #endif /* MULTI_FRAME */
1797 Vminibuf_scroll_window = window;
1798 w = XWINDOW (window);
1799 XFASTINT (w->hscroll) = 0;
1800 set_marker_restricted (w->start, make_number (1), buf);
1801 set_marker_restricted (w->pointm, make_number (1), buf);
1802 }
1803 }
1804 \f
1805 static
1806 make_dummy_parent (window)
1807 Lisp_Object window;
1808 {
1809 register Lisp_Object old, new;
1810 register struct window *o, *p;
1811
1812 old = window;
1813 XSETTYPE (old, Lisp_Vector);
1814 new = Fcopy_sequence (old);
1815 XSETTYPE (new, Lisp_Window);
1816
1817 o = XWINDOW (old);
1818 p = XWINDOW (new);
1819 XFASTINT (p->sequence_number) = ++sequence_number;
1820
1821 /* Put new into window structure in place of window */
1822 replace_window (window, new);
1823
1824 o->next = Qnil;
1825 o->prev = Qnil;
1826 o->vchild = Qnil;
1827 o->hchild = Qnil;
1828 o->parent = new;
1829
1830 p->start = Qnil;
1831 p->pointm = Qnil;
1832 p->buffer = Qnil;
1833 }
1834
1835 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
1836 "Split WINDOW, putting SIZE lines in the first of the pair.\n\
1837 WINDOW defaults to selected one and SIZE to half its size.\n\
1838 If optional third arg HOR-FLAG is non-nil, split side by side\n\
1839 and put SIZE columns in the first of the pair.")
1840 (window, chsize, horflag)
1841 Lisp_Object window, chsize, horflag;
1842 {
1843 register Lisp_Object new;
1844 register struct window *o, *p;
1845 register int size;
1846
1847 if (NILP (window))
1848 window = selected_window;
1849 else
1850 CHECK_LIVE_WINDOW (window, 0);
1851
1852 o = XWINDOW (window);
1853
1854 if (NILP (chsize))
1855 {
1856 if (!NILP (horflag))
1857 /* Round odd size up, since this is for the left-hand window,
1858 and it will lose a column for the separators. */
1859 size = ((XFASTINT (o->width) + 1) & -2) >> 1;
1860 else
1861 size = XFASTINT (o->height) >> 1;
1862 }
1863 else
1864 {
1865 CHECK_NUMBER (chsize, 1);
1866 size = XINT (chsize);
1867 }
1868
1869 if (MINI_WINDOW_P (o))
1870 error ("Attempt to split minibuffer window");
1871 else if (FRAME_NO_SPLIT_P (XFRAME (WINDOW_FRAME (o))))
1872 error ("Attempt to split unsplittable frame");
1873
1874 check_min_window_sizes ();
1875
1876 if (NILP (horflag))
1877 {
1878 if (size < window_min_height
1879 || size + window_min_height > XFASTINT (o->height))
1880 args_out_of_range_3 (window, chsize, horflag);
1881 if (NILP (o->parent)
1882 || NILP (XWINDOW (o->parent)->vchild))
1883 {
1884 make_dummy_parent (window);
1885 new = o->parent;
1886 XWINDOW (new)->vchild = window;
1887 }
1888 }
1889 else
1890 {
1891 if (size < window_min_width
1892 || size + window_min_width > XFASTINT (o->width))
1893 args_out_of_range_3 (window, chsize, horflag);
1894 if (NILP (o->parent)
1895 || NILP (XWINDOW (o->parent)->hchild))
1896 {
1897 make_dummy_parent (window);
1898 new = o->parent;
1899 XWINDOW (new)->hchild = window;
1900 }
1901 }
1902
1903 /* Now we know that window's parent is a vertical combination
1904 if we are dividing vertically, or a horizontal combination
1905 if we are making side-by-side windows */
1906
1907 windows_or_buffers_changed++;
1908 new = make_window ();
1909 p = XWINDOW (new);
1910
1911 p->frame = o->frame;
1912 p->next = o->next;
1913 if (!NILP (p->next))
1914 XWINDOW (p->next)->prev = new;
1915 p->prev = window;
1916 o->next = new;
1917 p->parent = o->parent;
1918 p->buffer = Qt;
1919
1920 Fset_window_buffer (new, o->buffer);
1921
1922 /* Apportion the available frame space among the two new windows */
1923
1924 if (!NILP (horflag))
1925 {
1926 p->height = o->height;
1927 p->top = o->top;
1928 XFASTINT (p->width) = XFASTINT (o->width) - size;
1929 XFASTINT (o->width) = size;
1930 XFASTINT (p->left) = XFASTINT (o->left) + size;
1931 }
1932 else
1933 {
1934 p->left = o->left;
1935 p->width = o->width;
1936 XFASTINT (p->height) = XFASTINT (o->height) - size;
1937 XFASTINT (o->height) = size;
1938 XFASTINT (p->top) = XFASTINT (o->top) + size;
1939 }
1940
1941 return new;
1942 }
1943 \f
1944 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 2, "p",
1945 "Make current window ARG lines bigger.\n\
1946 From program, optional second arg non-nil means grow sideways ARG columns.")
1947 (n, side)
1948 register Lisp_Object n, side;
1949 {
1950 CHECK_NUMBER (n, 0);
1951 change_window_height (XINT (n), !NILP (side));
1952 return Qnil;
1953 }
1954
1955 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
1956 "Make current window ARG lines smaller.\n\
1957 From program, optional second arg non-nil means shrink sideways ARG columns.")
1958 (n, side)
1959 register Lisp_Object n, side;
1960 {
1961 CHECK_NUMBER (n, 0);
1962 change_window_height (-XINT (n), !NILP (side));
1963 return Qnil;
1964 }
1965
1966 int
1967 window_height (window)
1968 Lisp_Object window;
1969 {
1970 register struct window *p = XWINDOW (window);
1971 return XFASTINT (p->height);
1972 }
1973
1974 int
1975 window_width (window)
1976 Lisp_Object window;
1977 {
1978 register struct window *p = XWINDOW (window);
1979 return XFASTINT (p->width);
1980 }
1981
1982 #define MINSIZE(w) \
1983 (widthflag \
1984 ? window_min_width \
1985 : (MINI_WINDOW_P (XWINDOW (w)) ? 1 : window_min_height))
1986
1987 #define CURBEG(w) \
1988 *(widthflag ? (int *) &(XWINDOW (w)->left) : (int *) &(XWINDOW (w)->top))
1989
1990 #define CURSIZE(w) \
1991 *(widthflag ? (int *) &(XWINDOW (w)->width) : (int *) &(XWINDOW (w)->height))
1992
1993 /* Unlike set_window_height, this function
1994 also changes the heights of the siblings so as to
1995 keep everything consistent. */
1996
1997 change_window_height (delta, widthflag)
1998 register int delta;
1999 int widthflag;
2000 {
2001 register Lisp_Object parent;
2002 Lisp_Object window;
2003 register struct window *p;
2004 int *sizep;
2005 int (*sizefun) () = widthflag ? window_width : window_height;
2006 register int (*setsizefun) () = (widthflag
2007 ? set_window_width
2008 : set_window_height);
2009
2010 check_min_window_sizes ();
2011
2012 window = selected_window;
2013 while (1)
2014 {
2015 p = XWINDOW (window);
2016 parent = p->parent;
2017 if (NILP (parent))
2018 {
2019 if (widthflag)
2020 error ("No other window to side of this one");
2021 break;
2022 }
2023 if (widthflag ? !NILP (XWINDOW (parent)->hchild)
2024 : !NILP (XWINDOW (parent)->vchild))
2025 break;
2026 window = parent;
2027 }
2028
2029 sizep = &CURSIZE (window);
2030
2031 if (*sizep + delta < MINSIZE (window))
2032 {
2033 Fdelete_window (window);
2034 return;
2035 }
2036
2037 {
2038 register int maxdelta;
2039
2040 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - *sizep
2041 : !NILP (p->next) ? (*sizefun) (p->next) - MINSIZE (p->next)
2042 : !NILP (p->prev) ? (*sizefun) (p->prev) - MINSIZE (p->prev)
2043 /* This is a frame with only one window, a minibuffer-only
2044 or a minibufferless frame. */
2045 : (delta = 0));
2046
2047 if (delta > maxdelta)
2048 /* This case traps trying to make the minibuffer
2049 the full frame, or make the only window aside from the
2050 minibuffer the full frame. */
2051 delta = maxdelta;
2052
2053 if (delta == 0)
2054 return;
2055 }
2056
2057 if (!NILP (p->next) &&
2058 (*sizefun) (p->next) - delta >= MINSIZE (p->next))
2059 {
2060 (*setsizefun) (p->next, (*sizefun) (p->next) - delta, 0);
2061 (*setsizefun) (window, *sizep + delta, 0);
2062 CURBEG (p->next) += delta;
2063 /* This does not change size of p->next,
2064 but it propagates the new top edge to its children */
2065 (*setsizefun) (p->next, (*sizefun) (p->next), 0);
2066 }
2067 else if (!NILP (p->prev) &&
2068 (*sizefun) (p->prev) - delta >= MINSIZE (p->prev))
2069 {
2070 (*setsizefun) (p->prev, (*sizefun) (p->prev) - delta, 0);
2071 CURBEG (window) -= delta;
2072 (*setsizefun) (window, *sizep + delta, 0);
2073 }
2074 else
2075 {
2076 register int delta1;
2077 register int opht = (*sizefun) (parent);
2078
2079 /* If trying to grow this window to or beyond size of the parent,
2080 make delta1 so big that, on shrinking back down,
2081 all the siblings end up with less than one line and are deleted. */
2082 if (opht <= *sizep + delta)
2083 delta1 = opht * opht * 2;
2084 /* Otherwise, make delta1 just right so that if we add delta1
2085 lines to this window and to the parent, and then shrink
2086 the parent back to its original size, the new proportional
2087 size of this window will increase by delta. */
2088 else
2089 delta1 = (delta * opht * 100) / ((opht - *sizep - delta) * 100);
2090
2091 /* Add delta1 lines or columns to this window, and to the parent,
2092 keeping things consistent while not affecting siblings. */
2093 CURSIZE (parent) = opht + delta1;
2094 (*setsizefun) (window, *sizep + delta1, 0);
2095
2096 /* Squeeze out delta1 lines or columns from our parent,
2097 shriking this window and siblings proportionately.
2098 This brings parent back to correct size.
2099 Delta1 was calculated so this makes this window the desired size,
2100 taking it all out of the siblings. */
2101 (*setsizefun) (parent, opht, 0);
2102 }
2103
2104 XFASTINT (p->last_modified) = 0;
2105 }
2106 #undef MINSIZE
2107 #undef CURBEG
2108 #undef CURSIZE
2109
2110 \f
2111 /* Return number of lines of text (not counting mode line) in W. */
2112
2113 int
2114 window_internal_height (w)
2115 struct window *w;
2116 {
2117 int ht = XFASTINT (w->height);
2118
2119 if (MINI_WINDOW_P (w))
2120 return ht;
2121
2122 if (!NILP (w->parent) || !NILP (w->vchild) || !NILP (w->hchild)
2123 || !NILP (w->next) || !NILP (w->prev)
2124 || FRAME_WANTS_MODELINE_P (XFRAME (WINDOW_FRAME (w))))
2125 return ht - 1;
2126
2127 return ht;
2128 }
2129
2130
2131 /* Return the number of columns in W.
2132 Don't count columns occupied by scroll bars or the vertical bar
2133 separating W from the sibling to its right. */
2134 int
2135 window_internal_width (w)
2136 struct window *w;
2137 {
2138 FRAME_PTR f = XFRAME (WINDOW_FRAME (w));
2139 int left = XINT (w->left);
2140 int width = XINT (w->width);
2141
2142 /* If this window is flush against the right edge of the frame, its
2143 internal width is its full width. */
2144 if (left + width >= FRAME_WIDTH (f))
2145 return width;
2146
2147 /* If we are not flush right, then our rightmost columns are
2148 occupied by some sort of separator. */
2149
2150 /* Scroll bars occupy a few columns. */
2151 if (FRAME_HAS_VERTICAL_SCROLL_BARS (f))
2152 return width - VERTICAL_SCROLL_BAR_WIDTH;
2153
2154 /* The column of `|' characters separating side-by-side windows
2155 occupies one column only. */
2156 return width - 1;
2157 }
2158
2159
2160 /* Scroll contents of window WINDOW up N lines. */
2161
2162 void
2163 window_scroll (window, n, noerror)
2164 Lisp_Object window;
2165 int n;
2166 int noerror;
2167 {
2168 register struct window *w = XWINDOW (window);
2169 register int opoint = point;
2170 register int pos;
2171 register int ht = window_internal_height (w);
2172 register Lisp_Object tem;
2173 int lose;
2174 Lisp_Object bolp, nmoved;
2175
2176 XFASTINT (tem) = point;
2177 tem = Fpos_visible_in_window_p (tem, window);
2178
2179 if (NILP (tem))
2180 {
2181 Fvertical_motion (make_number (- (ht / 2)), window);
2182 XFASTINT (tem) = point;
2183 Fset_marker (w->start, tem, w->buffer);
2184 w->force_start = Qt;
2185 }
2186
2187 SET_PT (marker_position (w->start));
2188 lose = n < 0 && point == BEGV;
2189 Fvertical_motion (make_number (n), window);
2190 pos = point;
2191 bolp = Fbolp ();
2192 SET_PT (opoint);
2193
2194 if (lose)
2195 {
2196 if (noerror)
2197 return;
2198 else
2199 Fsignal (Qbeginning_of_buffer, Qnil);
2200 }
2201
2202 if (pos < ZV)
2203 {
2204 set_marker_restricted (w->start, make_number (pos), w->buffer);
2205 w->start_at_line_beg = bolp;
2206 w->update_mode_line = Qt;
2207 XFASTINT (w->last_modified) = 0;
2208 if (pos > opoint)
2209 SET_PT (pos);
2210 if (n < 0)
2211 {
2212 SET_PT (pos);
2213 tem = Fvertical_motion (make_number (ht), window);
2214 if (point > opoint || XFASTINT (tem) < ht)
2215 SET_PT (opoint);
2216 else
2217 Fvertical_motion (make_number (-1), window);
2218 }
2219 }
2220 else
2221 {
2222 if (noerror)
2223 return;
2224 else
2225 Fsignal (Qend_of_buffer, Qnil);
2226 }
2227 }
2228 \f
2229 /* This is the guts of Fscroll_up and Fscroll_down. */
2230
2231 static void
2232 scroll_command (n, direction)
2233 register Lisp_Object n;
2234 int direction;
2235 {
2236 register int defalt;
2237 int count = specpdl_ptr - specpdl;
2238
2239 /* If selected window's buffer isn't current, make it current for the moment.
2240 But don't screw up if window_scroll gets an error. */
2241 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
2242 {
2243 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2244 Fset_buffer (XWINDOW (selected_window)->buffer);
2245 }
2246
2247 defalt = (window_internal_height (XWINDOW (selected_window))
2248 - next_screen_context_lines);
2249 defalt = direction * (defalt < 1 ? 1 : defalt);
2250
2251 if (NILP (n))
2252 window_scroll (selected_window, defalt, 0);
2253 else if (EQ (n, Qminus))
2254 window_scroll (selected_window, - defalt, 0);
2255 else
2256 {
2257 n = Fprefix_numeric_value (n);
2258 window_scroll (selected_window, XINT (n) * direction, 0);
2259 }
2260
2261 unbind_to (count, Qnil);
2262 }
2263
2264 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
2265 "Scroll text of current window upward ARG lines; or near full screen if no ARG.\n\
2266 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2267 When calling from a program, supply a number as argument or nil.")
2268 (n)
2269 Lisp_Object n;
2270 {
2271 scroll_command (n, 1);
2272 return Qnil;
2273 }
2274
2275 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
2276 "Scroll text of current window downward ARG lines; or near full screen if no ARG.\n\
2277 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2278 When calling from a program, supply a number as argument or nil.")
2279 (n)
2280 Lisp_Object n;
2281 {
2282 scroll_command (n, -1);
2283 return Qnil;
2284 }
2285
2286 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
2287 "Scroll next window upward ARG lines; or near full screen if no ARG.\n\
2288 The next window is the one below the current one; or the one at the top\n\
2289 if the current one is at the bottom.\n\
2290 When calling from a program, supply a number as argument or nil.\n\
2291 \n\
2292 If in the minibuffer, `minibuffer-scroll-window' if non-nil\n\
2293 specifies the window to scroll.\n\
2294 If `other-window-scroll-buffer' is non-nil, scroll the window\n\
2295 showing that buffer, popping the buffer up if necessary.")
2296 (n)
2297 register Lisp_Object n;
2298 {
2299 register Lisp_Object window;
2300 register int ht;
2301 register struct window *w;
2302 register int count = specpdl_ptr - specpdl;
2303
2304 if (MINI_WINDOW_P (XWINDOW (selected_window))
2305 && !NILP (Vminibuf_scroll_window))
2306 window = Vminibuf_scroll_window;
2307 /* If buffer is specified, scroll that buffer. */
2308 else if (!NILP (Vother_window_scroll_buffer))
2309 {
2310 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
2311 if (NILP (window))
2312 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt);
2313 }
2314 else
2315 {
2316 /* Nothing specified; look for a neighboring window on the same
2317 frame. */
2318 window = Fnext_window (selected_window, Qnil, Qnil);
2319
2320 if (EQ (window, selected_window))
2321 /* That didn't get us anywhere; look for a window on another
2322 visible frame. */
2323 do
2324 window = Fnext_window (window, Qnil, Qt);
2325 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
2326 && ! EQ (window, selected_window));
2327 }
2328
2329 CHECK_LIVE_WINDOW (window, 0);
2330
2331 if (EQ (window, selected_window))
2332 error ("There is no other window");
2333
2334 w = XWINDOW (window);
2335 ht = window_internal_height (w);
2336
2337 /* Don't screw up if window_scroll gets an error. */
2338 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2339
2340 Fset_buffer (w->buffer);
2341 SET_PT (marker_position (w->pointm));
2342
2343 if (NILP (n))
2344 window_scroll (window, ht - next_screen_context_lines, 1);
2345 else if (EQ (n, Qminus))
2346 window_scroll (window, next_screen_context_lines - ht, 1);
2347 else
2348 {
2349 if (XTYPE (n) == Lisp_Cons)
2350 n = Fcar (n);
2351 CHECK_NUMBER (n, 0);
2352 window_scroll (window, XINT (n), 1);
2353 }
2354
2355 Fset_marker (w->pointm, make_number (point), Qnil);
2356 unbind_to (count, Qnil);
2357
2358 return Qnil;
2359 }
2360 \f
2361 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 1, "P",
2362 "Scroll selected window display ARG columns left.\n\
2363 Default for ARG is window width minus 2.")
2364 (arg)
2365 register Lisp_Object arg;
2366 {
2367
2368 if (NILP (arg))
2369 XFASTINT (arg) = window_internal_width (XWINDOW (selected_window)) - 2;
2370 else
2371 arg = Fprefix_numeric_value (arg);
2372
2373 return
2374 Fset_window_hscroll (selected_window,
2375 make_number (XINT (XWINDOW (selected_window)->hscroll)
2376 + XINT (arg)));
2377 }
2378
2379 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 1, "P",
2380 "Scroll selected window display ARG columns right.\n\
2381 Default for ARG is window width minus 2.")
2382 (arg)
2383 register Lisp_Object arg;
2384 {
2385 if (NILP (arg))
2386 XFASTINT (arg) = window_internal_width (XWINDOW (selected_window)) - 2;
2387 else
2388 arg = Fprefix_numeric_value (arg);
2389
2390 return
2391 Fset_window_hscroll (selected_window,
2392 make_number (XINT (XWINDOW (selected_window)->hscroll)
2393 - XINT (arg)));
2394 }
2395
2396 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
2397 "Center point in window and redisplay frame. With ARG, put point on line ARG.\n\
2398 The desired position of point is always relative to the current window.\n\
2399 Just C-u as prefix means put point in the center of the window.\n\
2400 No arg (i.e., it is nil) erases the entire frame and then\n\
2401 redraws with point in the center of the current window.")
2402 (n)
2403 register Lisp_Object n;
2404 {
2405 register struct window *w = XWINDOW (selected_window);
2406 register int ht = window_internal_height (w);
2407 register int opoint = point;
2408 Lisp_Object window;
2409
2410 if (NILP (n))
2411 {
2412 extern int frame_garbaged;
2413
2414 SET_FRAME_GARBAGED (XFRAME (WINDOW_FRAME (w)));
2415 XFASTINT (n) = ht / 2;
2416 }
2417 else if (XTYPE (n) == Lisp_Cons) /* Just C-u. */
2418 {
2419 XFASTINT (n) = ht / 2;
2420 }
2421 else
2422 {
2423 n = Fprefix_numeric_value (n);
2424 CHECK_NUMBER (n, 0);
2425 }
2426
2427 if (XINT (n) < 0)
2428 XSETINT (n, XINT (n) + ht);
2429
2430 XSETINT (n, - XINT (n));
2431
2432 XSET (window, Lisp_Window, w);
2433 Fvertical_motion (n, window);
2434 Fset_marker (w->start, make_number (point), w->buffer);
2435 w->start_at_line_beg = Fbolp ();
2436
2437 SET_PT (opoint);
2438 w->force_start = Qt;
2439
2440 return Qnil;
2441 }
2442 \f
2443 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
2444 1, 1, "P",
2445 "Position point relative to window.\n\
2446 With no argument, position text at center of window.\n\
2447 An argument specifies frame line; zero means top of window,\n\
2448 negative means relative to bottom of window.")
2449 (arg)
2450 register Lisp_Object arg;
2451 {
2452 register struct window *w = XWINDOW (selected_window);
2453 register int height = window_internal_height (w);
2454 register int start;
2455 Lisp_Object window;
2456
2457 if (NILP (arg))
2458 XFASTINT (arg) = height / 2;
2459 else
2460 {
2461 arg = Fprefix_numeric_value (arg);
2462 if (XINT (arg) < 0)
2463 XSETINT (arg, XINT (arg) + height);
2464 }
2465
2466 start = marker_position (w->start);
2467 XSET (window, Lisp_Window, w);
2468 if (start < BEGV || start > ZV)
2469 {
2470 Fvertical_motion (make_number (- (height / 2)), window);
2471 Fset_marker (w->start, make_number (point), w->buffer);
2472 w->start_at_line_beg = Fbolp ();
2473 w->force_start = Qt;
2474 }
2475 else
2476 SET_PT (start);
2477
2478 return Fvertical_motion (arg, window);
2479 }
2480 \f
2481 struct save_window_data
2482 {
2483 int size_from_Lisp_Vector_struct;
2484 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2485 Lisp_Object frame_width, frame_height, frame_menu_bar_lines;
2486 Lisp_Object selected_frame;
2487 Lisp_Object current_window;
2488 Lisp_Object current_buffer;
2489 Lisp_Object minibuf_scroll_window;
2490 Lisp_Object root_window;
2491 Lisp_Object focus_frame;
2492 /* A vector, interpreted as a struct saved_window */
2493 Lisp_Object saved_windows;
2494 };
2495
2496 /* Arg to Fmake_vector */
2497 #define SAVE_WINDOW_DATA_SIZE \
2498 ((sizeof (struct save_window_data) \
2499 - (sizeof (struct Lisp_Vector) \
2500 /* Don't count the contents member of the struct Lisp_Vector */ \
2501 - sizeof (Lisp_Object))) \
2502 / sizeof (Lisp_Object))
2503
2504 /* This is saved as a Lisp_Vector */
2505 struct saved_window
2506 {
2507 /* these first two must agree with struct Lisp_Vector in lisp.h */
2508 int size_from_Lisp_Vector_struct;
2509 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2510
2511 Lisp_Object window;
2512 Lisp_Object buffer, start, pointm, mark;
2513 Lisp_Object left, top, width, height, hscroll;
2514 Lisp_Object parent, prev;
2515 Lisp_Object start_at_line_beg;
2516 Lisp_Object display_table;
2517 };
2518 #define SAVED_WINDOW_VECTOR_SIZE 14 /* Arg to Fmake_vector */
2519
2520 #define SAVED_WINDOW_N(swv,n) \
2521 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
2522
2523 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
2524 "T if OBJECT is a window-configration object.")
2525 (obj)
2526 Lisp_Object obj;
2527 {
2528 if (XTYPE (obj) == Lisp_Window_Configuration)
2529 return Qt;
2530 return Qnil;
2531 }
2532
2533
2534 DEFUN ("set-window-configuration", Fset_window_configuration,
2535 Sset_window_configuration, 1, 1, 0,
2536 "Set the configuration of windows and buffers as specified by CONFIGURATION.\n\
2537 CONFIGURATION must be a value previously returned\n\
2538 by `current-window-configuration' (which see).")
2539 (configuration)
2540 Lisp_Object configuration;
2541 {
2542 register struct save_window_data *data;
2543 struct Lisp_Vector *saved_windows;
2544 Lisp_Object new_current_buffer;
2545 Lisp_Object frame;
2546 FRAME_PTR f;
2547
2548 while (XTYPE (configuration) != Lisp_Window_Configuration)
2549 {
2550 configuration = wrong_type_argument (intern ("window-configuration-p"),
2551 configuration);
2552 }
2553
2554 data = (struct save_window_data *) XVECTOR (configuration);
2555 saved_windows = XVECTOR (data->saved_windows);
2556
2557 new_current_buffer = data->current_buffer;
2558 if (NILP (XBUFFER (new_current_buffer)->name))
2559 new_current_buffer = Qnil;
2560
2561 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
2562 f = XFRAME (frame);
2563
2564 /* If f is a dead frame, don't bother rebuilding its window tree.
2565 However, there is other stuff we should still try to do below. */
2566 if (FRAME_LIVE_P (f))
2567 {
2568 register struct window *w;
2569 register struct saved_window *p;
2570 int k;
2571
2572 /* If the frame has been resized since this window configuration was
2573 made, we change the frame to the size specified in the
2574 configuration, restore the configuration, and then resize it
2575 back. We keep track of the prevailing height in these variables. */
2576 int previous_frame_height = FRAME_HEIGHT (f);
2577 int previous_frame_width = FRAME_WIDTH (f);
2578 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
2579
2580 if (XFASTINT (data->frame_height) != previous_frame_height
2581 || XFASTINT (data->frame_width) != previous_frame_width)
2582 change_frame_size (f, data->frame_height, data->frame_width, 0, 0);
2583 if (XFASTINT (data->frame_menu_bar_lines)
2584 != previous_frame_menu_bar_lines)
2585 x_set_menu_bar_lines (f, data->frame_menu_bar_lines, 0);
2586
2587 windows_or_buffers_changed++;
2588
2589 /* Kludge Alert!
2590 Mark all windows now on frame as "deleted".
2591 Restoring the new configuration "undeletes" any that are in it.
2592
2593 Save their current buffers in their height fields, since we may
2594 need it later, if a buffer saved in the configuration is now
2595 dead. */
2596 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
2597
2598 for (k = 0; k < saved_windows->size; k++)
2599 {
2600 p = SAVED_WINDOW_N (saved_windows, k);
2601 w = XWINDOW (p->window);
2602 w->next = Qnil;
2603
2604 if (!NILP (p->parent))
2605 w->parent = SAVED_WINDOW_N (saved_windows,
2606 XFASTINT (p->parent))->window;
2607 else
2608 w->parent = Qnil;
2609
2610 if (!NILP (p->prev))
2611 {
2612 w->prev = SAVED_WINDOW_N (saved_windows,
2613 XFASTINT (p->prev))->window;
2614 XWINDOW (w->prev)->next = p->window;
2615 }
2616 else
2617 {
2618 w->prev = Qnil;
2619 if (!NILP (w->parent))
2620 {
2621 if (EQ (p->width, XWINDOW (w->parent)->width))
2622 {
2623 XWINDOW (w->parent)->vchild = p->window;
2624 XWINDOW (w->parent)->hchild = Qnil;
2625 }
2626 else
2627 {
2628 XWINDOW (w->parent)->hchild = p->window;
2629 XWINDOW (w->parent)->vchild = Qnil;
2630 }
2631 }
2632 }
2633
2634 /* If we squirreled away the buffer in the window's height,
2635 restore it now. */
2636 if (XTYPE (w->height) == Lisp_Buffer)
2637 w->buffer = w->height;
2638 w->left = p->left;
2639 w->top = p->top;
2640 w->width = p->width;
2641 w->height = p->height;
2642 w->hscroll = p->hscroll;
2643 w->display_table = p->display_table;
2644 XFASTINT (w->last_modified) = 0;
2645
2646 /* Reinstall the saved buffer and pointers into it. */
2647 if (NILP (p->buffer))
2648 w->buffer = p->buffer;
2649 else
2650 {
2651 if (!NILP (XBUFFER (p->buffer)->name))
2652 /* If saved buffer is alive, install it. */
2653 {
2654 w->buffer = p->buffer;
2655 w->start_at_line_beg = p->start_at_line_beg;
2656 set_marker_restricted (w->start,
2657 Fmarker_position (p->start),
2658 w->buffer);
2659 set_marker_restricted (w->pointm,
2660 Fmarker_position (p->pointm),
2661 w->buffer);
2662 Fset_marker (XBUFFER (w->buffer)->mark,
2663 Fmarker_position (p->mark), w->buffer);
2664
2665 /* As documented in Fcurrent_window_configuration, don't
2666 save the location of point in the buffer which was current
2667 when the window configuration was recorded. */
2668 if (!EQ (p->buffer, new_current_buffer) &&
2669 XBUFFER (p->buffer) == current_buffer)
2670 Fgoto_char (w->pointm);
2671 }
2672 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
2673 /* Else unless window has a live buffer, get one. */
2674 {
2675 w->buffer = Fcdr (Fcar (Vbuffer_alist));
2676 /* This will set the markers to beginning of visible
2677 range. */
2678 set_marker_restricted (w->start, make_number (0), w->buffer);
2679 set_marker_restricted (w->pointm, make_number (0),w->buffer);
2680 w->start_at_line_beg = Qt;
2681 }
2682 else
2683 /* Keeping window's old buffer; make sure the markers
2684 are real. */
2685 {
2686 /* Set window markers at start of visible range. */
2687 if (XMARKER (w->start)->buffer == 0)
2688 set_marker_restricted (w->start, make_number (0),
2689 w->buffer);
2690 if (XMARKER (w->pointm)->buffer == 0)
2691 set_marker_restricted (w->pointm,
2692 (make_number
2693 (BUF_PT (XBUFFER (w->buffer)))),
2694 w->buffer);
2695 w->start_at_line_beg = Qt;
2696 }
2697 }
2698 }
2699
2700 FRAME_ROOT_WINDOW (f) = data->root_window;
2701 Fselect_window (data->current_window);
2702
2703 #ifdef MULTI_FRAME
2704 if (NILP (data->focus_frame)
2705 || (XTYPE (data->focus_frame) == Lisp_Frame
2706 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
2707 Fredirect_frame_focus (frame, data->focus_frame);
2708 #endif
2709
2710 #if 0 /* I don't understand why this is needed, and it causes problems
2711 when the frame's old selected window has been deleted. */
2712 #ifdef MULTI_FRAME
2713 if (f != selected_frame && ! FRAME_TERMCAP_P (f))
2714 Fhandle_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)), Qnil);
2715 #endif
2716 #endif
2717
2718 /* Set the screen height to the value it had before this function. */
2719 if (previous_frame_height != FRAME_HEIGHT (f)
2720 || previous_frame_width != FRAME_WIDTH (f))
2721 change_frame_size (f, previous_frame_height, previous_frame_width,
2722 0, 0);
2723 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
2724 x_set_menu_bar_lines (f, previous_frame_menu_bar_lines, 0);
2725 }
2726
2727 #ifdef MULTI_FRAME
2728 /* Fselect_window will have made f the selected frame, so we
2729 reselect the proper frame here. Fhandle_switch_frame will change the
2730 selected window too, but that doesn't make the call to
2731 Fselect_window above totally superfluous; it still sets f's
2732 selected window. */
2733 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
2734 Fhandle_switch_frame (data->selected_frame, Qnil);
2735 #endif
2736
2737 if (!NILP (new_current_buffer))
2738 Fset_buffer (new_current_buffer);
2739
2740 Vminibuf_scroll_window = data->minibuf_scroll_window;
2741 return (Qnil);
2742 }
2743
2744 /* Mark all windows now on frame as deleted
2745 by setting their buffers to nil. */
2746
2747 void
2748 delete_all_subwindows (w)
2749 register struct window *w;
2750 {
2751 if (!NILP (w->next))
2752 delete_all_subwindows (XWINDOW (w->next));
2753 if (!NILP (w->vchild))
2754 delete_all_subwindows (XWINDOW (w->vchild));
2755 if (!NILP (w->hchild))
2756 delete_all_subwindows (XWINDOW (w->hchild));
2757
2758 w->height = w->buffer; /* See Fset_window_configuration for excuse. */
2759
2760 /* We set all three of these fields to nil, to make sure that we can
2761 distinguish this dead window from any live window. Live leaf
2762 windows will have buffer set, and combination windows will have
2763 vchild or hchild set. */
2764 w->buffer = Qnil;
2765 w->vchild = Qnil;
2766 w->hchild = Qnil;
2767 }
2768 \f
2769 static int
2770 count_windows (window)
2771 register struct window *window;
2772 {
2773 register int count = 1;
2774 if (!NILP (window->next))
2775 count += count_windows (XWINDOW (window->next));
2776 if (!NILP (window->vchild))
2777 count += count_windows (XWINDOW (window->vchild));
2778 if (!NILP (window->hchild))
2779 count += count_windows (XWINDOW (window->hchild));
2780 return count;
2781 }
2782
2783 static int
2784 save_window_save (window, vector, i)
2785 Lisp_Object window;
2786 struct Lisp_Vector *vector;
2787 int i;
2788 {
2789 register struct saved_window *p;
2790 register struct window *w;
2791 register Lisp_Object tem;
2792
2793 for (;!NILP (window); window = w->next)
2794 {
2795 p = SAVED_WINDOW_N (vector, i);
2796 w = XWINDOW (window);
2797
2798 XFASTINT (w->temslot) = i++;
2799 p->window = window;
2800 p->buffer = w->buffer;
2801 p->left = w->left;
2802 p->top = w->top;
2803 p->width = w->width;
2804 p->height = w->height;
2805 p->hscroll = w->hscroll;
2806 p->display_table = w->display_table;
2807 if (!NILP (w->buffer))
2808 {
2809 /* Save w's value of point in the window configuration.
2810 If w is the selected window, then get the value of point
2811 from the buffer; pointm is garbage in the selected window. */
2812 if (EQ (window, selected_window))
2813 {
2814 p->pointm = Fmake_marker ();
2815 Fset_marker (p->pointm, BUF_PT (XBUFFER (w->buffer)),
2816 w->buffer);
2817 }
2818 else
2819 p->pointm = Fcopy_marker (w->pointm);
2820
2821 p->start = Fcopy_marker (w->start);
2822 p->start_at_line_beg = w->start_at_line_beg;
2823
2824 tem = XBUFFER (w->buffer)->mark;
2825 p->mark = Fcopy_marker (tem);
2826 }
2827 else
2828 {
2829 p->pointm = Qnil;
2830 p->start = Qnil;
2831 p->mark = Qnil;
2832 p->start_at_line_beg = Qnil;
2833 }
2834
2835 if (NILP (w->parent))
2836 p->parent = Qnil;
2837 else
2838 p->parent = XWINDOW (w->parent)->temslot;
2839
2840 if (NILP (w->prev))
2841 p->prev = Qnil;
2842 else
2843 p->prev = XWINDOW (w->prev)->temslot;
2844
2845 if (!NILP (w->vchild))
2846 i = save_window_save (w->vchild, vector, i);
2847 if (!NILP (w->hchild))
2848 i = save_window_save (w->hchild, vector, i);
2849 }
2850
2851 return i;
2852 }
2853
2854 DEFUN ("current-window-configuration",
2855 Fcurrent_window_configuration, Scurrent_window_configuration, 0, 1, 0,
2856 "Return an object representing the current window configuration of FRAME.\n\
2857 If FRAME is nil or omitted, use the selected frame.\n\
2858 This describes the number of windows, their sizes and current buffers,\n\
2859 and for each displayed buffer, where display starts, and the positions of\n\
2860 point and mark. An exception is made for point in the current buffer:\n\
2861 its value is -not- saved.\n\
2862 This also records the currently selected frame, and FRAME's focus\n\
2863 redirection (see `redirect-frame-focus').")
2864 (frame)
2865 Lisp_Object frame;
2866 {
2867 register Lisp_Object tem;
2868 register int n_windows;
2869 register struct save_window_data *data;
2870 register int i;
2871 FRAME_PTR f;
2872
2873 if (NILP (frame))
2874 f = selected_frame;
2875 else
2876 {
2877 CHECK_LIVE_FRAME (frame, 0);
2878 f = XFRAME (frame);
2879 }
2880
2881 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
2882 data = (struct save_window_data *)
2883 XVECTOR (Fmake_vector (make_number (SAVE_WINDOW_DATA_SIZE),
2884 Qnil));
2885 XFASTINT (data->frame_width) = FRAME_WIDTH (f);
2886 XFASTINT (data->frame_height) = FRAME_HEIGHT (f);
2887 XFASTINT (data->frame_menu_bar_lines) = FRAME_MENU_BAR_LINES (f);
2888 #ifdef MULTI_FRAME
2889 XSET (data->selected_frame, Lisp_Frame, selected_frame);
2890 #endif
2891 data->current_window = FRAME_SELECTED_WINDOW (f);
2892 XSET (data->current_buffer, Lisp_Buffer, current_buffer);
2893 data->minibuf_scroll_window = Vminibuf_scroll_window;
2894 data->root_window = FRAME_ROOT_WINDOW (f);
2895 data->focus_frame = FRAME_FOCUS_FRAME (f);
2896 tem = Fmake_vector (make_number (n_windows), Qnil);
2897 data->saved_windows = tem;
2898 for (i = 0; i < n_windows; i++)
2899 XVECTOR (tem)->contents[i]
2900 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE), Qnil);
2901 save_window_save (FRAME_ROOT_WINDOW (f),
2902 XVECTOR (tem), 0);
2903 XSET (tem, Lisp_Window_Configuration, data);
2904 return (tem);
2905 }
2906
2907 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
2908 0, UNEVALLED, 0,
2909 "Execute body, preserving window sizes and contents.\n\
2910 Restores which buffer appears in which window, where display starts,\n\
2911 as well as the current buffer.\n\
2912 Does not restore the value of point in current buffer.")
2913 (args)
2914 Lisp_Object args;
2915 {
2916 register Lisp_Object val;
2917 register int count = specpdl_ptr - specpdl;
2918
2919 record_unwind_protect (Fset_window_configuration,
2920 Fcurrent_window_configuration (Qnil));
2921 val = Fprogn (args);
2922 return unbind_to (count, val);
2923 }
2924 \f
2925 init_window_once ()
2926 {
2927 #ifdef MULTI_FRAME
2928 selected_frame = make_terminal_frame ();
2929 minibuf_window = selected_frame->minibuffer_window;
2930 selected_window = selected_frame->selected_window;
2931 last_nonminibuf_frame = selected_frame;
2932 #else /* not MULTI_FRAME */
2933 extern Lisp_Object get_minibuffer ();
2934
2935 minibuf_window = make_window ();
2936 FRAME_ROOT_WINDOW (selected_frame) = make_window ();
2937
2938 XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->next = minibuf_window;
2939 XWINDOW (minibuf_window)->prev = FRAME_ROOT_WINDOW (selected_frame);
2940 XWINDOW (minibuf_window)->mini_p = Qt;
2941
2942 /* These values 9 and 10 are arbitrary,
2943 just so that there is "something there."
2944 Correct values are put in in init_xdisp */
2945
2946 XFASTINT (XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->width) = 10;
2947 XFASTINT (XWINDOW (minibuf_window)->width) = 10;
2948
2949 XFASTINT (XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->height) = 9;
2950 XFASTINT (XWINDOW (minibuf_window)->top) = 9;
2951 XFASTINT (XWINDOW (minibuf_window)->height) = 1;
2952
2953 /* Prevent error in Fset_window_buffer. */
2954 XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->buffer = Qt;
2955 XWINDOW (minibuf_window)->buffer = Qt;
2956
2957 /* Now set them up for real. */
2958 Fset_window_buffer (FRAME_ROOT_WINDOW (selected_frame),
2959 Fcurrent_buffer ());
2960 Fset_window_buffer (minibuf_window, get_minibuffer (0));
2961
2962 selected_window = FRAME_ROOT_WINDOW (selected_frame);
2963 /* Make sure this window seems more recently used than
2964 a newly-created, never-selected window. Increment
2965 window_select_count so the first selection ever will get
2966 something newer than this. */
2967 XFASTINT (XWINDOW (selected_window)->use_time) = ++window_select_count;
2968 #endif /* not MULTI_FRAME */
2969 }
2970
2971 syms_of_window ()
2972 {
2973 Qwindowp = intern ("windowp");
2974 staticpro (&Qwindowp);
2975
2976 Qwindow_live_p = intern ("window-live-p");
2977 staticpro (&Qwindow_live_p);
2978
2979 #ifndef MULTI_FRAME
2980 /* Make sure all windows get marked */
2981 staticpro (&minibuf_window);
2982 #endif
2983
2984 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
2985 "Non-nil means call as function to display a help buffer.\n\
2986 Used by `with-output-to-temp-buffer'.");
2987 Vtemp_buffer_show_function = Qnil;
2988
2989 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
2990 "If non-nil, function to call to handle `display-buffer'.\n\
2991 It will receive two args, the buffer and a flag which if non-nil means\n\
2992 that the currently selected window is not acceptable.\n\
2993 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'\n\
2994 work using this function.");
2995 Vdisplay_buffer_function = Qnil;
2996
2997 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
2998 "Non-nil means it is the window that C-M-v in minibuffer should scroll.");
2999 Vminibuf_scroll_window = Qnil;
3000
3001 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
3002 "If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window.");
3003 Vother_window_scroll_buffer = Qnil;
3004
3005 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
3006 "*Non-nil means `display-buffer' should make a separate frame.");
3007 pop_up_frames = 0;
3008
3009 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
3010 "*If non-nil, function to call to handle automatic new frame creation.\n\
3011 It is called with no arguments and should return a newly created frame.\n\
3012 \n\
3013 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'\n\
3014 where `pop-up-frame-alist' would hold the default frame parameters.");
3015 Vpop_up_frame_function = Qnil;
3016
3017 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
3018 "*Non-nil means display-buffer should make new windows.");
3019 pop_up_windows = 1;
3020
3021 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
3022 "*Number of lines of continuity when scrolling by screenfuls.");
3023 next_screen_context_lines = 2;
3024
3025 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
3026 "*display-buffer would prefer to split the largest window if this large.\n\
3027 If there is only one window, it is split regardless of this value.");
3028 split_height_threshold = 500;
3029
3030 DEFVAR_INT ("window-min-height", &window_min_height,
3031 "*Delete any window less than this tall (including its mode line).");
3032 window_min_height = 4;
3033
3034 DEFVAR_INT ("window-min-width", &window_min_width,
3035 "*Delete any window less than this wide.");
3036 window_min_width = 10;
3037
3038 defsubr (&Sselected_window);
3039 defsubr (&Sminibuffer_window);
3040 defsubr (&Swindow_minibuffer_p);
3041 defsubr (&Swindowp);
3042 defsubr (&Swindow_live_p);
3043 defsubr (&Spos_visible_in_window_p);
3044 defsubr (&Swindow_buffer);
3045 defsubr (&Swindow_height);
3046 defsubr (&Swindow_width);
3047 defsubr (&Swindow_hscroll);
3048 defsubr (&Sset_window_hscroll);
3049 defsubr (&Swindow_edges);
3050 defsubr (&Scoordinates_in_window_p);
3051 defsubr (&Swindow_at);
3052 defsubr (&Swindow_point);
3053 defsubr (&Swindow_start);
3054 defsubr (&Swindow_end);
3055 defsubr (&Sset_window_point);
3056 defsubr (&Sset_window_start);
3057 defsubr (&Swindow_dedicated_p);
3058 defsubr (&Sset_window_dedicated_p);
3059 defsubr (&Swindow_display_table);
3060 defsubr (&Sset_window_display_table);
3061 defsubr (&Snext_window);
3062 defsubr (&Sprevious_window);
3063 defsubr (&Sother_window);
3064 defsubr (&Sget_lru_window);
3065 defsubr (&Sget_largest_window);
3066 defsubr (&Sget_buffer_window);
3067 defsubr (&Sdelete_other_windows);
3068 defsubr (&Sdelete_windows_on);
3069 defsubr (&Sreplace_buffer_in_windows);
3070 defsubr (&Sdelete_window);
3071 defsubr (&Sset_window_buffer);
3072 defsubr (&Sselect_window);
3073 defsubr (&Sdisplay_buffer);
3074 defsubr (&Ssplit_window);
3075 defsubr (&Senlarge_window);
3076 defsubr (&Sshrink_window);
3077 defsubr (&Sscroll_up);
3078 defsubr (&Sscroll_down);
3079 defsubr (&Sscroll_left);
3080 defsubr (&Sscroll_right);
3081 defsubr (&Sscroll_other_window);
3082 defsubr (&Srecenter);
3083 defsubr (&Smove_to_window_line);
3084 defsubr (&Swindow_configuration_p);
3085 defsubr (&Sset_window_configuration);
3086 defsubr (&Scurrent_window_configuration);
3087 defsubr (&Ssave_window_excursion);
3088 }
3089
3090 keys_of_window ()
3091 {
3092 initial_define_key (control_x_map, '1', "delete-other-windows");
3093 initial_define_key (control_x_map, '2', "split-window");
3094 initial_define_key (control_x_map, '0', "delete-window");
3095 initial_define_key (control_x_map, 'o', "other-window");
3096 initial_define_key (control_x_map, '^', "enlarge-window");
3097 initial_define_key (control_x_map, '<', "scroll-left");
3098 initial_define_key (control_x_map, '>', "scroll-right");
3099
3100 initial_define_key (global_map, Ctl ('V'), "scroll-up");
3101 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
3102 initial_define_key (meta_map, 'v', "scroll-down");
3103
3104 initial_define_key (global_map, Ctl('L'), "recenter");
3105 initial_define_key (meta_map, 'r', "move-to-window-line");
3106 }