*** empty log message ***
[emacs.git] / src / window.c
blob43a4a95b744f12fd5dbdb52c59beb98f3d944f44
1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985, 1986, 1987 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
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 1, or (at your option)
10 any later version.
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.
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. */
21 #include "config.h"
22 #include "lisp.h"
23 #include "buffer.h"
24 #include "screen.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"
32 Lisp_Object Qwindowp;
34 Lisp_Object Fnext_window (), Fdelete_window (), Fselect_window ();
35 Lisp_Object Fset_window_buffer (), Fsplit_window (), Frecenter ();
37 static void delete_all_subwindows ();
38 static struct window *decode_window();
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.
45 This value is always the same as
46 SCREEN_SELECTED_WINDOW (selected_screen). */
48 Lisp_Object selected_window;
50 #ifndef MULTI_SCREEN
52 /* The root window for the screen.
53 This is accessed via SCREEN_ROOT_WINDOW (selected_screen). */
54 Lisp_Object root_window;
56 #endif
58 /* The minibuffer window of the selected screen.
59 Note that you cannot test for minibufferness of an arbitrary window
60 by comparing against this; but you can test for minibufferness of
61 the selected window. */
62 Lisp_Object minibuf_window;
64 /* Non-nil means it is the window for C-M-v to scroll
65 when the minibuffer is selected. */
66 Lisp_Object Vminibuf_scroll_window;
68 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
69 Lisp_Object Vother_window_scroll_buffer;
71 /* Window that the mouse is over (nil if no mouse support). */
72 Lisp_Object Vmouse_window;
74 /* Last mouse click data structure (nil if no mouse support). */
75 Lisp_Object Vmouse_event;
77 /* Non-nil means it's function to call to display temp buffers. */
78 Lisp_Object Vtemp_buffer_show_function;
80 /* If a window gets smaller than either of these, it is removed. */
81 int window_min_height;
82 int window_min_width;
84 /* Nonzero implies Fdisplay_buffer should create windows. */
85 int pop_up_windows;
87 /* Nonzero implies make new X screens for Fdisplay_buffer. */
88 int pop_up_screens;
90 /* Non-nil means use this function instead of default */
91 Lisp_Object Vpop_up_screen_function;
93 /* Function to call to handle Fdisplay_buffer. */
94 Lisp_Object Vdisplay_buffer_function;
96 /* Fdisplay_buffer always splits the largest window
97 if that window is more than this high. */
98 int split_height_threshold;
100 /* Number of lines of continuity in scrolling by screenfuls. */
101 int next_screen_context_lines;
103 /* Incremented for each window created. */
104 static int sequence_number;
106 #define min(a, b) ((a) < (b) ? (a) : (b))
108 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
109 "Returns t if OBJ is a window.")
110 (obj)
111 Lisp_Object obj;
113 return XTYPE (obj) == Lisp_Window ? Qt : Qnil;
116 Lisp_Object
117 make_window ()
119 register Lisp_Object val;
120 register struct window *p;
122 /* Add sizeof (Lisp_Object) here because sizeof (struct Lisp_Vector)
123 includes the first element. */
124 val = Fmake_vector (
125 make_number ((sizeof (struct window) - sizeof (struct Lisp_Vector)
126 + sizeof (Lisp_Object))
127 / sizeof (Lisp_Object)),
128 Qnil);
129 XSETTYPE (val, Lisp_Window);
130 p = XWINDOW (val);
131 XFASTINT (p->sequence_number) = ++sequence_number;
132 XFASTINT (p->left) = XFASTINT (p->top)
133 = XFASTINT (p->height) = XFASTINT (p->width)
134 = XFASTINT (p->hscroll) = 0;
135 XFASTINT (p->last_point_x) = XFASTINT (p->last_point_y) = 0;
136 p->start = Fmake_marker ();
137 p->pointm = Fmake_marker ();
138 XFASTINT (p->use_time) = 0;
139 p->screen = Qnil;
140 p->display_table = Qnil;
141 p->dedicated = Qnil;
142 return val;
145 DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
146 "Return the window that the cursor now appears in and commands apply to.")
149 return selected_window;
152 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 0, 0,
153 "Return the window used now for minibuffers.")
156 #ifdef MULTI_SCREEN
157 choose_minibuf_screen ();
158 #endif /* MULTI_SCREEN */
159 return minibuf_window;
162 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 1, 1, 0,
163 "Returns non-nil if WINDOW is a minibuffer window.")
164 (window)
165 Lisp_Object window;
167 struct window *w = decode_window (window);
168 return (MINI_WINDOW_P (w) ? Qt : Qnil);
171 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p,
172 Spos_visible_in_window_p, 0, 2, 0,
173 "Return t if position POS is currently on the screen in WINDOW.\n\
174 Returns nil if that position is scrolled vertically out of view.\n\
175 POS defaults to point; WINDOW, to the selected window.")
176 (pos, window)
177 Lisp_Object pos, window;
179 register struct window *w;
180 register int top;
181 register int height;
182 register int posint;
183 register struct buffer *buf;
184 struct position posval;
186 if (NILP (pos))
187 posint = point;
188 else
190 CHECK_NUMBER_COERCE_MARKER (pos, 0);
191 posint = XINT (pos);
194 if (NILP (window))
195 window = selected_window;
196 else
197 CHECK_WINDOW (window, 1);
198 w = XWINDOW (window);
199 top = marker_position (w->start);
201 if (posint < top)
202 return Qnil;
204 height = XFASTINT (w->height) - ! MINI_WINDOW_P (w);
206 buf = XBUFFER (w->buffer);
207 if (XFASTINT (w->last_modified) >= BUF_MODIFF (buf))
209 /* If screen is up to date,
210 use the info recorded about how much text fit on it. */
211 if (posint < BUF_Z (buf) - XFASTINT (w->window_end_pos)
212 || (XFASTINT (w->window_end_vpos) < height))
213 return Qt;
214 return Qnil;
216 else
218 if (posint > BUF_Z (buf))
219 return Qnil;
221 /* If that info is not correct, calculate afresh */
222 posval = *compute_motion (top, 0, 0, posint, height, 0,
223 XFASTINT (w->width) - 1
224 - (XFASTINT (w->width) + XFASTINT (w->left)
225 != XSCREEN (w->screen)->width),
226 XINT (w->hscroll), 0);
228 return posval.vpos < height ? Qt : Qnil;
232 static struct window *
233 decode_window (window)
234 register Lisp_Object window;
236 if (NILP (window))
237 return XWINDOW (selected_window);
239 CHECK_WINDOW (window, 0);
240 return XWINDOW (window);
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;
248 return decode_window (window)->buffer;
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;
256 return decode_window (window)->height;
259 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
260 "Return the number of columns in WINDOW.")
261 (window)
262 Lisp_Object window;
264 register struct window *w = decode_window (window);
265 register int width = w->width;
267 /* If this window does not end at the right margin,
268 must deduct one column for the border */
269 if ((width + w->left) == SCREEN_WIDTH (XSCREEN (WINDOW_SCREEN (w))))
270 return width;
271 return width - 1;
274 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
275 "Return the number of columns by which WINDOW is scrolled from left margin.")
276 (window)
277 Lisp_Object window;
279 return decode_window (window)->hscroll;
282 DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
283 "Set number of columns WINDOW is scrolled from left margin to NCOL.\n\
284 NCOL should be zero or positive.")
285 (window, ncol)
286 register Lisp_Object window, ncol;
288 register struct window *w;
290 CHECK_NUMBER (ncol, 1);
291 if (XINT (ncol) < 0) XFASTINT (ncol) = 0;
292 if (XFASTINT (ncol) >= (1 << (SHORTBITS - 1)))
293 args_out_of_range (ncol, Qnil);
294 w = decode_window (window);
295 if (w->hscroll != ncol)
296 clip_changed = 1; /* Prevent redisplay shortcuts */
297 w->hscroll = ncol;
298 return ncol;
301 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
302 "Return a list of the edge coordinates of WINDOW.\n\
303 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of screen.\n\
304 RIGHT is one more than the rightmost column used by WINDOW,\n\
305 and BOTTOM is one more than the bottommost row used by WINDOW\n\
306 and its mode-line.")
307 (window)
308 Lisp_Object window;
310 register struct window *w = decode_window (window);
312 return Fcons (w->left, Fcons (w->top,
313 Fcons (make_number (XFASTINT (w->left) + XFASTINT (w->width)),
314 Fcons (make_number (XFASTINT (w->top)
315 + XFASTINT (w->height)),
316 Qnil))));
319 /* Test if the character at column *x, row *y is within window *w.
320 If it is not, return 0;
321 if it is in the window's text area,
322 set *x and *y to its location relative to the upper left corner
323 of the window, and
324 return 1;
325 if it is on the window's modeline, return 2;
326 if it is on the border between the window and its right sibling,
327 return 3. */
328 static int
329 coordinates_in_window (w, x, y)
330 register struct window *w;
331 register int *x, *y;
333 register int left = XINT (w->left);
334 register int width = XINT (w->width);
335 register int window_height = XINT (w->height);
336 register int top = XFASTINT (w->top);
338 if ( *x < left || *x >= left + width
339 || *y < top || *y >= top + window_height)
340 return 0;
342 /* Is the character is the mode line? */
343 if (*y == top + window_height - 1
344 && window_height > 1) /* 1 line => minibuffer */
345 return 2;
347 /* Is the character in the right border? */
348 if (*x == left + width - 1
349 && left + width != SCREEN_WIDTH (XSCREEN (w->screen)))
350 return 3;
352 *x -= left;
353 *y -= top;
354 return 1;
357 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
358 Scoordinates_in_window_p, 2, 2, 0,
359 "Return non-nil if COORDINATES are in WINDOW.\n\
360 COORDINATES is a cons of the form (X . Y), X and Y being screen-relative.\n\
361 If COORDINATES are in the text portion of WINDOW,\n\
362 the coordinates relative to the window are returned.\n\
363 If they are in the mode line of WINDOW, 'mode-line is returned.\n\
364 If they are on the border between WINDOW and its right sibling,\n\
365 'vertical-split is returned.")
366 (coordinates, window)
367 register Lisp_Object coordinates, window;
369 int x, y;
371 CHECK_WINDOW (window, 0);
372 CHECK_CONS (coordinates, 1);
373 x = XINT (Fcar (coordinates));
374 y = XINT (Fcdr (coordinates));
376 switch (coordinates_in_window (XWINDOW (window), &x, &y))
378 case 0: /* NOT in window at all. */
379 return Qnil;
381 case 1: /* In text part of window. */
382 return Fcons (x, y);
384 case 2: /* In mode line of window. */
385 return Qmode_line;
387 case 3: /* On right border of window. */
388 return Qvertical_split;
390 default:
391 abort ();
395 /* Find the window containing column x, row y, and return it as a
396 Lisp_Object. If x, y is on the window's modeline, set *part
397 to 1; if it is on the separating line between the window and its
398 right sibling, set it to 2; otherwise set it to 0. If there is no
399 window under x, y return nil and leave *part unmodified. */
400 Lisp_Object
401 window_from_coordinates (screen, x, y, part)
402 SCREEN_PTR screen;
403 int x, y;
404 int *part;
406 register Lisp_Object tem, first;
408 tem = first = SCREEN_SELECTED_WINDOW (screen);
412 int found = coordinates_in_window (XWINDOW (tem), &x, &y);
414 if (found)
416 *part = found - 1;
417 return tem;
420 tem = Fnext_window (tem, Qt, Qlambda);
422 while (! EQ (tem, first));
424 return Qnil;
427 DEFUN ("window-at", Fwindow_at, Swindow_at, 1, 2, 0,
428 "Return window containing position COORDINATES on SCREEN.\n\
429 If omitted, SCREEN defaults to the currently selected screen.\n\
430 COORDINATES is a pair (SCREEN-X . SCREEN-Y) of coordinates\n\
431 which are relative to 0,0 at the top left corner of the screen.")
432 (coordinates, screen)
433 Lisp_Object coordinates, screen;
435 int part;
437 if (NILP (screen))
438 XSET (screen, Lisp_Screen, selected_screen);
439 else
440 CHECK_LIVE_SCREEN (screen, 0);
441 CHECK_CONS (coordinates, 1);
442 CHECK_NUMBER (XCONS (coordinates)->car, 1);
443 CHECK_NUMBER (XCONS (coordinates)->cdr, 1);
445 return window_from_coordinates (XSCREEN (screen),
446 XINT (Fcar (coordinates)),
447 XINT (Fcdr (coordinates)),
448 &part);
451 DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
452 "Return current value of point in WINDOW.\n\
453 For a nonselected window, this is the value point would have\n\
454 if that window were selected.\n\
456 Note that, when WINDOW is the selected window and its buffer\n\
457 is also currently selected, the value returned is the same as (point).\n\
458 It would be more strictly correct to return the `top-level' value\n\
459 of point, outside of any save-excursion forms.\n\
460 But that is hard to define.")
461 (window)
462 Lisp_Object window;
464 register struct window *w = decode_window (window);
466 if (w == XWINDOW (selected_window)
467 && current_buffer == XBUFFER (w->buffer))
468 return Fpoint ();
469 return Fmarker_position (w->pointm);
472 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
473 "Return position at which display currently starts in WINDOW.")
474 (window)
475 Lisp_Object window;
477 return Fmarker_position (decode_window (window)->start);
480 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 1, 0,
481 "Return position at which display currently ends in WINDOW.")
482 (window)
483 Lisp_Object window;
485 Lisp_Object value;
486 struct window *w = decode_window (window);
488 XSET (value, Lisp_Int,
489 BUF_Z (current_buffer) - XFASTINT (w->window_end_pos));
491 return value;
494 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
495 "Make point value in WINDOW be at position POS in WINDOW's buffer.")
496 (window, pos)
497 Lisp_Object window, pos;
499 register struct window *w = decode_window (window);
501 CHECK_NUMBER_COERCE_MARKER (pos, 1);
502 if (w == XWINDOW (selected_window))
503 Fgoto_char (pos);
504 else
505 set_marker_restricted (w->pointm, pos, w->buffer);
507 return pos;
510 DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
511 "Make display in WINDOW start at position POS in WINDOW's buffer.\n\
512 Optional third arg NOFORCE non-nil inhibits next redisplay\n\
513 from overriding motion of point in order to display at this exact start.")
514 (window, pos, noforce)
515 Lisp_Object window, pos, noforce;
517 register struct window *w = decode_window (window);
519 CHECK_NUMBER_COERCE_MARKER (pos, 1);
520 set_marker_restricted (w->start, pos, w->buffer);
521 /* this is not right, but much easier than doing what is right. */
522 w->start_at_line_beg = Qnil;
523 if (NILP (noforce))
524 w->force_start = Qt;
525 w->update_mode_line = Qt;
526 XFASTINT (w->last_modified) = 0;
527 if (!EQ (window, selected_window))
528 windows_or_buffers_changed++;
529 return pos;
532 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
533 1, 1, 0,
534 "Return WINDOW's dedicated object, usually t or nil.\n\
535 See also `set-window-buffer-dedicated'.")
536 (window)
537 Lisp_Object window;
539 return decode_window (window)->dedicated;
542 DEFUN ("set-window-buffer-dedicated", Fset_window_buffer_dedicated,
543 Sset_window_buffer_dedicated, 2, 2, 0,
544 "Make WINDOW display BUFFER and be dedicated to that buffer.\n\
545 Then Emacs will not automatically change which buffer appears in WINDOW.\n\
546 If BUFFER is nil, make WINDOW not be dedicated (but don't change which\n\
547 buffer appears in it currently).")
548 (window, arg)
549 Lisp_Object window, arg;
551 register struct window *w = decode_window (window);
553 if (NILP (arg))
554 w->dedicated = Qnil;
555 else
557 Fset_window_buffer (window, Fget_buffer_create (arg));
558 w->dedicated = Qt;
561 return w->dedicated;
564 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
565 0, 1, 0,
566 "Return the display-table that WINDOW is using.")
567 (window)
568 Lisp_Object window;
570 return decode_window (window)->display_table;
573 /* Get the display table for use currently on window W.
574 This is either W's display table or W's buffer's display table.
575 Ignore the specified tables if they are not valid;
576 if no valid table is specified, return 0. */
578 struct Lisp_Vector *
579 window_display_table (w)
580 struct window *w;
582 Lisp_Object tem;
583 tem = w->display_table;
584 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
585 return XVECTOR (tem);
586 tem = XBUFFER (w->buffer)->display_table;
587 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
588 return XVECTOR (tem);
589 tem = Vstandard_display_table;
590 if (XTYPE (tem) == Lisp_Vector && XVECTOR (tem)->size == DISP_TABLE_SIZE)
591 return XVECTOR (tem);
592 return 0;
595 DEFUN ("set-window-display-table",
596 Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
597 "Set WINDOW's display-table to TABLE.")
598 (window, table)
599 register Lisp_Object window, table;
601 register struct window *w;
602 register Lisp_Object z; /* Return value. */
604 w = decode_window (window);
605 w->display_table = table;
606 return table;
609 /* Record info on buffer window w is displaying
610 when it is about to cease to display that buffer. */
611 static
612 unshow_buffer (w)
613 register struct window *w;
615 Lisp_Object buf = w->buffer;
617 if (XBUFFER (buf) != XMARKER (w->pointm)->buffer)
618 abort ();
620 if (w == XWINDOW (selected_window)
621 || ! EQ (buf, XWINDOW (selected_window)->buffer))
622 /* Do this except when the selected window's buffer
623 is being removed from some other window. */
624 XBUFFER (buf)->last_window_start = marker_position (w->start);
626 /* Point in the selected window's buffer
627 is actually stored in that buffer, and the window's pointm isn't used.
628 So don't clobber point in that buffer. */
629 if (! EQ (buf, XWINDOW (selected_window)->buffer))
630 BUF_PT (XBUFFER (buf))
631 = clip_to_bounds (BUF_BEGV (XBUFFER (buf)),
632 marker_position (w->pointm),
633 BUF_ZV (XBUFFER (buf)));
636 /* Put replacement into the window structure in place of old. */
637 static
638 replace_window (old, replacement)
639 Lisp_Object old, replacement;
641 register Lisp_Object tem;
642 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
644 /* If OLD is its screen's root_window, then replacement is the new
645 root_window for that screen. */
647 if (old == XSCREEN (o->screen)->root_window)
648 XSCREEN (o->screen)->root_window = replacement;
650 p->left = o->left;
651 p->top = o->top;
652 p->width = o->width;
653 p->height = o->height;
655 p->next = tem = o->next;
656 if (!NILP (tem))
657 XWINDOW (tem)->prev = replacement;
659 p->prev = tem = o->prev;
660 if (!NILP (tem))
661 XWINDOW (tem)->next = replacement;
663 p->parent = tem = o->parent;
664 if (!NILP (tem))
666 if (EQ (XWINDOW (tem)->vchild, old))
667 XWINDOW (tem)->vchild = replacement;
668 if (EQ (XWINDOW (tem)->hchild, old))
669 XWINDOW (tem)->hchild = replacement;
672 /*** Here, if replacement is a vertical combination
673 and so is its new parent, we should make replacement's
674 children be children of that parent instead. ***/
677 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
678 "Remove WINDOW from the display. Default is selected window.")
679 (window)
680 register Lisp_Object window;
682 register Lisp_Object tem, parent, sib;
683 register struct window *p;
684 register struct window *par;
686 if (NILP (window))
687 window = selected_window;
688 else
689 CHECK_WINDOW (window, 0);
691 p = XWINDOW (window);
692 parent = p->parent;
693 if (NILP (parent))
694 error ("Attempt to delete minibuffer or sole ordinary window");
695 par = XWINDOW (parent);
697 windows_or_buffers_changed++;
699 if (EQ (window, selected_window))
700 Fselect_window (Fnext_window (window, Qnil, Qnil));
702 tem = p->buffer;
703 /* tem is null for dummy parent windows
704 (which have inferiors but not any contents themselves) */
705 if (!NILP (tem))
707 unshow_buffer (p);
708 unchain_marker (p->pointm);
709 unchain_marker (p->start);
710 p->buffer = Qnil;
713 tem = p->next;
714 if (!NILP (tem))
715 XWINDOW (tem)->prev = p->prev;
717 tem = p->prev;
718 if (!NILP (tem))
719 XWINDOW (tem)->next = p->next;
721 if (EQ (window, par->hchild))
722 par->hchild = p->next;
723 if (EQ (window, par->vchild))
724 par->vchild = p->next;
726 /* Find one of our siblings to give our space to. */
727 sib = p->prev;
728 if (NILP (sib))
730 /* If p gives its space to its next sibling, that sibling needs
731 to have its top/left side pulled back to where p's is.
732 set_window_{height,width} will re-position the sibling's
733 children. */
734 sib = p->next;
735 XFASTINT (XWINDOW (sib)->top) = p->top;
736 XFASTINT (XWINDOW (sib)->left) = p->left;
739 /* Stretch that sibling. */
740 if (!NILP (par->vchild))
741 set_window_height (sib,
742 XFASTINT (XWINDOW (sib)->height) + XFASTINT (p->height),
744 if (!NILP (par->hchild))
745 set_window_width (sib,
746 XFASTINT (XWINDOW (sib)->width) + XFASTINT (p->width),
749 /* If parent now has only one child,
750 put the child into the parent's place. */
752 tem = par->hchild;
753 if (NILP (tem))
754 tem = par->vchild;
755 if (NILP (XWINDOW (tem)->next))
756 replace_window (parent, tem);
757 return Qnil;
761 extern Lisp_Object next_screen (), prev_screen ();
763 DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
764 "Return next window after WINDOW in canonical ordering of windows.\n\
765 If omitted, WINDOW defaults to the selected window.\n\
767 Optional second arg MINIBUF t means count the minibuffer window even\n\
768 if not active. MINIBUF nil or omitted means count the minibuffer iff\n\
769 it is active. MINIBUF neither t nor nil means not to count the\n\
770 minibuffer even if it is active.\n\
772 Several screens may share a single minibuffer; if the minibuffer\n\
773 counts, all windows on all screens that share that minibuffer count\n\
774 too. This means that next-window may be used to iterate through the\n\
775 set of windows even when the minibuffer is on another screen. If the\n\
776 minibuffer does not count, only windows from WINDOW's screen count.\n\
778 Optional third arg ALL-SCREENS t means include windows on all screens.\n\
779 ALL-SCREENS nil or omitted means cycle within the screens as specified\n\
780 above. If neither nil nor t, restrict to WINDOW's screen.")
781 (window, minibuf, all_screens)
782 register Lisp_Object window, minibuf, all_screens;
784 register Lisp_Object tem;
785 Lisp_Object start_window;
787 if (NILP (window))
788 window = selected_window;
789 else
790 CHECK_WINDOW (window, 0);
792 start_window = window;
794 /* minibuf == nil may or may not include minibuffers.
795 Decide if it does. */
796 if (NILP (minibuf))
797 minibuf = (minibuf_level ? Qt : Qlambda);
799 /* all_screens == nil doesn't specify which screens to include.
800 Decide which screens it includes. */
801 if (NILP (all_screens))
802 all_screens = (EQ (minibuf, Qt)
803 ? (SCREEN_MINIBUF_WINDOW
804 (XSCREEN
805 (WINDOW_SCREEN
806 (XWINDOW (window)))))
807 : Qnil);
808 else if (! EQ (all_screens, Qt))
809 all_screens = Qnil;
811 /* Do this loop at least once, to get the next window, and perhaps
812 again, if we hit the minibuffer and that is not acceptable. */
815 /* Find a window that actually has a next one. This loop
816 climbs up the tree. */
817 while (tem = XWINDOW (window)->next, NILP (tem))
818 if (tem = XWINDOW (window)->parent, !NILP (tem))
819 window = tem;
820 else
822 /* We've reached the end of this screen.
823 Which other screens are acceptable? */
824 tem = WINDOW_SCREEN (XWINDOW (window));
825 #ifdef MULTI_SCREEN
826 if (! NILP (all_screens))
827 tem = next_screen (tem, all_screens);
828 #endif
829 tem = SCREEN_ROOT_WINDOW (XSCREEN (tem));
831 break;
834 window = tem;
836 /* If we're in a combination window, find its first child and
837 recurse on that. Otherwise, we've found the window we want. */
838 while (1)
840 if (!NILP (XWINDOW (window)->hchild))
841 window = XWINDOW (window)->hchild;
842 else if (!NILP (XWINDOW (window)->vchild))
843 window = XWINDOW (window)->vchild;
844 else break;
847 /* Which windows are acceptible?
848 Exit the loop and accept this window if
849 this isn't a minibuffer window, or
850 we're accepting minibuffer windows, or
851 we've come all the way around and we're back at the original window. */
852 while (MINI_WINDOW_P (XWINDOW (window))
853 && ! EQ (minibuf, Qt)
854 && window != start_window);
856 return window;
859 DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
860 "Return the window preceeding WINDOW in canonical ordering of windows.\n\
861 If omitted, WINDOW defaults to the selected window.\n\
863 Optional second arg MINIBUF t means count the minibuffer window even\n\
864 if not active. MINIBUF nil or omitted means count the minibuffer iff\n\
865 it is active. MINIBUF neither t nor nil means not to count the\n\
866 minibuffer even if it is active.\n\
868 Several screens may share a single minibuffer; if the minibuffer\n\
869 counts, all windows on all screens that share that minibuffer count\n\
870 too. This means that previous-window may be used to iterate through\n\
871 the set of windows even when the minibuffer is on another screen. If\n\
872 the minibuffer does not count, only windows from WINDOW's screen\n\
873 count.\n\
875 Optional third arg ALL-SCREENS t means include windows on all screens.\n\
876 ALL-SCREENS nil or omitted means cycle within the screens as specified\n\
877 above. If neither nil nor t, restrict to WINDOW's screen.")
878 (window, minibuf, all_screens)
879 register Lisp_Object window, minibuf, all_screens;
881 register Lisp_Object tem;
882 Lisp_Object start_window;
884 if (NILP (window))
885 window = selected_window;
886 else
887 CHECK_WINDOW (window, 0);
889 start_window = window;
891 /* minibuf == nil may or may not include minibuffers.
892 Decide if it does. */
893 if (NILP (minibuf))
894 minibuf = (minibuf_level ? Qt : Qlambda);
896 /* all_screens == nil doesn't specify which screens to include.
897 Decide which screens it includes. */
898 if (NILP (all_screens))
899 all_screens = (EQ (minibuf, Qt)
900 ? (SCREEN_MINIBUF_WINDOW
901 (XSCREEN
902 (WINDOW_SCREEN
903 (XWINDOW (window)))))
904 : Qnil);
905 else if (! EQ (all_screens, Qt))
906 all_screens = Qnil;
908 /* Do this loop at least once, to get the previous window, and perhaps
909 again, if we hit the minibuffer and that is not acceptable. */
912 /* Find a window that actually has a previous one. This loop
913 climbs up the tree. */
914 while (tem = XWINDOW (window)->prev, NILP (tem))
915 if (tem = XWINDOW (window)->parent, !NILP (tem))
916 window = tem;
917 else
919 /* We have found the top window on the screen.
920 Which screens are acceptable? */
921 tem = WINDOW_SCREEN (XWINDOW (window));
922 #ifdef MULTI_SCREEN
923 if (! NILP (all_screens))
924 tem = next_screen (tem, all_screens);
925 #endif
926 tem = SCREEN_ROOT_WINDOW (XSCREEN (tem));
928 break;
931 window = tem;
932 /* If we're in a combination window, find its last child and
933 recurse on that. Otherwise, we've found the window we want. */
934 while (1)
936 if (!NILP (XWINDOW (window)->hchild))
937 window = XWINDOW (window)->hchild;
938 else if (!NILP (XWINDOW (window)->vchild))
939 window = XWINDOW (window)->vchild;
940 else break;
941 while (tem = XWINDOW (window)->next, !NILP (tem))
942 window = tem;
945 /* Which windows are acceptable?
946 Exit the loop and accept this window if
947 this isn't a minibuffer window, or
948 we're accepting minibuffer windows, or
949 we've come all the way around and we're back at the original window. */
950 while (MINI_WINDOW_P (XWINDOW (window))
951 && !EQ (minibuf, Qt)
952 && window != start_window);
954 return window;
957 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
958 "Select the ARG'th different window on this screen.\n\
959 All windows on current screen are arranged in a cyclic order.\n\
960 This command selects the window ARG steps away in that order.\n\
961 A negative ARG moves in the opposite order. If the optional second\n\
962 argument ALL_SCREENS is non-nil, cycle through all screens.")
963 (n, all_screens)
964 register Lisp_Object n, all_screens;
966 register int i;
967 register Lisp_Object w;
969 CHECK_NUMBER (n, 0);
970 w = selected_window;
971 i = XINT (n);
973 while (i > 0)
975 w = Fnext_window (w, Qnil, all_screens);
976 i--;
978 while (i < 0)
980 w = Fprevious_window (w, Qnil, all_screens);
981 i++;
983 Fselect_window (w);
984 return Qnil;
987 /* Look at all windows, performing an operation specified by TYPE
988 with argument OBJ.
989 If SCREENS is Qt, look at all screens, if Qnil, look at just the selected
990 screen. If SCREENS is a screen, just look at windows on that screen.
991 If MINI is non-zero, perform the operation on minibuffer windows too.
994 enum window_loop
996 WINDOW_LOOP_UNUSED,
997 GET_BUFFER_WINDOW, /* Arg is buffer */
998 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
999 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
1000 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
1001 GET_LARGEST_WINDOW,
1002 UNSHOW_BUFFER, /* Arg is buffer */
1005 static Lisp_Object
1006 window_loop (type, obj, mini, screens)
1007 enum window_loop type;
1008 register Lisp_Object obj, screens;
1009 int mini;
1011 register Lisp_Object w;
1012 register Lisp_Object best_window;
1013 register Lisp_Object next_window;
1014 register Lisp_Object first_window;
1015 SCREEN_PTR screen;
1017 /* If we're only looping through windows on a particular screen,
1018 screen points to that screen. If we're looping through windows
1019 on all screens, screen is 0. */
1020 if (SCREENP (screens))
1021 screen = XSCREEN (screens);
1022 else if (NILP (screens))
1023 screen = selected_screen;
1024 else
1025 screen = 0;
1027 /* Pick a window to start with. */
1028 if (XTYPE (obj) == Lisp_Window)
1029 first_window = obj;
1030 else if (screen)
1031 first_window = SCREEN_SELECTED_WINDOW (screen);
1032 else
1033 first_window = SCREEN_SELECTED_WINDOW (selected_screen);
1035 w = first_window;
1036 best_window = Qnil;
1039 /* Pick the next window now, since some operations will delete
1040 the current window. */
1041 #ifdef MULTI_SCREEN
1042 if (screen)
1043 next_window = Fnext_window (w, (mini ? Qt : Qnil), Qlambda);
1044 else
1045 #endif /* MULTI_SCREEN */
1046 /* We know screen is 0, so we're looping through all screens.
1047 Or we know this isn't a MULTI_SCREEN Emacs, so who cares? */
1048 next_window = Fnext_window (w, mini ? Qt : Qnil, Qt);
1050 if (!MINI_WINDOW_P (XWINDOW (w))
1051 || (mini && minibuf_level > 0))
1052 switch (type)
1054 case GET_BUFFER_WINDOW:
1055 #if 0
1056 /* Ignore invisible and iconified screens. */
1057 if (! SCREEN_VISIBLE_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w))))
1058 || SCREEN_ICONIFIED_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w)))))
1059 break;
1060 #endif
1061 if (XBUFFER (XWINDOW (w)->buffer) == XBUFFER (obj))
1062 return w;
1063 break;
1065 case GET_LRU_WINDOW:
1066 /* t as arg means consider only full-width windows */
1067 if (!NILP (obj) && XFASTINT (XWINDOW (w)->width) != screen->width)
1068 break;
1069 #if 0
1070 /* Ignore invisible and iconified screens. */
1071 if (! SCREEN_VISIBLE_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w))))
1072 || SCREEN_ICONIFIED_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w)))))
1073 break;
1074 #endif
1075 /* Ignore dedicated windows and minibuffers. */
1076 if (MINI_WINDOW_P (XWINDOW (w))
1077 || !NILP (XWINDOW (w)->dedicated))
1078 break;
1079 if (NILP (best_window)
1080 || (XFASTINT (XWINDOW (best_window)->use_time)
1081 > XFASTINT (XWINDOW (w)->use_time)))
1082 best_window = w;
1083 break;
1085 case DELETE_OTHER_WINDOWS:
1086 if (XWINDOW (w) != XWINDOW (obj))
1087 Fdelete_window (w);
1088 break;
1090 case DELETE_BUFFER_WINDOWS:
1091 if (EQ (XWINDOW (w)->buffer, obj))
1093 /* If we're deleting the buffer displayed in the only window
1094 on the screen, find a new buffer to display there. */
1095 if (NILP (XWINDOW (w)->parent))
1097 Lisp_Object new_buffer = Fother_buffer (obj);
1098 if (NILP (new_buffer))
1099 new_buffer
1100 = Fget_buffer_create (build_string ("*scratch*"));
1101 Fset_window_buffer (w, new_buffer);
1102 Fset_buffer (XWINDOW (w)->buffer);
1104 else
1105 Fdelete_window (w);
1107 break;
1109 case GET_LARGEST_WINDOW:
1110 #if 0
1111 /* Ignore invisible and iconified screens. */
1112 if (! SCREEN_VISIBLE_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w))))
1113 || SCREEN_ICONIFIED_P (XSCREEN (WINDOW_SCREEN (XWINDOW (w)))))
1114 break;
1115 #endif
1116 /* Ignore dedicated windows and minibuffers. */
1117 if (MINI_WINDOW_P (XWINDOW (w))
1118 || !NILP (XWINDOW (w)->dedicated))
1119 break;
1121 struct window *best_window_ptr = XWINDOW (best_window);
1122 struct window *w_ptr = XWINDOW (w);
1123 if (NILP (best_window) ||
1124 (XFASTINT (w_ptr->height) * XFASTINT (w_ptr->width))
1125 > (XFASTINT (best_window_ptr->height)
1126 * XFASTINT (best_window_ptr->width)))
1127 best_window = w;
1129 break;
1131 case UNSHOW_BUFFER:
1132 if (EQ (XWINDOW (w)->buffer, obj))
1134 /* Find another buffer to show in this window. */
1135 Lisp_Object another_buffer = Fother_buffer (obj);
1136 if (NILP (another_buffer))
1137 another_buffer
1138 = Fget_buffer_create (build_string ("*scratch*"));
1139 Fset_window_buffer (w, another_buffer);
1140 if (EQ (w, selected_window))
1141 Fset_buffer (XWINDOW (w)->buffer);
1143 break;
1145 w = next_window;
1147 while (! EQ (w, first_window));
1149 return best_window;
1152 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 1, 0,
1153 "Return the window least recently selected or used for display.\n\
1154 If optional argument SCREENS is t, search all screens. If SCREEN is a\n\
1155 screen, search only that screen.\n")
1156 (screens)
1157 Lisp_Object screens;
1159 register Lisp_Object w;
1160 /* First try for a window that is full-width */
1161 w = window_loop (GET_LRU_WINDOW, Qt, 0, screens);
1162 if (!NILP (w) && !EQ (w, selected_window))
1163 return w;
1164 /* If none of them, try the rest */
1165 return window_loop (GET_LRU_WINDOW, Qnil, 0, screens);
1168 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 1, 0,
1169 "Return the largest window in area.\n\
1170 If optional argument SCREENS is t, search all screens. If SCREEN is a\n\
1171 screen, search only that screen.\n")
1172 (screen)
1173 Lisp_Object screen;
1175 return window_loop (GET_LARGEST_WINDOW, Qnil, 0,
1176 screen);
1179 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
1180 "Return a window currently displaying BUFFER, or nil if none.\n\
1181 If optional argument SCREENS is t, search all screens. If SCREEN is a\n\
1182 screen, search only that screen.\n")
1183 (buffer, screen)
1184 Lisp_Object buffer, screen;
1186 buffer = Fget_buffer (buffer);
1187 if (XTYPE (buffer) == Lisp_Buffer)
1188 return window_loop (GET_BUFFER_WINDOW, buffer, 1, screen);
1189 else
1190 return Qnil;
1193 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
1194 0, 1, "",
1195 "Make WINDOW (or the selected window) fill its screen.\n\
1196 Only the screen WINDOW is on is affected.")
1197 (window)
1198 Lisp_Object window;
1200 struct window *w;
1201 int opoint = point;
1202 struct buffer *obuf = current_buffer;
1203 int top;
1205 if (NILP (window))
1206 window = selected_window;
1207 else
1208 CHECK_WINDOW (window, 0);
1210 w = XWINDOW (window);
1211 top = XFASTINT (w->top);
1213 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_SCREEN(w));
1215 Fset_buffer (w->buffer);
1216 SET_PT (marker_position (w->start));
1217 Frecenter (make_number (top));
1219 set_buffer_internal (obuf);
1220 SET_PT (opoint);
1221 return Qnil;
1224 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
1225 1, 1, "bDelete windows on (buffer): ",
1226 "Delete all windows showing BUFFER.")
1227 (buffer)
1228 Lisp_Object buffer;
1230 if (!NILP (buffer))
1232 buffer = Fget_buffer (buffer);
1233 CHECK_BUFFER (buffer, 0);
1234 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, Qt);
1236 return Qnil;
1239 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
1240 Sreplace_buffer_in_windows,
1241 1, 1, "bReplace buffer in windows: ",
1242 "Replace BUFFER with some other buffer in all windows showing it.")
1243 (buffer)
1244 Lisp_Object buffer;
1246 if (!NILP (buffer))
1248 buffer = Fget_buffer (buffer);
1249 CHECK_BUFFER (buffer, 0);
1250 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
1252 return Qnil;
1255 /* Set the height of WINDOW and all its inferiors. */
1256 /* Normally the window is deleted if it gets too small.
1257 nodelete nonzero means do not do this.
1258 (The caller should check later and do so if appropriate) */
1260 set_window_height (window, height, nodelete)
1261 Lisp_Object window;
1262 int height;
1263 int nodelete;
1265 register struct window *w = XWINDOW (window);
1266 register struct window *c;
1267 int oheight = XFASTINT (w->height);
1268 int top, pos, lastbot, opos, lastobot;
1269 Lisp_Object child;
1271 if (!nodelete
1272 && ! NILP (w->parent)
1273 && height < window_min_height)
1275 Fdelete_window (window);
1276 return;
1279 XFASTINT (w->last_modified) = 0;
1280 windows_or_buffers_changed++;
1281 XFASTINT (w->height) = height;
1282 if (!NILP (w->hchild))
1284 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1286 XWINDOW (child)->top = w->top;
1287 set_window_height (child, height, nodelete);
1290 else if (!NILP (w->vchild))
1292 lastbot = top = XFASTINT (w->top);
1293 lastobot = 0;
1294 for (child = w->vchild; !NILP (child); child = c->next)
1296 c = XWINDOW (child);
1298 opos = lastobot + XFASTINT (c->height);
1300 XFASTINT (c->top) = lastbot;
1302 pos = (((opos * height) << 1) + oheight) / (oheight << 1);
1304 /* Avoid confusion: inhibit deletion of child if becomes too small */
1305 set_window_height (child, pos + top - lastbot, 1);
1307 /* Now advance child to next window,
1308 and set lastbot if child was not just deleted. */
1309 lastbot = pos + top;
1310 lastobot = opos;
1312 /* Now delete any children that became too small. */
1313 if (!nodelete)
1314 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1316 set_window_height (child, XINT (XWINDOW (child)->height), 0);
1321 /* Recursively set width of WINDOW and its inferiors. */
1323 set_window_width (window, width, nodelete)
1324 Lisp_Object window;
1325 int width;
1326 int nodelete;
1328 register struct window *w = XWINDOW (window);
1329 register struct window *c;
1330 int owidth = XFASTINT (w->width);
1331 int left, pos, lastright, opos, lastoright;
1332 Lisp_Object child;
1334 if (!nodelete && width < window_min_width)
1336 Fdelete_window (window);
1337 return;
1340 XFASTINT (w->last_modified) = 0;
1341 windows_or_buffers_changed++;
1342 XFASTINT (w->width) = width;
1343 if (!NILP (w->vchild))
1345 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
1347 XWINDOW (child)->left = w->left;
1348 set_window_width (child, width, nodelete);
1351 else if (!NILP (w->hchild))
1353 lastright = left = XFASTINT (w->left);
1354 lastoright = 0;
1355 for (child = w->hchild; !NILP (child); child = c->next)
1357 c = XWINDOW (child);
1359 opos = lastoright + XFASTINT (c->width);
1361 XFASTINT (c->left) = lastright;
1363 pos = (((opos * width) << 1) + owidth) / (owidth << 1);
1365 /* Inhibit deletion for becoming too small */
1366 set_window_width (child, pos + left - lastright, 1);
1368 /* Now advance child to next window,
1369 and set lastright if child was not just deleted. */
1370 lastright = pos + left, lastoright = opos;
1372 /* Delete children that became too small */
1373 if (!nodelete)
1374 for (child = w->hchild; !NILP (child); child = XWINDOW (child)->next)
1376 set_window_width (child, XINT (XWINDOW (child)->width), 0);
1381 int window_select_count;
1383 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 2, 0,
1384 "Make WINDOW display BUFFER as its contents.\n\
1385 BUFFER can be a buffer or buffer name.")
1386 (window, buffer)
1387 register Lisp_Object window, buffer;
1389 register Lisp_Object tem;
1390 register struct window *w = decode_window (window);
1392 buffer = Fget_buffer (buffer);
1393 CHECK_BUFFER (buffer, 1);
1395 if (NILP (XBUFFER (buffer)->name))
1396 error ("Attempt to display deleted buffer");
1398 tem = w->buffer;
1399 if (NILP (tem))
1400 error ("Window is deleted");
1401 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
1402 is first being set up. */
1404 if (!NILP (w->dedicated) && !EQ (tem, buffer))
1405 error ("Window is dedicated to %s\n", tem);
1407 unshow_buffer (w);
1410 w->buffer = buffer;
1411 Fset_marker (w->pointm,
1412 make_number (BUF_PT (XBUFFER (buffer))),
1413 buffer);
1414 set_marker_restricted (w->start,
1415 make_number (XBUFFER (buffer)->last_window_start),
1416 buffer);
1417 w->start_at_line_beg = Qnil;
1418 XFASTINT (w->last_modified) = 0;
1419 windows_or_buffers_changed++;
1420 if (EQ (window, selected_window))
1421 Fset_buffer (buffer);
1423 return Qnil;
1426 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 1, 0,
1427 "Select WINDOW. Most editing will apply to WINDOW's buffer.\n\
1428 The main editor command loop selects the buffer of the selected window\n\
1429 before each command.")
1430 (window)
1431 register Lisp_Object window;
1433 register struct window *w;
1434 register struct window *ow = XWINDOW (selected_window);
1436 CHECK_WINDOW (window, 0);
1438 w = XWINDOW (window);
1440 if (NILP (w->buffer))
1441 error ("Trying to select deleted window or non-leaf window");
1443 XFASTINT (w->use_time) = ++window_select_count;
1444 if (EQ (window, selected_window))
1445 return window;
1447 Fset_marker (ow->pointm, make_number (BUF_PT (XBUFFER (ow->buffer))),
1448 ow->buffer);
1450 selected_window = window;
1451 #ifdef MULTI_SCREEN
1452 if (XSCREEN (WINDOW_SCREEN (w)) != selected_screen)
1454 XSCREEN (WINDOW_SCREEN (w))->selected_window = window;
1455 Fselect_screen (WINDOW_SCREEN (w), Qnil);
1457 else
1458 selected_screen->selected_window = window;
1459 #endif
1461 record_buffer (w->buffer);
1462 Fset_buffer (w->buffer);
1464 /* Go to the point recorded in the window.
1465 This is important when the buffer is in more
1466 than one window. It also matters when
1467 redisplay_window has altered point after scrolling,
1468 because it makes the change only in the window. */
1470 register int new_point = marker_position (w->pointm);
1471 if (new_point < BEGV)
1472 SET_PT (BEGV);
1473 if (new_point > ZV)
1474 SET_PT (ZV);
1475 else
1476 SET_PT (new_point);
1479 windows_or_buffers_changed++;
1480 return window;
1483 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 2, 0,
1484 "Make BUFFER appear in some window but don't select it.\n\
1485 BUFFER can be a buffer or a buffer name.\n\
1486 If BUFFER is shown already in some window, just use that one,\n\
1487 unless the window is the selected window and the optional second\n\
1488 argument NOT_THIS_WINDOW is non-nil.\n\
1489 Returns the window displaying BUFFER.")
1490 (buffer, not_this_window)
1491 register Lisp_Object buffer, not_this_window;
1493 register Lisp_Object window;
1495 buffer = Fget_buffer (buffer);
1496 CHECK_BUFFER (buffer, 0);
1498 if (!NILP (Vdisplay_buffer_function))
1499 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
1501 if (NILP (not_this_window)
1502 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
1503 return selected_window;
1505 window = Fget_buffer_window (buffer, Qnil);
1506 if (!NILP (window)
1507 && (NILP (not_this_window) || !EQ (window, selected_window)))
1508 return window;
1510 #ifdef MULTI_SCREEN
1511 /* If there are no screens open that have more than a minibuffer,
1512 we need to create a new screen. */
1513 if (pop_up_screens || last_nonminibuf_screen == 0)
1515 window
1516 = Fscreen_selected_window (call0 (Vpop_up_screen_function));
1517 Fset_window_buffer (window, buffer);
1518 #if 0
1519 Fselect_screen (XWINDOW (window)->screen, Qnil);
1520 #endif
1521 return window;
1523 #endif /* MULTI_SCREEN */
1525 if (pop_up_windows
1526 #ifdef MULTI_SCREEN
1527 || SCREEN_MINIBUF_ONLY_P (selected_screen)
1528 #endif
1531 Lisp_Object screens = Qnil;
1533 #ifdef MULTI_SCREEN
1534 if (SCREEN_MINIBUF_ONLY_P (selected_screen))
1535 XSET (screens, Lisp_Screen, last_nonminibuf_screen);
1536 #endif
1537 /* Don't try to create a window if would get an error */
1538 if (split_height_threshold < window_min_height << 1)
1539 split_height_threshold = window_min_height << 1;
1541 window = Fget_largest_window (screens);
1543 if (!NILP (window)
1544 && window_height (window) >= split_height_threshold
1546 (XFASTINT (XWINDOW (window)->width)
1547 == SCREEN_WIDTH (XSCREEN (WINDOW_SCREEN (XWINDOW (window))))))
1548 window = Fsplit_window (window, Qnil, Qnil);
1549 else
1551 window = Fget_lru_window (screens);
1552 if ((EQ (window, selected_window)
1553 || EQ (XWINDOW (window)->parent, Qnil))
1554 && window_height (window) >= window_min_height << 1)
1555 window = Fsplit_window (window, Qnil, Qnil);
1558 else
1559 window = Fget_lru_window (Qnil);
1561 Fset_window_buffer (window, buffer);
1562 return window;
1565 void
1566 temp_output_buffer_show (buf)
1567 register Lisp_Object buf;
1569 register struct buffer *old = current_buffer;
1570 register Lisp_Object window;
1571 register struct window *w;
1573 Fset_buffer (buf);
1574 XBUFFER (buf)->save_modified = MODIFF;
1575 BEGV = BEG;
1576 ZV = Z;
1577 SET_PT (BEG);
1578 clip_changed = 1;
1579 set_buffer_internal (old);
1581 if (!EQ (Vtemp_buffer_show_function, Qnil))
1582 call1 (Vtemp_buffer_show_function, buf);
1583 else
1585 window = Fdisplay_buffer (buf, Qnil);
1587 #ifdef MULTI_SCREEN
1588 if (XSCREEN (XWINDOW (window)->screen) != selected_screen)
1589 Fmake_screen_visible (XWINDOW (window)->screen);
1590 #endif /* MULTI_SCREEN */
1591 Vminibuf_scroll_window = window;
1592 w = XWINDOW (window);
1593 XFASTINT (w->hscroll) = 0;
1594 set_marker_restricted (w->start, make_number (1), buf);
1595 set_marker_restricted (w->pointm, make_number (1), buf);
1599 static
1600 make_dummy_parent (window)
1601 Lisp_Object window;
1603 register Lisp_Object old, new;
1604 register struct window *o, *p;
1606 old = window;
1607 XSETTYPE (old, Lisp_Vector);
1608 new = Fcopy_sequence (old);
1609 XSETTYPE (new, Lisp_Window);
1611 o = XWINDOW (old);
1612 p = XWINDOW (new);
1613 XFASTINT (p->sequence_number) = ++sequence_number;
1615 /* Put new into window structure in place of window */
1616 replace_window (window, new);
1618 o->next = Qnil;
1619 o->prev = Qnil;
1620 o->vchild = Qnil;
1621 o->hchild = Qnil;
1622 o->parent = new;
1624 p->start = Qnil;
1625 p->pointm = Qnil;
1626 p->buffer = Qnil;
1629 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
1630 "Split WINDOW, putting SIZE lines in the first of the pair.\n\
1631 WINDOW defaults to selected one and SIZE to half its size.\n\
1632 If optional third arg HOR-FLAG is non-nil, split side by side\n\
1633 and put SIZE columns in the first of the pair.")
1634 (window, chsize, horflag)
1635 Lisp_Object window, chsize, horflag;
1637 register Lisp_Object new;
1638 register struct window *o, *p;
1639 register int size;
1641 if (NILP (window))
1642 window = selected_window;
1643 else
1644 CHECK_WINDOW (window, 0);
1646 o = XWINDOW (window);
1648 if (NILP (chsize))
1650 if (!NILP (horflag))
1651 /* Round odd size up, since this is for the left-hand window,
1652 and it will lose a column for the separators. */
1653 size = ((XFASTINT (o->width) + 1) & -2) >> 1;
1654 else
1655 size = XFASTINT (o->height) >> 1;
1657 else
1659 CHECK_NUMBER (chsize, 1);
1660 size = XINT (chsize);
1663 if (MINI_WINDOW_P (o))
1664 error ("Attempt to split minibuffer window");
1665 else if (SCREEN_NO_SPLIT_P (XSCREEN (WINDOW_SCREEN (o))))
1666 error ("Attempt to split unsplittable screen");
1668 /* Smaller values might permit a crash. */
1669 if (window_min_width < 2)
1670 window_min_width = 2;
1671 if (window_min_height < 2)
1672 window_min_height = 2;
1674 if (NILP (horflag))
1676 if (size < window_min_height
1677 || size + window_min_height > XFASTINT (o->height))
1678 args_out_of_range_3 (window, chsize, horflag);
1679 if (NILP (o->parent)
1680 || NILP (XWINDOW (o->parent)->vchild))
1682 make_dummy_parent (window);
1683 new = o->parent;
1684 XWINDOW (new)->vchild = window;
1687 else
1689 if (size < window_min_width
1690 || size + window_min_width > XFASTINT (o->width))
1691 args_out_of_range_3 (window, chsize, horflag);
1692 if (NILP (o->parent)
1693 || NILP (XWINDOW (o->parent)->hchild))
1695 make_dummy_parent (window);
1696 new = o->parent;
1697 XWINDOW (new)->hchild = window;
1701 /* Now we know that window's parent is a vertical combination
1702 if we are dividing vertically, or a horizontal combination
1703 if we are making side-by-side windows */
1705 windows_or_buffers_changed++;
1706 new = make_window ();
1707 p = XWINDOW (new);
1709 p->screen = o->screen;
1710 p->next = o->next;
1711 if (!NILP (p->next))
1712 XWINDOW (p->next)->prev = new;
1713 p->prev = window;
1714 o->next = new;
1715 p->parent = o->parent;
1716 p->buffer = Qt;
1718 Fset_window_buffer (new, o->buffer);
1720 /* Apportion the available screen space among the two new windows */
1722 if (!NILP (horflag))
1724 p->height = o->height;
1725 p->top = o->top;
1726 XFASTINT (p->width) = XFASTINT (o->width) - size;
1727 XFASTINT (o->width) = size;
1728 XFASTINT (p->left) = XFASTINT (o->left) + size;
1730 else
1732 p->left = o->left;
1733 p->width = o->width;
1734 XFASTINT (p->height) = XFASTINT (o->height) - size;
1735 XFASTINT (o->height) = size;
1736 XFASTINT (p->top) = XFASTINT (o->top) + size;
1739 return new;
1742 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 2, "p",
1743 "Make current window ARG lines bigger.\n\
1744 From program, optional second arg non-nil means grow sideways ARG columns.")
1745 (n, side)
1746 register Lisp_Object n, side;
1748 CHECK_NUMBER (n, 0);
1749 change_window_height (XINT (n), !NILP (side));
1750 return Qnil;
1753 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
1754 "Make current window ARG lines smaller.\n\
1755 From program, optional second arg non-nil means shrink sideways ARG columns.")
1756 (n, side)
1757 register Lisp_Object n, side;
1759 CHECK_NUMBER (n, 0);
1760 change_window_height (-XINT (n), !NILP (side));
1761 return Qnil;
1765 window_height (window)
1766 Lisp_Object window;
1768 register struct window *p = XWINDOW (window);
1769 return XFASTINT (p->height);
1773 window_width (window)
1774 Lisp_Object window;
1776 register struct window *p = XWINDOW (window);
1777 return XFASTINT (p->width);
1780 #define MINSIZE(w) \
1781 (widthflag ? window_min_width : window_min_height)
1783 #define CURBEG(w) \
1784 *(widthflag ? (int *) &(w)->left : (int *) &(w)->top)
1786 #define CURSIZE(w) \
1787 *(widthflag ? (int *) &(w)->width : (int *) &(w)->height)
1789 /* Unlike set_window_height, this function
1790 also changes the heights of the siblings so as to
1791 keep everything consistent. */
1793 change_window_height (delta, widthflag)
1794 register int delta;
1795 int widthflag;
1797 register Lisp_Object parent;
1798 Lisp_Object window;
1799 register struct window *p;
1800 int *sizep;
1801 int (*sizefun) () = widthflag ? window_width : window_height;
1802 register int (*setsizefun) () = (widthflag
1803 ? set_window_width
1804 : set_window_height);
1806 /* Smaller values might permit a crash. */
1807 if (window_min_width < 2)
1808 window_min_width = 2;
1809 if (window_min_height < 2)
1810 window_min_height = 2;
1812 window = selected_window;
1813 while (1)
1815 p = XWINDOW (window);
1816 parent = p->parent;
1817 if (NILP (parent))
1819 if (widthflag)
1820 error ("No other window to side of this one");
1821 break;
1823 if (widthflag ? !NILP (XWINDOW (parent)->hchild)
1824 : !NILP (XWINDOW (parent)->vchild))
1825 break;
1826 window = parent;
1829 sizep = &CURSIZE (p);
1831 if (*sizep + delta < MINSIZE (p)
1832 && !NILP (XWINDOW (window)->parent))
1834 Fdelete_window (window);
1835 return;
1839 register int maxdelta;
1841 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - *sizep
1842 : !NILP (p->next) ? (*sizefun) (p->next) - MINSIZE (p->next)
1843 : !NILP (p->prev) ? (*sizefun) (p->prev) - MINSIZE (p->prev)
1844 /* This is a screen with only one window, a minibuffer-only
1845 or a minibufferless screen. */
1846 : (delta = 0));
1848 if (delta > maxdelta)
1849 /* This case traps trying to make the minibuffer
1850 the full screen, or make the only window aside from the
1851 minibuffer the full screen. */
1852 delta = maxdelta;
1854 if (delta == 0)
1855 return;
1858 if (!NILP (p->next) &&
1859 (*sizefun) (p->next) - delta >= MINSIZE (p->next))
1861 (*setsizefun) (p->next, (*sizefun) (p->next) - delta, 0);
1862 (*setsizefun) (window, *sizep + delta, 0);
1863 CURBEG (XWINDOW (p->next)) += delta;
1864 /* This does not change size of p->next,
1865 but it propagates the new top edge to its children */
1866 (*setsizefun) (p->next, (*sizefun) (p->next), 0);
1868 else if (!NILP (p->prev) &&
1869 (*sizefun) (p->prev) - delta >= MINSIZE (p->prev))
1871 (*setsizefun) (p->prev, (*sizefun) (p->prev) - delta, 0);
1872 CURBEG (p) -= delta;
1873 (*setsizefun) (window, *sizep + delta, 0);
1875 else
1877 register int delta1;
1878 register int opht = (*sizefun) (parent);
1880 /* If trying to grow this window to or beyond size of the parent,
1881 make delta1 so big that, on shrinking back down,
1882 all the siblings end up with less than one line and are deleted. */
1883 if (opht <= *sizep + delta)
1884 delta1 = opht * opht * 2;
1885 /* Otherwise, make delta1 just right so that if we add delta1
1886 lines to this window and to the parent, and then shrink
1887 the parent back to its original size, the new proportional
1888 size of this window will increase by delta. */
1889 else
1890 delta1 = (delta * opht * 100) / ((opht - *sizep - delta) * 100);
1892 /* Add delta1 lines or columns to this window, and to the parent,
1893 keeping things consistent while not affecting siblings. */
1894 CURSIZE (XWINDOW (parent)) = opht + delta1;
1895 (*setsizefun) (window, *sizep + delta1, 0);
1897 /* Squeeze out delta1 lines or columns from our parent,
1898 shriking this window and siblings proportionately.
1899 This brings parent back to correct size.
1900 Delta1 was calculated so this makes this window the desired size,
1901 taking it all out of the siblings. */
1902 (*setsizefun) (parent, opht, 0);
1905 XFASTINT (p->last_modified) = 0;
1907 #undef MINSIZE
1908 #undef CURBEG
1909 #undef CURSIZE
1912 /* Return number of lines of text (not counting mode line) in W. */
1915 window_internal_height (w)
1916 struct window *w;
1918 int ht = XFASTINT (w->height);
1920 if (MINI_WINDOW_P (w))
1921 return ht;
1923 if (!NILP (w->parent) || !NILP (w->vchild) || !NILP (w->hchild)
1924 || !NILP (w->next) || !NILP (w->prev)
1925 || SCREEN_WANTS_MODELINE_P (XSCREEN (WINDOW_SCREEN (w))))
1926 return ht - 1;
1928 return ht;
1931 /* Scroll contents of window WINDOW up N lines. */
1933 void
1934 window_scroll (window, n, noerror)
1935 Lisp_Object window;
1936 int n;
1937 int noerror;
1939 register struct window *w = XWINDOW (window);
1940 register int opoint = point;
1941 register int pos;
1942 register int ht = window_internal_height (w);
1943 register Lisp_Object tem;
1944 int lose;
1945 Lisp_Object bolp, nmoved;
1947 XFASTINT (tem) = point;
1948 tem = Fpos_visible_in_window_p (tem, window);
1950 if (NILP (tem))
1952 Fvertical_motion (make_number (- ht / 2));
1953 XFASTINT (tem) = point;
1954 Fset_marker (w->start, tem, w->buffer);
1955 w->force_start = Qt;
1958 SET_PT (marker_position (w->start));
1959 lose = n < 0 && point == BEGV;
1960 Fvertical_motion (make_number (n));
1961 pos = point;
1962 bolp = Fbolp ();
1963 SET_PT (opoint);
1965 if (lose)
1967 if (noerror)
1968 return;
1969 else
1970 Fsignal (Qbeginning_of_buffer, Qnil);
1973 if (pos < ZV)
1975 set_marker_restricted (w->start, make_number (pos), w->buffer);
1976 w->start_at_line_beg = bolp;
1977 w->update_mode_line = Qt;
1978 XFASTINT (w->last_modified) = 0;
1979 if (pos > opoint)
1980 SET_PT (pos);
1981 if (n < 0)
1983 SET_PT (pos);
1984 tem = Fvertical_motion (make_number (ht));
1985 if (point > opoint || XFASTINT (tem) < ht)
1986 SET_PT (opoint);
1987 else
1988 Fvertical_motion (make_number (-1));
1991 else
1993 if (noerror)
1994 return;
1995 else
1996 Fsignal (Qend_of_buffer, Qnil);
2000 /* This is the guts of Fscroll_up and Fscroll_down. */
2002 static void
2003 scroll_command (n, direction)
2004 register Lisp_Object n;
2005 int direction;
2007 register int defalt;
2008 int count = specpdl_ptr - specpdl;
2010 /* Code here used to set the current buffer to the selected window's
2011 buffer, but since this command always operates on the selected
2012 window, the current buffer should always be the selected window's
2013 buffer already. Verify this assumption, so we won't be screwed
2014 if we're guessing wrong. */
2015 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
2016 abort ();
2018 defalt = (window_internal_height (XWINDOW (selected_window))
2019 - next_screen_context_lines);
2020 defalt = direction * (defalt < 1 ? 1 : defalt);
2022 if (NILP (n))
2023 window_scroll (selected_window, defalt, 0);
2024 else if (EQ (n, Qminus))
2025 window_scroll (selected_window, - defalt, 0);
2026 else
2028 n = Fprefix_numeric_value (n);
2029 window_scroll (selected_window, XINT (n) * direction, 0);
2033 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
2034 "Scroll text of current window upward ARG lines; or near full screen if no ARG.\n\
2035 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2036 When calling from a program, supply a number as argument or nil.")
2038 Lisp_Object n;
2040 scroll_command (n, 1);
2041 return Qnil;
2044 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
2045 "Scroll text of current window downward ARG lines; or near full screen if no ARG.\n\
2046 A near full screen is `next-screen-context-lines' less than a full screen.\n\
2047 When calling from a program, supply a number as argument or nil.")
2049 Lisp_Object n;
2051 scroll_command (n, -1);
2052 return Qnil;
2055 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
2056 "Scroll text of next window upward ARG lines; or near full screen if no ARG.\n\
2057 The next window is the one below the current one; or the one at the top\n\
2058 if the current one is at the bottom.\n\
2059 When calling from a program, supply a number as argument or nil.\n\
2061 If in the minibuffer, `minibuf-scroll-window' if non-nil\n\
2062 specifies the window to scroll.\n\
2063 If `other-window-scroll-buffer' is non-nil, scroll the window\n\
2064 showing that buffer, popping the buffer up if necessary.")
2066 register Lisp_Object n;
2068 register Lisp_Object window;
2069 register int ht;
2070 register struct window *w;
2071 register int count = specpdl_ptr - specpdl;
2073 if (MINI_WINDOW_P (XWINDOW (selected_window))
2074 && !NILP (Vminibuf_scroll_window))
2075 window = Vminibuf_scroll_window;
2076 /* If buffer is specified, scroll that buffer. */
2077 else if (!NILP (Vother_window_scroll_buffer))
2079 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
2080 if (NILP (window))
2081 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt);
2083 else
2084 /* Nothing specified; pick a neighboring window. */
2085 window = Fnext_window (selected_window, Qnil, Qt);
2086 CHECK_WINDOW (window, 0);
2088 if (EQ (window, selected_window))
2089 error ("There is no other window");
2091 w = XWINDOW (window);
2092 ht = window_internal_height (w);
2094 /* Don't screw up if window_scroll gets an error. */
2095 record_unwind_protect (save_excursion_restore, save_excursion_save ());
2097 Fset_buffer (w->buffer);
2098 SET_PT (marker_position (w->pointm));
2100 if (NILP (n))
2101 window_scroll (window, ht - next_screen_context_lines, 1);
2102 else if (EQ (n, Qminus))
2103 window_scroll (window, next_screen_context_lines - ht, 1);
2104 else
2106 if (XTYPE (n) == Lisp_Cons)
2107 n = Fcar (n);
2108 CHECK_NUMBER (n, 0);
2109 window_scroll (window, XINT (n), 1);
2112 Fset_marker (w->pointm, make_number (point), Qnil);
2113 unbind_to (count);
2115 return Qnil;
2118 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 1, 1, "P",
2119 "Scroll selected window display ARG columns left.\n\
2120 Default for ARG is window width minus 2.")
2121 (arg)
2122 register Lisp_Object arg;
2125 if (NILP (arg))
2126 XFASTINT (arg) = XFASTINT (XWINDOW (selected_window)->width) - 2;
2127 else
2128 arg = Fprefix_numeric_value (arg);
2130 return
2131 Fset_window_hscroll (selected_window,
2132 make_number (XINT (XWINDOW (selected_window)->hscroll)
2133 + XINT (arg)));
2136 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 1, 1, "P",
2137 "Scroll selected window display ARG columns right.\n\
2138 Default for ARG is window width minus 2.")
2139 (arg)
2140 register Lisp_Object arg;
2142 if (NILP (arg))
2143 XFASTINT (arg) = XFASTINT (XWINDOW (selected_window)->width) - 2;
2144 else
2145 arg = Fprefix_numeric_value (arg);
2147 return
2148 Fset_window_hscroll (selected_window,
2149 make_number (XINT (XWINDOW (selected_window)->hscroll)
2150 - XINT (arg)));
2153 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
2154 "Center point in window and redisplay screen. With ARG, put point on line ARG.\n\
2155 The desired position of point is always relative to the current window.\n\
2156 Just C-u as prefix means put point in the center of the screen.\n\
2157 No arg (i.e., it is nil) erases the entire screen and then\n\
2158 redraws with point in the center.")
2160 register Lisp_Object n;
2162 register struct window *w = XWINDOW (selected_window);
2163 register int ht = window_internal_height (w);
2164 register int opoint = point;
2166 if (NILP (n))
2168 extern int screen_garbaged;
2170 SET_SCREEN_GARBAGED (XSCREEN (WINDOW_SCREEN (w)));
2171 XFASTINT (n) = ht / 2;
2173 else if (XTYPE (n) == Lisp_Cons) /* Just C-u. */
2175 XFASTINT (n) = ht / 2;
2177 else
2179 n = Fprefix_numeric_value (n);
2180 CHECK_NUMBER (n, 0);
2183 if (XINT (n) < 0)
2184 XSETINT (n, XINT (n) + ht);
2186 XSETINT (n, - XINT (n));
2188 Fvertical_motion (n);
2189 Fset_marker (w->start, make_number (point), w->buffer);
2190 w->start_at_line_beg = Fbolp ();
2192 SET_PT (opoint);
2193 w->force_start = Qt;
2195 return Qnil;
2198 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
2199 1, 1, "P",
2200 "Position point relative to window.\n\
2201 With no argument, position text at center of window.\n\
2202 An argument specifies screen line; zero means top of window,\n\
2203 negative means relative to bottom of window.")
2204 (arg)
2205 register Lisp_Object arg;
2207 register struct window *w = XWINDOW (selected_window);
2208 register int height = window_internal_height (w);
2209 register int start;
2211 if (NILP (arg))
2212 XFASTINT (arg) = height / 2;
2213 else
2215 arg = Fprefix_numeric_value (arg);
2216 if (XINT (arg) < 0)
2217 XSETINT (arg, XINT (arg) + height);
2220 start = marker_position (w->start);
2221 if (start < BEGV || start > ZV)
2223 Fvertical_motion (make_number (- height / 2));
2224 Fset_marker (w->start, make_number (point), w->buffer);
2225 w->start_at_line_beg = Fbolp ();
2226 w->force_start = Qt;
2228 else
2229 SET_PT (start);
2231 return Fvertical_motion (arg);
2234 struct save_window_data
2236 int size_from_Lisp_Vector_struct;
2237 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2238 Lisp_Object screen_width, screen_height;
2239 Lisp_Object current_window;
2240 Lisp_Object current_buffer;
2241 Lisp_Object minibuf_scroll_window;
2242 Lisp_Object root_window;
2243 /* A vector, interpreted as a struct saved_window */
2244 Lisp_Object saved_windows;
2246 #define SAVE_WINDOW_DATA_SIZE 7 /* Arg to Fmake_vector */
2248 /* This is saved as a Lisp_Vector */
2249 struct saved_window
2251 /* these first two must agree with struct Lisp_Vector in lisp.h */
2252 int size_from_Lisp_Vector_struct;
2253 struct Lisp_Vector *next_from_Lisp_Vector_struct;
2255 Lisp_Object window;
2256 Lisp_Object buffer, start, pointm, mark;
2257 Lisp_Object left, top, width, height, hscroll;
2258 Lisp_Object parent, prev;
2259 Lisp_Object start_at_line_beg;
2260 Lisp_Object display_table;
2262 #define SAVED_WINDOW_VECTOR_SIZE 14 /* Arg to Fmake_vector */
2264 #define SAVED_WINDOW_N(swv,n) \
2265 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
2267 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
2268 "T if OBJECT is a window-configration object.")
2269 (obj)
2270 Lisp_Object obj;
2272 if (XTYPE (obj) == Lisp_Window_Configuration)
2273 return Qt;
2274 return Qnil;
2278 DEFUN ("set-window-configuration",
2279 Fset_window_configuration, Sset_window_configuration,
2280 1, 1, 0,
2281 "Set the configuration of windows and buffers as specified by CONFIGURATION.\n\
2282 CONFIGURATION must be a value previously returned\n\
2283 by `current-window-configuration' (which see).")
2284 (arg)
2285 Lisp_Object arg;
2287 register struct window *w;
2288 register struct save_window_data *data;
2289 struct Lisp_Vector *saved_windows;
2290 register struct saved_window *p;
2291 register Lisp_Object tem;
2292 Lisp_Object new_current_buffer;
2293 int k;
2294 SCREEN_PTR s;
2296 while (XTYPE (arg) != Lisp_Window_Configuration)
2298 arg = wrong_type_argument (intern ("window-configuration-p"), arg);
2301 data = (struct save_window_data *) XVECTOR (arg);
2302 saved_windows = XVECTOR (data->saved_windows);
2304 s = XSCREEN (XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->screen);
2306 if (XFASTINT (data->screen_height) != SCREEN_HEIGHT (s)
2307 || XFASTINT (data->screen_width) != SCREEN_WIDTH (s))
2309 /* Presumably something clever could be done.
2310 However, it doesn't seem worth the effort */
2311 error ("Screen size %dx%d in saved window configuration mismatches screen.",
2312 XFASTINT (data->screen_height),
2313 XFASTINT (data->screen_width));
2316 windows_or_buffers_changed++;
2317 new_current_buffer = data->current_buffer;
2318 if (NILP (XBUFFER (new_current_buffer)->name))
2319 new_current_buffer = Qnil;
2321 /* Mark all windows now on screen as "deleted".
2322 Restoring the new configuration "undeletes" any that are in it. */
2324 delete_all_subwindows (XWINDOW (SCREEN_ROOT_WINDOW (s)));
2325 #if 0
2326 /* This loses when the minibuf screen is not s. */
2327 delete_all_subwindows (XWINDOW (XWINDOW (minibuf_window)->prev));
2328 #endif
2330 for (k = 0; k < saved_windows->size; k++)
2332 p = SAVED_WINDOW_N (saved_windows, k);
2333 w = XWINDOW (p->window);
2334 w->next = Qnil;
2336 if (!NILP (p->parent))
2337 w->parent = SAVED_WINDOW_N (saved_windows, XFASTINT (p->parent))->window;
2338 else
2339 w->parent = Qnil;
2341 if (!NILP (p->prev))
2343 w->prev = SAVED_WINDOW_N (saved_windows, XFASTINT (p->prev))->window;
2344 #ifdef MULTI_SCREEN
2345 /* This is true for a minibuffer-only screen. */
2346 if (w->mini_p && EQ (w->prev, p->window))
2347 w->next = Qnil;
2348 else
2349 #endif /* MULTI_SCREEN */
2350 XWINDOW (w->prev)->next = p->window;
2352 else
2354 w->prev = Qnil;
2355 if (!NILP (w->parent))
2357 if (EQ (p->width, XWINDOW (w->parent)->width))
2359 XWINDOW (w->parent)->vchild = p->window;
2360 XWINDOW (w->parent)->hchild = Qnil;
2362 else
2364 XWINDOW (w->parent)->hchild = p->window;
2365 XWINDOW (w->parent)->vchild = Qnil;
2369 w->left = p->left;
2370 w->top = p->top;
2371 w->width = p->width;
2372 w->height = p->height;
2373 w->hscroll = p->hscroll;
2374 w->display_table = p->display_table;
2375 XFASTINT (w->last_modified) = 0;
2377 /* Reinstall the saved buffer and pointers into it. */
2378 if (NILP (p->buffer))
2379 w->buffer = p->buffer;
2380 else
2382 if (!NILP (XBUFFER (p->buffer)->name))
2383 /* If saved buffer is alive, install it. */
2385 w->buffer = p->buffer;
2386 w->start_at_line_beg = p->start_at_line_beg;
2387 set_marker_restricted (w->start, Fmarker_position (p->start), w->buffer);
2388 set_marker_restricted (w->pointm, Fmarker_position (p->pointm), w->buffer);
2389 Fset_marker (XBUFFER (w->buffer)->mark,
2390 Fmarker_position (p->mark), w->buffer);
2392 if (!EQ (p->buffer, new_current_buffer) &&
2393 XBUFFER (p->buffer) == current_buffer)
2394 Fgoto_char (w->pointm);
2396 else if (NILP (XBUFFER (w->buffer)->name))
2397 /* Else if window's old buffer is dead too, get a live one. */
2399 w->buffer = Fcdr (Fcar (Vbuffer_alist));
2400 /* This will set the markers to beginning of visible range. */
2401 set_marker_restricted (w->start, make_number (0), w->buffer);
2402 set_marker_restricted (w->pointm, make_number (0), w->buffer);
2403 w->start_at_line_beg = Qt;
2405 else
2406 /* Keeping window's old buffer; make sure the markers are real. */
2407 /* Else if window's old buffer is dead too, get a live one. */
2409 /* Set window markers at start of visible range. */
2410 if (XMARKER (w->start)->buffer == 0)
2411 set_marker_restricted (w->start, make_number (0), w->buffer);
2412 if (XMARKER (w->pointm)->buffer == 0)
2413 set_marker_restricted (w->pointm,
2414 make_number (BUF_PT (XBUFFER (w->buffer))),
2415 w->buffer);
2416 w->start_at_line_beg = Qt;
2421 SCREEN_ROOT_WINDOW (s) = data->root_window;
2423 #ifdef MULTI_SCREEN
2424 if (s != selected_screen && ! SCREEN_IS_TERMCAP (s))
2425 Fselect_screen (WINDOW_SCREEN (XWINDOW (data->root_window)), Qnil);
2426 #endif
2428 if (s == selected_screen)
2430 Fselect_window (data->current_window);
2431 if (!NILP (new_current_buffer))
2432 Fset_buffer (new_current_buffer);
2433 else
2434 Fset_buffer (XWINDOW (selected_window)->buffer);
2437 Vminibuf_scroll_window = data->minibuf_scroll_window;
2438 return (Qnil);
2441 /* Mark all windows now on screen as deleted
2442 by setting their buffers to nil. */
2444 static void
2445 delete_all_subwindows (w)
2446 register struct window *w;
2448 register int count = 1;
2449 w->buffer = Qnil;
2450 if (!NILP (w->next))
2451 delete_all_subwindows (XWINDOW (w->next));
2452 if (!NILP (w->vchild))
2453 delete_all_subwindows (XWINDOW (w->vchild));
2454 if (!NILP (w->hchild))
2455 delete_all_subwindows (XWINDOW (w->hchild));
2458 static int
2459 count_windows (window)
2460 register struct window *window;
2462 register int count = 1;
2463 if (!NILP (window->next))
2464 count += count_windows (XWINDOW (window->next));
2465 if (!NILP (window->vchild))
2466 count += count_windows (XWINDOW (window->vchild));
2467 if (!NILP (window->hchild))
2468 count += count_windows (XWINDOW (window->hchild));
2469 return count;
2472 static int
2473 save_window_save (window, vector, i)
2474 Lisp_Object window;
2475 struct Lisp_Vector *vector;
2476 int i;
2478 register struct saved_window *p;
2479 register struct window *w;
2480 register Lisp_Object tem;
2482 for (;!NILP (window); window = w->next)
2484 p = SAVED_WINDOW_N (vector, i);
2485 w = XWINDOW (window);
2487 XFASTINT (w->temslot) = i++;
2488 p->window = window;
2489 p->buffer = w->buffer;
2490 p->left = w->left;
2491 p->top = w->top;
2492 p->width = w->width;
2493 p->height = w->height;
2494 p->hscroll = w->hscroll;
2495 p->display_table = w->display_table;
2496 if (!NILP (w->buffer))
2498 /* Save w's value of point in the window configuration.
2499 If w is the selected window, then get the value of point
2500 from the buffer; pointm is garbage in the selected window. */
2501 if (EQ (window, selected_window))
2503 p->pointm = Fmake_marker ();
2504 Fset_marker (p->pointm, BUF_PT (XBUFFER (w->buffer)),
2505 w->buffer);
2507 else
2508 p->pointm = Fcopy_marker (w->pointm);
2510 p->start = Fcopy_marker (w->start);
2511 p->start_at_line_beg = w->start_at_line_beg;
2513 tem = XBUFFER (w->buffer)->mark;
2514 p->mark = Fcopy_marker (tem);
2516 else
2518 p->pointm = Qnil;
2519 p->start = Qnil;
2520 p->mark = Qnil;
2521 p->start_at_line_beg = Qnil;
2524 if (NILP (w->parent))
2525 p->parent = Qnil;
2526 else
2527 p->parent = XWINDOW (w->parent)->temslot;
2529 if (NILP (w->prev))
2530 p->prev = Qnil;
2531 else
2532 p->prev = XWINDOW (w->prev)->temslot;
2534 if (!NILP (w->vchild))
2535 i = save_window_save (w->vchild, vector, i);
2536 if (!NILP (w->hchild))
2537 i = save_window_save (w->hchild, vector, i);
2540 return i;
2543 DEFUN ("current-window-configuration",
2544 Fcurrent_window_configuration, Scurrent_window_configuration, 0, 1, 0,
2545 "Return an object representing the current window configuration of SCREEN.\n\
2546 If SCREEN is nil or omitted, use the selected screen.\n\
2547 This describes the number of windows, their sizes and current buffers,\n\
2548 and for each displayed buffer, where display starts, and the positions of\n\
2549 point and mark. An exception is made for point in the current buffer:\n\
2550 its value is -not- saved.")
2551 (screen)
2552 Lisp_Object screen;
2554 register Lisp_Object tem;
2555 register int n_windows;
2556 register struct save_window_data *data;
2557 register int i;
2558 SCREEN_PTR s;
2560 if (NILP (screen))
2561 s = selected_screen;
2562 else
2564 CHECK_LIVE_SCREEN (screen, 0);
2565 s = XSCREEN (screen);
2568 n_windows = count_windows (XWINDOW (SCREEN_ROOT_WINDOW (s)));
2569 data = (struct save_window_data *)
2570 XVECTOR (Fmake_vector (make_number (SAVE_WINDOW_DATA_SIZE),
2571 Qnil));
2572 XFASTINT (data->screen_width) = SCREEN_WIDTH (s);
2573 XFASTINT (data->screen_height) = SCREEN_HEIGHT (s);
2574 data->current_window = SCREEN_SELECTED_WINDOW (s);
2575 XSET (data->current_buffer, Lisp_Buffer, current_buffer);
2576 data->minibuf_scroll_window = Vminibuf_scroll_window;
2577 data->root_window = SCREEN_ROOT_WINDOW (s);
2578 tem = Fmake_vector (make_number (n_windows), Qnil);
2579 data->saved_windows = tem;
2580 for (i = 0; i < n_windows; i++)
2581 XVECTOR (tem)->contents[i]
2582 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE), Qnil);
2583 save_window_save (SCREEN_ROOT_WINDOW (s),
2584 XVECTOR (tem), 0);
2585 XSET (tem, Lisp_Window_Configuration, data);
2586 return (tem);
2589 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
2590 0, UNEVALLED, 0,
2591 "Execute body, preserving window sizes and contents.\n\
2592 Restores which buffer appears in which window, where display starts,\n\
2593 as well as the current buffer.\n\
2594 Does not restore the value of point in current buffer.")
2595 (args)
2596 Lisp_Object args;
2598 register Lisp_Object val;
2599 register int count = specpdl_ptr - specpdl;
2601 record_unwind_protect (Fset_window_configuration,
2602 Fcurrent_window_configuration (Qnil));
2603 val = Fprogn (args);
2604 return unbind_to (count, val);
2607 init_window_once ()
2609 #ifdef MULTI_SCREEN
2610 selected_screen = make_terminal_screen ();
2611 minibuf_window = selected_screen->minibuffer_window;
2612 selected_window = selected_screen->selected_window;
2613 last_nonminibuf_screen = selected_screen;
2614 #else /* not MULTI_SCREEN */
2615 extern Lisp_Object get_minibuffer ();
2617 root_window = make_window (0);
2618 minibuf_window = make_window (0);
2620 XWINDOW (root_window)->next = minibuf_window;
2621 XWINDOW (minibuf_window)->prev = root_window;
2623 /* These values 9 and 10 are arbitrary,
2624 just so that there is "something there."
2625 Correct values are put in in init_xdisp */
2627 XFASTINT (XWINDOW (root_window)->width) = 10;
2628 XFASTINT (XWINDOW (minibuf_window)->width) = 10;
2630 XFASTINT (XWINDOW (root_window)->height) = 9;
2631 XFASTINT (XWINDOW (minibuf_window)->top) = 9;
2632 XFASTINT (XWINDOW (minibuf_window)->height) = 1;
2634 /* Prevent error in Fset_window_buffer. */
2635 XWINDOW (root_window)->buffer = Qt;
2636 XWINDOW (minibuf_window)->buffer = Qt;
2638 /* Now set them up for real. */
2639 Fset_window_buffer (root_window, Fcurrent_buffer ());
2640 Fset_window_buffer (minibuf_window, get_minibuffer (0));
2642 selected_window = root_window;
2643 /* Make sure this window seems more recently used than
2644 a newly-created, never-selected window. Increment
2645 window_select_count so the first selection ever will get
2646 something newer than this. */
2647 XFASTINT (XWINDOW (selected_window)->use_time) = ++window_select_count;
2648 #endif /* not MULTI_SCREEN */
2651 syms_of_window ()
2653 Qwindowp = intern ("windowp");
2654 staticpro (&Qwindowp);
2656 /* Make sure all windows get marked */
2657 staticpro (&minibuf_window);
2659 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
2660 "Non-nil means call as function to display a help buffer.\n\
2661 Used by `with-output-to-temp-buffer'.");
2662 Vtemp_buffer_show_function = Qnil;
2664 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
2665 "If non-nil, function to call to handle `display-buffer'.\n\
2666 It will receive two args, the buffer and a flag which if non-nil means\n\
2667 that the currently selected window is not acceptable.\n\
2668 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'\n\
2669 work using this function.");
2670 Vdisplay_buffer_function = Qnil;
2672 DEFVAR_LISP ("mouse-window", &Vmouse_window,
2673 "Window that the last mouse click occurred on.");
2674 Vmouse_window = Qnil;
2676 DEFVAR_LISP ("mouse-event", &Vmouse_event,
2677 "The last mouse-event object. A list of four elements:\n\
2678 ((X-POS Y-POS) WINDOW SCREEN-PART KEYSEQ).\n\
2679 KEYSEQ is a string, the key sequence to be looked up in the mouse maps.\n\
2680 WINDOW is the window that the click applies do.\n\
2681 If SCREEN-PART is non-nil, the event was on a scrollbar;\n\
2682 then Y-POS is really the total length of the scrollbar, while X-POS is\n\
2683 the relative position of the scrollbar's value within that total length.\n\
2684 SCREEN-PART is one of the following symbols:\n\
2685 `vertical-scrollbar', `vertical-slider',\n\
2686 `vertical-thumbup', `vertical-thumbdown',\n\
2687 `horizontal-scrollbar', `horizontal-slider',\n\
2688 `horizontal-thumbleft', `horizontal-thumbright'");
2689 Vmouse_event = Qnil;
2691 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
2692 "Non-nil means it is the window that C-M-v in minibuffer should scroll.");
2693 Vminibuf_scroll_window = Qnil;
2695 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
2696 "If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window.");
2697 Vother_window_scroll_buffer = Qnil;
2699 #ifdef MULTI_SCREEN
2700 DEFVAR_BOOL ("pop-up-screens", &pop_up_screens,
2701 "*Non-nil means `display-buffer' should make a separate X-window.");
2702 pop_up_screens = 0;
2704 DEFVAR_LISP ("pop-up-screen-function", &Vpop_up_screen_function,
2705 "*If non-nil, function to call to handle automatic new screen creation.\n\
2706 It is called with no arguments and should return a newly created screen.\n\
2708 A typical value might be `(lambda () (x-create-screen auto-screen-parms))'\n\
2709 where `auto-screen-parms' would hold the default screen parameters.");
2710 Vpop_up_screen_function = Qnil;
2711 #endif
2713 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
2714 "*Non-nil means display-buffer should make new windows.");
2715 pop_up_windows = 1;
2717 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
2718 "*Number of lines of continuity when scrolling by screenfuls.");
2719 next_screen_context_lines = 2;
2721 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
2722 "*display-buffer would prefer to split the largest window if this large.\n\
2723 If there is only one window, it is split regardless of this value.");
2724 split_height_threshold = 500;
2726 DEFVAR_INT ("window-min-height", &window_min_height,
2727 "*Delete any window less than this tall (including its mode line).");
2728 window_min_height = 4;
2730 DEFVAR_INT ("window-min-width", &window_min_width,
2731 "*Delete any window less than this wide.");
2732 window_min_width = 10;
2734 defsubr (&Sselected_window);
2735 defsubr (&Sminibuffer_window);
2736 defsubr (&Swindow_minibuffer_p);
2737 defsubr (&Swindowp);
2738 defsubr (&Spos_visible_in_window_p);
2739 defsubr (&Swindow_buffer);
2740 defsubr (&Swindow_height);
2741 defsubr (&Swindow_width);
2742 defsubr (&Swindow_hscroll);
2743 defsubr (&Sset_window_hscroll);
2744 defsubr (&Swindow_edges);
2745 defsubr (&Scoordinates_in_window_p);
2746 defsubr (&Swindow_at);
2747 defsubr (&Swindow_point);
2748 defsubr (&Swindow_start);
2749 defsubr (&Swindow_end);
2750 defsubr (&Sset_window_point);
2751 defsubr (&Sset_window_start);
2752 defsubr (&Swindow_dedicated_p);
2753 defsubr (&Sset_window_buffer_dedicated);
2754 defsubr (&Swindow_display_table);
2755 defsubr (&Sset_window_display_table);
2756 defsubr (&Snext_window);
2757 defsubr (&Sprevious_window);
2758 defsubr (&Sother_window);
2759 defsubr (&Sget_lru_window);
2760 defsubr (&Sget_largest_window);
2761 defsubr (&Sget_buffer_window);
2762 defsubr (&Sdelete_other_windows);
2763 defsubr (&Sdelete_windows_on);
2764 defsubr (&Sreplace_buffer_in_windows);
2765 defsubr (&Sdelete_window);
2766 defsubr (&Sset_window_buffer);
2767 defsubr (&Sselect_window);
2768 defsubr (&Sdisplay_buffer);
2769 defsubr (&Ssplit_window);
2770 defsubr (&Senlarge_window);
2771 defsubr (&Sshrink_window);
2772 defsubr (&Sscroll_up);
2773 defsubr (&Sscroll_down);
2774 defsubr (&Sscroll_left);
2775 defsubr (&Sscroll_right);
2776 defsubr (&Sscroll_other_window);
2777 defsubr (&Srecenter);
2778 defsubr (&Smove_to_window_line);
2779 defsubr (&Swindow_configuration_p);
2780 defsubr (&Sset_window_configuration);
2781 defsubr (&Scurrent_window_configuration);
2782 defsubr (&Ssave_window_excursion);
2785 keys_of_window ()
2787 initial_define_key (control_x_map, '1', "delete-other-windows");
2788 initial_define_key (control_x_map, '2', "split-window");
2789 initial_define_key (control_x_map, '0', "delete-window");
2790 initial_define_key (control_x_map, 'o', "other-window");
2791 initial_define_key (control_x_map, '^', "enlarge-window");
2792 initial_define_key (control_x_map, '<', "scroll-left");
2793 initial_define_key (control_x_map, '>', "scroll-right");
2795 initial_define_key (global_map, Ctl ('V'), "scroll-up");
2796 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
2797 initial_define_key (meta_map, 'v', "scroll-down");
2799 initial_define_key (global_map, Ctl('L'), "recenter");
2800 initial_define_key (meta_map, 'r', "move-to-window-line");