]> code.delx.au - gnu-emacs/blob - src/window.c
(Fselect_window): Don't select an inactive minibuffer.
[gnu-emacs] / 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 #ifdef MULTI_FRAME
1184 if (frame != 0 && EQ (frames, Qt)
1185 && FRAME_VISIBLE_P (w_frame))
1186 continue;
1187 #endif
1188 if (! MINI_WINDOW_P (XWINDOW (w))
1189 || (mini && minibuf_level > 0))
1190 switch (type)
1191 {
1192 case GET_BUFFER_WINDOW:
1193 /* Ignore invisible and iconified frames. */
1194 if (! FRAME_VISIBLE_P (w_frame)
1195 || FRAME_ICONIFIED_P (w_frame))
1196 break;
1197 if (XBUFFER (XWINDOW (w)->buffer) == XBUFFER (obj))
1198 return w;
1199 break;
1200
1201 case GET_LRU_WINDOW:
1202 /* t as arg means consider only full-width windows */
1203 if (!NILP (obj) && XFASTINT (XWINDOW (w)->width)
1204 != FRAME_WIDTH (XFRAME (WINDOW_FRAME (XWINDOW (w)))))
1205 break;
1206 #if 0
1207 /* Ignore invisible and iconified frames. */
1208 if (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (w))))
1209 || FRAME_ICONIFIED_P (XFRAME (WINDOW_FRAME (XWINDOW (w)))))
1210 break;
1211 #endif
1212 /* Ignore dedicated windows and minibuffers. */
1213 if (MINI_WINDOW_P (XWINDOW (w))
1214 || !NILP (XWINDOW (w)->dedicated))
1215 break;
1216 if (NILP (best_window)
1217 || (XFASTINT (XWINDOW (best_window)->use_time)
1218 > XFASTINT (XWINDOW (w)->use_time)))
1219 best_window = w;
1220 break;
1221
1222 case DELETE_OTHER_WINDOWS:
1223 if (XWINDOW (w) != XWINDOW (obj))
1224 Fdelete_window (w);
1225 break;
1226
1227 case DELETE_BUFFER_WINDOWS:
1228 if (EQ (XWINDOW (w)->buffer, obj))
1229 {
1230 /* If we're deleting the buffer displayed in the only window
1231 on the frame, find a new buffer to display there. */
1232 if (NILP (XWINDOW (w)->parent))
1233 {
1234 Lisp_Object new_buffer = Fother_buffer (obj, Qnil);
1235 if (NILP (new_buffer))
1236 new_buffer
1237 = Fget_buffer_create (build_string ("*scratch*"));
1238 Fset_window_buffer (w, new_buffer);
1239 if (EQ (w, selected_window))
1240 Fset_buffer (XWINDOW (w)->buffer);
1241 }
1242 else
1243 Fdelete_window (w);
1244 }
1245 break;
1246
1247 case GET_LARGEST_WINDOW:
1248 #if 0
1249 /* Ignore invisible and iconified frames. */
1250 if (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (w))))
1251 || FRAME_ICONIFIED_P (XFRAME (WINDOW_FRAME (XWINDOW (w)))))
1252 break;
1253 #endif
1254 /* Ignore dedicated windows and minibuffers. */
1255 if (MINI_WINDOW_P (XWINDOW (w))
1256 || !NILP (XWINDOW (w)->dedicated))
1257 break;
1258 {
1259 struct window *best_window_ptr = XWINDOW (best_window);
1260 struct window *w_ptr = XWINDOW (w);
1261 if (NILP (best_window) ||
1262 (XFASTINT (w_ptr->height) * XFASTINT (w_ptr->width))
1263 > (XFASTINT (best_window_ptr->height)
1264 * XFASTINT (best_window_ptr->width)))
1265 best_window = w;
1266 }
1267 break;
1268
1269 case UNSHOW_BUFFER:
1270 if (EQ (XWINDOW (w)->buffer, obj))
1271 {
1272 /* Find another buffer to show in this window. */
1273 Lisp_Object another_buffer = Fother_buffer (obj, Qnil);
1274 if (NILP (another_buffer))
1275 another_buffer
1276 = Fget_buffer_create (build_string ("*scratch*"));
1277 Fset_window_buffer (w, another_buffer);
1278 if (EQ (w, selected_window))
1279 Fset_buffer (XWINDOW (w)->buffer);
1280 }
1281 break;
1282 }
1283
1284 if (EQ (w, last_window))
1285 break;
1286
1287 w = next_window;
1288 }
1289
1290 return best_window;
1291 }
1292
1293 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 1, 0,
1294 "Return the window least recently selected or used for display.\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 register Lisp_Object w;
1303 /* First try for a window that is full-width */
1304 w = window_loop (GET_LRU_WINDOW, Qt, 0, frame);
1305 if (!NILP (w) && !EQ (w, selected_window))
1306 return w;
1307 /* If none of them, try the rest */
1308 return window_loop (GET_LRU_WINDOW, Qnil, 0, frame);
1309 }
1310
1311 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 1, 0,
1312 "Return the largest window in area.\n\
1313 If optional argument FRAME is `visible', search all visible frames.\n\
1314 If FRAME is t, search all frames.\n\
1315 If FRAME is nil, search only the selected frame.\n\
1316 If FRAME is a frame, search only that frame.")
1317 (frame)
1318 Lisp_Object frame;
1319 {
1320 return window_loop (GET_LARGEST_WINDOW, Qnil, 0,
1321 frame);
1322 }
1323
1324 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
1325 "Return a window currently displaying BUFFER, or nil if none.\n\
1326 If optional argument FRAME is `visible', search all visible frames.\n\
1327 If FRAME is t, search all frames.\n\
1328 If FRAME is nil, search only the selected frame.\n\
1329 If FRAME is a frame, search only that frame.")
1330 (buffer, frame)
1331 Lisp_Object buffer, frame;
1332 {
1333 buffer = Fget_buffer (buffer);
1334 if (XTYPE (buffer) == Lisp_Buffer)
1335 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
1336 else
1337 return Qnil;
1338 }
1339
1340 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
1341 0, 1, "",
1342 "Make WINDOW (or the selected window) fill its frame.\n\
1343 Only the frame WINDOW is on is affected.\n\
1344 This function tries to reduce display jumps\n\
1345 by keeping the text previously visible in WINDOW\n\
1346 in the same place on the frame. Doing this depends on\n\
1347 the value of (window-start WINDOW), so if calling this function\n\
1348 in a program gives strange scrolling, make sure the window-start\n\
1349 value is reasonable when this function is called.")
1350 (window)
1351 Lisp_Object window;
1352 {
1353 struct window *w;
1354 struct buffer *obuf = current_buffer;
1355 int opoint;
1356 int top;
1357
1358 if (NILP (window))
1359 window = selected_window;
1360 else
1361 CHECK_LIVE_WINDOW (window, 0);
1362
1363 w = XWINDOW (window);
1364 top = XFASTINT (w->top);
1365
1366 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
1367
1368 Fset_buffer (w->buffer);
1369 opoint = point;
1370 SET_PT (marker_position (w->start));
1371 /* Like Frecenter but avoid setting w->force_start. */
1372 Fvertical_motion (make_number (- (top - FRAME_MENU_BAR_LINES (XFRAME (WINDOW_FRAME (w))))));
1373 Fset_marker (w->start, make_number (PT), w->buffer);
1374 w->start_at_line_beg = Fbolp ();
1375
1376 SET_PT (opoint);
1377 set_buffer_internal (obuf);
1378 return Qnil;
1379 }
1380
1381 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
1382 1, 2, "bDelete windows on (buffer): ",
1383 "Delete all windows showing BUFFER.\n\
1384 Optional second argument FRAME controls which frames are affected.\n\
1385 If nil or omitted, delete all windows showing BUFFER in any frame.\n\
1386 If t, delete only windows showing BUFFER in the selected frame.\n\
1387 If `visible', delete all windows showing BUFFER in any visible frame.\n\
1388 If a frame, delete only windows showing BUFFER in that frame.")
1389 (buffer, frame)
1390 Lisp_Object buffer, frame;
1391 {
1392 #ifdef MULTI_FRAME
1393 /* FRAME uses t and nil to mean the opposite of what window_loop
1394 expects. */
1395 if (! FRAMEP (frame))
1396 frame = NILP (frame) ? Qt : Qnil;
1397 #else
1398 frame = Qt;
1399 #endif
1400
1401 if (!NILP (buffer))
1402 {
1403 buffer = Fget_buffer (buffer);
1404 CHECK_BUFFER (buffer, 0);
1405 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
1406 }
1407 return Qnil;
1408 }
1409
1410 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
1411 Sreplace_buffer_in_windows,
1412 1, 1, "bReplace buffer in windows: ",
1413 "Replace BUFFER with some other buffer in all windows showing it.")
1414 (buffer)
1415 Lisp_Object buffer;
1416 {
1417 if (!NILP (buffer))
1418 {
1419 buffer = Fget_buffer (buffer);
1420 CHECK_BUFFER (buffer, 0);
1421 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
1422 }
1423 return Qnil;
1424 }
1425 \f
1426 /* Set the height of WINDOW and all its inferiors. */
1427
1428 /* The smallest acceptable dimensions for a window. Anything smaller
1429 might crash Emacs. */
1430 #define MIN_SAFE_WINDOW_WIDTH (2)
1431 #define MIN_SAFE_WINDOW_HEIGHT (2)
1432
1433 /* Make sure that window_min_height and window_min_width are
1434 not too small; if they are, set them to safe minima. */
1435
1436 static void
1437 check_min_window_sizes ()
1438 {
1439 /* Smaller values might permit a crash. */
1440 if (window_min_width < MIN_SAFE_WINDOW_WIDTH)
1441 window_min_width = MIN_SAFE_WINDOW_WIDTH;
1442 if (window_min_height < MIN_SAFE_WINDOW_HEIGHT)
1443 window_min_height = MIN_SAFE_WINDOW_HEIGHT;
1444 }
1445
1446 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
1447 minimum allowable size. */
1448 void
1449 check_frame_size (frame, rows, cols)
1450 FRAME_PTR frame;
1451 int *rows, *cols;
1452 {
1453 /* For height, we have to see:
1454 whether the frame has a minibuffer,
1455 whether it wants a mode line, and
1456 whether it has a menu bar. */
1457 int min_height =
1458 (FRAME_MINIBUF_ONLY_P (frame) ? MIN_SAFE_WINDOW_HEIGHT - 1
1459 : (! FRAME_HAS_MINIBUF_P (frame)) ? MIN_SAFE_WINDOW_HEIGHT
1460 : 2 * MIN_SAFE_WINDOW_HEIGHT - 1);
1461 if (FRAME_MENU_BAR_LINES (frame) > 0)
1462 min_height += FRAME_MENU_BAR_LINES (frame);
1463
1464 if (*rows < min_height)
1465 *rows = min_height;
1466 if (*cols < MIN_SAFE_WINDOW_WIDTH)
1467 *cols = MIN_SAFE_WINDOW_WIDTH;
1468 }
1469
1470 /* Normally the window is deleted if it gets too small.
1471 nodelete nonzero means do not do this.
1472 (The caller should check later and do so if appropriate) */
1473
1474 set_window_height (window, height, nodelete)
1475 Lisp_Object window;
1476 int height;
1477 int nodelete;
1478 {
1479 register struct window *w = XWINDOW (window);
1480 register struct window *c;
1481 int oheight = XFASTINT (w->height);
1482 int top, pos, lastbot, opos, lastobot;
1483 Lisp_Object child;
1484
1485 check_min_window_sizes ();
1486
1487 if (!nodelete
1488 && ! NILP (w->parent)
1489 && height < window_min_height)
1490 {
1491 Fdelete_window (window);
1492 return;
1493 }
1494
1495 XFASTINT (w->last_modified) = 0;
1496 windows_or_buffers_changed++;
1497 XFASTINT (w->height) = height;
1498 if (!NILP (w->hchild))
1499 {
1500 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1501 {
1502 XWINDOW (child)->top = w->top;
1503 set_window_height (child, height, nodelete);
1504 }
1505 }
1506 else if (!NILP (w->vchild))
1507 {
1508 lastbot = top = XFASTINT (w->top);
1509 lastobot = 0;
1510 for (child = w->vchild; !NILP (child); child = c->next)
1511 {
1512 c = XWINDOW (child);
1513
1514 opos = lastobot + XFASTINT (c->height);
1515
1516 XFASTINT (c->top) = lastbot;
1517
1518 pos = (((opos * height) << 1) + oheight) / (oheight << 1);
1519
1520 /* Avoid confusion: inhibit deletion of child if becomes too small */
1521 set_window_height (child, pos + top - lastbot, 1);
1522
1523 /* Now advance child to next window,
1524 and set lastbot if child was not just deleted. */
1525 lastbot = pos + top;
1526 lastobot = opos;
1527 }
1528 /* Now delete any children that became too small. */
1529 if (!nodelete)
1530 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1531 {
1532 set_window_height (child, XINT (XWINDOW (child)->height), 0);
1533 }
1534 }
1535 }
1536
1537 /* Recursively set width of WINDOW and its inferiors. */
1538
1539 set_window_width (window, width, nodelete)
1540 Lisp_Object window;
1541 int width;
1542 int nodelete;
1543 {
1544 register struct window *w = XWINDOW (window);
1545 register struct window *c;
1546 int owidth = XFASTINT (w->width);
1547 int left, pos, lastright, opos, lastoright;
1548 Lisp_Object child;
1549
1550 if (!nodelete && width < window_min_width)
1551 {
1552 Fdelete_window (window);
1553 return;
1554 }
1555
1556 XFASTINT (w->last_modified) = 0;
1557 windows_or_buffers_changed++;
1558 XFASTINT (w->width) = width;
1559 if (!NILP (w->vchild))
1560 {
1561 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1562 {
1563 XWINDOW (child)->left = w->left;
1564 set_window_width (child, width, nodelete);
1565 }
1566 }
1567 else if (!NILP (w->hchild))
1568 {
1569 lastright = left = XFASTINT (w->left);
1570 lastoright = 0;
1571 for (child = w->hchild; !NILP (child); child = c->next)
1572 {
1573 c = XWINDOW (child);
1574
1575 opos = lastoright + XFASTINT (c->width);
1576
1577 XFASTINT (c->left) = lastright;
1578
1579 pos = (((opos * width) << 1) + owidth) / (owidth << 1);
1580
1581 /* Inhibit deletion for becoming too small */
1582 set_window_width (child, pos + left - lastright, 1);
1583
1584 /* Now advance child to next window,
1585 and set lastright if child was not just deleted. */
1586 lastright = pos + left, lastoright = opos;
1587 }
1588 /* Delete children that became too small */
1589 if (!nodelete)
1590 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1591 {
1592 set_window_width (child, XINT (XWINDOW (child)->width), 0);
1593 }
1594 }
1595 }
1596 \f
1597 int window_select_count;
1598
1599 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 2, 0,
1600 "Make WINDOW display BUFFER as its contents.\n\
1601 BUFFER can be a buffer or buffer name.")
1602 (window, buffer)
1603 register Lisp_Object window, buffer;
1604 {
1605 register Lisp_Object tem;
1606 register struct window *w = decode_window (window);
1607
1608 buffer = Fget_buffer (buffer);
1609 CHECK_BUFFER (buffer, 1);
1610
1611 if (NILP (XBUFFER (buffer)->name))
1612 error ("Attempt to display deleted buffer");
1613
1614 tem = w->buffer;
1615 if (NILP (tem))
1616 error ("Window is deleted");
1617 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
1618 is first being set up. */
1619 {
1620 if (!NILP (w->dedicated) && !EQ (tem, buffer))
1621 error ("Window is dedicated to %s\n", tem);
1622
1623 unshow_buffer (w);
1624 }
1625
1626 w->buffer = buffer;
1627 w->window_end_pos = 0;
1628 w->window_end_valid = Qnil;
1629 w->hscroll = 0;
1630 Fset_marker (w->pointm,
1631 make_number (BUF_PT (XBUFFER (buffer))),
1632 buffer);
1633 set_marker_restricted (w->start,
1634 make_number (XBUFFER (buffer)->last_window_start),
1635 buffer);
1636 w->start_at_line_beg = Qnil;
1637 w->force_start = Qnil;
1638 XFASTINT (w->last_modified) = 0;
1639 windows_or_buffers_changed++;
1640 if (EQ (window, selected_window))
1641 Fset_buffer (buffer);
1642
1643 return Qnil;
1644 }
1645
1646 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 1, 0,
1647 "Select WINDOW. Most editing will apply to WINDOW's buffer.\n\
1648 The main editor command loop selects the buffer of the selected window\n\
1649 before each command.")
1650 (window)
1651 register Lisp_Object window;
1652 {
1653 register struct window *w;
1654 register struct window *ow = XWINDOW (selected_window);
1655
1656 CHECK_LIVE_WINDOW (window, 0);
1657
1658 w = XWINDOW (window);
1659
1660 if (MINI_WINDOW_P (w)
1661 && NILP (call1 (intern ("minibuffer-window-active-p"), window)))
1662 error ("Attempt to select inactive minibuffer window");
1663
1664 if (NILP (w->buffer))
1665 error ("Trying to select deleted window or non-leaf window");
1666
1667 XFASTINT (w->use_time) = ++window_select_count;
1668 if (EQ (window, selected_window))
1669 return window;
1670
1671 Fset_marker (ow->pointm, make_number (BUF_PT (XBUFFER (ow->buffer))),
1672 ow->buffer);
1673
1674 selected_window = window;
1675 #ifdef MULTI_FRAME
1676 if (XFRAME (WINDOW_FRAME (w)) != selected_frame)
1677 {
1678 XFRAME (WINDOW_FRAME (w))->selected_window = window;
1679 Fhandle_switch_frame (WINDOW_FRAME (w), Qnil);
1680 }
1681 else
1682 selected_frame->selected_window = window;
1683 #endif
1684
1685 record_buffer (w->buffer);
1686 Fset_buffer (w->buffer);
1687
1688 /* Go to the point recorded in the window.
1689 This is important when the buffer is in more
1690 than one window. It also matters when
1691 redisplay_window has altered point after scrolling,
1692 because it makes the change only in the window. */
1693 {
1694 register int new_point = marker_position (w->pointm);
1695 if (new_point < BEGV)
1696 SET_PT (BEGV);
1697 if (new_point > ZV)
1698 SET_PT (ZV);
1699 else
1700 SET_PT (new_point);
1701 }
1702
1703 windows_or_buffers_changed++;
1704 return window;
1705 }
1706
1707 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 2,
1708 "BDisplay buffer: \nP",
1709 "Make BUFFER appear in some window but don't select it.\n\
1710 BUFFER can be a buffer or a buffer name.\n\
1711 If BUFFER is shown already in some window, just use that one,\n\
1712 unless the window is the selected window and the optional second\n\
1713 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).\n\
1714 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.\n\
1715 Returns the window displaying BUFFER.")
1716 (buffer, not_this_window)
1717 register Lisp_Object buffer, not_this_window;
1718 {
1719 register Lisp_Object window;
1720
1721 buffer = Fget_buffer (buffer);
1722 CHECK_BUFFER (buffer, 0);
1723
1724 if (!NILP (Vdisplay_buffer_function))
1725 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
1726
1727 if (NILP (not_this_window)
1728 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
1729 return selected_window;
1730
1731 /* If pop_up_frames,
1732 look for a window showing BUFFER on any visible frame. */
1733 window = Fget_buffer_window (buffer, pop_up_frames ? Qvisible : Qnil);
1734 if (!NILP (window)
1735 && (NILP (not_this_window) || !EQ (window, selected_window)))
1736 return window;
1737
1738 #ifdef MULTI_FRAME
1739 /* If there are no frames open that have more than a minibuffer,
1740 we need to create a new frame. */
1741 if (pop_up_frames || last_nonminibuf_frame == 0)
1742 {
1743 window
1744 = Fframe_selected_window (call0 (Vpop_up_frame_function));
1745 Fset_window_buffer (window, buffer);
1746 #if 0
1747 Fhandle_switch_frame (XWINDOW (window)->frame, Qnil);
1748 #endif
1749 return window;
1750 }
1751 #endif /* MULTI_FRAME */
1752
1753 if (pop_up_windows
1754 #ifdef MULTI_FRAME
1755 || FRAME_MINIBUF_ONLY_P (selected_frame)
1756 #endif
1757 )
1758 {
1759 Lisp_Object frames = Qnil;
1760
1761 #ifdef MULTI_FRAME
1762 if (FRAME_MINIBUF_ONLY_P (selected_frame))
1763 XSET (frames, Lisp_Frame, last_nonminibuf_frame);
1764 #endif
1765 /* Don't try to create a window if would get an error */
1766 if (split_height_threshold < window_min_height << 1)
1767 split_height_threshold = window_min_height << 1;
1768
1769 window = Fget_largest_window (frames);
1770
1771 if (!NILP (window)
1772 && window_height (window) >= split_height_threshold
1773 && (XFASTINT (XWINDOW (window)->width)
1774 == FRAME_WIDTH (XFRAME (WINDOW_FRAME (XWINDOW (window))))))
1775 window = Fsplit_window (window, Qnil, Qnil);
1776 else
1777 {
1778 window = Fget_lru_window (frames);
1779 if ((EQ (window, selected_window)
1780 || EQ (XWINDOW (window)->parent, Qnil))
1781 && window_height (window) >= window_min_height << 1)
1782 window = Fsplit_window (window, Qnil, Qnil);
1783 }
1784 }
1785 else
1786 window = Fget_lru_window (Qnil);
1787
1788 Fset_window_buffer (window, buffer);
1789 return window;
1790 }
1791
1792 void
1793 temp_output_buffer_show (buf)
1794 register Lisp_Object buf;
1795 {
1796 register struct buffer *old = current_buffer;
1797 register Lisp_Object window;
1798 register struct window *w;
1799
1800 Fset_buffer (buf);
1801 XBUFFER (buf)->save_modified = MODIFF;
1802 BEGV = BEG;
1803 ZV = Z;
1804 SET_PT (BEG);
1805 clip_changed = 1;
1806 set_buffer_internal (old);
1807
1808 if (!EQ (Vtemp_buffer_show_function, Qnil))
1809 call1 (Vtemp_buffer_show_function, buf);
1810 else
1811 {
1812 window = Fdisplay_buffer (buf, Qnil);
1813
1814 #ifdef MULTI_FRAME
1815 if (XFRAME (XWINDOW (window)->frame) != selected_frame)
1816 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
1817 #endif /* MULTI_FRAME */
1818 Vminibuf_scroll_window = window;
1819 w = XWINDOW (window);
1820 XFASTINT (w->hscroll) = 0;
1821 set_marker_restricted (w->start, make_number (1), buf);
1822 set_marker_restricted (w->pointm, make_number (1), buf);
1823 }
1824 }
1825 \f
1826 static
1827 make_dummy_parent (window)
1828 Lisp_Object window;
1829 {
1830 register Lisp_Object old, new;
1831 register struct window *o, *p;
1832
1833 old = window;
1834 XSETTYPE (old, Lisp_Vector);
1835 new = Fcopy_sequence (old);
1836 XSETTYPE (new, Lisp_Window);
1837
1838 o = XWINDOW (old);
1839 p = XWINDOW (new);
1840 XFASTINT (p->sequence_number) = ++sequence_number;
1841
1842 /* Put new into window structure in place of window */
1843 replace_window (window, new);
1844
1845 o->next = Qnil;
1846 o->prev = Qnil;
1847 o->vchild = Qnil;
1848 o->hchild = Qnil;
1849 o->parent = new;
1850
1851 p->start = Qnil;
1852 p->pointm = Qnil;
1853 p->buffer = Qnil;
1854 }
1855
1856 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
1857 "Split WINDOW, putting SIZE lines in the first of the pair.\n\
1858 WINDOW defaults to selected one and SIZE to half its size.\n\
1859 If optional third arg HOR-FLAG is non-nil, split side by side\n\
1860 and put SIZE columns in the first of the pair.")
1861 (window, chsize, horflag)
1862 Lisp_Object window, chsize, horflag;
1863 {
1864 register Lisp_Object new;
1865 register struct window *o, *p;
1866 register int size;
1867
1868 if (NILP (window))
1869 window = selected_window;
1870 else
1871 CHECK_LIVE_WINDOW (window, 0);
1872
1873 o = XWINDOW (window);
1874
1875 if (NILP (chsize))
1876 {
1877 if (!NILP (horflag))
1878 /* Round odd size up, since this is for the left-hand window,
1879 and it will lose a column for the separators. */
1880 size = ((XFASTINT (o->width) + 1) & -2) >> 1;
1881 else
1882 size = XFASTINT (o->height) >> 1;
1883 }
1884 else
1885 {
1886 CHECK_NUMBER (chsize, 1);
1887 size = XINT (chsize);
1888 }
1889
1890 if (MINI_WINDOW_P (o))
1891 error ("Attempt to split minibuffer window");
1892 else if (FRAME_NO_SPLIT_P (XFRAME (WINDOW_FRAME (o))))
1893 error ("Attempt to split unsplittable frame");
1894
1895 check_min_window_sizes ();
1896
1897 if (NILP (horflag))
1898 {
1899 if (size < window_min_height
1900 || size + window_min_height > XFASTINT (o->height))
1901 args_out_of_range_3 (window, chsize, horflag);
1902 if (NILP (o->parent)
1903 || NILP (XWINDOW (o->parent)->vchild))
1904 {
1905 make_dummy_parent (window);
1906 new = o->parent;
1907 XWINDOW (new)->vchild = window;
1908 }
1909 }
1910 else
1911 {
1912 if (size < window_min_width
1913 || size + window_min_width > XFASTINT (o->width))
1914 args_out_of_range_3 (window, chsize, horflag);
1915 if (NILP (o->parent)
1916 || NILP (XWINDOW (o->parent)->hchild))
1917 {
1918 make_dummy_parent (window);
1919 new = o->parent;
1920 XWINDOW (new)->hchild = window;
1921 }
1922 }
1923
1924 /* Now we know that window's parent is a vertical combination
1925 if we are dividing vertically, or a horizontal combination
1926 if we are making side-by-side windows */
1927
1928 windows_or_buffers_changed++;
1929 new = make_window ();
1930 p = XWINDOW (new);
1931
1932 p->frame = o->frame;
1933 p->next = o->next;
1934 if (!NILP (p->next))
1935 XWINDOW (p->next)->prev = new;
1936 p->prev = window;
1937 o->next = new;
1938 p->parent = o->parent;
1939 p->buffer = Qt;
1940
1941 Fset_window_buffer (new, o->buffer);
1942
1943 /* Apportion the available frame space among the two new windows */
1944
1945 if (!NILP (horflag))
1946 {
1947 p->height = o->height;
1948 p->top = o->top;
1949 XFASTINT (p->width) = XFASTINT (o->width) - size;
1950 XFASTINT (o->width) = size;
1951 XFASTINT (p->left) = XFASTINT (o->left) + size;
1952 }
1953 else
1954 {
1955 p->left = o->left;
1956 p->width = o->width;
1957 XFASTINT (p->height) = XFASTINT (o->height) - size;
1958 XFASTINT (o->height) = size;
1959 XFASTINT (p->top) = XFASTINT (o->top) + size;
1960 }
1961
1962 return new;
1963 }
1964 \f
1965 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 2, "p",
1966 "Make current window ARG lines bigger.\n\
1967 From program, optional second arg non-nil means grow sideways ARG columns.")
1968 (n, side)
1969 register Lisp_Object n, side;
1970 {
1971 CHECK_NUMBER (n, 0);
1972 change_window_height (XINT (n), !NILP (side));
1973 return Qnil;
1974 }
1975
1976 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
1977 "Make current window ARG lines smaller.\n\
1978 From program, optional second arg non-nil means shrink sideways ARG columns.")
1979 (n, side)
1980 register Lisp_Object n, side;
1981 {
1982 CHECK_NUMBER (n, 0);
1983 change_window_height (-XINT (n), !NILP (side));
1984 return Qnil;
1985 }
1986
1987 int
1988 window_height (window)
1989 Lisp_Object window;
1990 {
1991 register struct window *p = XWINDOW (window);
1992 return XFASTINT (p->height);
1993 }
1994
1995 int
1996 window_width (window)
1997 Lisp_Object window;
1998 {
1999 register struct window *p = XWINDOW (window);
2000 return XFASTINT (p->width);
2001 }
2002
2003 #define MINSIZE(w) \
2004 (widthflag \
2005 ? window_min_width \
2006 : (MINI_WINDOW_P (XWINDOW (w)) ? 1 : window_min_height))
2007
2008 #define CURBEG(w) \
2009 *(widthflag ? (int *) &(XWINDOW (w)->left) : (int *) &(XWINDOW (w)->top))
2010
2011 #define CURSIZE(w) \
2012 *(widthflag ? (int *) &(XWINDOW (w)->width) : (int *) &(XWINDOW (w)->height))
2013
2014 /* Unlike set_window_height, this function
2015 also changes the heights of the siblings so as to
2016 keep everything consistent. */
2017
2018 change_window_height (delta, widthflag)
2019 register int delta;
2020 int widthflag;
2021 {
2022 register Lisp_Object parent;
2023 Lisp_Object window;
2024 register struct window *p;
2025 int *sizep;
2026 int (*sizefun) () = widthflag ? window_width : window_height;
2027 register int (*setsizefun) () = (widthflag
2028 ? set_window_width
2029 : set_window_height);
2030
2031 check_min_window_sizes ();
2032
2033 window = selected_window;
2034 while (1)
2035 {
2036 p = XWINDOW (window);
2037 parent = p->parent;
2038 if (NILP (parent))
2039 {
2040 if (widthflag)
2041 error ("No other window to side of this one");
2042 break;
2043 }
2044 if (widthflag ? !NILP (XWINDOW (parent)->hchild)
2045 : !NILP (XWINDOW (parent)->vchild))
2046 break;
2047 window = parent;
2048 }
2049
2050 sizep = &CURSIZE (window);
2051
2052 if (*sizep + delta < MINSIZE (window))
2053 {
2054 Fdelete_window (window);
2055 return;
2056 }
2057
2058 {
2059 register int maxdelta;
2060
2061 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - *sizep
2062 : !NILP (p->next) ? (*sizefun) (p->next) - MINSIZE (p->next)
2063 : !NILP (p->prev) ? (*sizefun) (p->prev) - MINSIZE (p->prev)
2064 /* This is a frame with only one window, a minibuffer-only
2065 or a minibufferless frame. */
2066 : (delta = 0));
2067
2068 if (delta > maxdelta)
2069 /* This case traps trying to make the minibuffer
2070 the full frame, or make the only window aside from the
2071 minibuffer the full frame. */
2072 delta = maxdelta;
2073
2074 if (delta == 0)
2075 return;
2076 }
2077
2078 if (!NILP (p->next) &&
2079 (*sizefun) (p->next) - delta >= MINSIZE (p->next))
2080 {
2081 (*setsizefun) (p->next, (*sizefun) (p->next) - delta, 0);
2082 (*setsizefun) (window, *sizep + delta, 0);
2083 CURBEG (p->next) += delta;
2084 /* This does not change size of p->next,
2085 but it propagates the new top edge to its children */
2086 (*setsizefun) (p->next, (*sizefun) (p->next), 0);
2087 }
2088 else if (!NILP (p->prev) &&
2089 (*sizefun) (p->prev) - delta >= MINSIZE (p->prev))
2090 {
2091 (*setsizefun) (p->prev, (*sizefun) (p->prev) - delta, 0);
2092 CURBEG (window) -= delta;
2093 (*setsizefun) (window, *sizep + delta, 0);
2094 }
2095 else
2096 {
2097 register int delta1;
2098 register int opht = (*sizefun) (parent);
2099
2100 /* If trying to grow this window to or beyond size of the parent,
2101 make delta1 so big that, on shrinking back down,
2102 all the siblings end up with less than one line and are deleted. */
2103 if (opht <= *sizep + delta)
2104 delta1 = opht * opht * 2;
2105 /* Otherwise, make delta1 just right so that if we add delta1
2106 lines to this window and to the parent, and then shrink
2107 the parent back to its original size, the new proportional
2108 size of this window will increase by delta. */
2109 else
2110 delta1 = (delta * opht * 100) / ((opht - *sizep - delta) * 100);
2111
2112 /* Add delta1 lines or columns to this window, and to the parent,
2113 keeping things consistent while not affecting siblings. */
2114 CURSIZE (parent) = opht + delta1;
2115 (*setsizefun) (window, *sizep + delta1, 0);
2116
2117 /* Squeeze out delta1 lines or columns from our parent,
2118 shriking this window and siblings proportionately.
2119 This brings parent back to correct size.
2120 Delta1 was calculated so this makes this window the desired size,
2121 taking it all out of the siblings. */
2122 (*setsizefun) (parent, opht, 0);
2123 }
2124
2125 XFASTINT (p->last_modified) = 0;
2126 }
2127 #undef MINSIZE
2128 #undef CURBEG
2129 #undef CURSIZE
2130
2131 \f
2132 /* Return number of lines of text (not counting mode line) in W. */
2133
2134 int
2135 window_internal_height (w)
2136 struct window *w;
2137 {
2138 int ht = XFASTINT (w->height);
2139
2140 if (MINI_WINDOW_P (w))
2141 return ht;
2142
2143 if (!NILP (w->parent) || !NILP (w->vchild) || !NILP (w->hchild)
2144 || !NILP (w->next) || !NILP (w->prev)
2145 || FRAME_WANTS_MODELINE_P (XFRAME (WINDOW_FRAME (w))))
2146 return ht - 1;
2147
2148 return ht;
2149 }
2150
2151
2152 /* Return the number of columns in W.
2153 Don't count columns occupied by scroll bars or the vertical bar
2154 separating W from the sibling to its right. */
2155 int
2156 window_internal_width (w)
2157 struct window *w;
2158 {
2159 FRAME_PTR f = XFRAME (WINDOW_FRAME (w));
2160 int left = XINT (w->left);
2161 int width = XINT (w->width);
2162
2163 /* If this window is flush against the right edge of the frame, its
2164 internal width is its full width. */
2165 if (left + width >= FRAME_WIDTH (f))
2166 return width;
2167
2168 /* If we are not flush right, then our rightmost columns are
2169 occupied by some sort of separator. */
2170
2171 /* Scroll bars occupy a few columns. */
2172 if (FRAME_HAS_VERTICAL_SCROLL_BARS (f))
2173 return width - VERTICAL_SCROLL_BAR_WIDTH;
2174
2175 /* The column of `|' characters separating side-by-side windows
2176 occupies one column only. */
2177 return width - 1;
2178 }
2179
2180
2181 /* Scroll contents of window WINDOW up N lines. */
2182
2183 void
2184 window_scroll (window, n, noerror)
2185 Lisp_Object window;
2186 int n;
2187 int noerror;
2188 {
2189 register struct window *w = XWINDOW (window);
2190 register int opoint = point;
2191 register int pos;
2192 register int ht = window_internal_height (w);
2193 register Lisp_Object tem;
2194 int lose;
2195 Lisp_Object bolp, nmoved;
2196
2197 XFASTINT (tem) = point;
2198 tem = Fpos_visible_in_window_p (tem, window);
2199
2200 if (NILP (tem))
2201 {
2202 Fvertical_motion (make_number (- ht / 2));
2203 XFASTINT (tem) = point;
2204 Fset_marker (w->start, tem, w->buffer);
2205 w->force_start = Qt;
2206 }
2207
2208 SET_PT (marker_position (w->start));
2209 lose = n < 0 && point == BEGV;
2210 Fvertical_motion (make_number (n));
2211 pos = point;
2212 bolp = Fbolp ();
2213 SET_PT (opoint);
2214
2215 if (lose)
2216 {
2217 if (noerror)
2218 return;
2219 else
2220 Fsignal (Qbeginning_of_buffer, Qnil);
2221 }
2222
2223 if (pos < ZV)
2224 {
2225 set_marker_restricted (w->start, make_number (pos), w->buffer);
2226 w->start_at_line_beg = bolp;
2227 w->update_mode_line = Qt;
2228 XFASTINT (w->last_modified) = 0;
2229 if (pos > opoint)
2230 SET_PT (pos);
2231 if (n < 0)
2232 {
2233 SET_PT (pos);
2234 tem = Fvertical_motion (make_number (ht));
2235 if (point > opoint || XFASTINT (tem) < ht)
2236 SET_PT (opoint);
2237 else
2238 Fvertical_motion (make_number (-1));
2239 }
2240 }
2241 else
2242 {
2243 if (noerror)
2244 return;
2245 else
2246 Fsignal (Qend_of_buffer, Qnil);
2247 }
2248 }
2249 \f
2250 /* This is the guts of Fscroll_up and Fscroll_down. */
2251
2252 static void
2253 scroll_command (n, direction)
2254 register Lisp_Object n;
2255 int direction;
2256 {
2257 register int defalt;
2258 int count = specpdl_ptr - specpdl;
2259
2260 /* If selected window's buffer isn't current, make it current for the moment.
2261 But don't screw up if window_scroll gets an error. */
2262 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
2263 {
2264 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2265 Fset_buffer (XWINDOW (selected_window)->buffer);
2266 }
2267
2268 defalt = (window_internal_height (XWINDOW (selected_window))
2269 - next_screen_context_lines);
2270 defalt = direction * (defalt < 1 ? 1 : defalt);
2271
2272 if (NILP (n))
2273 window_scroll (selected_window, defalt, 0);
2274 else if (EQ (n, Qminus))
2275 window_scroll (selected_window, - defalt, 0);
2276 else
2277 {
2278 n = Fprefix_numeric_value (n);
2279 window_scroll (selected_window, XINT (n) * direction, 0);
2280 }
2281
2282 unbind_to (count, Qnil);
2283 }
2284
2285 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
2286 "Scroll text of current window upward ARG lines; or near full screen if no ARG.\n\
2287 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2288 When calling from a program, supply a number as argument or nil.")
2289 (n)
2290 Lisp_Object n;
2291 {
2292 scroll_command (n, 1);
2293 return Qnil;
2294 }
2295
2296 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
2297 "Scroll text of current window downward ARG lines; or near full screen if no ARG.\n\
2298 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2299 When calling from a program, supply a number as argument or nil.")
2300 (n)
2301 Lisp_Object n;
2302 {
2303 scroll_command (n, -1);
2304 return Qnil;
2305 }
2306
2307 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
2308 "Scroll next window upward ARG lines; or near full screen if no ARG.\n\
2309 The next window is the one below the current one; or the one at the top\n\
2310 if the current one is at the bottom.\n\
2311 When calling from a program, supply a number as argument or nil.\n\
2312 \n\
2313 If in the minibuffer, `minibuffer-scroll-window' if non-nil\n\
2314 specifies the window to scroll.\n\
2315 If `other-window-scroll-buffer' is non-nil, scroll the window\n\
2316 showing that buffer, popping the buffer up if necessary.")
2317 (n)
2318 register Lisp_Object n;
2319 {
2320 register Lisp_Object window;
2321 register int ht;
2322 register struct window *w;
2323 register int count = specpdl_ptr - specpdl;
2324
2325 if (MINI_WINDOW_P (XWINDOW (selected_window))
2326 && !NILP (Vminibuf_scroll_window))
2327 window = Vminibuf_scroll_window;
2328 /* If buffer is specified, scroll that buffer. */
2329 else if (!NILP (Vother_window_scroll_buffer))
2330 {
2331 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
2332 if (NILP (window))
2333 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt);
2334 }
2335 else
2336 {
2337 /* Nothing specified; look for a neighboring window on the same
2338 frame. */
2339 window = Fnext_window (selected_window, Qnil, Qnil);
2340
2341 if (EQ (window, selected_window))
2342 /* That didn't get us anywhere; look for a window on another
2343 visible frame. */
2344 do
2345 window = Fnext_window (window, Qnil, Qt);
2346 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
2347 && ! EQ (window, selected_window));
2348 }
2349
2350 CHECK_LIVE_WINDOW (window, 0);
2351
2352 if (EQ (window, selected_window))
2353 error ("There is no other window");
2354
2355 w = XWINDOW (window);
2356 ht = window_internal_height (w);
2357
2358 /* Don't screw up if window_scroll gets an error. */
2359 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2360
2361 Fset_buffer (w->buffer);
2362 SET_PT (marker_position (w->pointm));
2363
2364 if (NILP (n))
2365 window_scroll (window, ht - next_screen_context_lines, 1);
2366 else if (EQ (n, Qminus))
2367 window_scroll (window, next_screen_context_lines - ht, 1);
2368 else
2369 {
2370 if (XTYPE (n) == Lisp_Cons)
2371 n = Fcar (n);
2372 CHECK_NUMBER (n, 0);
2373 window_scroll (window, XINT (n), 1);
2374 }
2375
2376 Fset_marker (w->pointm, make_number (point), Qnil);
2377 unbind_to (count, Qnil);
2378
2379 return Qnil;
2380 }
2381 \f
2382 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 1, "P",
2383 "Scroll selected window display ARG columns left.\n\
2384 Default for ARG is window width minus 2.")
2385 (arg)
2386 register Lisp_Object arg;
2387 {
2388
2389 if (NILP (arg))
2390 XFASTINT (arg) = window_internal_width (XWINDOW (selected_window)) - 2;
2391 else
2392 arg = Fprefix_numeric_value (arg);
2393
2394 return
2395 Fset_window_hscroll (selected_window,
2396 make_number (XINT (XWINDOW (selected_window)->hscroll)
2397 + XINT (arg)));
2398 }
2399
2400 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 1, "P",
2401 "Scroll selected window display ARG columns right.\n\
2402 Default for ARG is window width minus 2.")
2403 (arg)
2404 register Lisp_Object arg;
2405 {
2406 if (NILP (arg))
2407 XFASTINT (arg) = window_internal_width (XWINDOW (selected_window)) - 2;
2408 else
2409 arg = Fprefix_numeric_value (arg);
2410
2411 return
2412 Fset_window_hscroll (selected_window,
2413 make_number (XINT (XWINDOW (selected_window)->hscroll)
2414 - XINT (arg)));
2415 }
2416
2417 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
2418 "Center point in window and redisplay frame. With ARG, put point on line ARG.\n\
2419 The desired position of point is always relative to the current window.\n\
2420 Just C-u as prefix means put point in the center of the window.\n\
2421 No arg (i.e., it is nil) erases the entire frame and then\n\
2422 redraws with point in the center of the current window.")
2423 (n)
2424 register Lisp_Object n;
2425 {
2426 register struct window *w = XWINDOW (selected_window);
2427 register int ht = window_internal_height (w);
2428 register int opoint = point;
2429
2430 if (NILP (n))
2431 {
2432 extern int frame_garbaged;
2433
2434 SET_FRAME_GARBAGED (XFRAME (WINDOW_FRAME (w)));
2435 XFASTINT (n) = ht / 2;
2436 }
2437 else if (XTYPE (n) == Lisp_Cons) /* Just C-u. */
2438 {
2439 XFASTINT (n) = ht / 2;
2440 }
2441 else
2442 {
2443 n = Fprefix_numeric_value (n);
2444 CHECK_NUMBER (n, 0);
2445 }
2446
2447 if (XINT (n) < 0)
2448 XSETINT (n, XINT (n) + ht);
2449
2450 XSETINT (n, - XINT (n));
2451
2452 Fvertical_motion (n);
2453 Fset_marker (w->start, make_number (point), w->buffer);
2454 w->start_at_line_beg = Fbolp ();
2455
2456 SET_PT (opoint);
2457 w->force_start = Qt;
2458
2459 return Qnil;
2460 }
2461 \f
2462 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
2463 1, 1, "P",
2464 "Position point relative to window.\n\
2465 With no argument, position text at center of window.\n\
2466 An argument specifies frame line; zero means top of window,\n\
2467 negative means relative to bottom of window.")
2468 (arg)
2469 register Lisp_Object arg;
2470 {
2471 register struct window *w = XWINDOW (selected_window);
2472 register int height = window_internal_height (w);
2473 register int start;
2474
2475 if (NILP (arg))
2476 XFASTINT (arg) = height / 2;
2477 else
2478 {
2479 arg = Fprefix_numeric_value (arg);
2480 if (XINT (arg) < 0)
2481 XSETINT (arg, XINT (arg) + height);
2482 }
2483
2484 start = marker_position (w->start);
2485 if (start < BEGV || start > ZV)
2486 {
2487 Fvertical_motion (make_number (- height / 2));
2488 Fset_marker (w->start, make_number (point), w->buffer);
2489 w->start_at_line_beg = Fbolp ();
2490 w->force_start = Qt;
2491 }
2492 else
2493 SET_PT (start);
2494
2495 return Fvertical_motion (arg);
2496 }
2497 \f
2498 struct save_window_data
2499 {
2500 int size_from_Lisp_Vector_struct;
2501 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2502 Lisp_Object frame_width, frame_height, frame_menu_bar_lines;
2503 Lisp_Object selected_frame;
2504 Lisp_Object current_window;
2505 Lisp_Object current_buffer;
2506 Lisp_Object minibuf_scroll_window;
2507 Lisp_Object root_window;
2508 Lisp_Object focus_frame;
2509 /* A vector, interpreted as a struct saved_window */
2510 Lisp_Object saved_windows;
2511 };
2512
2513 /* Arg to Fmake_vector */
2514 #define SAVE_WINDOW_DATA_SIZE \
2515 ((sizeof (struct save_window_data) \
2516 - (sizeof (struct Lisp_Vector) \
2517 /* Don't count the contents member of the struct Lisp_Vector */ \
2518 - sizeof (Lisp_Object))) \
2519 / sizeof (Lisp_Object))
2520
2521 /* This is saved as a Lisp_Vector */
2522 struct saved_window
2523 {
2524 /* these first two must agree with struct Lisp_Vector in lisp.h */
2525 int size_from_Lisp_Vector_struct;
2526 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2527
2528 Lisp_Object window;
2529 Lisp_Object buffer, start, pointm, mark;
2530 Lisp_Object left, top, width, height, hscroll;
2531 Lisp_Object parent, prev;
2532 Lisp_Object start_at_line_beg;
2533 Lisp_Object display_table;
2534 };
2535 #define SAVED_WINDOW_VECTOR_SIZE 14 /* Arg to Fmake_vector */
2536
2537 #define SAVED_WINDOW_N(swv,n) \
2538 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
2539
2540 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
2541 "T if OBJECT is a window-configration object.")
2542 (obj)
2543 Lisp_Object obj;
2544 {
2545 if (XTYPE (obj) == Lisp_Window_Configuration)
2546 return Qt;
2547 return Qnil;
2548 }
2549
2550
2551 DEFUN ("set-window-configuration", Fset_window_configuration,
2552 Sset_window_configuration, 1, 1, 0,
2553 "Set the configuration of windows and buffers as specified by CONFIGURATION.\n\
2554 CONFIGURATION must be a value previously returned\n\
2555 by `current-window-configuration' (which see).")
2556 (configuration)
2557 Lisp_Object configuration;
2558 {
2559 register struct save_window_data *data;
2560 struct Lisp_Vector *saved_windows;
2561 Lisp_Object new_current_buffer;
2562 Lisp_Object frame;
2563 FRAME_PTR f;
2564
2565 while (XTYPE (configuration) != Lisp_Window_Configuration)
2566 {
2567 configuration = wrong_type_argument (intern ("window-configuration-p"),
2568 configuration);
2569 }
2570
2571 data = (struct save_window_data *) XVECTOR (configuration);
2572 saved_windows = XVECTOR (data->saved_windows);
2573
2574 new_current_buffer = data->current_buffer;
2575 if (NILP (XBUFFER (new_current_buffer)->name))
2576 new_current_buffer = Qnil;
2577
2578 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
2579 f = XFRAME (frame);
2580
2581 /* If f is a dead frame, don't bother rebuilding its window tree.
2582 However, there is other stuff we should still try to do below. */
2583 if (FRAME_LIVE_P (f))
2584 {
2585 register struct window *w;
2586 register struct saved_window *p;
2587 int k;
2588
2589 /* If the frame has been resized since this window configuration was
2590 made, we change the frame to the size specified in the
2591 configuration, restore the configuration, and then resize it
2592 back. We keep track of the prevailing height in these variables. */
2593 int previous_frame_height = FRAME_HEIGHT (f);
2594 int previous_frame_width = FRAME_WIDTH (f);
2595 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
2596
2597 if (XFASTINT (data->frame_height) != previous_frame_height
2598 || XFASTINT (data->frame_width) != previous_frame_width)
2599 change_frame_size (f, data->frame_height, data->frame_width, 0, 0);
2600 if (XFASTINT (data->frame_menu_bar_lines)
2601 != previous_frame_menu_bar_lines)
2602 x_set_menu_bar_lines (f, data->frame_menu_bar_lines, 0);
2603
2604 windows_or_buffers_changed++;
2605
2606 /* Kludge Alert!
2607 Mark all windows now on frame as "deleted".
2608 Restoring the new configuration "undeletes" any that are in it.
2609
2610 Save their current buffers in their height fields, since we may
2611 need it later, if a buffer saved in the configuration is now
2612 dead. */
2613 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
2614
2615 for (k = 0; k < saved_windows->size; k++)
2616 {
2617 p = SAVED_WINDOW_N (saved_windows, k);
2618 w = XWINDOW (p->window);
2619 w->next = Qnil;
2620
2621 if (!NILP (p->parent))
2622 w->parent = SAVED_WINDOW_N (saved_windows,
2623 XFASTINT (p->parent))->window;
2624 else
2625 w->parent = Qnil;
2626
2627 if (!NILP (p->prev))
2628 {
2629 w->prev = SAVED_WINDOW_N (saved_windows,
2630 XFASTINT (p->prev))->window;
2631 XWINDOW (w->prev)->next = p->window;
2632 }
2633 else
2634 {
2635 w->prev = Qnil;
2636 if (!NILP (w->parent))
2637 {
2638 if (EQ (p->width, XWINDOW (w->parent)->width))
2639 {
2640 XWINDOW (w->parent)->vchild = p->window;
2641 XWINDOW (w->parent)->hchild = Qnil;
2642 }
2643 else
2644 {
2645 XWINDOW (w->parent)->hchild = p->window;
2646 XWINDOW (w->parent)->vchild = Qnil;
2647 }
2648 }
2649 }
2650
2651 /* If we squirreled away the buffer in the window's height,
2652 restore it now. */
2653 if (XTYPE (w->height) == Lisp_Buffer)
2654 w->buffer = w->height;
2655 w->left = p->left;
2656 w->top = p->top;
2657 w->width = p->width;
2658 w->height = p->height;
2659 w->hscroll = p->hscroll;
2660 w->display_table = p->display_table;
2661 XFASTINT (w->last_modified) = 0;
2662
2663 /* Reinstall the saved buffer and pointers into it. */
2664 if (NILP (p->buffer))
2665 w->buffer = p->buffer;
2666 else
2667 {
2668 if (!NILP (XBUFFER (p->buffer)->name))
2669 /* If saved buffer is alive, install it. */
2670 {
2671 w->buffer = p->buffer;
2672 w->start_at_line_beg = p->start_at_line_beg;
2673 set_marker_restricted (w->start,
2674 Fmarker_position (p->start),
2675 w->buffer);
2676 set_marker_restricted (w->pointm,
2677 Fmarker_position (p->pointm),
2678 w->buffer);
2679 Fset_marker (XBUFFER (w->buffer)->mark,
2680 Fmarker_position (p->mark), w->buffer);
2681
2682 /* As documented in Fcurrent_window_configuration, don't
2683 save the location of point in the buffer which was current
2684 when the window configuration was recorded. */
2685 if (!EQ (p->buffer, new_current_buffer) &&
2686 XBUFFER (p->buffer) == current_buffer)
2687 Fgoto_char (w->pointm);
2688 }
2689 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
2690 /* Else unless window has a live buffer, get one. */
2691 {
2692 w->buffer = Fcdr (Fcar (Vbuffer_alist));
2693 /* This will set the markers to beginning of visible
2694 range. */
2695 set_marker_restricted (w->start, make_number (0), w->buffer);
2696 set_marker_restricted (w->pointm, make_number (0),w->buffer);
2697 w->start_at_line_beg = Qt;
2698 }
2699 else
2700 /* Keeping window's old buffer; make sure the markers
2701 are real. */
2702 {
2703 /* Set window markers at start of visible range. */
2704 if (XMARKER (w->start)->buffer == 0)
2705 set_marker_restricted (w->start, make_number (0),
2706 w->buffer);
2707 if (XMARKER (w->pointm)->buffer == 0)
2708 set_marker_restricted (w->pointm,
2709 (make_number
2710 (BUF_PT (XBUFFER (w->buffer)))),
2711 w->buffer);
2712 w->start_at_line_beg = Qt;
2713 }
2714 }
2715 }
2716
2717 FRAME_ROOT_WINDOW (f) = data->root_window;
2718 Fselect_window (data->current_window);
2719
2720 #ifdef MULTI_FRAME
2721 if (NILP (data->focus_frame)
2722 || (XTYPE (data->focus_frame) == Lisp_Frame
2723 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
2724 Fredirect_frame_focus (frame, data->focus_frame);
2725 #endif
2726
2727 #if 0 /* I don't understand why this is needed, and it causes problems
2728 when the frame's old selected window has been deleted. */
2729 #ifdef MULTI_FRAME
2730 if (f != selected_frame && ! FRAME_TERMCAP_P (f))
2731 Fhandle_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)), Qnil);
2732 #endif
2733 #endif
2734
2735 /* Set the screen height to the value it had before this function. */
2736 if (previous_frame_height != FRAME_HEIGHT (f)
2737 || previous_frame_width != FRAME_WIDTH (f))
2738 change_frame_size (f, previous_frame_height, previous_frame_width,
2739 0, 0);
2740 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
2741 x_set_menu_bar_lines (f, previous_frame_menu_bar_lines, 0);
2742 }
2743
2744 #ifdef MULTI_FRAME
2745 /* Fselect_window will have made f the selected frame, so we
2746 reselect the proper frame here. Fhandle_switch_frame will change the
2747 selected window too, but that doesn't make the call to
2748 Fselect_window above totally superfluous; it still sets f's
2749 selected window. */
2750 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
2751 Fhandle_switch_frame (data->selected_frame, Qnil);
2752 #endif
2753
2754 if (!NILP (new_current_buffer))
2755 Fset_buffer (new_current_buffer);
2756
2757 Vminibuf_scroll_window = data->minibuf_scroll_window;
2758 return (Qnil);
2759 }
2760
2761 /* Mark all windows now on frame as deleted
2762 by setting their buffers to nil. */
2763
2764 void
2765 delete_all_subwindows (w)
2766 register struct window *w;
2767 {
2768 if (!NILP (w->next))
2769 delete_all_subwindows (XWINDOW (w->next));
2770 if (!NILP (w->vchild))
2771 delete_all_subwindows (XWINDOW (w->vchild));
2772 if (!NILP (w->hchild))
2773 delete_all_subwindows (XWINDOW (w->hchild));
2774
2775 w->height = w->buffer; /* See Fset_window_configuration for excuse. */
2776
2777 /* We set all three of these fields to nil, to make sure that we can
2778 distinguish this dead window from any live window. Live leaf
2779 windows will have buffer set, and combination windows will have
2780 vchild or hchild set. */
2781 w->buffer = Qnil;
2782 w->vchild = Qnil;
2783 w->hchild = Qnil;
2784 }
2785 \f
2786 static int
2787 count_windows (window)
2788 register struct window *window;
2789 {
2790 register int count = 1;
2791 if (!NILP (window->next))
2792 count += count_windows (XWINDOW (window->next));
2793 if (!NILP (window->vchild))
2794 count += count_windows (XWINDOW (window->vchild));
2795 if (!NILP (window->hchild))
2796 count += count_windows (XWINDOW (window->hchild));
2797 return count;
2798 }
2799
2800 static int
2801 save_window_save (window, vector, i)
2802 Lisp_Object window;
2803 struct Lisp_Vector *vector;
2804 int i;
2805 {
2806 register struct saved_window *p;
2807 register struct window *w;
2808 register Lisp_Object tem;
2809
2810 for (;!NILP (window); window = w->next)
2811 {
2812 p = SAVED_WINDOW_N (vector, i);
2813 w = XWINDOW (window);
2814
2815 XFASTINT (w->temslot) = i++;
2816 p->window = window;
2817 p->buffer = w->buffer;
2818 p->left = w->left;
2819 p->top = w->top;
2820 p->width = w->width;
2821 p->height = w->height;
2822 p->hscroll = w->hscroll;
2823 p->display_table = w->display_table;
2824 if (!NILP (w->buffer))
2825 {
2826 /* Save w's value of point in the window configuration.
2827 If w is the selected window, then get the value of point
2828 from the buffer; pointm is garbage in the selected window. */
2829 if (EQ (window, selected_window))
2830 {
2831 p->pointm = Fmake_marker ();
2832 Fset_marker (p->pointm, BUF_PT (XBUFFER (w->buffer)),
2833 w->buffer);
2834 }
2835 else
2836 p->pointm = Fcopy_marker (w->pointm);
2837
2838 p->start = Fcopy_marker (w->start);
2839 p->start_at_line_beg = w->start_at_line_beg;
2840
2841 tem = XBUFFER (w->buffer)->mark;
2842 p->mark = Fcopy_marker (tem);
2843 }
2844 else
2845 {
2846 p->pointm = Qnil;
2847 p->start = Qnil;
2848 p->mark = Qnil;
2849 p->start_at_line_beg = Qnil;
2850 }
2851
2852 if (NILP (w->parent))
2853 p->parent = Qnil;
2854 else
2855 p->parent = XWINDOW (w->parent)->temslot;
2856
2857 if (NILP (w->prev))
2858 p->prev = Qnil;
2859 else
2860 p->prev = XWINDOW (w->prev)->temslot;
2861
2862 if (!NILP (w->vchild))
2863 i = save_window_save (w->vchild, vector, i);
2864 if (!NILP (w->hchild))
2865 i = save_window_save (w->hchild, vector, i);
2866 }
2867
2868 return i;
2869 }
2870
2871 DEFUN ("current-window-configuration",
2872 Fcurrent_window_configuration, Scurrent_window_configuration, 0, 1, 0,
2873 "Return an object representing the current window configuration of FRAME.\n\
2874 If FRAME is nil or omitted, use the selected frame.\n\
2875 This describes the number of windows, their sizes and current buffers,\n\
2876 and for each displayed buffer, where display starts, and the positions of\n\
2877 point and mark. An exception is made for point in the current buffer:\n\
2878 its value is -not- saved.\n\
2879 This also records the currently selected frame, and FRAME's focus\n\
2880 redirection (see `redirect-frame-focus').")
2881 (frame)
2882 Lisp_Object frame;
2883 {
2884 register Lisp_Object tem;
2885 register int n_windows;
2886 register struct save_window_data *data;
2887 register int i;
2888 FRAME_PTR f;
2889
2890 if (NILP (frame))
2891 f = selected_frame;
2892 else
2893 {
2894 CHECK_LIVE_FRAME (frame, 0);
2895 f = XFRAME (frame);
2896 }
2897
2898 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
2899 data = (struct save_window_data *)
2900 XVECTOR (Fmake_vector (make_number (SAVE_WINDOW_DATA_SIZE),
2901 Qnil));
2902 XFASTINT (data->frame_width) = FRAME_WIDTH (f);
2903 XFASTINT (data->frame_height) = FRAME_HEIGHT (f);
2904 XFASTINT (data->frame_menu_bar_lines) = FRAME_MENU_BAR_LINES (f);
2905 #ifdef MULTI_FRAME
2906 XSET (data->selected_frame, Lisp_Frame, selected_frame);
2907 #endif
2908 data->current_window = FRAME_SELECTED_WINDOW (f);
2909 XSET (data->current_buffer, Lisp_Buffer, current_buffer);
2910 data->minibuf_scroll_window = Vminibuf_scroll_window;
2911 data->root_window = FRAME_ROOT_WINDOW (f);
2912 data->focus_frame = FRAME_FOCUS_FRAME (f);
2913 tem = Fmake_vector (make_number (n_windows), Qnil);
2914 data->saved_windows = tem;
2915 for (i = 0; i < n_windows; i++)
2916 XVECTOR (tem)->contents[i]
2917 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE), Qnil);
2918 save_window_save (FRAME_ROOT_WINDOW (f),
2919 XVECTOR (tem), 0);
2920 XSET (tem, Lisp_Window_Configuration, data);
2921 return (tem);
2922 }
2923
2924 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
2925 0, UNEVALLED, 0,
2926 "Execute body, preserving window sizes and contents.\n\
2927 Restores which buffer appears in which window, where display starts,\n\
2928 as well as the current buffer.\n\
2929 Does not restore the value of point in current buffer.")
2930 (args)
2931 Lisp_Object args;
2932 {
2933 register Lisp_Object val;
2934 register int count = specpdl_ptr - specpdl;
2935
2936 record_unwind_protect (Fset_window_configuration,
2937 Fcurrent_window_configuration (Qnil));
2938 val = Fprogn (args);
2939 return unbind_to (count, val);
2940 }
2941 \f
2942 init_window_once ()
2943 {
2944 #ifdef MULTI_FRAME
2945 selected_frame = make_terminal_frame ();
2946 minibuf_window = selected_frame->minibuffer_window;
2947 selected_window = selected_frame->selected_window;
2948 last_nonminibuf_frame = selected_frame;
2949 #else /* not MULTI_FRAME */
2950 extern Lisp_Object get_minibuffer ();
2951
2952 minibuf_window = make_window ();
2953 FRAME_ROOT_WINDOW (selected_frame) = make_window ();
2954
2955 XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->next = minibuf_window;
2956 XWINDOW (minibuf_window)->prev = FRAME_ROOT_WINDOW (selected_frame);
2957 XWINDOW (minibuf_window)->mini_p = Qt;
2958
2959 /* These values 9 and 10 are arbitrary,
2960 just so that there is "something there."
2961 Correct values are put in in init_xdisp */
2962
2963 XFASTINT (XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->width) = 10;
2964 XFASTINT (XWINDOW (minibuf_window)->width) = 10;
2965
2966 XFASTINT (XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->height) = 9;
2967 XFASTINT (XWINDOW (minibuf_window)->top) = 9;
2968 XFASTINT (XWINDOW (minibuf_window)->height) = 1;
2969
2970 /* Prevent error in Fset_window_buffer. */
2971 XWINDOW (FRAME_ROOT_WINDOW (selected_frame))->buffer = Qt;
2972 XWINDOW (minibuf_window)->buffer = Qt;
2973
2974 /* Now set them up for real. */
2975 Fset_window_buffer (FRAME_ROOT_WINDOW (selected_frame),
2976 Fcurrent_buffer ());
2977 Fset_window_buffer (minibuf_window, get_minibuffer (0));
2978
2979 selected_window = FRAME_ROOT_WINDOW (selected_frame);
2980 /* Make sure this window seems more recently used than
2981 a newly-created, never-selected window. Increment
2982 window_select_count so the first selection ever will get
2983 something newer than this. */
2984 XFASTINT (XWINDOW (selected_window)->use_time) = ++window_select_count;
2985 #endif /* not MULTI_FRAME */
2986 }
2987
2988 syms_of_window ()
2989 {
2990 Qwindowp = intern ("windowp");
2991 staticpro (&Qwindowp);
2992
2993 Qwindow_live_p = intern ("window-live-p");
2994 staticpro (&Qwindow_live_p);
2995
2996 #ifndef MULTI_FRAME
2997 /* Make sure all windows get marked */
2998 staticpro (&minibuf_window);
2999 #endif
3000
3001 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
3002 "Non-nil means call as function to display a help buffer.\n\
3003 Used by `with-output-to-temp-buffer'.");
3004 Vtemp_buffer_show_function = Qnil;
3005
3006 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
3007 "If non-nil, function to call to handle `display-buffer'.\n\
3008 It will receive two args, the buffer and a flag which if non-nil means\n\
3009 that the currently selected window is not acceptable.\n\
3010 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'\n\
3011 work using this function.");
3012 Vdisplay_buffer_function = Qnil;
3013
3014 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
3015 "Non-nil means it is the window that C-M-v in minibuffer should scroll.");
3016 Vminibuf_scroll_window = Qnil;
3017
3018 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
3019 "If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window.");
3020 Vother_window_scroll_buffer = Qnil;
3021
3022 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
3023 "*Non-nil means `display-buffer' should make a separate frame.");
3024 pop_up_frames = 0;
3025
3026 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
3027 "*If non-nil, function to call to handle automatic new frame creation.\n\
3028 It is called with no arguments and should return a newly created frame.\n\
3029 \n\
3030 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'\n\
3031 where `pop-up-frame-alist' would hold the default frame parameters.");
3032 Vpop_up_frame_function = Qnil;
3033
3034 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
3035 "*Non-nil means display-buffer should make new windows.");
3036 pop_up_windows = 1;
3037
3038 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
3039 "*Number of lines of continuity when scrolling by screenfuls.");
3040 next_screen_context_lines = 2;
3041
3042 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
3043 "*display-buffer would prefer to split the largest window if this large.\n\
3044 If there is only one window, it is split regardless of this value.");
3045 split_height_threshold = 500;
3046
3047 DEFVAR_INT ("window-min-height", &window_min_height,
3048 "*Delete any window less than this tall (including its mode line).");
3049 window_min_height = 4;
3050
3051 DEFVAR_INT ("window-min-width", &window_min_width,
3052 "*Delete any window less than this wide.");
3053 window_min_width = 10;
3054
3055 defsubr (&Sselected_window);
3056 defsubr (&Sminibuffer_window);
3057 defsubr (&Swindow_minibuffer_p);
3058 defsubr (&Swindowp);
3059 defsubr (&Swindow_live_p);
3060 defsubr (&Spos_visible_in_window_p);
3061 defsubr (&Swindow_buffer);
3062 defsubr (&Swindow_height);
3063 defsubr (&Swindow_width);
3064 defsubr (&Swindow_hscroll);
3065 defsubr (&Sset_window_hscroll);
3066 defsubr (&Swindow_edges);
3067 defsubr (&Scoordinates_in_window_p);
3068 defsubr (&Swindow_at);
3069 defsubr (&Swindow_point);
3070 defsubr (&Swindow_start);
3071 defsubr (&Swindow_end);
3072 defsubr (&Sset_window_point);
3073 defsubr (&Sset_window_start);
3074 defsubr (&Swindow_dedicated_p);
3075 defsubr (&Sset_window_dedicated_p);
3076 defsubr (&Swindow_display_table);
3077 defsubr (&Sset_window_display_table);
3078 defsubr (&Snext_window);
3079 defsubr (&Sprevious_window);
3080 defsubr (&Sother_window);
3081 defsubr (&Sget_lru_window);
3082 defsubr (&Sget_largest_window);
3083 defsubr (&Sget_buffer_window);
3084 defsubr (&Sdelete_other_windows);
3085 defsubr (&Sdelete_windows_on);
3086 defsubr (&Sreplace_buffer_in_windows);
3087 defsubr (&Sdelete_window);
3088 defsubr (&Sset_window_buffer);
3089 defsubr (&Sselect_window);
3090 defsubr (&Sdisplay_buffer);
3091 defsubr (&Ssplit_window);
3092 defsubr (&Senlarge_window);
3093 defsubr (&Sshrink_window);
3094 defsubr (&Sscroll_up);
3095 defsubr (&Sscroll_down);
3096 defsubr (&Sscroll_left);
3097 defsubr (&Sscroll_right);
3098 defsubr (&Sscroll_other_window);
3099 defsubr (&Srecenter);
3100 defsubr (&Smove_to_window_line);
3101 defsubr (&Swindow_configuration_p);
3102 defsubr (&Sset_window_configuration);
3103 defsubr (&Scurrent_window_configuration);
3104 defsubr (&Ssave_window_excursion);
3105 }
3106
3107 keys_of_window ()
3108 {
3109 initial_define_key (control_x_map, '1', "delete-other-windows");
3110 initial_define_key (control_x_map, '2', "split-window");
3111 initial_define_key (control_x_map, '0', "delete-window");
3112 initial_define_key (control_x_map, 'o', "other-window");
3113 initial_define_key (control_x_map, '^', "enlarge-window");
3114 initial_define_key (control_x_map, '<', "scroll-left");
3115 initial_define_key (control_x_map, '>', "scroll-right");
3116
3117 initial_define_key (global_map, Ctl ('V'), "scroll-up");
3118 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
3119 initial_define_key (meta_map, 'v', "scroll-down");
3120
3121 initial_define_key (global_map, Ctl('L'), "recenter");
3122 initial_define_key (meta_map, 'r', "move-to-window-line");
3123 }