* textmodes/picture.el (picture-mouse-set-point): New command.
[emacs.git] / src / window.c
blob1c7bff2767c8628bed12711d5b6abd3831381940
1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985,86,87,93,94,95,96,97,1998,2000, 2001, 2002
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
23 #include <config.h>
24 #include "lisp.h"
25 #include "buffer.h"
26 #include "keyboard.h"
27 #include "keymap.h"
28 #include "frame.h"
29 #include "window.h"
30 #include "commands.h"
31 #include "indent.h"
32 #include "termchar.h"
33 #include "disptab.h"
34 #include "dispextern.h"
35 #include "blockinput.h"
36 #include "intervals.h"
38 #ifdef HAVE_X_WINDOWS
39 #include "xterm.h"
40 #endif /* HAVE_X_WINDOWS */
41 #ifdef WINDOWSNT
42 #include "w32term.h"
43 #endif
44 #ifdef MSDOS
45 #include "msdos.h"
46 #endif
47 #ifdef MAC_OS
48 #include "macterm.h"
49 #endif
51 /* Values returned from coordinates_in_window. */
53 enum window_part
55 ON_NOTHING,
56 ON_TEXT,
57 ON_MODE_LINE,
58 ON_VERTICAL_BORDER,
59 ON_HEADER_LINE,
60 ON_LEFT_FRINGE,
61 ON_RIGHT_FRINGE,
62 ON_LEFT_MARGIN,
63 ON_RIGHT_MARGIN
67 Lisp_Object Qwindowp, Qwindow_live_p, Qwindow_configuration_p;
68 Lisp_Object Qwindow_size_fixed;
69 extern Lisp_Object Qleft_margin, Qright_margin;
70 extern Lisp_Object Qheight, Qwidth;
72 static int displayed_window_lines P_ ((struct window *));
73 static struct window *decode_window P_ ((Lisp_Object));
74 static Lisp_Object select_window_1 P_ ((Lisp_Object, int));
75 static int count_windows P_ ((struct window *));
76 static int get_leaf_windows P_ ((struct window *, struct window **, int));
77 static void window_scroll P_ ((Lisp_Object, int, int, int));
78 static void window_scroll_pixel_based P_ ((Lisp_Object, int, int, int));
79 static void window_scroll_line_based P_ ((Lisp_Object, int, int, int));
80 static int window_min_size_1 P_ ((struct window *, int));
81 static int window_min_size P_ ((struct window *, int, int, int *));
82 static void size_window P_ ((Lisp_Object, int, int, int));
83 static int freeze_window_start P_ ((struct window *, void *));
84 static int window_fixed_size_p P_ ((struct window *, int, int));
85 static void enlarge_window P_ ((Lisp_Object, int, int, int));
86 static Lisp_Object window_list P_ ((void));
87 static int add_window_to_list P_ ((struct window *, void *));
88 static int candidate_window_p P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
89 Lisp_Object));
90 static Lisp_Object next_window P_ ((Lisp_Object, Lisp_Object,
91 Lisp_Object, int));
92 static void decode_next_window_args P_ ((Lisp_Object *, Lisp_Object *,
93 Lisp_Object *));
94 static int foreach_window_1 P_ ((struct window *,
95 int (* fn) (struct window *, void *),
96 void *));
97 static Lisp_Object window_list_1 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
99 /* The value of `window-size-fixed'. */
101 int window_size_fixed;
103 /* This is the window in which the terminal's cursor should
104 be left when nothing is being done with it. This must
105 always be a leaf window, and its buffer is selected by
106 the top level editing loop at the end of each command.
108 This value is always the same as
109 FRAME_SELECTED_WINDOW (selected_frame). */
111 Lisp_Object selected_window;
113 /* A list of all windows for use by next_window and Fwindow_list.
114 Functions creating or deleting windows should invalidate this cache
115 by setting it to nil. */
117 Lisp_Object Vwindow_list;
119 /* The mini-buffer window of the selected frame.
120 Note that you cannot test for mini-bufferness of an arbitrary window
121 by comparing against this; but you can test for mini-bufferness of
122 the selected window. */
124 Lisp_Object minibuf_window;
126 /* Non-nil means it is the window whose mode line should be
127 shown as the selected window when the minibuffer is selected. */
129 Lisp_Object minibuf_selected_window;
131 /* Non-nil means it is the window for C-M-v to scroll
132 when the mini-buffer is selected. */
134 Lisp_Object Vminibuf_scroll_window;
136 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
138 Lisp_Object Vother_window_scroll_buffer;
140 /* Non-nil means it's function to call to display temp buffers. */
142 Lisp_Object Vtemp_buffer_show_function;
144 /* Non-zero means to use mode-line-inactive face in all windows but the
145 selected-window and the minibuffer-scroll-window when the
146 minibuffer is active. */
147 int mode_line_in_non_selected_windows;
149 /* If a window gets smaller than either of these, it is removed. */
151 EMACS_INT window_min_height;
152 EMACS_INT window_min_width;
154 /* Nonzero implies Fdisplay_buffer should create windows. */
156 int pop_up_windows;
158 /* Nonzero implies make new frames for Fdisplay_buffer. */
160 int pop_up_frames;
162 /* Nonzero means reuse existing frames for displaying buffers. */
164 int display_buffer_reuse_frames;
166 /* Non-nil means use this function instead of default */
168 Lisp_Object Vpop_up_frame_function;
170 /* Function to call to handle Fdisplay_buffer. */
172 Lisp_Object Vdisplay_buffer_function;
174 /* Non-nil means that Fdisplay_buffer should even the heights of windows. */
176 Lisp_Object Veven_window_heights;
178 /* List of buffer *names* for buffers that should have their own frames. */
180 Lisp_Object Vspecial_display_buffer_names;
182 /* List of regexps for buffer names that should have their own frames. */
184 Lisp_Object Vspecial_display_regexps;
186 /* Function to pop up a special frame. */
188 Lisp_Object Vspecial_display_function;
190 /* List of buffer *names* for buffers to appear in selected window. */
192 Lisp_Object Vsame_window_buffer_names;
194 /* List of regexps for buffer names to appear in selected window. */
196 Lisp_Object Vsame_window_regexps;
198 /* Hook run at end of temp_output_buffer_show. */
200 Lisp_Object Qtemp_buffer_show_hook;
202 /* Fdisplay_buffer always splits the largest window
203 if that window is more than this high. */
205 EMACS_INT split_height_threshold;
207 /* Number of lines of continuity in scrolling by screenfuls. */
209 EMACS_INT next_screen_context_lines;
211 /* Incremented for each window created. */
213 static int sequence_number;
215 /* Nonzero after init_window_once has finished. */
217 static int window_initialized;
219 /* Hook to run when window config changes. */
221 Lisp_Object Qwindow_configuration_change_hook;
222 Lisp_Object Vwindow_configuration_change_hook;
224 /* Nonzero means scroll commands try to put point
225 at the same screen height as previously. */
227 Lisp_Object Vscroll_preserve_screen_position;
229 #if 0 /* This isn't used anywhere. */
230 /* Nonzero means we can split a frame even if it is "unsplittable". */
231 static int inhibit_frame_unsplittable;
232 #endif /* 0 */
234 extern EMACS_INT scroll_margin;
236 extern Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
238 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
239 doc: /* Returns t if OBJECT is a window. */)
240 (object)
241 Lisp_Object object;
243 return WINDOWP (object) ? Qt : Qnil;
246 DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
247 doc: /* Returns t if OBJECT is a window which is currently visible. */)
248 (object)
249 Lisp_Object object;
251 return WINDOW_LIVE_P (object) ? Qt : Qnil;
254 Lisp_Object
255 make_window ()
257 Lisp_Object val;
258 register struct window *p;
260 p = allocate_window ();
261 XSETFASTINT (p->sequence_number, ++sequence_number);
262 XSETFASTINT (p->left, 0);
263 XSETFASTINT (p->top, 0);
264 XSETFASTINT (p->height, 0);
265 XSETFASTINT (p->width, 0);
266 XSETFASTINT (p->hscroll, 0);
267 XSETFASTINT (p->min_hscroll, 0);
268 p->orig_top = p->orig_height = Qnil;
269 p->start = Fmake_marker ();
270 p->pointm = Fmake_marker ();
271 XSETFASTINT (p->use_time, 0);
272 p->frame = Qnil;
273 p->display_table = Qnil;
274 p->dedicated = Qnil;
275 p->pseudo_window_p = 0;
276 bzero (&p->cursor, sizeof (p->cursor));
277 bzero (&p->last_cursor, sizeof (p->last_cursor));
278 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
279 p->desired_matrix = p->current_matrix = 0;
280 p->phys_cursor_type = -1;
281 p->phys_cursor_width = -1;
282 p->must_be_updated_p = 0;
283 XSETFASTINT (p->window_end_vpos, 0);
284 XSETFASTINT (p->window_end_pos, 0);
285 p->window_end_valid = Qnil;
286 p->vscroll = 0;
287 XSETWINDOW (val, p);
288 XSETFASTINT (p->last_point, 0);
289 p->frozen_window_start_p = 0;
290 p->height_fixed_p = 0;
291 p->last_cursor_off_p = p->cursor_off_p = 0;
293 Vwindow_list = Qnil;
294 return val;
297 DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
298 doc: /* Return the window that the cursor now appears in and commands apply to. */)
301 return selected_window;
304 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
305 doc: /* Return the window used now for minibuffers.
306 If the optional argument FRAME is specified, return the minibuffer window
307 used by that frame. */)
308 (frame)
309 Lisp_Object frame;
311 if (NILP (frame))
312 frame = selected_frame;
313 CHECK_LIVE_FRAME (frame);
314 return FRAME_MINIBUF_WINDOW (XFRAME (frame));
317 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 0, 1, 0,
318 doc: /* Returns non-nil if WINDOW is a minibuffer window. */)
319 (window)
320 Lisp_Object window;
322 struct window *w = decode_window (window);
323 return MINI_WINDOW_P (w) ? Qt : Qnil;
327 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p,
328 Spos_visible_in_window_p, 0, 3, 0,
329 doc: /* Return t if position POS is currently on the frame in WINDOW.
330 Return nil if that position is scrolled vertically out of view.
331 If a character is only partially visible, nil is returned, unless the
332 optional argument PARTIALLY is non-nil.
333 POS defaults to point in WINDOW; WINDOW defaults to the selected window. */)
334 (pos, window, partially)
335 Lisp_Object pos, window, partially;
337 register struct window *w;
338 register int posint;
339 register struct buffer *buf;
340 struct text_pos top;
341 Lisp_Object in_window;
342 int fully_p;
344 w = decode_window (window);
345 buf = XBUFFER (w->buffer);
346 SET_TEXT_POS_FROM_MARKER (top, w->start);
348 if (!NILP (pos))
350 CHECK_NUMBER_COERCE_MARKER (pos);
351 posint = XINT (pos);
353 else if (w == XWINDOW (selected_window))
354 posint = PT;
355 else
356 posint = XMARKER (w->pointm)->charpos;
358 /* If position is above window start, it's not visible. */
359 if (posint < CHARPOS (top))
360 in_window = Qnil;
361 else if (XFASTINT (w->last_modified) >= BUF_MODIFF (buf)
362 && XFASTINT (w->last_overlay_modified) >= BUF_OVERLAY_MODIFF (buf)
363 && posint < BUF_Z (buf) - XFASTINT (w->window_end_pos))
365 /* If frame is up-to-date, and POSINT is < window end pos, use
366 that info. This doesn't work for POSINT == end pos, because
367 the window end pos is actually the position _after_ the last
368 char in the window. */
369 if (NILP (partially))
371 pos_visible_p (w, posint, &fully_p, NILP (partially));
372 in_window = fully_p ? Qt : Qnil;
374 else
375 in_window = Qt;
377 else if (posint > BUF_ZV (buf))
378 in_window = Qnil;
379 else if (CHARPOS (top) < BUF_BEGV (buf) || CHARPOS (top) > BUF_ZV (buf))
380 /* If window start is out of range, do something reasonable. */
381 in_window = Qnil;
382 else
384 if (pos_visible_p (w, posint, &fully_p, NILP (partially)))
385 in_window = !NILP (partially) || fully_p ? Qt : Qnil;
386 else
387 in_window = Qnil;
390 return in_window;
394 static struct window *
395 decode_window (window)
396 register Lisp_Object window;
398 if (NILP (window))
399 return XWINDOW (selected_window);
401 CHECK_LIVE_WINDOW (window);
402 return XWINDOW (window);
405 DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
406 doc: /* Return the buffer that WINDOW is displaying. */)
407 (window)
408 Lisp_Object window;
410 return decode_window (window)->buffer;
413 DEFUN ("window-height", Fwindow_height, Swindow_height, 0, 1, 0,
414 doc: /* Return the number of lines in WINDOW (including its mode line). */)
415 (window)
416 Lisp_Object window;
418 return decode_window (window)->height;
421 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
422 doc: /* Return the number of display columns in WINDOW.
423 This is the width that is usable columns available for text in WINDOW.
424 If you want to find out how many columns WINDOW takes up,
425 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))). */)
426 (window)
427 Lisp_Object window;
429 return make_number (window_internal_width (decode_window (window)));
432 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
433 doc: /* Return the number of columns by which WINDOW is scrolled from left margin. */)
434 (window)
435 Lisp_Object window;
437 return decode_window (window)->hscroll;
440 DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
441 doc: /* Set number of columns WINDOW is scrolled from left margin to NCOL.
442 NCOL should be zero or positive.
444 Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
445 window so that the location of point becomes invisible. */)
446 (window, ncol)
447 Lisp_Object window, ncol;
449 struct window *w = decode_window (window);
450 int hscroll;
452 CHECK_NUMBER (ncol);
453 hscroll = max (0, XINT (ncol));
455 /* Prevent redisplay shortcuts when changing the hscroll. */
456 if (XINT (w->hscroll) != hscroll)
457 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
459 w->hscroll = make_number (hscroll);
460 return ncol;
463 DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger,
464 Swindow_redisplay_end_trigger, 0, 1, 0,
465 doc: /* Return WINDOW's redisplay end trigger value.
466 See `set-window-redisplay-end-trigger' for more information. */)
467 (window)
468 Lisp_Object window;
470 return decode_window (window)->redisplay_end_trigger;
473 DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger,
474 Sset_window_redisplay_end_trigger, 2, 2, 0,
475 doc: /* Set WINDOW's redisplay end trigger value to VALUE.
476 VALUE should be a buffer position (typically a marker) or nil.
477 If it is a buffer position, then if redisplay in WINDOW reaches a position
478 beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
479 with two arguments: WINDOW, and the end trigger value.
480 Afterwards the end-trigger value is reset to nil. */)
481 (window, value)
482 register Lisp_Object window, value;
484 register struct window *w;
486 w = decode_window (window);
487 w->redisplay_end_trigger = value;
488 return value;
491 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
492 doc: /* Return a list of the edge coordinates of WINDOW.
493 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
494 RIGHT is one more than the rightmost column used by WINDOW,
495 and BOTTOM is one more than the bottommost row used by WINDOW
496 and its mode-line. */)
497 (window)
498 Lisp_Object window;
500 register struct window *w = decode_window (window);
502 return Fcons (w->left, Fcons (w->top,
503 Fcons (make_number (WINDOW_RIGHT_EDGE (w)),
504 Fcons (make_number (XFASTINT (w->top)
505 + XFASTINT (w->height)),
506 Qnil))));
509 /* Test if the character at column *X, row *Y is within window W.
510 If it is not, return 0;
511 if it is in the window's text area,
512 set *x and *y to its location relative to the upper left corner
513 of the window, and
514 return 1;
515 if it is on the window's modeline, return 2;
516 if it is on the border between the window and its right sibling,
517 return 3.
518 if it is on the window's top line, return 4;
519 if it is in left or right fringe of the window,
520 return 5 or 6, and convert *X and *Y to window-relative coordinates;
521 if it is in the marginal area to the left/right of the window,
522 return 7 or 8, and convert *X and *Y to window-relative coordinates.
524 X and Y are frame relative pixel coordinates. */
526 static enum window_part
527 coordinates_in_window (w, x, y)
528 register struct window *w;
529 register int *x, *y;
531 /* Let's make this a global enum later, instead of using numbers
532 everywhere. */
533 struct frame *f = XFRAME (WINDOW_FRAME (w));
534 int left_x, right_x, top_y, bottom_y;
535 enum window_part part;
536 int ux = CANON_X_UNIT (f);
537 int x0 = XFASTINT (w->left) * ux;
538 int x1 = x0 + XFASTINT (w->width) * ux;
539 /* The width of the area where the vertical line can be dragged.
540 (Between mode lines for instance. */
541 int grabbable_width = ux;
542 int lmargin_width = 0, rmargin_width = 0;
544 if (*x < x0 || *x >= x1)
545 return ON_NOTHING;
547 /* In what's below, we subtract 1 when computing right_x because we
548 want the rightmost pixel, which is given by left_pixel+width-1. */
549 if (w->pseudo_window_p)
551 left_x = 0;
552 right_x = XFASTINT (w->width) * CANON_X_UNIT (f) - 1;
553 top_y = WINDOW_DISPLAY_TOP_EDGE_PIXEL_Y (w);
554 bottom_y = WINDOW_DISPLAY_BOTTOM_EDGE_PIXEL_Y (w);
556 else
558 left_x = (WINDOW_DISPLAY_LEFT_EDGE_PIXEL_X (w)
559 - FRAME_INTERNAL_BORDER_WIDTH_SAFE (f));
560 right_x = WINDOW_DISPLAY_RIGHT_EDGE_PIXEL_X (w) - 1;
561 top_y = (WINDOW_DISPLAY_TOP_EDGE_PIXEL_Y (w)
562 - FRAME_INTERNAL_BORDER_WIDTH_SAFE (f));
563 bottom_y = WINDOW_DISPLAY_BOTTOM_EDGE_PIXEL_Y (w);
566 /* On the mode line or header line? If it's near the start of
567 the mode or header line of window that's has a horizontal
568 sibling, say it's on the vertical line. That's to be able
569 to resize windows horizontally in case we're using toolkit
570 scroll bars. */
572 if (WINDOW_WANTS_MODELINE_P (w)
573 && *y >= bottom_y - CURRENT_MODE_LINE_HEIGHT (w)
574 && *y < bottom_y)
576 /* We're somewhere on the mode line. We consider the place
577 between mode lines of horizontally adjacent mode lines
578 as the vertical border. If scroll bars on the left,
579 return the right window. */
580 part = ON_MODE_LINE;
582 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
584 if (abs (*x - x0) < grabbable_width)
585 part = ON_VERTICAL_BORDER;
587 else if (!WINDOW_RIGHTMOST_P (w) && abs (*x - x1) < grabbable_width)
588 part = ON_VERTICAL_BORDER;
590 else if (WINDOW_WANTS_HEADER_LINE_P (w)
591 && *y < top_y + CURRENT_HEADER_LINE_HEIGHT (w)
592 && *y >= top_y)
594 part = ON_HEADER_LINE;
596 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
598 if (abs (*x - x0) < grabbable_width)
599 part = ON_VERTICAL_BORDER;
601 else if (!WINDOW_RIGHTMOST_P (w) && abs (*x - x1) < grabbable_width)
602 part = ON_VERTICAL_BORDER;
604 /* Outside anything interesting? */
605 else if (*y < top_y
606 || *y >= bottom_y
607 || *x < (left_x
608 - FRAME_LEFT_FRINGE_WIDTH (f)
609 - FRAME_LEFT_SCROLL_BAR_WIDTH (f) * ux)
610 || *x > (right_x
611 + FRAME_RIGHT_FRINGE_WIDTH (f)
612 + FRAME_RIGHT_SCROLL_BAR_WIDTH (f) * ux))
614 part = ON_NOTHING;
616 else if (FRAME_WINDOW_P (f))
618 if (!w->pseudo_window_p
619 && !FRAME_HAS_VERTICAL_SCROLL_BARS (f)
620 && !WINDOW_RIGHTMOST_P (w)
621 && (abs (*x - right_x - FRAME_RIGHT_FRINGE_WIDTH (f)) < grabbable_width))
623 part = ON_VERTICAL_BORDER;
625 else if (*x < left_x || *x > right_x)
627 /* Other lines than the mode line don't include fringes and
628 scroll bars on the left. */
630 /* Convert X and Y to window-relative pixel coordinates. */
631 *x -= left_x;
632 *y -= top_y;
633 part = *x < left_x ? ON_LEFT_FRINGE : ON_RIGHT_FRINGE;
635 else
637 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
638 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
639 /* You can never be on a margin area if its width is zero. */
640 if (lmargin_width
641 && *x <= window_box_right (w, LEFT_MARGIN_AREA))
642 part = ON_LEFT_MARGIN;
643 else if (rmargin_width
644 && *x >= window_box_left (w, RIGHT_MARGIN_AREA))
645 part = ON_RIGHT_MARGIN;
646 else
648 part = ON_TEXT;
649 *x -= left_x;
650 *y -= top_y;
654 else
656 /* Need to say "*x > right_x" rather than >=, since on character
657 terminals, the vertical line's x coordinate is right_x. */
658 if (*x < left_x || *x > right_x)
660 /* Other lines than the mode line don't include fringes and
661 scroll bars on the left. */
663 /* Convert X and Y to window-relative pixel coordinates. */
664 *x -= left_x;
665 *y -= top_y;
666 part = *x < left_x ? ON_LEFT_FRINGE : ON_RIGHT_FRINGE;
668 /* Here, too, "*x > right_x" is because of character terminals. */
669 else if (!w->pseudo_window_p
670 && !WINDOW_RIGHTMOST_P (w)
671 && *x > right_x - ux)
673 /* On the border on the right side of the window? Assume that
674 this area begins at RIGHT_X minus a canonical char width. */
675 part = ON_VERTICAL_BORDER;
677 else
679 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
680 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
681 /* You can never be on a margin area if its width is zero.
682 This is especially important for character terminals. */
683 if (lmargin_width
684 && *x <= window_box_right (w, LEFT_MARGIN_AREA))
685 part = ON_LEFT_MARGIN;
686 else if (rmargin_width
687 && *x >= window_box_left (w, RIGHT_MARGIN_AREA))
688 part = ON_RIGHT_MARGIN;
689 else
691 part = ON_TEXT;
692 /* Convert X and Y to window-relative pixel coordinates. */
693 *x -= left_x;
694 *y -= top_y;
699 return part;
703 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
704 Scoordinates_in_window_p, 2, 2, 0,
705 doc: /* Return non-nil if COORDINATES are in WINDOW.
706 COORDINATES is a cons of the form (X . Y), X and Y being distances
707 measured in characters from the upper-left corner of the frame.
708 \(0 . 0) denotes the character in the upper left corner of the
709 frame.
710 If COORDINATES are in the text portion of WINDOW,
711 the coordinates relative to the window are returned.
712 If they are in the mode line of WINDOW, `mode-line' is returned.
713 If they are in the top mode line of WINDOW, `header-line' is returned.
714 If they are in the left fringe of WINDOW, `left-fringe' is returned.
715 If they are in the right fringe of WINDOW, `right-fringe' is returned.
716 If they are on the border between WINDOW and its right sibling,
717 `vertical-line' is returned.
718 If they are in the windows's left or right marginal areas, `left-margin'\n\
719 or `right-margin' is returned. */)
720 (coordinates, window)
721 register Lisp_Object coordinates, window;
723 struct window *w;
724 struct frame *f;
725 int x, y;
726 Lisp_Object lx, ly;
728 CHECK_LIVE_WINDOW (window);
729 w = XWINDOW (window);
730 f = XFRAME (w->frame);
731 CHECK_CONS (coordinates);
732 lx = Fcar (coordinates);
733 ly = Fcdr (coordinates);
734 CHECK_NUMBER_OR_FLOAT (lx);
735 CHECK_NUMBER_OR_FLOAT (ly);
736 x = PIXEL_X_FROM_CANON_X (f, lx);
737 y = PIXEL_Y_FROM_CANON_Y (f, ly);
739 switch (coordinates_in_window (w, &x, &y))
741 case ON_NOTHING:
742 return Qnil;
744 case ON_TEXT:
745 /* X and Y are now window relative pixel coordinates. Convert
746 them to canonical char units before returning them. */
747 return Fcons (CANON_X_FROM_PIXEL_X (f, x),
748 CANON_Y_FROM_PIXEL_Y (f, y));
750 case ON_MODE_LINE:
751 return Qmode_line;
753 case ON_VERTICAL_BORDER:
754 return Qvertical_line;
756 case ON_HEADER_LINE:
757 return Qheader_line;
759 case ON_LEFT_FRINGE:
760 return Qleft_fringe;
762 case ON_RIGHT_FRINGE:
763 return Qright_fringe;
765 case ON_LEFT_MARGIN:
766 return Qleft_margin;
768 case ON_RIGHT_MARGIN:
769 return Qright_margin;
771 default:
772 abort ();
777 /* Callback for foreach_window, used in window_from_coordinates.
778 Check if window W contains coordinates specified by USER_DATA which
779 is actually a pointer to a struct check_window_data CW.
781 Check if window W contains coordinates *CW->x and *CW->y. If it
782 does, return W in *CW->window, as Lisp_Object, and return in
783 *CW->part the part of the window under coordinates *X,*Y. Return
784 zero from this function to stop iterating over windows. */
786 struct check_window_data
788 Lisp_Object *window;
789 int *x, *y, *part;
792 static int
793 check_window_containing (w, user_data)
794 struct window *w;
795 void *user_data;
797 struct check_window_data *cw = (struct check_window_data *) user_data;
798 enum window_part found;
799 int continue_p = 1;
801 found = coordinates_in_window (w, cw->x, cw->y);
802 if (found != ON_NOTHING)
804 *cw->part = found - 1;
805 XSETWINDOW (*cw->window, w);
806 continue_p = 0;
809 return continue_p;
813 /* Find the window containing frame-relative pixel position X/Y and
814 return it as a Lisp_Object. If X, Y is on the window's modeline,
815 set *PART to 1; if it is on the separating line between the window
816 and its right sibling, set it to 2; otherwise set it to 0. If
817 there is no window under X, Y return nil and leave *PART
818 unmodified. TOOL_BAR_P non-zero means detect tool-bar windows.
820 This function was previously implemented with a loop cycling over
821 windows with Fnext_window, and starting with the frame's selected
822 window. It turned out that this doesn't work with an
823 implementation of next_window using Vwindow_list, because
824 FRAME_SELECTED_WINDOW (F) is not always contained in the window
825 tree of F when this function is called asynchronously from
826 note_mouse_highlight. The original loop didn't terminate in this
827 case. */
829 Lisp_Object
830 window_from_coordinates (f, x, y, part, tool_bar_p)
831 struct frame *f;
832 int x, y;
833 int *part;
834 int tool_bar_p;
836 Lisp_Object window;
837 struct check_window_data cw;
839 window = Qnil;
840 cw.window = &window, cw.x = &x, cw.y = &y; cw.part = part;
841 foreach_window (f, check_window_containing, &cw);
843 /* If not found above, see if it's in the tool bar window, if a tool
844 bar exists. */
845 if (NILP (window)
846 && tool_bar_p
847 && WINDOWP (f->tool_bar_window)
848 && XINT (XWINDOW (f->tool_bar_window)->height) > 0
849 && (coordinates_in_window (XWINDOW (f->tool_bar_window), &x, &y)
850 != ON_NOTHING))
852 *part = 0;
853 window = f->tool_bar_window;
856 return window;
859 DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
860 doc: /* Return window containing coordinates X and Y on FRAME.
861 If omitted, FRAME defaults to the currently selected frame.
862 The top left corner of the frame is considered to be row 0,
863 column 0. */)
864 (x, y, frame)
865 Lisp_Object x, y, frame;
867 int part;
868 struct frame *f;
870 if (NILP (frame))
871 frame = selected_frame;
872 CHECK_LIVE_FRAME (frame);
873 f = XFRAME (frame);
875 /* Check that arguments are integers or floats. */
876 CHECK_NUMBER_OR_FLOAT (x);
877 CHECK_NUMBER_OR_FLOAT (y);
879 return window_from_coordinates (f,
880 PIXEL_X_FROM_CANON_X (f, x),
881 PIXEL_Y_FROM_CANON_Y (f, y),
882 &part, 0);
885 DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
886 doc: /* Return current value of point in WINDOW.
887 For a nonselected window, this is the value point would have
888 if that window were selected.
890 Note that, when WINDOW is the selected window and its buffer
891 is also currently selected, the value returned is the same as (point).
892 It would be more strictly correct to return the `top-level' value
893 of point, outside of any save-excursion forms.
894 But that is hard to define. */)
895 (window)
896 Lisp_Object window;
898 register struct window *w = decode_window (window);
900 if (w == XWINDOW (selected_window)
901 && current_buffer == XBUFFER (w->buffer))
902 return Fpoint ();
903 return Fmarker_position (w->pointm);
906 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
907 doc: /* Return position at which display currently starts in WINDOW.
908 This is updated by redisplay or by calling `set-window-start'. */)
909 (window)
910 Lisp_Object window;
912 return Fmarker_position (decode_window (window)->start);
915 /* This is text temporarily removed from the doc string below.
917 This function returns nil if the position is not currently known.
918 That happens when redisplay is preempted and doesn't finish.
919 If in that case you want to compute where the end of the window would
920 have been if redisplay had finished, do this:
921 (save-excursion
922 (goto-char (window-start window))
923 (vertical-motion (1- (window-height window)) window)
924 (point))") */
926 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 2, 0,
927 doc: /* Return position at which display currently ends in WINDOW.
928 This is updated by redisplay, when it runs to completion.
929 Simply changing the buffer text or setting `window-start'
930 does not update this value.
931 If UPDATE is non-nil, compute the up-to-date position
932 if it isn't already recorded. */)
933 (window, update)
934 Lisp_Object window, update;
936 Lisp_Object value;
937 struct window *w = decode_window (window);
938 Lisp_Object buf;
940 buf = w->buffer;
941 CHECK_BUFFER (buf);
943 #if 0 /* This change broke some things. We should make it later. */
944 /* If we don't know the end position, return nil.
945 The user can compute it with vertical-motion if he wants to.
946 It would be nicer to do it automatically,
947 but that's so slow that it would probably bother people. */
948 if (NILP (w->window_end_valid))
949 return Qnil;
950 #endif
952 if (! NILP (update)
953 && ! (! NILP (w->window_end_valid)
954 && XFASTINT (w->last_modified) >= MODIFF))
956 struct text_pos startp;
957 struct it it;
958 struct buffer *old_buffer = NULL, *b = XBUFFER (buf);
960 /* In case W->start is out of the range, use something
961 reasonable. This situation occurred when loading a file with
962 `-l' containing a call to `rmail' with subsequent other
963 commands. At the end, W->start happened to be BEG, while
964 rmail had already narrowed the buffer. */
965 if (XMARKER (w->start)->charpos < BEGV)
966 SET_TEXT_POS (startp, BEGV, BEGV_BYTE);
967 else if (XMARKER (w->start)->charpos > ZV)
968 SET_TEXT_POS (startp, ZV, ZV_BYTE);
969 else
970 SET_TEXT_POS_FROM_MARKER (startp, w->start);
972 /* Cannot use Fvertical_motion because that function doesn't
973 cope with variable-height lines. */
974 if (b != current_buffer)
976 old_buffer = current_buffer;
977 set_buffer_internal (b);
980 start_display (&it, w, startp);
981 move_it_vertically (&it, window_box_height (w));
982 if (it.current_y < it.last_visible_y)
983 move_it_past_eol (&it);
984 value = make_number (IT_CHARPOS (it));
986 if (old_buffer)
987 set_buffer_internal (old_buffer);
989 else
990 XSETINT (value, BUF_Z (XBUFFER (buf)) - XFASTINT (w->window_end_pos));
992 return value;
995 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
996 doc: /* Make point value in WINDOW be at position POS in WINDOW's buffer. */)
997 (window, pos)
998 Lisp_Object window, pos;
1000 register struct window *w = decode_window (window);
1002 CHECK_NUMBER_COERCE_MARKER (pos);
1003 if (w == XWINDOW (selected_window)
1004 && XBUFFER (w->buffer) == current_buffer)
1005 Fgoto_char (pos);
1006 else
1007 set_marker_restricted (w->pointm, pos, w->buffer);
1009 /* We have to make sure that redisplay updates the window to show
1010 the new value of point. */
1011 if (!EQ (window, selected_window))
1012 ++windows_or_buffers_changed;
1014 return pos;
1017 DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
1018 doc: /* Make display in WINDOW start at position POS in WINDOW's buffer.
1019 Optional third arg NOFORCE non-nil inhibits next redisplay
1020 from overriding motion of point in order to display at this exact start. */)
1021 (window, pos, noforce)
1022 Lisp_Object window, pos, noforce;
1024 register struct window *w = decode_window (window);
1026 CHECK_NUMBER_COERCE_MARKER (pos);
1027 set_marker_restricted (w->start, pos, w->buffer);
1028 /* this is not right, but much easier than doing what is right. */
1029 w->start_at_line_beg = Qnil;
1030 if (NILP (noforce))
1031 w->force_start = Qt;
1032 w->update_mode_line = Qt;
1033 XSETFASTINT (w->last_modified, 0);
1034 XSETFASTINT (w->last_overlay_modified, 0);
1035 if (!EQ (window, selected_window))
1036 windows_or_buffers_changed++;
1038 return pos;
1041 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
1042 1, 1, 0,
1043 doc: /* Return WINDOW's dedicated object, usually t or nil.
1044 See also `set-window-dedicated-p'. */)
1045 (window)
1046 Lisp_Object window;
1048 return decode_window (window)->dedicated;
1051 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
1052 Sset_window_dedicated_p, 2, 2, 0,
1053 doc: /* Control whether WINDOW is dedicated to the buffer it displays.
1054 If it is dedicated, Emacs will not automatically change
1055 which buffer appears in it.
1056 The second argument is the new value for the dedication flag;
1057 non-nil means yes. */)
1058 (window, arg)
1059 Lisp_Object window, arg;
1061 register struct window *w = decode_window (window);
1063 if (NILP (arg))
1064 w->dedicated = Qnil;
1065 else
1066 w->dedicated = Qt;
1068 return w->dedicated;
1071 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
1072 0, 1, 0,
1073 doc: /* Return the display-table that WINDOW is using. */)
1074 (window)
1075 Lisp_Object window;
1077 return decode_window (window)->display_table;
1080 /* Get the display table for use on window W. This is either W's
1081 display table or W's buffer's display table. Ignore the specified
1082 tables if they are not valid; if no valid table is specified,
1083 return 0. */
1085 struct Lisp_Char_Table *
1086 window_display_table (w)
1087 struct window *w;
1089 struct Lisp_Char_Table *dp = NULL;
1091 if (DISP_TABLE_P (w->display_table))
1092 dp = XCHAR_TABLE (w->display_table);
1093 else if (BUFFERP (w->buffer))
1095 struct buffer *b = XBUFFER (w->buffer);
1097 if (DISP_TABLE_P (b->display_table))
1098 dp = XCHAR_TABLE (b->display_table);
1099 else if (DISP_TABLE_P (Vstandard_display_table))
1100 dp = XCHAR_TABLE (Vstandard_display_table);
1103 return dp;
1106 DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
1107 doc: /* Set WINDOW's display-table to TABLE. */)
1108 (window, table)
1109 register Lisp_Object window, table;
1111 register struct window *w;
1113 w = decode_window (window);
1114 w->display_table = table;
1115 return table;
1118 /* Record info on buffer window w is displaying
1119 when it is about to cease to display that buffer. */
1120 static void
1121 unshow_buffer (w)
1122 register struct window *w;
1124 Lisp_Object buf;
1125 struct buffer *b;
1127 buf = w->buffer;
1128 b = XBUFFER (buf);
1129 if (b != XMARKER (w->pointm)->buffer)
1130 abort ();
1132 #if 0
1133 if (w == XWINDOW (selected_window)
1134 || ! EQ (buf, XWINDOW (selected_window)->buffer))
1135 /* Do this except when the selected window's buffer
1136 is being removed from some other window. */
1137 #endif
1138 /* last_window_start records the start position that this buffer
1139 had in the last window to be disconnected from it.
1140 Now that this statement is unconditional,
1141 it is possible for the buffer to be displayed in the
1142 selected window, while last_window_start reflects another
1143 window which was recently showing the same buffer.
1144 Some people might say that might be a good thing. Let's see. */
1145 b->last_window_start = marker_position (w->start);
1147 /* Point in the selected window's buffer
1148 is actually stored in that buffer, and the window's pointm isn't used.
1149 So don't clobber point in that buffer. */
1150 if (! EQ (buf, XWINDOW (selected_window)->buffer)
1151 /* This line helps to fix Horsley's testbug.el bug. */
1152 && !(WINDOWP (b->last_selected_window)
1153 && w != XWINDOW (b->last_selected_window)
1154 && EQ (buf, XWINDOW (b->last_selected_window)->buffer)))
1155 temp_set_point_both (b,
1156 clip_to_bounds (BUF_BEGV (b),
1157 XMARKER (w->pointm)->charpos,
1158 BUF_ZV (b)),
1159 clip_to_bounds (BUF_BEGV_BYTE (b),
1160 marker_byte_position (w->pointm),
1161 BUF_ZV_BYTE (b)));
1163 if (WINDOWP (b->last_selected_window)
1164 && w == XWINDOW (b->last_selected_window))
1165 b->last_selected_window = Qnil;
1168 /* Put replacement into the window structure in place of old. */
1169 static void
1170 replace_window (old, replacement)
1171 Lisp_Object old, replacement;
1173 register Lisp_Object tem;
1174 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
1176 /* If OLD is its frame's root_window, then replacement is the new
1177 root_window for that frame. */
1179 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
1180 FRAME_ROOT_WINDOW (XFRAME (o->frame)) = replacement;
1182 p->left = o->left;
1183 p->top = o->top;
1184 p->width = o->width;
1185 p->height = o->height;
1186 p->desired_matrix = p->current_matrix = 0;
1187 p->vscroll = 0;
1188 bzero (&p->cursor, sizeof (p->cursor));
1189 bzero (&p->last_cursor, sizeof (p->last_cursor));
1190 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
1191 p->phys_cursor_type = -1;
1192 p->phys_cursor_width = -1;
1193 p->must_be_updated_p = 0;
1194 p->pseudo_window_p = 0;
1195 XSETFASTINT (p->window_end_vpos, 0);
1196 XSETFASTINT (p->window_end_pos, 0);
1197 p->window_end_valid = Qnil;
1198 p->frozen_window_start_p = 0;
1199 p->orig_top = p->orig_height = Qnil;
1201 p->next = tem = o->next;
1202 if (!NILP (tem))
1203 XWINDOW (tem)->prev = replacement;
1205 p->prev = tem = o->prev;
1206 if (!NILP (tem))
1207 XWINDOW (tem)->next = replacement;
1209 p->parent = tem = o->parent;
1210 if (!NILP (tem))
1212 if (EQ (XWINDOW (tem)->vchild, old))
1213 XWINDOW (tem)->vchild = replacement;
1214 if (EQ (XWINDOW (tem)->hchild, old))
1215 XWINDOW (tem)->hchild = replacement;
1218 /*** Here, if replacement is a vertical combination
1219 and so is its new parent, we should make replacement's
1220 children be children of that parent instead. ***/
1223 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
1224 doc: /* Remove WINDOW from the display. Default is selected window. */)
1225 (window)
1226 register Lisp_Object window;
1228 delete_window (window);
1230 if (! NILP (Vwindow_configuration_change_hook)
1231 && ! NILP (Vrun_hooks))
1232 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
1234 return Qnil;
1237 void
1238 delete_window (window)
1239 register Lisp_Object window;
1241 register Lisp_Object tem, parent, sib;
1242 register struct window *p;
1243 register struct window *par;
1244 struct frame *f;
1246 /* Because this function is called by other C code on non-leaf
1247 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
1248 so we can't decode_window here. */
1249 if (NILP (window))
1250 window = selected_window;
1251 else
1252 CHECK_WINDOW (window);
1253 p = XWINDOW (window);
1255 /* It's okay to delete an already-deleted window. */
1256 if (NILP (p->buffer)
1257 && NILP (p->hchild)
1258 && NILP (p->vchild))
1259 return;
1261 parent = p->parent;
1262 if (NILP (parent))
1263 error ("Attempt to delete minibuffer or sole ordinary window");
1264 par = XWINDOW (parent);
1266 windows_or_buffers_changed++;
1267 Vwindow_list = Qnil;
1268 f = XFRAME (WINDOW_FRAME (p));
1269 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
1271 /* Are we trying to delete any frame's selected window? */
1273 Lisp_Object swindow, pwindow;
1275 /* See if the frame's selected window is either WINDOW
1276 or any subwindow of it, by finding all that window's parents
1277 and comparing each one with WINDOW. */
1278 swindow = FRAME_SELECTED_WINDOW (f);
1280 while (1)
1282 pwindow = swindow;
1283 while (!NILP (pwindow))
1285 if (EQ (window, pwindow))
1286 break;
1287 pwindow = XWINDOW (pwindow)->parent;
1290 /* If the window being deleted is not a parent of SWINDOW,
1291 then SWINDOW is ok as the new selected window. */
1292 if (!EQ (window, pwindow))
1293 break;
1294 /* Otherwise, try another window for SWINDOW. */
1295 swindow = Fnext_window (swindow, Qlambda, Qnil);;
1297 /* If we get back to the frame's selected window,
1298 it means there was no acceptable alternative,
1299 so we cannot delete. */
1300 if (EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1301 error ("Cannot delete window");
1304 /* If we need to change SWINDOW, do it. */
1305 if (! EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1307 /* If we're about to delete the selected window on the
1308 selected frame, then we should use Fselect_window to select
1309 the new window. On the other hand, if we're about to
1310 delete the selected window on any other frame, we shouldn't do
1311 anything but set the frame's selected_window slot. */
1312 if (EQ (FRAME_SELECTED_WINDOW (f), selected_window))
1313 Fselect_window (swindow);
1314 else
1315 FRAME_SELECTED_WINDOW (f) = swindow;
1319 tem = p->buffer;
1320 /* tem is null for dummy parent windows
1321 (which have inferiors but not any contents themselves) */
1322 if (!NILP (tem))
1324 unshow_buffer (p);
1325 unchain_marker (p->pointm);
1326 unchain_marker (p->start);
1329 /* Free window glyph matrices. It is sure that they are allocated
1330 again when ADJUST_GLYPHS is called. Block input so that expose
1331 events and other events that access glyph matrices are not
1332 processed while we are changing them. */
1333 BLOCK_INPUT;
1334 free_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f)));
1336 tem = p->next;
1337 if (!NILP (tem))
1338 XWINDOW (tem)->prev = p->prev;
1340 tem = p->prev;
1341 if (!NILP (tem))
1342 XWINDOW (tem)->next = p->next;
1344 if (EQ (window, par->hchild))
1345 par->hchild = p->next;
1346 if (EQ (window, par->vchild))
1347 par->vchild = p->next;
1349 /* Find one of our siblings to give our space to. */
1350 sib = p->prev;
1351 if (NILP (sib))
1353 /* If p gives its space to its next sibling, that sibling needs
1354 to have its top/left side pulled back to where p's is.
1355 set_window_{height,width} will re-position the sibling's
1356 children. */
1357 sib = p->next;
1358 XWINDOW (sib)->top = p->top;
1359 XWINDOW (sib)->left = p->left;
1362 /* Stretch that sibling. */
1363 if (!NILP (par->vchild))
1364 set_window_height (sib,
1365 XFASTINT (XWINDOW (sib)->height) + XFASTINT (p->height),
1367 if (!NILP (par->hchild))
1368 set_window_width (sib,
1369 XFASTINT (XWINDOW (sib)->width) + XFASTINT (p->width),
1372 /* If parent now has only one child,
1373 put the child into the parent's place. */
1374 tem = par->hchild;
1375 if (NILP (tem))
1376 tem = par->vchild;
1377 if (NILP (XWINDOW (tem)->next))
1378 replace_window (parent, tem);
1380 /* Since we may be deleting combination windows, we must make sure that
1381 not only p but all its children have been marked as deleted. */
1382 if (! NILP (p->hchild))
1383 delete_all_subwindows (XWINDOW (p->hchild));
1384 else if (! NILP (p->vchild))
1385 delete_all_subwindows (XWINDOW (p->vchild));
1387 /* Mark this window as deleted. */
1388 p->buffer = p->hchild = p->vchild = Qnil;
1390 /* Adjust glyph matrices. */
1391 adjust_glyphs (f);
1392 UNBLOCK_INPUT;
1397 /***********************************************************************
1398 Window List
1399 ***********************************************************************/
1401 /* Add window W to *USER_DATA. USER_DATA is actually a Lisp_Object
1402 pointer. This is a callback function for foreach_window, used in
1403 function window_list. */
1405 static int
1406 add_window_to_list (w, user_data)
1407 struct window *w;
1408 void *user_data;
1410 Lisp_Object *list = (Lisp_Object *) user_data;
1411 Lisp_Object window;
1412 XSETWINDOW (window, w);
1413 *list = Fcons (window, *list);
1414 return 1;
1418 /* Return a list of all windows, for use by next_window. If
1419 Vwindow_list is a list, return that list. Otherwise, build a new
1420 list, cache it in Vwindow_list, and return that. */
1422 static Lisp_Object
1423 window_list ()
1425 if (!CONSP (Vwindow_list))
1427 Lisp_Object tail;
1429 Vwindow_list = Qnil;
1430 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1432 Lisp_Object args[2];
1434 /* We are visiting windows in canonical order, and add
1435 new windows at the front of args[1], which means we
1436 have to reverse this list at the end. */
1437 args[1] = Qnil;
1438 foreach_window (XFRAME (XCAR (tail)), add_window_to_list, &args[1]);
1439 args[0] = Vwindow_list;
1440 args[1] = Fnreverse (args[1]);
1441 Vwindow_list = Fnconc (2, args);
1445 return Vwindow_list;
1449 /* Value is non-zero if WINDOW satisfies the constraints given by
1450 OWINDOW, MINIBUF and ALL_FRAMES.
1452 MINIBUF t means WINDOW may be minibuffer windows.
1453 `lambda' means WINDOW may not be a minibuffer window.
1454 a window means a specific minibuffer window
1456 ALL_FRAMES t means search all frames,
1457 nil means search just current frame,
1458 `visible' means search just visible frames,
1459 0 means search visible and iconified frames,
1460 a window means search the frame that window belongs to,
1461 a frame means consider windows on that frame, only. */
1463 static int
1464 candidate_window_p (window, owindow, minibuf, all_frames)
1465 Lisp_Object window, owindow, minibuf, all_frames;
1467 struct window *w = XWINDOW (window);
1468 struct frame *f = XFRAME (w->frame);
1469 int candidate_p = 1;
1471 if (!BUFFERP (w->buffer))
1472 candidate_p = 0;
1473 else if (MINI_WINDOW_P (w)
1474 && (EQ (minibuf, Qlambda)
1475 || (WINDOWP (minibuf) && !EQ (minibuf, window))))
1477 /* If MINIBUF is `lambda' don't consider any mini-windows.
1478 If it is a window, consider only that one. */
1479 candidate_p = 0;
1481 else if (EQ (all_frames, Qt))
1482 candidate_p = 1;
1483 else if (NILP (all_frames))
1485 xassert (WINDOWP (owindow));
1486 candidate_p = EQ (w->frame, XWINDOW (owindow)->frame);
1488 else if (EQ (all_frames, Qvisible))
1490 FRAME_SAMPLE_VISIBILITY (f);
1491 candidate_p = FRAME_VISIBLE_P (f);
1493 else if (INTEGERP (all_frames) && XINT (all_frames) == 0)
1495 FRAME_SAMPLE_VISIBILITY (f);
1496 candidate_p = FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f);
1498 else if (WINDOWP (all_frames))
1499 candidate_p = (EQ (FRAME_MINIBUF_WINDOW (f), all_frames)
1500 || EQ (XWINDOW (all_frames)->frame, w->frame)
1501 || EQ (XWINDOW (all_frames)->frame, FRAME_FOCUS_FRAME (f)));
1502 else if (FRAMEP (all_frames))
1503 candidate_p = EQ (all_frames, w->frame);
1505 return candidate_p;
1509 /* Decode arguments as allowed by Fnext_window, Fprevious_window, and
1510 Fwindow_list. See there for the meaning of WINDOW, MINIBUF, and
1511 ALL_FRAMES. */
1513 static void
1514 decode_next_window_args (window, minibuf, all_frames)
1515 Lisp_Object *window, *minibuf, *all_frames;
1517 if (NILP (*window))
1518 *window = selected_window;
1519 else
1520 CHECK_LIVE_WINDOW (*window);
1522 /* MINIBUF nil may or may not include minibuffers. Decide if it
1523 does. */
1524 if (NILP (*minibuf))
1525 *minibuf = minibuf_level ? minibuf_window : Qlambda;
1526 else if (!EQ (*minibuf, Qt))
1527 *minibuf = Qlambda;
1529 /* Now *MINIBUF can be t => count all minibuffer windows, `lambda'
1530 => count none of them, or a specific minibuffer window (the
1531 active one) to count. */
1533 /* ALL_FRAMES nil doesn't specify which frames to include. */
1534 if (NILP (*all_frames))
1535 *all_frames = (!EQ (*minibuf, Qlambda)
1536 ? FRAME_MINIBUF_WINDOW (XFRAME (XWINDOW (*window)->frame))
1537 : Qnil);
1538 else if (EQ (*all_frames, Qvisible))
1540 else if (XFASTINT (*all_frames) == 0)
1542 else if (FRAMEP (*all_frames))
1544 else if (!EQ (*all_frames, Qt))
1545 *all_frames = Qnil;
1547 /* Now *ALL_FRAMES is t meaning search all frames, nil meaning
1548 search just current frame, `visible' meaning search just visible
1549 frames, 0 meaning search visible and iconified frames, or a
1550 window, meaning search the frame that window belongs to, or a
1551 frame, meaning consider windows on that frame, only. */
1555 /* Return the next or previous window of WINDOW in canonical ordering
1556 of windows. NEXT_P non-zero means return the next window. See the
1557 documentation string of next-window for the meaning of MINIBUF and
1558 ALL_FRAMES. */
1560 static Lisp_Object
1561 next_window (window, minibuf, all_frames, next_p)
1562 Lisp_Object window, minibuf, all_frames;
1563 int next_p;
1565 decode_next_window_args (&window, &minibuf, &all_frames);
1567 /* If ALL_FRAMES is a frame, and WINDOW isn't on that frame, just
1568 return the first window on the frame. */
1569 if (FRAMEP (all_frames)
1570 && !EQ (all_frames, XWINDOW (window)->frame))
1571 return Fframe_first_window (all_frames);
1573 if (next_p)
1575 Lisp_Object list;
1577 /* Find WINDOW in the list of all windows. */
1578 list = Fmemq (window, window_list ());
1580 /* Scan forward from WINDOW to the end of the window list. */
1581 if (CONSP (list))
1582 for (list = XCDR (list); CONSP (list); list = XCDR (list))
1583 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1584 break;
1586 /* Scan from the start of the window list up to WINDOW. */
1587 if (!CONSP (list))
1588 for (list = Vwindow_list;
1589 CONSP (list) && !EQ (XCAR (list), window);
1590 list = XCDR (list))
1591 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1592 break;
1594 if (CONSP (list))
1595 window = XCAR (list);
1597 else
1599 Lisp_Object candidate, list;
1601 /* Scan through the list of windows for candidates. If there are
1602 candidate windows in front of WINDOW, the last one of these
1603 is the one we want. If there are candidates following WINDOW
1604 in the list, again the last one of these is the one we want. */
1605 candidate = Qnil;
1606 for (list = window_list (); CONSP (list); list = XCDR (list))
1608 if (EQ (XCAR (list), window))
1610 if (WINDOWP (candidate))
1611 break;
1613 else if (candidate_window_p (XCAR (list), window, minibuf,
1614 all_frames))
1615 candidate = XCAR (list);
1618 if (WINDOWP (candidate))
1619 window = candidate;
1622 return window;
1626 DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
1627 doc: /* Return next window after WINDOW in canonical ordering of windows.
1628 If omitted, WINDOW defaults to the selected window.
1630 Optional second arg MINIBUF t means count the minibuffer window even
1631 if not active. MINIBUF nil or omitted means count the minibuffer iff
1632 it is active. MINIBUF neither t nor nil means not to count the
1633 minibuffer even if it is active.
1635 Several frames may share a single minibuffer; if the minibuffer
1636 counts, all windows on all frames that share that minibuffer count
1637 too. Therefore, `next-window' can be used to iterate through the
1638 set of windows even when the minibuffer is on another frame. If the
1639 minibuffer does not count, only windows from WINDOW's frame count.
1641 Optional third arg ALL-FRAMES t means include windows on all frames.
1642 ALL-FRAMES nil or omitted means cycle within the frames as specified
1643 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1644 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1645 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1646 Anything else means restrict to WINDOW's frame.
1648 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1649 `next-window' to iterate through the entire cycle of acceptable
1650 windows, eventually ending up back at the window you started with.
1651 `previous-window' traverses the same cycle, in the reverse order. */)
1652 (window, minibuf, all_frames)
1653 Lisp_Object window, minibuf, all_frames;
1655 return next_window (window, minibuf, all_frames, 1);
1659 DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
1660 doc: /* Return the window preceding WINDOW in canonical ordering of windows.
1661 If omitted, WINDOW defaults to the selected window.
1663 Optional second arg MINIBUF t means count the minibuffer window even
1664 if not active. MINIBUF nil or omitted means count the minibuffer iff
1665 it is active. MINIBUF neither t nor nil means not to count the
1666 minibuffer even if it is active.
1668 Several frames may share a single minibuffer; if the minibuffer
1669 counts, all windows on all frames that share that minibuffer count
1670 too. Therefore, `previous-window' can be used to iterate through
1671 the set of windows even when the minibuffer is on another frame. If
1672 the minibuffer does not count, only windows from WINDOW's frame count
1674 Optional third arg ALL-FRAMES t means include windows on all frames.
1675 ALL-FRAMES nil or omitted means cycle within the frames as specified
1676 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1677 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1678 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1679 Anything else means restrict to WINDOW's frame.
1681 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1682 `previous-window' to iterate through the entire cycle of acceptable
1683 windows, eventually ending up back at the window you started with.
1684 `next-window' traverses the same cycle, in the reverse order. */)
1685 (window, minibuf, all_frames)
1686 Lisp_Object window, minibuf, all_frames;
1688 return next_window (window, minibuf, all_frames, 0);
1692 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
1693 doc: /* Select the ARG'th different window on this frame.
1694 All windows on current frame are arranged in a cyclic order.
1695 This command selects the window ARG steps away in that order.
1696 A negative ARG moves in the opposite order. If the optional second
1697 argument ALL_FRAMES is non-nil, cycle through all frames. */)
1698 (arg, all_frames)
1699 Lisp_Object arg, all_frames;
1701 Lisp_Object window;
1702 int i;
1704 CHECK_NUMBER (arg);
1705 window = selected_window;
1707 for (i = XINT (arg); i > 0; --i)
1708 window = Fnext_window (window, Qnil, all_frames);
1709 for (; i < 0; ++i)
1710 window = Fprevious_window (window, Qnil, all_frames);
1712 Fselect_window (window);
1713 return Qnil;
1717 DEFUN ("window-list", Fwindow_list, Swindow_list, 0, 3, 0,
1718 doc: /* Return a list of windows on FRAME, starting with WINDOW.
1719 FRAME nil or omitted means use the selected frame.
1720 WINDOW nil or omitted means use the selected window.
1721 MINIBUF t means include the minibuffer window, even if it isn't active.
1722 MINIBUF nil or omitted means include the minibuffer window only
1723 if it's active.
1724 MINIBUF neither nil nor t means never include the minibuffer window. */)
1725 (frame, minibuf, window)
1726 Lisp_Object frame, minibuf, window;
1728 if (NILP (window))
1729 window = selected_window;
1730 if (NILP (frame))
1731 frame = selected_frame;
1733 if (!EQ (frame, XWINDOW (window)->frame))
1734 error ("Window is on a different frame");
1736 return window_list_1 (window, minibuf, frame);
1740 /* Return a list of windows in canonical ordering. Arguments are like
1741 for `next-window'. */
1743 static Lisp_Object
1744 window_list_1 (window, minibuf, all_frames)
1745 Lisp_Object window, minibuf, all_frames;
1747 Lisp_Object tail, list;
1749 decode_next_window_args (&window, &minibuf, &all_frames);
1750 list = Qnil;
1752 for (tail = window_list (); CONSP (tail); tail = XCDR (tail))
1753 if (candidate_window_p (XCAR (tail), window, minibuf, all_frames))
1754 list = Fcons (XCAR (tail), list);
1756 return Fnreverse (list);
1761 /* Look at all windows, performing an operation specified by TYPE
1762 with argument OBJ.
1763 If FRAMES is Qt, look at all frames;
1764 Qnil, look at just the selected frame;
1765 Qvisible, look at visible frames;
1766 a frame, just look at windows on that frame.
1767 If MINI is non-zero, perform the operation on minibuffer windows too. */
1769 enum window_loop
1771 WINDOW_LOOP_UNUSED,
1772 GET_BUFFER_WINDOW, /* Arg is buffer */
1773 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
1774 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
1775 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
1776 GET_LARGEST_WINDOW,
1777 UNSHOW_BUFFER, /* Arg is buffer */
1778 CHECK_ALL_WINDOWS
1781 static Lisp_Object
1782 window_loop (type, obj, mini, frames)
1783 enum window_loop type;
1784 Lisp_Object obj, frames;
1785 int mini;
1787 Lisp_Object window, windows, best_window, frame_arg;
1788 struct frame *f;
1789 struct gcpro gcpro1;
1791 /* If we're only looping through windows on a particular frame,
1792 frame points to that frame. If we're looping through windows
1793 on all frames, frame is 0. */
1794 if (FRAMEP (frames))
1795 f = XFRAME (frames);
1796 else if (NILP (frames))
1797 f = SELECTED_FRAME ();
1798 else
1799 f = NULL;
1801 if (f)
1802 frame_arg = Qlambda;
1803 else if (XFASTINT (frames) == 0)
1804 frame_arg = frames;
1805 else if (EQ (frames, Qvisible))
1806 frame_arg = frames;
1807 else
1808 frame_arg = Qt;
1810 /* frame_arg is Qlambda to stick to one frame,
1811 Qvisible to consider all visible frames,
1812 or Qt otherwise. */
1814 /* Pick a window to start with. */
1815 if (WINDOWP (obj))
1816 window = obj;
1817 else if (f)
1818 window = FRAME_SELECTED_WINDOW (f);
1819 else
1820 window = FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
1822 windows = window_list_1 (window, mini ? Qt : Qnil, frame_arg);
1823 GCPRO1 (windows);
1824 best_window = Qnil;
1826 for (; CONSP (windows); windows = CDR (windows))
1828 struct window *w;
1830 window = XCAR (windows);
1831 w = XWINDOW (window);
1833 /* Note that we do not pay attention here to whether the frame
1834 is visible, since Fwindow_list skips non-visible frames if
1835 that is desired, under the control of frame_arg. */
1836 if (!MINI_WINDOW_P (w)
1837 /* For UNSHOW_BUFFER, we must always consider all windows. */
1838 || type == UNSHOW_BUFFER
1839 || (mini && minibuf_level > 0))
1840 switch (type)
1842 case GET_BUFFER_WINDOW:
1843 if (EQ (w->buffer, obj)
1844 /* Don't find any minibuffer window
1845 except the one that is currently in use. */
1846 && (MINI_WINDOW_P (w)
1847 ? EQ (window, minibuf_window)
1848 : 1))
1850 if (NILP (best_window))
1851 best_window = window;
1852 else if (EQ (window, selected_window))
1853 /* For compatibility with 20.x, prefer to return
1854 selected-window. */
1855 best_window = window;
1857 break;
1859 case GET_LRU_WINDOW:
1860 /* t as arg means consider only full-width windows */
1861 if (!NILP (obj) && !WINDOW_FULL_WIDTH_P (w))
1862 break;
1863 /* Ignore dedicated windows and minibuffers. */
1864 if (MINI_WINDOW_P (w) || EQ (w->dedicated, Qt))
1865 break;
1866 if (NILP (best_window)
1867 || (XFASTINT (XWINDOW (best_window)->use_time)
1868 > XFASTINT (w->use_time)))
1869 best_window = window;
1870 break;
1872 case DELETE_OTHER_WINDOWS:
1873 if (!EQ (window, obj))
1874 Fdelete_window (window);
1875 break;
1877 case DELETE_BUFFER_WINDOWS:
1878 if (EQ (w->buffer, obj))
1880 struct frame *f = XFRAME (WINDOW_FRAME (w));
1882 /* If this window is dedicated, and in a frame of its own,
1883 kill the frame. */
1884 if (EQ (window, FRAME_ROOT_WINDOW (f))
1885 && !NILP (w->dedicated)
1886 && other_visible_frames (f))
1888 /* Skip the other windows on this frame.
1889 There might be one, the minibuffer! */
1890 while (CONSP (XCDR (windows))
1891 && EQ (XWINDOW (XCAR (windows))->frame,
1892 XWINDOW (XCAR (XCDR (windows)))->frame))
1893 windows = XCDR (windows);
1895 /* Now we can safely delete the frame. */
1896 Fdelete_frame (w->frame, Qnil);
1898 else if (NILP (w->parent))
1900 /* If we're deleting the buffer displayed in the
1901 only window on the frame, find a new buffer to
1902 display there. */
1903 Lisp_Object buffer;
1904 buffer = Fother_buffer (obj, Qnil, w->frame);
1905 Fset_window_buffer (window, buffer);
1906 if (EQ (window, selected_window))
1907 Fset_buffer (w->buffer);
1909 else
1910 Fdelete_window (window);
1912 break;
1914 case GET_LARGEST_WINDOW:
1916 /* Ignore dedicated windows and minibuffers. */
1917 if (MINI_WINDOW_P (w) || EQ (w->dedicated, Qt))
1918 break;
1920 if (NILP (best_window))
1921 best_window = window;
1922 else
1924 struct window *b = XWINDOW (best_window);
1925 if (XFASTINT (w->height) * XFASTINT (w->width)
1926 > XFASTINT (b->height) * XFASTINT (b->width))
1927 best_window = window;
1930 break;
1932 case UNSHOW_BUFFER:
1933 if (EQ (w->buffer, obj))
1935 Lisp_Object buffer;
1936 struct frame *f = XFRAME (w->frame);
1938 /* Find another buffer to show in this window. */
1939 buffer = Fother_buffer (obj, Qnil, w->frame);
1941 /* If this window is dedicated, and in a frame of its own,
1942 kill the frame. */
1943 if (EQ (window, FRAME_ROOT_WINDOW (f))
1944 && !NILP (w->dedicated)
1945 && other_visible_frames (f))
1947 /* Skip the other windows on this frame.
1948 There might be one, the minibuffer! */
1949 while (CONSP (XCDR (windows))
1950 && EQ (XWINDOW (XCAR (windows))->frame,
1951 XWINDOW (XCAR (XCDR (windows)))->frame))
1952 windows = XCDR (windows);
1954 /* Now we can safely delete the frame. */
1955 Fdelete_frame (w->frame, Qnil);
1957 else if (!NILP (w->dedicated) && !NILP (w->parent))
1959 Lisp_Object window;
1960 XSETWINDOW (window, w);
1961 /* If this window is dedicated and not the only window
1962 in its frame, then kill it. */
1963 Fdelete_window (window);
1965 else
1967 /* Otherwise show a different buffer in the window. */
1968 w->dedicated = Qnil;
1969 Fset_window_buffer (window, buffer);
1970 if (EQ (window, selected_window))
1971 Fset_buffer (w->buffer);
1974 break;
1976 /* Check for a window that has a killed buffer. */
1977 case CHECK_ALL_WINDOWS:
1978 if (! NILP (w->buffer)
1979 && NILP (XBUFFER (w->buffer)->name))
1980 abort ();
1981 break;
1983 case WINDOW_LOOP_UNUSED:
1984 break;
1988 UNGCPRO;
1989 return best_window;
1992 /* Used for debugging. Abort if any window has a dead buffer. */
1994 void
1995 check_all_windows ()
1997 window_loop (CHECK_ALL_WINDOWS, Qnil, 1, Qt);
2000 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 1, 0,
2001 doc: /* Return the window least recently selected or used for display.
2002 If optional argument FRAME is `visible', search all visible frames.
2003 If FRAME is 0, search all visible and iconified frames.
2004 If FRAME is t, search all frames.
2005 If FRAME is nil, search only the selected frame.
2006 If FRAME is a frame, search only that frame. */)
2007 (frame)
2008 Lisp_Object frame;
2010 register Lisp_Object w;
2011 /* First try for a window that is full-width */
2012 w = window_loop (GET_LRU_WINDOW, Qt, 0, frame);
2013 if (!NILP (w) && !EQ (w, selected_window))
2014 return w;
2015 /* If none of them, try the rest */
2016 return window_loop (GET_LRU_WINDOW, Qnil, 0, frame);
2019 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 1, 0,
2020 doc: /* Return the largest window in area.
2021 If optional argument FRAME is `visible', search all visible frames.
2022 If FRAME is 0, search all visible and iconified frames.
2023 If FRAME is t, search all frames.
2024 If FRAME is nil, search only the selected frame.
2025 If FRAME is a frame, search only that frame. */)
2026 (frame)
2027 Lisp_Object frame;
2029 return window_loop (GET_LARGEST_WINDOW, Qnil, 0,
2030 frame);
2033 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
2034 doc: /* Return a window currently displaying BUFFER, or nil if none.
2035 If optional argument FRAME is `visible', search all visible frames.
2036 If optional argument FRAME is 0, search all visible and iconified frames.
2037 If FRAME is t, search all frames.
2038 If FRAME is nil, search only the selected frame.
2039 If FRAME is a frame, search only that frame. */)
2040 (buffer, frame)
2041 Lisp_Object buffer, frame;
2043 buffer = Fget_buffer (buffer);
2044 if (BUFFERP (buffer))
2045 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
2046 else
2047 return Qnil;
2050 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
2051 0, 1, "",
2052 doc: /* Make WINDOW (or the selected window) fill its frame.
2053 Only the frame WINDOW is on is affected.
2054 This function tries to reduce display jumps
2055 by keeping the text previously visible in WINDOW
2056 in the same place on the frame. Doing this depends on
2057 the value of (window-start WINDOW), so if calling this function
2058 in a program gives strange scrolling, make sure the window-start
2059 value is reasonable when this function is called. */)
2060 (window)
2061 Lisp_Object window;
2063 struct window *w;
2064 int startpos;
2065 int top, new_top;
2067 if (NILP (window))
2068 window = selected_window;
2069 else
2070 CHECK_LIVE_WINDOW (window);
2071 w = XWINDOW (window);
2073 startpos = marker_position (w->start);
2074 top = XFASTINT (w->top) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2076 if (MINI_WINDOW_P (w) && top > 0)
2077 error ("Can't expand minibuffer to full frame");
2079 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
2081 /* Try to minimize scrolling, by setting the window start to the point
2082 will cause the text at the old window start to be at the same place
2083 on the frame. But don't try to do this if the window start is
2084 outside the visible portion (as might happen when the display is
2085 not current, due to typeahead). */
2086 new_top = XFASTINT (w->top) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2087 if (new_top != top
2088 && startpos >= BUF_BEGV (XBUFFER (w->buffer))
2089 && startpos <= BUF_ZV (XBUFFER (w->buffer)))
2091 struct position pos;
2092 struct buffer *obuf = current_buffer;
2094 Fset_buffer (w->buffer);
2095 /* This computation used to temporarily move point, but that can
2096 have unwanted side effects due to text properties. */
2097 pos = *vmotion (startpos, -top, w);
2099 set_marker_both (w->start, w->buffer, pos.bufpos, pos.bytepos);
2100 w->window_end_valid = Qnil;
2101 w->start_at_line_beg = ((pos.bytepos == BEGV_BYTE
2102 || FETCH_BYTE (pos.bytepos - 1) == '\n') ? Qt
2103 : Qnil);
2104 /* We need to do this, so that the window-scroll-functions
2105 get called. */
2106 w->optional_new_start = Qt;
2108 set_buffer_internal (obuf);
2111 return Qnil;
2114 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
2115 1, 2, "bDelete windows on (buffer): ",
2116 doc: /* Delete all windows showing BUFFER.
2117 Optional second argument FRAME controls which frames are affected.
2118 If optional argument FRAME is `visible', search all visible frames.
2119 If FRAME is 0, search all visible and iconified frames.
2120 If FRAME is nil, search all frames.
2121 If FRAME is t, search only the selected frame.
2122 If FRAME is a frame, search only that frame. */)
2123 (buffer, frame)
2124 Lisp_Object buffer, frame;
2126 /* FRAME uses t and nil to mean the opposite of what window_loop
2127 expects. */
2128 if (NILP (frame))
2129 frame = Qt;
2130 else if (EQ (frame, Qt))
2131 frame = Qnil;
2133 if (!NILP (buffer))
2135 buffer = Fget_buffer (buffer);
2136 CHECK_BUFFER (buffer);
2137 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
2140 return Qnil;
2143 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
2144 Sreplace_buffer_in_windows,
2145 1, 1, "bReplace buffer in windows: ",
2146 doc: /* Replace BUFFER with some other buffer in all windows showing it. */)
2147 (buffer)
2148 Lisp_Object buffer;
2150 if (!NILP (buffer))
2152 buffer = Fget_buffer (buffer);
2153 CHECK_BUFFER (buffer);
2154 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
2156 return Qnil;
2159 /* Replace BUFFER with some other buffer in all windows
2160 of all frames, even those on other keyboards. */
2162 void
2163 replace_buffer_in_all_windows (buffer)
2164 Lisp_Object buffer;
2166 #ifdef MULTI_KBOARD
2167 Lisp_Object tail, frame;
2169 /* A single call to window_loop won't do the job
2170 because it only considers frames on the current keyboard.
2171 So loop manually over frames, and handle each one. */
2172 FOR_EACH_FRAME (tail, frame)
2173 window_loop (UNSHOW_BUFFER, buffer, 1, frame);
2174 #else
2175 window_loop (UNSHOW_BUFFER, buffer, 1, Qt);
2176 #endif
2179 /* Set the height of WINDOW and all its inferiors. */
2181 /* The smallest acceptable dimensions for a window. Anything smaller
2182 might crash Emacs. */
2184 #define MIN_SAFE_WINDOW_WIDTH (2)
2185 #define MIN_SAFE_WINDOW_HEIGHT (1)
2187 /* Make sure that window_min_height and window_min_width are
2188 not too small; if they are, set them to safe minima. */
2190 static void
2191 check_min_window_sizes ()
2193 /* Smaller values might permit a crash. */
2194 if (window_min_width < MIN_SAFE_WINDOW_WIDTH)
2195 window_min_width = MIN_SAFE_WINDOW_WIDTH;
2196 if (window_min_height < MIN_SAFE_WINDOW_HEIGHT)
2197 window_min_height = MIN_SAFE_WINDOW_HEIGHT;
2200 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
2201 minimum allowable size. */
2203 void
2204 check_frame_size (frame, rows, cols)
2205 FRAME_PTR frame;
2206 int *rows, *cols;
2208 /* For height, we have to see:
2209 how many windows the frame has at minimum (one or two),
2210 and whether it has a menu bar or other special stuff at the top. */
2211 int min_height
2212 = ((FRAME_MINIBUF_ONLY_P (frame) || ! FRAME_HAS_MINIBUF_P (frame))
2213 ? MIN_SAFE_WINDOW_HEIGHT
2214 : 2 * MIN_SAFE_WINDOW_HEIGHT);
2216 if (FRAME_TOP_MARGIN (frame) > 0)
2217 min_height += FRAME_TOP_MARGIN (frame);
2219 if (*rows < min_height)
2220 *rows = min_height;
2221 if (*cols < MIN_SAFE_WINDOW_WIDTH)
2222 *cols = MIN_SAFE_WINDOW_WIDTH;
2226 /* Value is non-zero if window W is fixed-size. WIDTH_P non-zero means
2227 check if W's width can be changed, otherwise check W's height.
2228 CHECK_SIBLINGS_P non-zero means check resizablity of WINDOW's
2229 siblings, too. If none of the siblings is resizable, WINDOW isn't
2230 either. */
2232 static int
2233 window_fixed_size_p (w, width_p, check_siblings_p)
2234 struct window *w;
2235 int width_p, check_siblings_p;
2237 int fixed_p;
2238 struct window *c;
2240 if (!NILP (w->hchild))
2242 c = XWINDOW (w->hchild);
2244 if (width_p)
2246 /* A horiz. combination is fixed-width if all of if its
2247 children are. */
2248 while (c && window_fixed_size_p (c, width_p, 0))
2249 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2250 fixed_p = c == NULL;
2252 else
2254 /* A horiz. combination is fixed-height if one of if its
2255 children is. */
2256 while (c && !window_fixed_size_p (c, width_p, 0))
2257 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2258 fixed_p = c != NULL;
2261 else if (!NILP (w->vchild))
2263 c = XWINDOW (w->vchild);
2265 if (width_p)
2267 /* A vert. combination is fixed-width if one of if its
2268 children is. */
2269 while (c && !window_fixed_size_p (c, width_p, 0))
2270 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2271 fixed_p = c != NULL;
2273 else
2275 /* A vert. combination is fixed-height if all of if its
2276 children are. */
2277 while (c && window_fixed_size_p (c, width_p, 0))
2278 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2279 fixed_p = c == NULL;
2282 else if (BUFFERP (w->buffer))
2284 if (w->height_fixed_p && !width_p)
2285 fixed_p = 1;
2286 else
2288 struct buffer *old = current_buffer;
2289 Lisp_Object val;
2291 current_buffer = XBUFFER (w->buffer);
2292 val = find_symbol_value (Qwindow_size_fixed);
2293 current_buffer = old;
2295 fixed_p = 0;
2296 if (!EQ (val, Qunbound))
2298 fixed_p = !NILP (val);
2300 if (fixed_p
2301 && ((EQ (val, Qheight) && width_p)
2302 || (EQ (val, Qwidth) && !width_p)))
2303 fixed_p = 0;
2307 /* Can't tell if this one is resizable without looking at
2308 siblings. If all siblings are fixed-size this one is too. */
2309 if (!fixed_p && check_siblings_p && WINDOWP (w->parent))
2311 Lisp_Object child;
2313 for (child = w->prev; !NILP (child); child = XWINDOW (child)->prev)
2314 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2315 break;
2317 if (NILP (child))
2318 for (child = w->next; !NILP (child); child = XWINDOW (child)->next)
2319 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2320 break;
2322 if (NILP (child))
2323 fixed_p = 1;
2326 else
2327 fixed_p = 1;
2329 return fixed_p;
2333 /* Return the minimum size of window W, not taking fixed-width windows
2334 into account. WIDTH_P non-zero means return the minimum width,
2335 otherwise return the minimum height. If W is a combination window,
2336 compute the minimum size from the minimum sizes of W's children. */
2338 static int
2339 window_min_size_1 (w, width_p)
2340 struct window *w;
2341 int width_p;
2343 struct window *c;
2344 int size;
2346 if (!NILP (w->hchild))
2348 c = XWINDOW (w->hchild);
2349 size = 0;
2351 if (width_p)
2353 /* The min width of a horizontal combination is
2354 the sum of the min widths of its children. */
2355 while (c)
2357 size += window_min_size_1 (c, width_p);
2358 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2361 else
2363 /* The min height a horizontal combination equals
2364 the maximum of all min height of its children. */
2365 while (c)
2367 int min_size = window_min_size_1 (c, width_p);
2368 size = max (min_size, size);
2369 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2373 else if (!NILP (w->vchild))
2375 c = XWINDOW (w->vchild);
2376 size = 0;
2378 if (width_p)
2380 /* The min width of a vertical combination is
2381 the maximum of the min widths of its children. */
2382 while (c)
2384 int min_size = window_min_size_1 (c, width_p);
2385 size = max (min_size, size);
2386 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2389 else
2391 /* The min height of a vertical combination equals
2392 the sum of the min height of its children. */
2393 while (c)
2395 size += window_min_size_1 (c, width_p);
2396 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2400 else
2402 if (width_p)
2403 size = window_min_width;
2404 else
2406 if (MINI_WINDOW_P (w)
2407 || (!WINDOW_WANTS_MODELINE_P (w)
2408 && !WINDOW_WANTS_HEADER_LINE_P (w)))
2409 size = 1;
2410 else
2411 size = window_min_height;
2415 return size;
2419 /* Return the minimum size of window W, taking fixed-size windows into
2420 account. WIDTH_P non-zero means return the minimum width,
2421 otherwise return the minimum height. IGNORE_FIXED_P non-zero means
2422 ignore if W is fixed-size. Set *FIXED to 1 if W is fixed-size
2423 unless FIXED is null. */
2425 static int
2426 window_min_size (w, width_p, ignore_fixed_p, fixed)
2427 struct window *w;
2428 int width_p, ignore_fixed_p, *fixed;
2430 int size, fixed_p;
2432 if (ignore_fixed_p)
2433 fixed_p = 0;
2434 else
2435 fixed_p = window_fixed_size_p (w, width_p, 1);
2437 if (fixed)
2438 *fixed = fixed_p;
2440 if (fixed_p)
2441 size = width_p ? XFASTINT (w->width) : XFASTINT (w->height);
2442 else
2443 size = window_min_size_1 (w, width_p);
2445 return size;
2449 /* Set WINDOW's height or width to SIZE. WIDTH_P non-zero means set
2450 WINDOW's width. Resize WINDOW's children, if any, so that they
2451 keep their proportionate size relative to WINDOW. Propagate
2452 WINDOW's top or left edge position to children. Delete windows
2453 that become too small unless NODELETE_P is non-zero.
2455 If NODELETE_P is 2, that means we do delete windows that are
2456 too small, even if they were too small before! */
2458 static void
2459 size_window (window, size, width_p, nodelete_p)
2460 Lisp_Object window;
2461 int size, width_p, nodelete_p;
2463 struct window *w = XWINDOW (window);
2464 struct window *c;
2465 Lisp_Object child, *forward, *sideward;
2466 int old_size, min_size;
2468 if (nodelete_p == 2)
2469 nodelete_p = 0;
2471 check_min_window_sizes ();
2472 size = max (0, size);
2474 /* If the window has been "too small" at one point,
2475 don't delete it for being "too small" in the future.
2476 Preserve it as long as that is at all possible. */
2477 if (width_p)
2479 old_size = XINT (w->width);
2480 min_size = window_min_width;
2482 else
2484 old_size = XINT (w->height);
2485 min_size = window_min_height;
2488 if (old_size < min_size && nodelete_p != 2)
2489 w->too_small_ok = Qt;
2491 /* Maybe delete WINDOW if it's too small. */
2492 if (nodelete_p != 1 && !NILP (w->parent))
2494 if (!MINI_WINDOW_P (w) && !NILP (w->too_small_ok))
2495 min_size = width_p ? MIN_SAFE_WINDOW_WIDTH : MIN_SAFE_WINDOW_HEIGHT;
2496 else
2497 min_size = width_p ? window_min_width : window_min_height;
2499 if (size < min_size)
2501 delete_window (window);
2502 return;
2506 /* Set redisplay hints. */
2507 w->last_modified = make_number (0);
2508 w->last_overlay_modified = make_number (0);
2509 windows_or_buffers_changed++;
2510 FRAME_WINDOW_SIZES_CHANGED (XFRAME (w->frame)) = 1;
2512 if (width_p)
2514 sideward = &w->vchild;
2515 forward = &w->hchild;
2516 w->width = make_number (size);
2518 else
2520 sideward = &w->hchild;
2521 forward = &w->vchild;
2522 w->height = make_number (size);
2523 w->orig_height = Qnil;
2526 if (!NILP (*sideward))
2528 for (child = *sideward; !NILP (child); child = c->next)
2530 c = XWINDOW (child);
2531 if (width_p)
2532 c->left = w->left;
2533 else
2534 c->top = w->top;
2535 size_window (child, size, width_p, nodelete_p);
2538 else if (!NILP (*forward))
2540 int fixed_size, each, extra, n;
2541 int resize_fixed_p, nfixed;
2542 int last_pos, first_pos, nchildren, total;
2544 /* Determine the fixed-size portion of the this window, and the
2545 number of child windows. */
2546 fixed_size = nchildren = nfixed = total = 0;
2547 for (child = *forward; !NILP (child); child = c->next, ++nchildren)
2549 int child_size;
2551 c = XWINDOW (child);
2552 child_size = width_p ? XINT (c->width) : XINT (c->height);
2553 total += child_size;
2555 if (window_fixed_size_p (c, width_p, 0))
2557 fixed_size += child_size;
2558 ++nfixed;
2562 /* If the new size is smaller than fixed_size, or if there
2563 aren't any resizable windows, allow resizing fixed-size
2564 windows. */
2565 resize_fixed_p = nfixed == nchildren || size < fixed_size;
2567 /* Compute how many lines/columns to add to each child. The
2568 value of extra takes care of rounding errors. */
2569 n = resize_fixed_p ? nchildren : nchildren - nfixed;
2570 each = (size - total) / n;
2571 extra = (size - total) - n * each;
2573 /* Compute new children heights and edge positions. */
2574 first_pos = width_p ? XINT (w->left) : XINT (w->top);
2575 last_pos = first_pos;
2576 for (child = *forward; !NILP (child); child = c->next)
2578 int new_size, old_size;
2580 c = XWINDOW (child);
2581 old_size = width_p ? XFASTINT (c->width) : XFASTINT (c->height);
2582 new_size = old_size;
2584 /* The top or left edge position of this child equals the
2585 bottom or right edge of its predecessor. */
2586 if (width_p)
2587 c->left = make_number (last_pos);
2588 else
2589 c->top = make_number (last_pos);
2591 /* If this child can be resized, do it. */
2592 if (resize_fixed_p || !window_fixed_size_p (c, width_p, 0))
2594 new_size = old_size + each + extra;
2595 extra = 0;
2598 /* Set new height. Note that size_window also propagates
2599 edge positions to children, so it's not a no-op if we
2600 didn't change the child's size. */
2601 size_window (child, new_size, width_p, 1);
2603 /* Remember the bottom/right edge position of this child; it
2604 will be used to set the top/left edge of the next child. */
2605 last_pos += new_size;
2608 /* We should have covered the parent exactly with child windows. */
2609 xassert (size == last_pos - first_pos);
2611 /* Now delete any children that became too small. */
2612 if (!nodelete_p)
2613 for (child = *forward; !NILP (child); child = c->next)
2615 int child_size;
2616 c = XWINDOW (child);
2617 child_size = width_p ? XINT (c->width) : XINT (c->height);
2618 size_window (child, child_size, width_p, 2);
2623 /* Set WINDOW's height to HEIGHT, and recursively change the height of
2624 WINDOW's children. NODELETE non-zero means don't delete windows
2625 that become too small in the process. (The caller should check
2626 later and do so if appropriate.) */
2628 void
2629 set_window_height (window, height, nodelete)
2630 Lisp_Object window;
2631 int height;
2632 int nodelete;
2634 size_window (window, height, 0, nodelete);
2638 /* Set WINDOW's width to WIDTH, and recursively change the width of
2639 WINDOW's children. NODELETE non-zero means don't delete windows
2640 that become too small in the process. (The caller should check
2641 later and do so if appropriate.) */
2643 void
2644 set_window_width (window, width, nodelete)
2645 Lisp_Object window;
2646 int width;
2647 int nodelete;
2649 size_window (window, width, 1, nodelete);
2653 int window_select_count;
2655 Lisp_Object
2656 Fset_window_buffer_unwind (obuf)
2657 Lisp_Object obuf;
2659 Fset_buffer (obuf);
2660 return Qnil;
2664 /* Make WINDOW display BUFFER as its contents. RUN_HOOKS_P non-zero
2665 means it's allowed to run hooks. See make_frame for a case where
2666 it's not allowed. */
2668 void
2669 set_window_buffer (window, buffer, run_hooks_p)
2670 Lisp_Object window, buffer;
2671 int run_hooks_p;
2673 struct window *w = XWINDOW (window);
2674 struct buffer *b = XBUFFER (buffer);
2675 int count = SPECPDL_INDEX ();
2677 w->buffer = buffer;
2679 if (EQ (window, selected_window))
2680 b->last_selected_window = window;
2682 /* Update time stamps of buffer display. */
2683 if (INTEGERP (b->display_count))
2684 XSETINT (b->display_count, XINT (b->display_count) + 1);
2685 b->display_time = Fcurrent_time ();
2687 XSETFASTINT (w->window_end_pos, 0);
2688 XSETFASTINT (w->window_end_vpos, 0);
2689 bzero (&w->last_cursor, sizeof w->last_cursor);
2690 w->window_end_valid = Qnil;
2691 w->hscroll = w->min_hscroll = make_number (0);
2692 w->vscroll = 0;
2693 set_marker_both (w->pointm, buffer, BUF_PT (b), BUF_PT_BYTE (b));
2694 set_marker_restricted (w->start,
2695 make_number (b->last_window_start),
2696 buffer);
2697 w->start_at_line_beg = Qnil;
2698 w->force_start = Qnil;
2699 XSETFASTINT (w->last_modified, 0);
2700 XSETFASTINT (w->last_overlay_modified, 0);
2701 windows_or_buffers_changed++;
2703 /* We must select BUFFER for running the window-scroll-functions.
2704 If WINDOW is selected, switch permanently.
2705 Otherwise, switch but go back to the ambient buffer afterward. */
2706 if (EQ (window, selected_window))
2707 Fset_buffer (buffer);
2708 /* We can't check ! NILP (Vwindow_scroll_functions) here
2709 because that might itself be a local variable. */
2710 else if (window_initialized)
2712 record_unwind_protect (Fset_window_buffer_unwind, Fcurrent_buffer ());
2713 Fset_buffer (buffer);
2716 /* Set left and right marginal area width from buffer. */
2717 Fset_window_margins (window, b->left_margin_width, b->right_margin_width);
2719 if (run_hooks_p)
2721 if (! NILP (Vwindow_scroll_functions))
2722 run_hook_with_args_2 (Qwindow_scroll_functions, window,
2723 Fmarker_position (w->start));
2725 if (! NILP (Vwindow_configuration_change_hook)
2726 && ! NILP (Vrun_hooks))
2727 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
2730 unbind_to (count, Qnil);
2734 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 2, 0,
2735 doc: /* Make WINDOW display BUFFER as its contents.
2736 BUFFER can be a buffer or buffer name. */)
2737 (window, buffer)
2738 register Lisp_Object window, buffer;
2740 register Lisp_Object tem;
2741 register struct window *w = decode_window (window);
2743 XSETWINDOW (window, w);
2744 buffer = Fget_buffer (buffer);
2745 CHECK_BUFFER (buffer);
2747 if (NILP (XBUFFER (buffer)->name))
2748 error ("Attempt to display deleted buffer");
2750 tem = w->buffer;
2751 if (NILP (tem))
2752 error ("Window is deleted");
2753 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
2754 is first being set up. */
2756 if (!NILP (w->dedicated) && !EQ (tem, buffer))
2757 error ("Window is dedicated to `%s'",
2758 SDATA (XBUFFER (tem)->name));
2760 unshow_buffer (w);
2763 set_window_buffer (window, buffer, 1);
2764 return Qnil;
2767 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 1, 0,
2768 doc: /* Select WINDOW. Most editing will apply to WINDOW's buffer.
2769 If WINDOW is not already selected, also make WINDOW's buffer current.
2770 If WINDOW's frame is the selected frame, also make WINDOW the frame's
2771 selected window.
2773 Note that the main editor command loop
2774 selects the buffer of the selected window before each command. */)
2775 (window)
2776 register Lisp_Object window;
2778 return select_window_1 (window, 1);
2781 /* Note that selected_window can be nil
2782 when this is called from Fset_window_configuration. */
2784 static Lisp_Object
2785 select_window_1 (window, recordflag)
2786 register Lisp_Object window;
2787 int recordflag;
2789 register struct window *w;
2790 register struct window *ow;
2791 struct frame *sf;
2793 CHECK_LIVE_WINDOW (window);
2795 w = XWINDOW (window);
2796 w->frozen_window_start_p = 0;
2798 XSETFASTINT (w->use_time, ++window_select_count);
2799 if (EQ (window, selected_window))
2800 return window;
2802 if (!NILP (selected_window))
2804 ow = XWINDOW (selected_window);
2805 if (! NILP (ow->buffer))
2806 set_marker_both (ow->pointm, ow->buffer,
2807 BUF_PT (XBUFFER (ow->buffer)),
2808 BUF_PT_BYTE (XBUFFER (ow->buffer)));
2811 selected_window = window;
2812 sf = SELECTED_FRAME ();
2813 if (XFRAME (WINDOW_FRAME (w)) == sf)
2814 sf->selected_window = window;
2816 if (recordflag)
2817 record_buffer (w->buffer);
2818 Fset_buffer (w->buffer);
2820 XBUFFER (w->buffer)->last_selected_window = window;
2822 /* Go to the point recorded in the window.
2823 This is important when the buffer is in more
2824 than one window. It also matters when
2825 redisplay_window has altered point after scrolling,
2826 because it makes the change only in the window. */
2828 register int new_point = marker_position (w->pointm);
2829 if (new_point < BEGV)
2830 SET_PT (BEGV);
2831 else if (new_point > ZV)
2832 SET_PT (ZV);
2833 else
2834 SET_PT (new_point);
2837 windows_or_buffers_changed++;
2838 return window;
2841 /* Deiconify the frame containing the window WINDOW,
2842 unless it is the selected frame;
2843 then return WINDOW.
2845 The reason for the exception for the selected frame
2846 is that it seems better not to change the selected frames visibility
2847 merely because of displaying a different buffer in it.
2848 The deiconification is useful when a buffer gets shown in
2849 another frame that you were not using lately. */
2851 static Lisp_Object
2852 display_buffer_1 (window)
2853 Lisp_Object window;
2855 Lisp_Object frame = XWINDOW (window)->frame;
2856 FRAME_PTR f = XFRAME (frame);
2858 FRAME_SAMPLE_VISIBILITY (f);
2860 if (!EQ (frame, selected_frame))
2862 if (FRAME_ICONIFIED_P (f))
2863 Fmake_frame_visible (frame);
2864 else if (FRAME_VISIBLE_P (f))
2865 Fraise_frame (frame);
2868 return window;
2871 DEFUN ("special-display-p", Fspecial_display_p, Sspecial_display_p, 1, 1, 0,
2872 doc: /* Returns non-nil if a buffer named BUFFER-NAME would be created specially.
2873 The value is actually t if the frame should be called with default frame
2874 parameters, and a list of frame parameters if they were specified.
2875 See `special-display-buffer-names', and `special-display-regexps'. */)
2876 (buffer_name)
2877 Lisp_Object buffer_name;
2879 Lisp_Object tem;
2881 CHECK_STRING (buffer_name);
2883 tem = Fmember (buffer_name, Vspecial_display_buffer_names);
2884 if (!NILP (tem))
2885 return Qt;
2887 tem = Fassoc (buffer_name, Vspecial_display_buffer_names);
2888 if (!NILP (tem))
2889 return XCDR (tem);
2891 for (tem = Vspecial_display_regexps; CONSP (tem); tem = XCDR (tem))
2893 Lisp_Object car = XCAR (tem);
2894 if (STRINGP (car)
2895 && fast_string_match (car, buffer_name) >= 0)
2896 return Qt;
2897 else if (CONSP (car)
2898 && STRINGP (XCAR (car))
2899 && fast_string_match (XCAR (car), buffer_name) >= 0)
2900 return XCDR (car);
2902 return Qnil;
2905 DEFUN ("same-window-p", Fsame_window_p, Ssame_window_p, 1, 1, 0,
2906 doc: /* Returns non-nil if a new buffer named BUFFER-NAME would use the same window.
2907 See `same-window-buffer-names' and `same-window-regexps'. */)
2908 (buffer_name)
2909 Lisp_Object buffer_name;
2911 Lisp_Object tem;
2913 CHECK_STRING (buffer_name);
2915 tem = Fmember (buffer_name, Vsame_window_buffer_names);
2916 if (!NILP (tem))
2917 return Qt;
2919 tem = Fassoc (buffer_name, Vsame_window_buffer_names);
2920 if (!NILP (tem))
2921 return Qt;
2923 for (tem = Vsame_window_regexps; CONSP (tem); tem = XCDR (tem))
2925 Lisp_Object car = XCAR (tem);
2926 if (STRINGP (car)
2927 && fast_string_match (car, buffer_name) >= 0)
2928 return Qt;
2929 else if (CONSP (car)
2930 && STRINGP (XCAR (car))
2931 && fast_string_match (XCAR (car), buffer_name) >= 0)
2932 return Qt;
2934 return Qnil;
2937 /* Use B so the default is (other-buffer). */
2938 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 3,
2939 "BDisplay buffer: \nP",
2940 doc: /* Make BUFFER appear in some window but don't select it.
2941 BUFFER can be a buffer or a buffer name.
2942 If BUFFER is shown already in some window, just use that one,
2943 unless the window is the selected window and the optional second
2944 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
2945 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
2946 Returns the window displaying BUFFER.
2947 If `display-buffer-reuse-frames' is non-nil, and another frame is currently
2948 displaying BUFFER, then simply raise that frame.
2950 The variables `special-display-buffer-names', `special-display-regexps',
2951 `same-window-buffer-names', and `same-window-regexps' customize how certain
2952 buffer names are handled.
2954 If optional argument FRAME is `visible', search all visible frames.
2955 If FRAME is 0, search all visible and iconified frames.
2956 If FRAME is t, search all frames.
2957 If FRAME is a frame, search only that frame.
2958 If FRAME is nil, search only the selected frame
2959 (actually the last nonminibuffer frame),
2960 unless `pop-up-frames' or `display-buffer-reuse-frames' is non-nil,
2961 which means search visible and iconified frames.
2963 If `even-window-heights' is non-nil, window heights will be evened out
2964 if displaying the buffer causes two vertically adjacent windows to be
2965 displayed. */)
2966 (buffer, not_this_window, frame)
2967 register Lisp_Object buffer, not_this_window, frame;
2969 register Lisp_Object window, tem, swp;
2970 struct frame *f;
2972 swp = Qnil;
2973 buffer = Fget_buffer (buffer);
2974 CHECK_BUFFER (buffer);
2976 if (!NILP (Vdisplay_buffer_function))
2977 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
2979 if (NILP (not_this_window)
2980 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
2981 return display_buffer_1 (selected_window);
2983 /* See if the user has specified this buffer should appear
2984 in the selected window. */
2985 if (NILP (not_this_window))
2987 swp = Fsame_window_p (XBUFFER (buffer)->name);
2988 if (!NILP (swp) && !no_switch_window (selected_window))
2990 Fswitch_to_buffer (buffer, Qnil);
2991 return display_buffer_1 (selected_window);
2995 /* If the user wants pop-up-frames or display-buffer-reuse-frames,
2996 look for a window showing BUFFER on any visible or iconified frame.
2997 Otherwise search only the current frame. */
2998 if (! NILP (frame))
2999 tem = frame;
3000 else if (pop_up_frames
3001 || display_buffer_reuse_frames
3002 || last_nonminibuf_frame == 0)
3003 XSETFASTINT (tem, 0);
3004 else
3005 XSETFRAME (tem, last_nonminibuf_frame);
3007 window = Fget_buffer_window (buffer, tem);
3008 if (!NILP (window)
3009 && (NILP (not_this_window) || !EQ (window, selected_window)))
3010 return display_buffer_1 (window);
3012 /* Certain buffer names get special handling. */
3013 if (!NILP (Vspecial_display_function) && NILP (swp))
3015 tem = Fspecial_display_p (XBUFFER (buffer)->name);
3016 if (EQ (tem, Qt))
3017 return call1 (Vspecial_display_function, buffer);
3018 if (CONSP (tem))
3019 return call2 (Vspecial_display_function, buffer, tem);
3022 /* If there are no frames open that have more than a minibuffer,
3023 we need to create a new frame. */
3024 if (pop_up_frames || last_nonminibuf_frame == 0)
3026 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3027 Fset_window_buffer (window, buffer);
3028 return display_buffer_1 (window);
3031 f = SELECTED_FRAME ();
3032 if (pop_up_windows
3033 || FRAME_MINIBUF_ONLY_P (f)
3034 /* If the current frame is a special display frame,
3035 don't try to reuse its windows. */
3036 || !NILP (XWINDOW (FRAME_ROOT_WINDOW (f))->dedicated))
3038 Lisp_Object frames;
3040 frames = Qnil;
3041 if (FRAME_MINIBUF_ONLY_P (f))
3042 XSETFRAME (frames, last_nonminibuf_frame);
3043 /* Don't try to create a window if we would get an error. */
3044 if (split_height_threshold < window_min_height << 1)
3045 split_height_threshold = window_min_height << 1;
3047 /* Note that both Fget_largest_window and Fget_lru_window
3048 ignore minibuffers and dedicated windows.
3049 This means they can return nil. */
3051 /* If the frame we would try to split cannot be split,
3052 try other frames. */
3053 if (FRAME_NO_SPLIT_P (NILP (frames) ? f : last_nonminibuf_frame))
3055 /* Try visible frames first. */
3056 window = Fget_largest_window (Qvisible);
3057 /* If that didn't work, try iconified frames. */
3058 if (NILP (window))
3059 window = Fget_largest_window (make_number (0));
3060 if (NILP (window))
3061 window = Fget_largest_window (Qt);
3063 else
3064 window = Fget_largest_window (frames);
3066 /* If we got a tall enough full-width window that can be split,
3067 split it. */
3068 if (!NILP (window)
3069 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3070 && window_height (window) >= split_height_threshold
3071 && WINDOW_FULL_WIDTH_P (XWINDOW (window)))
3072 window = Fsplit_window (window, Qnil, Qnil);
3073 else
3075 Lisp_Object upper, lower, other;
3077 window = Fget_lru_window (frames);
3078 /* If the LRU window is selected, and big enough,
3079 and can be split, split it. */
3080 if (!NILP (window)
3081 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3082 && (EQ (window, selected_window)
3083 || EQ (XWINDOW (window)->parent, Qnil))
3084 && window_height (window) >= window_min_height << 1)
3085 window = Fsplit_window (window, Qnil, Qnil);
3086 /* If Fget_lru_window returned nil, try other approaches. */
3088 /* Try visible frames first. */
3089 if (NILP (window))
3090 window = Fget_buffer_window (buffer, Qvisible);
3091 if (NILP (window))
3092 window = Fget_largest_window (Qvisible);
3093 /* If that didn't work, try iconified frames. */
3094 if (NILP (window))
3095 window = Fget_buffer_window (buffer, make_number (0));
3096 if (NILP (window))
3097 window = Fget_largest_window (make_number (0));
3098 /* Try invisible frames. */
3099 if (NILP (window))
3100 window = Fget_buffer_window (buffer, Qt);
3101 if (NILP (window))
3102 window = Fget_largest_window (Qt);
3103 /* As a last resort, make a new frame. */
3104 if (NILP (window))
3105 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3106 /* If window appears above or below another,
3107 even out their heights. */
3108 other = upper = lower = Qnil;
3109 if (!NILP (XWINDOW (window)->prev))
3110 other = upper = XWINDOW (window)->prev, lower = window;
3111 if (!NILP (XWINDOW (window)->next))
3112 other = lower = XWINDOW (window)->next, upper = window;
3113 if (!NILP (other)
3114 && !NILP (Veven_window_heights)
3115 /* Check that OTHER and WINDOW are vertically arrayed. */
3116 && !EQ (XWINDOW (other)->top, XWINDOW (window)->top)
3117 && (XFASTINT (XWINDOW (other)->height)
3118 > XFASTINT (XWINDOW (window)->height)))
3120 int total = (XFASTINT (XWINDOW (other)->height)
3121 + XFASTINT (XWINDOW (window)->height));
3122 enlarge_window (upper,
3123 total / 2 - XFASTINT (XWINDOW (upper)->height),
3124 0, 0);
3128 else
3129 window = Fget_lru_window (Qnil);
3131 Fset_window_buffer (window, buffer);
3132 return display_buffer_1 (window);
3135 void
3136 temp_output_buffer_show (buf)
3137 register Lisp_Object buf;
3139 register struct buffer *old = current_buffer;
3140 register Lisp_Object window;
3141 register struct window *w;
3143 XBUFFER (buf)->directory = current_buffer->directory;
3145 Fset_buffer (buf);
3146 BUF_SAVE_MODIFF (XBUFFER (buf)) = MODIFF;
3147 BEGV = BEG;
3148 ZV = Z;
3149 SET_PT (BEG);
3150 #if 0 /* rms: there should be no reason for this. */
3151 XBUFFER (buf)->prevent_redisplay_optimizations_p = 1;
3152 #endif
3153 set_buffer_internal (old);
3155 if (!EQ (Vtemp_buffer_show_function, Qnil))
3156 call1 (Vtemp_buffer_show_function, buf);
3157 else
3159 window = Fdisplay_buffer (buf, Qnil, Qnil);
3161 if (!EQ (XWINDOW (window)->frame, selected_frame))
3162 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
3163 Vminibuf_scroll_window = window;
3164 w = XWINDOW (window);
3165 XSETFASTINT (w->hscroll, 0);
3166 XSETFASTINT (w->min_hscroll, 0);
3167 set_marker_restricted_both (w->start, buf, 1, 1);
3168 set_marker_restricted_both (w->pointm, buf, 1, 1);
3170 /* Run temp-buffer-show-hook, with the chosen window selected
3171 and its buffer current. */
3172 if (!NILP (Vrun_hooks))
3174 Lisp_Object tem;
3175 tem = Fboundp (Qtemp_buffer_show_hook);
3176 if (!NILP (tem))
3178 tem = Fsymbol_value (Qtemp_buffer_show_hook);
3179 if (!NILP (tem))
3181 int count = SPECPDL_INDEX ();
3182 Lisp_Object prev_window;
3183 prev_window = selected_window;
3185 /* Select the window that was chosen, for running the hook. */
3186 /* Both this Fselect_window and the select_window_1
3187 below will (may) incorrectly set-buffer to the buffer
3188 displayed in the window. --stef */
3189 record_unwind_protect (Fselect_window, prev_window);
3190 select_window_1 (window, 0);
3191 Fset_buffer (w->buffer);
3192 call1 (Vrun_hooks, Qtemp_buffer_show_hook);
3193 select_window_1 (prev_window, 0);
3194 unbind_to (count, Qnil);
3201 static void
3202 make_dummy_parent (window)
3203 Lisp_Object window;
3205 Lisp_Object new;
3206 register struct window *o, *p;
3207 int i;
3209 o = XWINDOW (window);
3210 p = allocate_window ();
3211 for (i = 0; i < VECSIZE (struct window); ++i)
3212 ((struct Lisp_Vector *) p)->contents[i]
3213 = ((struct Lisp_Vector *)o)->contents[i];
3214 XSETWINDOW (new, p);
3216 XSETFASTINT (p->sequence_number, ++sequence_number);
3218 /* Put new into window structure in place of window */
3219 replace_window (window, new);
3221 o->next = Qnil;
3222 o->prev = Qnil;
3223 o->vchild = Qnil;
3224 o->hchild = Qnil;
3225 o->parent = new;
3227 p->start = Qnil;
3228 p->pointm = Qnil;
3229 p->buffer = Qnil;
3232 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
3233 doc: /* Split WINDOW, putting SIZE lines in the first of the pair.
3234 WINDOW defaults to selected one and SIZE to half its size.
3235 If optional third arg HORFLAG is non-nil, split side by side
3236 and put SIZE columns in the first of the pair. In that case,
3237 SIZE includes that window's scroll bar, or the divider column to its right. */)
3238 (window, size, horflag)
3239 Lisp_Object window, size, horflag;
3241 register Lisp_Object new;
3242 register struct window *o, *p;
3243 FRAME_PTR fo;
3244 register int size_int;
3246 if (NILP (window))
3247 window = selected_window;
3248 else
3249 CHECK_LIVE_WINDOW (window);
3251 o = XWINDOW (window);
3252 fo = XFRAME (WINDOW_FRAME (o));
3254 if (NILP (size))
3256 if (!NILP (horflag))
3257 /* Calculate the size of the left-hand window, by dividing
3258 the usable space in columns by two.
3259 We round up, since the left-hand window may include
3260 a dividing line, while the right-hand may not. */
3261 size_int = (XFASTINT (o->width) + 1) >> 1;
3262 else
3263 size_int = XFASTINT (o->height) >> 1;
3265 else
3267 CHECK_NUMBER (size);
3268 size_int = XINT (size);
3271 if (MINI_WINDOW_P (o))
3272 error ("Attempt to split minibuffer window");
3273 else if (window_fixed_size_p (o, !NILP (horflag), 0))
3274 error ("Attempt to split fixed-size window");
3276 check_min_window_sizes ();
3278 if (NILP (horflag))
3280 if (size_int < window_min_height)
3281 error ("Window height %d too small (after splitting)", size_int);
3282 if (size_int + window_min_height > XFASTINT (o->height))
3283 error ("Window height %d too small (after splitting)",
3284 XFASTINT (o->height) - size_int);
3285 if (NILP (o->parent)
3286 || NILP (XWINDOW (o->parent)->vchild))
3288 make_dummy_parent (window);
3289 new = o->parent;
3290 XWINDOW (new)->vchild = window;
3293 else
3295 if (size_int < window_min_width)
3296 error ("Window width %d too small (after splitting)", size_int);
3298 if (size_int + window_min_width > XFASTINT (o->width))
3299 error ("Window width %d too small (after splitting)",
3300 XFASTINT (o->width) - size_int);
3301 if (NILP (o->parent)
3302 || NILP (XWINDOW (o->parent)->hchild))
3304 make_dummy_parent (window);
3305 new = o->parent;
3306 XWINDOW (new)->hchild = window;
3310 /* Now we know that window's parent is a vertical combination
3311 if we are dividing vertically, or a horizontal combination
3312 if we are making side-by-side windows */
3314 windows_or_buffers_changed++;
3315 FRAME_WINDOW_SIZES_CHANGED (fo) = 1;
3316 new = make_window ();
3317 p = XWINDOW (new);
3319 p->frame = o->frame;
3320 p->next = o->next;
3321 if (!NILP (p->next))
3322 XWINDOW (p->next)->prev = new;
3323 p->prev = window;
3324 o->next = new;
3325 p->parent = o->parent;
3326 p->buffer = Qt;
3327 p->window_end_valid = Qnil;
3328 bzero (&p->last_cursor, sizeof p->last_cursor);
3330 /* Apportion the available frame space among the two new windows */
3332 if (!NILP (horflag))
3334 p->height = o->height;
3335 p->top = o->top;
3336 XSETFASTINT (p->width, XFASTINT (o->width) - size_int);
3337 XSETFASTINT (o->width, size_int);
3338 XSETFASTINT (p->left, XFASTINT (o->left) + size_int);
3340 else
3342 p->left = o->left;
3343 p->width = o->width;
3344 XSETFASTINT (p->height, XFASTINT (o->height) - size_int);
3345 XSETFASTINT (o->height, size_int);
3346 XSETFASTINT (p->top, XFASTINT (o->top) + size_int);
3349 /* Adjust glyph matrices. */
3350 adjust_glyphs (fo);
3351 Fset_window_buffer (new, o->buffer);
3352 return new;
3355 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 3, "p",
3356 doc: /* Make current window ARG lines bigger.
3357 From program, optional second arg non-nil means grow sideways ARG columns.
3358 Interactively, if an argument is not given, make the window one line bigger.
3360 Optional third arg PRESERVE-BEFORE, if non-nil, means do not change the size
3361 of the siblings above or to the left of the selected window. Only
3362 siblings to the right or below are changed. */)
3363 (arg, side, preserve_before)
3364 register Lisp_Object arg, side, preserve_before;
3366 CHECK_NUMBER (arg);
3367 enlarge_window (selected_window, XINT (arg), !NILP (side),
3368 !NILP (preserve_before));
3370 if (! NILP (Vwindow_configuration_change_hook))
3371 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3373 return Qnil;
3376 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 3, "p",
3377 doc: /* Make current window ARG lines smaller.
3378 From program, optional second arg non-nil means shrink sideways arg columns.
3379 Interactively, if an argument is not given, make the window one line smaller.
3381 Optional third arg PRESERVE-BEFORE, if non-nil, means do not change the size
3382 of the siblings above or to the left of the selected window. Only
3383 siblings to the right or below are changed. */)
3384 (arg, side, preserve_before)
3385 register Lisp_Object arg, side, preserve_before;
3387 CHECK_NUMBER (arg);
3388 enlarge_window (selected_window, -XINT (arg), !NILP (side),
3389 !NILP (preserve_before));
3391 if (! NILP (Vwindow_configuration_change_hook))
3392 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3394 return Qnil;
3398 window_height (window)
3399 Lisp_Object window;
3401 register struct window *p = XWINDOW (window);
3402 return XFASTINT (p->height);
3406 window_width (window)
3407 Lisp_Object window;
3409 register struct window *p = XWINDOW (window);
3410 return XFASTINT (p->width);
3414 #define CURBEG(w) \
3415 *(widthflag ? &(XWINDOW (w)->left) : &(XWINDOW (w)->top))
3417 #define CURSIZE(w) \
3418 *(widthflag ? &(XWINDOW (w)->width) : &(XWINDOW (w)->height))
3421 /* Enlarge WINDOW by DELTA. WIDTHFLAG non-zero means
3422 increase its width. Siblings of the selected window are resized to
3423 fulfill the size request. If they become too small in the process,
3424 they will be deleted.
3426 If PRESERVE_BEFORE is nonzero, that means don't alter
3427 the siblings to the left or above WINDOW. */
3429 static void
3430 enlarge_window (window, delta, widthflag, preserve_before)
3431 Lisp_Object window;
3432 int delta, widthflag, preserve_before;
3434 Lisp_Object parent, next, prev;
3435 struct window *p;
3436 Lisp_Object *sizep;
3437 int maximum;
3438 int (*sizefun) P_ ((Lisp_Object))
3439 = widthflag ? window_width : window_height;
3440 void (*setsizefun) P_ ((Lisp_Object, int, int))
3441 = (widthflag ? set_window_width : set_window_height);
3443 /* Check values of window_min_width and window_min_height for
3444 validity. */
3445 check_min_window_sizes ();
3447 /* Give up if this window cannot be resized. */
3448 if (window_fixed_size_p (XWINDOW (window), widthflag, 1))
3449 error ("Window is not resizable");
3451 /* Find the parent of the selected window. */
3452 while (1)
3454 p = XWINDOW (window);
3455 parent = p->parent;
3457 if (NILP (parent))
3459 if (widthflag)
3460 error ("No other window to side of this one");
3461 break;
3464 if (widthflag
3465 ? !NILP (XWINDOW (parent)->hchild)
3466 : !NILP (XWINDOW (parent)->vchild))
3467 break;
3469 window = parent;
3472 sizep = &CURSIZE (window);
3475 register int maxdelta;
3477 /* Compute the maximum size increment this window can have. */
3479 if (preserve_before)
3481 if (!NILP (parent))
3483 maxdelta = (*sizefun) (parent) - XINT (*sizep);
3484 /* Subtract size of siblings before, since we can't take that. */
3485 maxdelta -= XINT (CURBEG (window)) - XINT (CURBEG (parent));
3487 else
3488 maxdelta = (!NILP (p->next) ? ((*sizefun) (p->next)
3489 - window_min_size (XWINDOW (p->next),
3490 widthflag, 0, 0))
3491 : (delta = 0));
3493 else
3494 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - XINT (*sizep)
3495 /* This is a main window followed by a minibuffer. */
3496 : !NILP (p->next) ? ((*sizefun) (p->next)
3497 - window_min_size (XWINDOW (p->next),
3498 widthflag, 0, 0))
3499 /* This is a minibuffer following a main window. */
3500 : !NILP (p->prev) ? ((*sizefun) (p->prev)
3501 - window_min_size (XWINDOW (p->prev),
3502 widthflag, 0, 0))
3503 /* This is a frame with only one window, a minibuffer-only
3504 or a minibufferless frame. */
3505 : (delta = 0));
3507 if (delta > maxdelta)
3508 /* This case traps trying to make the minibuffer
3509 the full frame, or make the only window aside from the
3510 minibuffer the full frame. */
3511 delta = maxdelta;
3514 if (XINT (*sizep) + delta < window_min_size (XWINDOW (window), widthflag, 0, 0))
3516 delete_window (window);
3517 return;
3520 if (delta == 0)
3521 return;
3523 /* Find the total we can get from other siblings without deleting them. */
3524 maximum = 0;
3525 for (next = p->next; ! NILP (next); next = XWINDOW (next)->next)
3526 maximum += (*sizefun) (next) - window_min_size (XWINDOW (next),
3527 widthflag, 0, 0);
3528 if (! preserve_before)
3529 for (prev = p->prev; ! NILP (prev); prev = XWINDOW (prev)->prev)
3530 maximum += (*sizefun) (prev) - window_min_size (XWINDOW (prev),
3531 widthflag, 0, 0);
3533 /* If we can get it all from them without deleting them, do so. */
3534 if (delta <= maximum)
3536 Lisp_Object first_unaffected;
3537 Lisp_Object first_affected;
3538 int fixed_p;
3540 next = p->next;
3541 prev = p->prev;
3542 first_affected = window;
3543 /* Look at one sibling at a time,
3544 moving away from this window in both directions alternately,
3545 and take as much as we can get without deleting that sibling. */
3546 while (delta != 0
3547 && (!NILP (next) || (!preserve_before && !NILP (prev))))
3549 if (! NILP (next))
3551 int this_one = ((*sizefun) (next)
3552 - window_min_size (XWINDOW (next),
3553 widthflag, 0, &fixed_p));
3554 if (!fixed_p)
3556 if (this_one > delta)
3557 this_one = delta;
3559 (*setsizefun) (next, (*sizefun) (next) - this_one, 0);
3560 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
3562 delta -= this_one;
3565 next = XWINDOW (next)->next;
3568 if (delta == 0)
3569 break;
3571 if (!preserve_before && ! NILP (prev))
3573 int this_one = ((*sizefun) (prev)
3574 - window_min_size (XWINDOW (prev),
3575 widthflag, 0, &fixed_p));
3576 if (!fixed_p)
3578 if (this_one > delta)
3579 this_one = delta;
3581 first_affected = prev;
3583 (*setsizefun) (prev, (*sizefun) (prev) - this_one, 0);
3584 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
3586 delta -= this_one;
3589 prev = XWINDOW (prev)->prev;
3593 xassert (delta == 0);
3595 /* Now recalculate the edge positions of all the windows affected,
3596 based on the new sizes. */
3597 first_unaffected = next;
3598 prev = first_affected;
3599 for (next = XWINDOW (prev)->next; ! EQ (next, first_unaffected);
3600 prev = next, next = XWINDOW (next)->next)
3602 XSETINT (CURBEG (next), XINT (CURBEG (prev)) + (*sizefun) (prev));
3603 /* This does not change size of NEXT,
3604 but it propagates the new top edge to its children */
3605 (*setsizefun) (next, (*sizefun) (next), 0);
3608 else
3610 register int delta1;
3611 register int opht = (*sizefun) (parent);
3613 if (opht <= XINT (*sizep) + delta)
3615 /* If trying to grow this window to or beyond size of the parent,
3616 just delete all the sibling windows. */
3617 Lisp_Object start, tem, next;
3619 start = XWINDOW (parent)->vchild;
3620 if (NILP (start))
3621 start = XWINDOW (parent)->hchild;
3623 /* Delete any siblings that come after WINDOW. */
3624 tem = XWINDOW (window)->next;
3625 while (! NILP (tem))
3627 next = XWINDOW (tem)->next;
3628 delete_window (tem);
3629 tem = next;
3632 /* Delete any siblings that come after WINDOW.
3633 Note that if START is not WINDOW, then WINDOW still
3634 Fhas siblings, so WINDOW has not yet replaced its parent. */
3635 tem = start;
3636 while (! EQ (tem, window))
3638 next = XWINDOW (tem)->next;
3639 delete_window (tem);
3640 tem = next;
3643 else
3645 /* Otherwise, make delta1 just right so that if we add
3646 delta1 lines to this window and to the parent, and then
3647 shrink the parent back to its original size, the new
3648 proportional size of this window will increase by delta.
3650 The function size_window will compute the new height h'
3651 of the window from delta1 as:
3653 e = delta1/n
3654 x = delta1 - delta1/n * n for the 1st resizable child
3655 h' = h + e + x
3657 where n is the number of children that can be resized.
3658 We can ignore x by choosing a delta1 that is a multiple of
3659 n. We want the height of this window to come out as
3661 h' = h + delta
3663 So, delta1 must be
3665 h + e = h + delta
3666 delta1/n = delta
3667 delta1 = n * delta.
3669 The number of children n equals the number of resizable
3670 children of this window + 1 because we know window itself
3671 is resizable (otherwise we would have signalled an error. */
3673 struct window *w = XWINDOW (window);
3674 Lisp_Object s;
3675 int n = 1;
3677 for (s = w->next; !NILP (s); s = XWINDOW (s)->next)
3678 if (!window_fixed_size_p (XWINDOW (s), widthflag, 0))
3679 ++n;
3680 for (s = w->prev; !NILP (s); s = XWINDOW (s)->prev)
3681 if (!window_fixed_size_p (XWINDOW (s), widthflag, 0))
3682 ++n;
3684 delta1 = n * delta;
3686 /* Add delta1 lines or columns to this window, and to the parent,
3687 keeping things consistent while not affecting siblings. */
3688 XSETINT (CURSIZE (parent), opht + delta1);
3689 (*setsizefun) (window, XINT (*sizep) + delta1, 0);
3691 /* Squeeze out delta1 lines or columns from our parent,
3692 shriking this window and siblings proportionately.
3693 This brings parent back to correct size.
3694 Delta1 was calculated so this makes this window the desired size,
3695 taking it all out of the siblings. */
3696 (*setsizefun) (parent, opht, 0);
3701 XSETFASTINT (p->last_modified, 0);
3702 XSETFASTINT (p->last_overlay_modified, 0);
3704 /* Adjust glyph matrices. */
3705 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
3708 #undef CURBEG
3709 #undef CURSIZE
3713 /***********************************************************************
3714 Resizing Mini-Windows
3715 ***********************************************************************/
3717 static void shrink_window_lowest_first P_ ((struct window *, int));
3719 enum save_restore_action
3721 CHECK_ORIG_SIZES,
3722 SAVE_ORIG_SIZES,
3723 RESTORE_ORIG_SIZES
3726 static int save_restore_orig_size P_ ((struct window *,
3727 enum save_restore_action));
3729 /* Shrink windows rooted in window W to HEIGHT. Take the space needed
3730 from lowest windows first. */
3732 static void
3733 shrink_window_lowest_first (w, height)
3734 struct window *w;
3735 int height;
3737 struct window *c;
3738 Lisp_Object child;
3739 int old_height;
3741 xassert (!MINI_WINDOW_P (w));
3743 /* Set redisplay hints. */
3744 XSETFASTINT (w->last_modified, 0);
3745 XSETFASTINT (w->last_overlay_modified, 0);
3746 windows_or_buffers_changed++;
3747 FRAME_WINDOW_SIZES_CHANGED (XFRAME (WINDOW_FRAME (w))) = 1;
3749 old_height = XFASTINT (w->height);
3750 XSETFASTINT (w->height, height);
3752 if (!NILP (w->hchild))
3754 for (child = w->hchild; !NILP (child); child = c->next)
3756 c = XWINDOW (child);
3757 c->top = w->top;
3758 shrink_window_lowest_first (c, height);
3761 else if (!NILP (w->vchild))
3763 Lisp_Object last_child;
3764 int delta = old_height - height;
3765 int last_top;
3767 last_child = Qnil;
3769 /* Find the last child. We are taking space from lowest windows
3770 first, so we iterate over children from the last child
3771 backwards. */
3772 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
3773 last_child = child;
3775 /* Assign new heights. We leave only MIN_SAFE_WINDOW_HEIGHT. */
3776 for (child = last_child; delta && !NILP (child); child = c->prev)
3778 int this_one;
3780 c = XWINDOW (child);
3781 this_one = XFASTINT (c->height) - MIN_SAFE_WINDOW_HEIGHT;
3783 if (this_one > delta)
3784 this_one = delta;
3786 shrink_window_lowest_first (c, XFASTINT (c->height) - this_one);
3787 delta -= this_one;
3790 /* Compute new positions. */
3791 last_top = XINT (w->top);
3792 for (child = w->vchild; !NILP (child); child = c->next)
3794 c = XWINDOW (child);
3795 c->top = make_number (last_top);
3796 shrink_window_lowest_first (c, XFASTINT (c->height));
3797 last_top += XFASTINT (c->height);
3803 /* Save, restore, or check positions and sizes in the window tree
3804 rooted at W. ACTION says what to do.
3806 If ACTION is CHECK_ORIG_SIZES, check if orig_top and orig_height
3807 members are valid for all windows in the window tree. Value is
3808 non-zero if they are valid.
3810 If ACTION is SAVE_ORIG_SIZES, save members top and height in
3811 orig_top and orig_height for all windows in the tree.
3813 If ACTION is RESTORE_ORIG_SIZES, restore top and height from
3814 values stored in orig_top and orig_height for all windows. */
3816 static int
3817 save_restore_orig_size (w, action)
3818 struct window *w;
3819 enum save_restore_action action;
3821 int success_p = 1;
3823 while (w)
3825 if (!NILP (w->hchild))
3827 if (!save_restore_orig_size (XWINDOW (w->hchild), action))
3828 success_p = 0;
3830 else if (!NILP (w->vchild))
3832 if (!save_restore_orig_size (XWINDOW (w->vchild), action))
3833 success_p = 0;
3836 switch (action)
3838 case CHECK_ORIG_SIZES:
3839 if (!INTEGERP (w->orig_top) || !INTEGERP (w->orig_height))
3840 return 0;
3841 break;
3843 case SAVE_ORIG_SIZES:
3844 w->orig_top = w->top;
3845 w->orig_height = w->height;
3846 XSETFASTINT (w->last_modified, 0);
3847 XSETFASTINT (w->last_overlay_modified, 0);
3848 break;
3850 case RESTORE_ORIG_SIZES:
3851 xassert (INTEGERP (w->orig_top) && INTEGERP (w->orig_height));
3852 w->top = w->orig_top;
3853 w->height = w->orig_height;
3854 w->orig_height = w->orig_top = Qnil;
3855 XSETFASTINT (w->last_modified, 0);
3856 XSETFASTINT (w->last_overlay_modified, 0);
3857 break;
3859 default:
3860 abort ();
3863 w = NILP (w->next) ? NULL : XWINDOW (w->next);
3866 return success_p;
3870 /* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we can
3871 without deleting other windows. */
3873 void
3874 grow_mini_window (w, delta)
3875 struct window *w;
3876 int delta;
3878 struct frame *f = XFRAME (w->frame);
3879 struct window *root;
3881 xassert (MINI_WINDOW_P (w));
3882 xassert (delta >= 0);
3884 /* Check values of window_min_width and window_min_height for
3885 validity. */
3886 check_min_window_sizes ();
3888 /* Compute how much we can enlarge the mini-window without deleting
3889 other windows. */
3890 root = XWINDOW (FRAME_ROOT_WINDOW (f));
3891 if (delta)
3893 int min_height = window_min_size (root, 0, 0, 0);
3894 if (XFASTINT (root->height) - delta < min_height)
3895 /* Note that the root window may already be smaller than
3896 min_height. */
3897 delta = max (0, XFASTINT (root->height) - min_height);
3900 if (delta)
3902 /* Save original window sizes and positions, if not already done. */
3903 if (!save_restore_orig_size (root, CHECK_ORIG_SIZES))
3904 save_restore_orig_size (root, SAVE_ORIG_SIZES);
3906 /* Shrink other windows. */
3907 shrink_window_lowest_first (root, XFASTINT (root->height) - delta);
3909 /* Grow the mini-window. */
3910 w->top = make_number (XFASTINT (root->top) + XFASTINT (root->height));
3911 w->height = make_number (XFASTINT (w->height) + delta);
3912 XSETFASTINT (w->last_modified, 0);
3913 XSETFASTINT (w->last_overlay_modified, 0);
3915 adjust_glyphs (f);
3920 /* Shrink mini-window W. If there is recorded info about window sizes
3921 before a call to grow_mini_window, restore recorded window sizes.
3922 Otherwise, if the mini-window is higher than 1 line, resize it to 1
3923 line. */
3925 void
3926 shrink_mini_window (w)
3927 struct window *w;
3929 struct frame *f = XFRAME (w->frame);
3930 struct window *root = XWINDOW (FRAME_ROOT_WINDOW (f));
3932 if (save_restore_orig_size (root, CHECK_ORIG_SIZES))
3934 save_restore_orig_size (root, RESTORE_ORIG_SIZES);
3935 adjust_glyphs (f);
3936 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
3937 windows_or_buffers_changed = 1;
3939 else if (XFASTINT (w->height) > 1)
3941 /* Distribute the additional lines of the mini-window
3942 among the other windows. */
3943 Lisp_Object window;
3944 XSETWINDOW (window, w);
3945 enlarge_window (window, 1 - XFASTINT (w->height), 0, 0);
3951 /* Mark window cursors off for all windows in the window tree rooted
3952 at W by setting their phys_cursor_on_p flag to zero. Called from
3953 xterm.c, e.g. when a frame is cleared and thereby all cursors on
3954 the frame are cleared. */
3956 void
3957 mark_window_cursors_off (w)
3958 struct window *w;
3960 while (w)
3962 if (!NILP (w->hchild))
3963 mark_window_cursors_off (XWINDOW (w->hchild));
3964 else if (!NILP (w->vchild))
3965 mark_window_cursors_off (XWINDOW (w->vchild));
3966 else
3967 w->phys_cursor_on_p = 0;
3969 w = NILP (w->next) ? 0 : XWINDOW (w->next);
3974 /* Return number of lines of text (not counting mode lines) in W. */
3977 window_internal_height (w)
3978 struct window *w;
3980 int ht = XFASTINT (w->height);
3982 if (!MINI_WINDOW_P (w))
3984 if (!NILP (w->parent)
3985 || !NILP (w->vchild)
3986 || !NILP (w->hchild)
3987 || !NILP (w->next)
3988 || !NILP (w->prev)
3989 || WINDOW_WANTS_MODELINE_P (w))
3990 --ht;
3992 if (WINDOW_WANTS_HEADER_LINE_P (w))
3993 --ht;
3996 return ht;
4000 /* Return the number of columns in W.
4001 Don't count columns occupied by scroll bars or the vertical bar
4002 separating W from the sibling to its right. */
4005 window_internal_width (w)
4006 struct window *w;
4008 struct frame *f = XFRAME (WINDOW_FRAME (w));
4009 int width = XINT (w->width);
4011 if (FRAME_HAS_VERTICAL_SCROLL_BARS (f))
4012 /* Scroll bars occupy a few columns. */
4013 width -= FRAME_SCROLL_BAR_COLS (f);
4014 else if (!WINDOW_RIGHTMOST_P (w) && !WINDOW_FULL_WIDTH_P (w))
4015 /* The column of `|' characters separating side-by-side windows
4016 occupies one column only. */
4017 width -= 1;
4019 /* On window-systems, areas to the left and right of the window
4020 are used as fringes. */
4021 if (FRAME_WINDOW_P (f))
4022 width -= FRAME_FRINGE_COLS (f);
4024 return width;
4028 /************************************************************************
4029 Window Scrolling
4030 ***********************************************************************/
4032 /* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
4033 N screen-fulls, which is defined as the height of the window minus
4034 next_screen_context_lines. If WHOLE is zero, scroll up N lines
4035 instead. Negative values of N mean scroll down. NOERROR non-zero
4036 means don't signal an error if we try to move over BEGV or ZV,
4037 respectively. */
4039 static void
4040 window_scroll (window, n, whole, noerror)
4041 Lisp_Object window;
4042 int n;
4043 int whole;
4044 int noerror;
4046 immediate_quit = 1;
4048 /* If we must, use the pixel-based version which is much slower than
4049 the line-based one but can handle varying line heights. */
4050 if (FRAME_WINDOW_P (XFRAME (XWINDOW (window)->frame)))
4051 window_scroll_pixel_based (window, n, whole, noerror);
4052 else
4053 window_scroll_line_based (window, n, whole, noerror);
4055 immediate_quit = 0;
4059 /* Implementation of window_scroll that works based on pixel line
4060 heights. See the comment of window_scroll for parameter
4061 descriptions. */
4063 static void
4064 window_scroll_pixel_based (window, n, whole, noerror)
4065 Lisp_Object window;
4066 int n;
4067 int whole;
4068 int noerror;
4070 struct it it;
4071 struct window *w = XWINDOW (window);
4072 struct text_pos start;
4073 Lisp_Object tem;
4074 int this_scroll_margin;
4075 int preserve_y;
4076 /* True if we fiddled the window vscroll field without really scrolling. */
4077 int vscrolled = 0;
4079 SET_TEXT_POS_FROM_MARKER (start, w->start);
4081 /* If PT is not visible in WINDOW, move back one half of
4082 the screen. Allow PT to be partially visible, otherwise
4083 something like (scroll-down 1) with PT in the line before
4084 the partially visible one would recenter. */
4085 tem = Fpos_visible_in_window_p (make_number (PT), window, Qt);
4086 if (NILP (tem))
4088 /* Move backward half the height of the window. Performance note:
4089 vmotion used here is about 10% faster, but would give wrong
4090 results for variable height lines. */
4091 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
4092 it.current_y = it.last_visible_y;
4093 move_it_vertically (&it, - window_box_height (w) / 2);
4095 /* The function move_iterator_vertically may move over more than
4096 the specified y-distance. If it->w is small, e.g. a
4097 mini-buffer window, we may end up in front of the window's
4098 display area. This is the case when Start displaying at the
4099 start of the line containing PT in this case. */
4100 if (it.current_y <= 0)
4102 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
4103 move_it_vertically (&it, 0);
4104 it.current_y = 0;
4107 start = it.current.pos;
4110 /* If scroll_preserve_screen_position is non-zero, we try to set
4111 point in the same window line as it is now, so get that line. */
4112 if (!NILP (Vscroll_preserve_screen_position))
4114 start_display (&it, w, start);
4115 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
4116 preserve_y = it.current_y;
4118 else
4119 preserve_y = -1;
4121 /* Move iterator it from start the specified distance forward or
4122 backward. The result is the new window start. */
4123 start_display (&it, w, start);
4124 if (whole)
4126 int screen_full = (window_box_height (w)
4127 - next_screen_context_lines * CANON_Y_UNIT (it.f));
4128 int dy = n * screen_full;
4130 /* Note that move_it_vertically always moves the iterator to the
4131 start of a line. So, if the last line doesn't have a newline,
4132 we would end up at the start of the line ending at ZV. */
4133 if (dy <= 0)
4134 move_it_vertically_backward (&it, -dy);
4135 else if (dy > 0)
4136 move_it_to (&it, ZV, -1, it.current_y + dy, -1,
4137 MOVE_TO_POS | MOVE_TO_Y);
4139 else
4140 move_it_by_lines (&it, n, 1);
4142 /* End if we end up at ZV or BEGV. */
4143 if ((n > 0 && IT_CHARPOS (it) == ZV)
4144 || (n < 0 && IT_CHARPOS (it) == CHARPOS (start)))
4146 if (IT_CHARPOS (it) == ZV)
4148 if (it.current_y + it.max_ascent + it.max_descent
4149 > it.last_visible_y)
4151 /* The last line was only partially visible, make it fully
4152 visible. */
4153 w->vscroll = (it.last_visible_y
4154 - it.current_y + it.max_ascent + it.max_descent);
4155 adjust_glyphs (it.f);
4157 else if (noerror)
4158 return;
4159 else
4160 Fsignal (Qend_of_buffer, Qnil);
4162 else
4164 if (w->vscroll != 0)
4165 /* The first line was only partially visible, make it fully
4166 visible. */
4167 w->vscroll = 0;
4168 else if (noerror)
4169 return;
4170 else
4171 Fsignal (Qbeginning_of_buffer, Qnil);
4174 /* If control gets here, then we vscrolled. */
4176 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
4178 /* Don't try to change the window start below. */
4179 vscrolled = 1;
4182 if (! vscrolled)
4184 int pos = IT_CHARPOS (it);
4185 int bytepos;
4186 /* Set the window start, and set up the window for redisplay. */
4187 set_marker_restricted (w->start, make_number (pos),
4188 w->buffer);
4189 bytepos = XMARKER (w->start)->bytepos;
4190 w->start_at_line_beg = ((pos == BEGV || FETCH_BYTE (bytepos - 1) == '\n')
4191 ? Qt : Qnil);
4192 w->update_mode_line = Qt;
4193 XSETFASTINT (w->last_modified, 0);
4194 XSETFASTINT (w->last_overlay_modified, 0);
4195 /* Set force_start so that redisplay_window will run the
4196 window-scroll-functions. */
4197 w->force_start = Qt;
4200 it.current_y = it.vpos = 0;
4202 /* Preserve the screen position if we must. */
4203 if (preserve_y >= 0)
4205 move_it_to (&it, -1, -1, preserve_y, -1, MOVE_TO_Y);
4206 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4208 else
4210 /* Move PT out of scroll margins. */
4211 this_scroll_margin = max (0, scroll_margin);
4212 this_scroll_margin = min (this_scroll_margin, XFASTINT (w->height) / 4);
4213 this_scroll_margin *= CANON_Y_UNIT (it.f);
4215 if (n > 0)
4217 /* We moved the window start towards ZV, so PT may be now
4218 in the scroll margin at the top. */
4219 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
4220 while (it.current_y < this_scroll_margin)
4222 int prev = it.current_y;
4223 move_it_by_lines (&it, 1, 1);
4224 if (prev == it.current_y)
4225 break;
4227 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4229 else if (n < 0)
4231 int charpos, bytepos;
4233 /* We moved the window start towards BEGV, so PT may be now
4234 in the scroll margin at the bottom. */
4235 move_it_to (&it, PT, -1,
4236 it.last_visible_y - this_scroll_margin - 1, -1,
4237 MOVE_TO_POS | MOVE_TO_Y);
4239 /* Save our position, in case it's correct. */
4240 charpos = IT_CHARPOS (it);
4241 bytepos = IT_BYTEPOS (it);
4243 /* See if point is on a partially visible line at the end. */
4244 move_it_by_lines (&it, 1, 1);
4245 if (it.current_y > it.last_visible_y)
4246 /* The last line was only partially visible, so back up two
4247 lines to make sure we're on a fully visible line. */
4249 move_it_by_lines (&it, -2, 0);
4250 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4252 else
4253 /* No, the position we saved is OK, so use it. */
4254 SET_PT_BOTH (charpos, bytepos);
4260 /* Implementation of window_scroll that works based on screen lines.
4261 See the comment of window_scroll for parameter descriptions. */
4263 static void
4264 window_scroll_line_based (window, n, whole, noerror)
4265 Lisp_Object window;
4266 int n;
4267 int whole;
4268 int noerror;
4270 register struct window *w = XWINDOW (window);
4271 register int opoint = PT, opoint_byte = PT_BYTE;
4272 register int pos, pos_byte;
4273 register int ht = window_internal_height (w);
4274 register Lisp_Object tem;
4275 int lose;
4276 Lisp_Object bolp;
4277 int startpos;
4278 struct position posit;
4279 int original_vpos;
4281 /* If scrolling screen-fulls, compute the number of lines to
4282 scroll from the window's height. */
4283 if (whole)
4284 n *= max (1, ht - next_screen_context_lines);
4286 startpos = marker_position (w->start);
4288 posit = *compute_motion (startpos, 0, 0, 0,
4289 PT, ht, 0,
4290 window_internal_width (w), XINT (w->hscroll),
4291 0, w);
4292 original_vpos = posit.vpos;
4294 XSETFASTINT (tem, PT);
4295 tem = Fpos_visible_in_window_p (tem, window, Qnil);
4297 if (NILP (tem))
4299 Fvertical_motion (make_number (- (ht / 2)), window);
4300 startpos = PT;
4303 SET_PT (startpos);
4304 lose = n < 0 && PT == BEGV;
4305 Fvertical_motion (make_number (n), window);
4306 pos = PT;
4307 pos_byte = PT_BYTE;
4308 bolp = Fbolp ();
4309 SET_PT_BOTH (opoint, opoint_byte);
4311 if (lose)
4313 if (noerror)
4314 return;
4315 else
4316 Fsignal (Qbeginning_of_buffer, Qnil);
4319 if (pos < ZV)
4321 int this_scroll_margin = scroll_margin;
4323 /* Don't use a scroll margin that is negative or too large. */
4324 if (this_scroll_margin < 0)
4325 this_scroll_margin = 0;
4327 if (XINT (w->height) < 4 * scroll_margin)
4328 this_scroll_margin = XINT (w->height) / 4;
4330 set_marker_restricted_both (w->start, w->buffer, pos, pos_byte);
4331 w->start_at_line_beg = bolp;
4332 w->update_mode_line = Qt;
4333 XSETFASTINT (w->last_modified, 0);
4334 XSETFASTINT (w->last_overlay_modified, 0);
4335 /* Set force_start so that redisplay_window will run
4336 the window-scroll-functions. */
4337 w->force_start = Qt;
4339 if (whole && !NILP (Vscroll_preserve_screen_position))
4341 SET_PT_BOTH (pos, pos_byte);
4342 Fvertical_motion (make_number (original_vpos), window);
4344 /* If we scrolled forward, put point enough lines down
4345 that it is outside the scroll margin. */
4346 else if (n > 0)
4348 int top_margin;
4350 if (this_scroll_margin > 0)
4352 SET_PT_BOTH (pos, pos_byte);
4353 Fvertical_motion (make_number (this_scroll_margin), window);
4354 top_margin = PT;
4356 else
4357 top_margin = pos;
4359 if (top_margin <= opoint)
4360 SET_PT_BOTH (opoint, opoint_byte);
4361 else if (!NILP (Vscroll_preserve_screen_position))
4363 SET_PT_BOTH (pos, pos_byte);
4364 Fvertical_motion (make_number (original_vpos), window);
4366 else
4367 SET_PT (top_margin);
4369 else if (n < 0)
4371 int bottom_margin;
4373 /* If we scrolled backward, put point near the end of the window
4374 but not within the scroll margin. */
4375 SET_PT_BOTH (pos, pos_byte);
4376 tem = Fvertical_motion (make_number (ht - this_scroll_margin), window);
4377 if (XFASTINT (tem) == ht - this_scroll_margin)
4378 bottom_margin = PT;
4379 else
4380 bottom_margin = PT + 1;
4382 if (bottom_margin > opoint)
4383 SET_PT_BOTH (opoint, opoint_byte);
4384 else
4386 if (!NILP (Vscroll_preserve_screen_position))
4388 SET_PT_BOTH (pos, pos_byte);
4389 Fvertical_motion (make_number (original_vpos), window);
4391 else
4392 Fvertical_motion (make_number (-1), window);
4396 else
4398 if (noerror)
4399 return;
4400 else
4401 Fsignal (Qend_of_buffer, Qnil);
4406 /* Scroll selected_window up or down. If N is nil, scroll a
4407 screen-full which is defined as the height of the window minus
4408 next_screen_context_lines. If N is the symbol `-', scroll.
4409 DIRECTION may be 1 meaning to scroll down, or -1 meaning to scroll
4410 up. This is the guts of Fscroll_up and Fscroll_down. */
4412 static void
4413 scroll_command (n, direction)
4414 Lisp_Object n;
4415 int direction;
4417 int count = SPECPDL_INDEX ();
4419 xassert (abs (direction) == 1);
4421 /* If selected window's buffer isn't current, make it current for
4422 the moment. But don't screw up if window_scroll gets an error. */
4423 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
4425 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4426 Fset_buffer (XWINDOW (selected_window)->buffer);
4428 /* Make redisplay consider other windows than just selected_window. */
4429 ++windows_or_buffers_changed;
4432 if (NILP (n))
4433 window_scroll (selected_window, direction, 1, 0);
4434 else if (EQ (n, Qminus))
4435 window_scroll (selected_window, -direction, 1, 0);
4436 else
4438 n = Fprefix_numeric_value (n);
4439 window_scroll (selected_window, XINT (n) * direction, 0, 0);
4442 unbind_to (count, Qnil);
4445 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
4446 doc: /* Scroll text of current window upward ARG lines; or near full screen if no ARG.
4447 A near full screen is `next-screen-context-lines' less than a full screen.
4448 Negative ARG means scroll downward.
4449 If ARG is the atom `-', scroll downward by nearly full screen.
4450 When calling from a program, supply as argument a number, nil, or `-'. */)
4451 (arg)
4452 Lisp_Object arg;
4454 scroll_command (arg, 1);
4455 return Qnil;
4458 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
4459 doc: /* Scroll text of current window down ARG lines; or near full screen if no ARG.
4460 A near full screen is `next-screen-context-lines' less than a full screen.
4461 Negative ARG means scroll upward.
4462 If ARG is the atom `-', scroll upward by nearly full screen.
4463 When calling from a program, supply as argument a number, nil, or `-'. */)
4464 (arg)
4465 Lisp_Object arg;
4467 scroll_command (arg, -1);
4468 return Qnil;
4471 DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling, Sother_window_for_scrolling, 0, 0, 0,
4472 doc: /* Return the other window for \"other window scroll\" commands.
4473 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4474 specifies the window.
4475 If `other-window-scroll-buffer' is non-nil, a window
4476 showing that buffer is used. */)
4479 Lisp_Object window;
4481 if (MINI_WINDOW_P (XWINDOW (selected_window))
4482 && !NILP (Vminibuf_scroll_window))
4483 window = Vminibuf_scroll_window;
4484 /* If buffer is specified, scroll that buffer. */
4485 else if (!NILP (Vother_window_scroll_buffer))
4487 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
4488 if (NILP (window))
4489 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt, Qnil);
4491 else
4493 /* Nothing specified; look for a neighboring window on the same
4494 frame. */
4495 window = Fnext_window (selected_window, Qnil, Qnil);
4497 if (EQ (window, selected_window))
4498 /* That didn't get us anywhere; look for a window on another
4499 visible frame. */
4501 window = Fnext_window (window, Qnil, Qt);
4502 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
4503 && ! EQ (window, selected_window));
4506 CHECK_LIVE_WINDOW (window);
4508 if (EQ (window, selected_window))
4509 error ("There is no other window");
4511 return window;
4514 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
4515 doc: /* Scroll next window upward ARG lines; or near full screen if no ARG.
4516 A near full screen is `next-screen-context-lines' less than a full screen.
4517 The next window is the one below the current one; or the one at the top
4518 if the current one is at the bottom. Negative ARG means scroll downward.
4519 If ARG is the atom `-', scroll downward by nearly full screen.
4520 When calling from a program, supply as argument a number, nil, or `-'.
4522 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4523 specifies the window to scroll.
4524 If `other-window-scroll-buffer' is non-nil, scroll the window
4525 showing that buffer, popping the buffer up if necessary. */)
4526 (arg)
4527 Lisp_Object arg;
4529 Lisp_Object window;
4530 struct window *w;
4531 int count = SPECPDL_INDEX ();
4533 window = Fother_window_for_scrolling ();
4534 w = XWINDOW (window);
4536 /* Don't screw up if window_scroll gets an error. */
4537 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4538 ++windows_or_buffers_changed;
4540 Fset_buffer (w->buffer);
4541 SET_PT (marker_position (w->pointm));
4543 if (NILP (arg))
4544 window_scroll (window, 1, 1, 1);
4545 else if (EQ (arg, Qminus))
4546 window_scroll (window, -1, 1, 1);
4547 else
4549 if (CONSP (arg))
4550 arg = Fcar (arg);
4551 CHECK_NUMBER (arg);
4552 window_scroll (window, XINT (arg), 0, 1);
4555 set_marker_both (w->pointm, Qnil, PT, PT_BYTE);
4556 unbind_to (count, Qnil);
4558 return Qnil;
4561 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 1, "P",
4562 doc: /* Scroll selected window display ARG columns left.
4563 Default for ARG is window width minus 2.
4564 Value is the total amount of leftward horizontal scrolling in
4565 effect after the change.
4566 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4567 a lower bound for automatic scrolling, i.e. automatic scrolling
4568 will not scroll a window to a column less than the value returned
4569 by this function. */)
4570 (arg)
4571 register Lisp_Object arg;
4573 Lisp_Object result;
4574 int hscroll;
4575 struct window *w = XWINDOW (selected_window);
4577 if (NILP (arg))
4578 XSETFASTINT (arg, window_internal_width (w) - 2);
4579 else
4580 arg = Fprefix_numeric_value (arg);
4582 hscroll = XINT (w->hscroll) + XINT (arg);
4583 result = Fset_window_hscroll (selected_window, make_number (hscroll));
4585 if (interactive_p (0))
4586 w->min_hscroll = w->hscroll;
4588 return result;
4591 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 1, "P",
4592 doc: /* Scroll selected window display ARG columns right.
4593 Default for ARG is window width minus 2.
4594 Value is the total amount of leftward horizontal scrolling in
4595 effect after the change.
4596 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4597 a lower bound for automatic scrolling, i.e. automatic scrolling
4598 will not scroll a window to a column less than the value returned
4599 by this function. */)
4600 (arg)
4601 register Lisp_Object arg;
4603 Lisp_Object result;
4604 int hscroll;
4605 struct window *w = XWINDOW (selected_window);
4607 if (NILP (arg))
4608 XSETFASTINT (arg, window_internal_width (w) - 2);
4609 else
4610 arg = Fprefix_numeric_value (arg);
4612 hscroll = XINT (w->hscroll) - XINT (arg);
4613 result = Fset_window_hscroll (selected_window, make_number (hscroll));
4615 if (interactive_p (0))
4616 w->min_hscroll = w->hscroll;
4618 return result;
4621 DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window, Sminibuffer_selected_window, 0, 0, 0,
4622 doc: /* Return the window which was selected when entering the minibuffer.
4623 Returns nil, if current window is not a minibuffer window. */)
4626 if (minibuf_level > 0
4627 && MINI_WINDOW_P (XWINDOW (selected_window))
4628 && !NILP (minibuf_selected_window)
4629 && WINDOW_LIVE_P (minibuf_selected_window))
4630 return minibuf_selected_window;
4632 return Qnil;
4635 /* Value is the number of lines actually displayed in window W,
4636 as opposed to its height. */
4638 static int
4639 displayed_window_lines (w)
4640 struct window *w;
4642 struct it it;
4643 struct text_pos start;
4644 int height = window_box_height (w);
4645 struct buffer *old_buffer;
4646 int bottom_y;
4648 if (XBUFFER (w->buffer) != current_buffer)
4650 old_buffer = current_buffer;
4651 set_buffer_internal (XBUFFER (w->buffer));
4653 else
4654 old_buffer = NULL;
4656 /* In case W->start is out of the accessible range, do something
4657 reasonable. This happens in Info mode when Info-scroll-down
4658 calls (recenter -1) while W->start is 1. */
4659 if (XMARKER (w->start)->charpos < BEGV)
4660 SET_TEXT_POS (start, BEGV, BEGV_BYTE);
4661 else if (XMARKER (w->start)->charpos > ZV)
4662 SET_TEXT_POS (start, ZV, ZV_BYTE);
4663 else
4664 SET_TEXT_POS_FROM_MARKER (start, w->start);
4666 start_display (&it, w, start);
4667 move_it_vertically (&it, height);
4668 bottom_y = line_bottom_y (&it);
4670 /* rms: On a non-window display,
4671 the value of it.vpos at the bottom of the screen
4672 seems to be 1 larger than window_box_height (w).
4673 This kludge fixes a bug whereby (move-to-window-line -1)
4674 when ZV is on the last screen line
4675 moves to the previous screen line instead of the last one. */
4676 if (! FRAME_WINDOW_P (XFRAME (w->frame)))
4677 height++;
4679 /* Add in empty lines at the bottom of the window. */
4680 if (bottom_y < height)
4682 int uy = CANON_Y_UNIT (it.f);
4683 it.vpos += (height - bottom_y + uy - 1) / uy;
4686 if (old_buffer)
4687 set_buffer_internal (old_buffer);
4689 return it.vpos;
4693 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
4694 doc: /* Center point in window and redisplay frame.
4695 With prefix argument ARG, recenter putting point on screen line ARG
4696 relative to the current window. If ARG is negative, it counts up from the
4697 bottom of the window. (ARG should be less than the height of the window.)
4699 If ARG is omitted or nil, erase the entire frame and then
4700 redraw with point in the center of the current window.
4701 Just C-u as prefix means put point in the center of the window
4702 and redisplay normally--don't erase and redraw the frame. */)
4703 (arg)
4704 register Lisp_Object arg;
4706 struct window *w = XWINDOW (selected_window);
4707 struct buffer *buf = XBUFFER (w->buffer);
4708 struct buffer *obuf = current_buffer;
4709 int center_p = 0;
4710 int charpos, bytepos;
4712 /* If redisplay is suppressed due to an error, try again. */
4713 obuf->display_error_modiff = 0;
4715 if (NILP (arg))
4717 int i;
4719 /* Invalidate pixel data calculated for all compositions. */
4720 for (i = 0; i < n_compositions; i++)
4721 composition_table[i]->font = NULL;
4723 Fredraw_frame (w->frame);
4724 SET_FRAME_GARBAGED (XFRAME (WINDOW_FRAME (w)));
4725 center_p = 1;
4727 else if (CONSP (arg)) /* Just C-u. */
4728 center_p = 1;
4729 else
4731 arg = Fprefix_numeric_value (arg);
4732 CHECK_NUMBER (arg);
4735 set_buffer_internal (buf);
4737 /* Handle centering on a graphical frame specially. Such frames can
4738 have variable-height lines and centering point on the basis of
4739 line counts would lead to strange effects. */
4740 if (FRAME_WINDOW_P (XFRAME (w->frame)))
4742 if (center_p)
4744 struct it it;
4745 struct text_pos pt;
4747 SET_TEXT_POS (pt, PT, PT_BYTE);
4748 start_display (&it, w, pt);
4749 move_it_vertically (&it, - window_box_height (w) / 2);
4750 charpos = IT_CHARPOS (it);
4751 bytepos = IT_BYTEPOS (it);
4753 else if (XINT (arg) < 0)
4755 struct it it;
4756 struct text_pos pt;
4757 int y0, y1, h, nlines;
4759 SET_TEXT_POS (pt, PT, PT_BYTE);
4760 start_display (&it, w, pt);
4761 y0 = it.current_y;
4763 /* The amount of pixels we have to move back is the window
4764 height minus what's displayed in the line containing PT,
4765 and the lines below. */
4766 nlines = - XINT (arg) - 1;
4767 move_it_by_lines (&it, nlines, 1);
4769 y1 = line_bottom_y (&it);
4771 /* If we can't move down NLINES lines because we hit
4772 the end of the buffer, count in some empty lines. */
4773 if (it.vpos < nlines)
4774 y1 += (nlines - it.vpos) * CANON_Y_UNIT (it.f);
4776 h = window_box_height (w) - (y1 - y0);
4778 start_display (&it, w, pt);
4779 move_it_vertically (&it, - h);
4780 charpos = IT_CHARPOS (it);
4781 bytepos = IT_BYTEPOS (it);
4783 else
4785 struct position pos;
4786 pos = *vmotion (PT, - XINT (arg), w);
4787 charpos = pos.bufpos;
4788 bytepos = pos.bytepos;
4791 else
4793 struct position pos;
4794 int ht = window_internal_height (w);
4796 if (center_p)
4797 arg = make_number (ht / 2);
4798 else if (XINT (arg) < 0)
4799 arg = make_number (XINT (arg) + ht);
4801 pos = *vmotion (PT, - XINT (arg), w);
4802 charpos = pos.bufpos;
4803 bytepos = pos.bytepos;
4806 /* Set the new window start. */
4807 set_marker_both (w->start, w->buffer, charpos, bytepos);
4808 w->window_end_valid = Qnil;
4810 w->optional_new_start = Qt;
4812 if (bytepos == BEGV_BYTE || FETCH_BYTE (bytepos - 1) == '\n')
4813 w->start_at_line_beg = Qt;
4814 else
4815 w->start_at_line_beg = Qnil;
4817 set_buffer_internal (obuf);
4818 return Qnil;
4822 DEFUN ("window-text-height", Fwindow_text_height, Swindow_text_height,
4823 0, 1, 0,
4824 doc: /* Return the height in lines of the text display area of WINDOW.
4825 This doesn't include the mode-line (or header-line if any) or any
4826 partial-height lines in the text display area. */)
4827 (window)
4828 Lisp_Object window;
4830 struct window *w = decode_window (window);
4831 int pixel_height = window_box_height (w);
4832 int line_height = pixel_height / CANON_Y_UNIT (XFRAME (w->frame));
4833 return make_number (line_height);
4838 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
4839 1, 1, "P",
4840 doc: /* Position point relative to window.
4841 With no argument, position point at center of window.
4842 An argument specifies vertical position within the window;
4843 zero means top of window, negative means relative to bottom of window. */)
4844 (arg)
4845 Lisp_Object arg;
4847 struct window *w = XWINDOW (selected_window);
4848 int lines, start;
4849 Lisp_Object window;
4851 window = selected_window;
4852 start = marker_position (w->start);
4853 if (start < BEGV || start > ZV)
4855 int height = window_internal_height (w);
4856 Fvertical_motion (make_number (- (height / 2)), window);
4857 set_marker_both (w->start, w->buffer, PT, PT_BYTE);
4858 w->start_at_line_beg = Fbolp ();
4859 w->force_start = Qt;
4861 else
4862 Fgoto_char (w->start);
4864 lines = displayed_window_lines (w);
4865 if (NILP (arg))
4866 XSETFASTINT (arg, lines / 2);
4867 else
4869 arg = Fprefix_numeric_value (arg);
4870 if (XINT (arg) < 0)
4871 XSETINT (arg, XINT (arg) + lines);
4874 /* Skip past a partially visible first line. */
4875 if (w->vscroll)
4876 XSETINT (arg, XINT (arg) + 1);
4878 return Fvertical_motion (arg, window);
4883 /***********************************************************************
4884 Window Configuration
4885 ***********************************************************************/
4887 struct save_window_data
4889 EMACS_INT size_from_Lisp_Vector_struct;
4890 struct Lisp_Vector *next_from_Lisp_Vector_struct;
4891 Lisp_Object frame_width, frame_height, frame_menu_bar_lines;
4892 Lisp_Object frame_tool_bar_lines;
4893 Lisp_Object selected_frame;
4894 Lisp_Object current_window;
4895 Lisp_Object current_buffer;
4896 Lisp_Object minibuf_scroll_window;
4897 Lisp_Object minibuf_selected_window;
4898 Lisp_Object root_window;
4899 Lisp_Object focus_frame;
4900 /* Record the values of window-min-width and window-min-height
4901 so that window sizes remain consistent with them. */
4902 Lisp_Object min_width, min_height;
4903 /* A vector, each of whose elements is a struct saved_window
4904 for one window. */
4905 Lisp_Object saved_windows;
4908 /* This is saved as a Lisp_Vector */
4909 struct saved_window
4911 /* these first two must agree with struct Lisp_Vector in lisp.h */
4912 EMACS_INT size_from_Lisp_Vector_struct;
4913 struct Lisp_Vector *next_from_Lisp_Vector_struct;
4915 Lisp_Object window;
4916 Lisp_Object buffer, start, pointm, mark;
4917 Lisp_Object left, top, width, height, hscroll, min_hscroll;
4918 Lisp_Object parent, prev;
4919 Lisp_Object start_at_line_beg;
4920 Lisp_Object display_table;
4921 Lisp_Object orig_top, orig_height;
4924 #define SAVED_WINDOW_VECTOR_SIZE 17 /* Arg to Fmake_vector */
4926 #define SAVED_WINDOW_N(swv,n) \
4927 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
4929 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
4930 doc: /* Return t if OBJECT is a window-configuration object. */)
4931 (object)
4932 Lisp_Object object;
4934 if (WINDOW_CONFIGURATIONP (object))
4935 return Qt;
4936 return Qnil;
4939 DEFUN ("window-configuration-frame", Fwindow_configuration_frame, Swindow_configuration_frame, 1, 1, 0,
4940 doc: /* Return the frame that CONFIG, a window-configuration object, is about. */)
4941 (config)
4942 Lisp_Object config;
4944 register struct save_window_data *data;
4945 struct Lisp_Vector *saved_windows;
4947 if (! WINDOW_CONFIGURATIONP (config))
4948 wrong_type_argument (Qwindow_configuration_p, config);
4950 data = (struct save_window_data *) XVECTOR (config);
4951 saved_windows = XVECTOR (data->saved_windows);
4952 return XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
4955 DEFUN ("set-window-configuration", Fset_window_configuration,
4956 Sset_window_configuration, 1, 1, 0,
4957 doc: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
4958 CONFIGURATION must be a value previously returned
4959 by `current-window-configuration' (which see).
4960 If CONFIGURATION was made from a frame that is now deleted,
4961 only frame-independent values can be restored. In this case,
4962 the return value is nil. Otherwise the value is t. */)
4963 (configuration)
4964 Lisp_Object configuration;
4966 register struct save_window_data *data;
4967 struct Lisp_Vector *saved_windows;
4968 Lisp_Object new_current_buffer;
4969 Lisp_Object frame;
4970 FRAME_PTR f;
4971 int old_point = -1;
4973 while (!WINDOW_CONFIGURATIONP (configuration))
4974 wrong_type_argument (Qwindow_configuration_p, configuration);
4976 data = (struct save_window_data *) XVECTOR (configuration);
4977 saved_windows = XVECTOR (data->saved_windows);
4979 new_current_buffer = data->current_buffer;
4980 if (NILP (XBUFFER (new_current_buffer)->name))
4981 new_current_buffer = Qnil;
4982 else
4983 old_point = BUF_PT (XBUFFER (new_current_buffer));
4985 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
4986 f = XFRAME (frame);
4988 /* If f is a dead frame, don't bother rebuilding its window tree.
4989 However, there is other stuff we should still try to do below. */
4990 if (FRAME_LIVE_P (f))
4992 register struct window *w;
4993 register struct saved_window *p;
4994 struct window *root_window;
4995 struct window **leaf_windows;
4996 int n_leaf_windows;
4997 int k, i, n;
4999 /* If the frame has been resized since this window configuration was
5000 made, we change the frame to the size specified in the
5001 configuration, restore the configuration, and then resize it
5002 back. We keep track of the prevailing height in these variables. */
5003 int previous_frame_height = FRAME_HEIGHT (f);
5004 int previous_frame_width = FRAME_WIDTH (f);
5005 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
5006 int previous_frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
5008 /* The mouse highlighting code could get screwed up
5009 if it runs during this. */
5010 BLOCK_INPUT;
5012 if (XFASTINT (data->frame_height) != previous_frame_height
5013 || XFASTINT (data->frame_width) != previous_frame_width)
5014 change_frame_size (f, XFASTINT (data->frame_height),
5015 XFASTINT (data->frame_width), 0, 0, 0);
5016 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
5017 if (XFASTINT (data->frame_menu_bar_lines)
5018 != previous_frame_menu_bar_lines)
5019 x_set_menu_bar_lines (f, data->frame_menu_bar_lines, make_number (0));
5020 #ifdef HAVE_WINDOW_SYSTEM
5021 if (XFASTINT (data->frame_tool_bar_lines)
5022 != previous_frame_tool_bar_lines)
5023 x_set_tool_bar_lines (f, data->frame_tool_bar_lines, make_number (0));
5024 #endif
5025 #endif
5027 /* "Swap out" point from the selected window
5028 into its buffer. We do this now, before
5029 restoring the window contents, and prevent it from
5030 being done later on when we select a new window. */
5031 if (! NILP (XWINDOW (selected_window)->buffer))
5033 w = XWINDOW (selected_window);
5034 set_marker_both (w->pointm,
5035 w->buffer,
5036 BUF_PT (XBUFFER (w->buffer)),
5037 BUF_PT_BYTE (XBUFFER (w->buffer)));
5040 windows_or_buffers_changed++;
5041 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
5043 /* Problem: Freeing all matrices and later allocating them again
5044 is a serious redisplay flickering problem. What we would
5045 really like to do is to free only those matrices not reused
5046 below. */
5047 root_window = XWINDOW (FRAME_ROOT_WINDOW (f));
5048 leaf_windows
5049 = (struct window **) alloca (count_windows (root_window)
5050 * sizeof (struct window *));
5051 n_leaf_windows = get_leaf_windows (root_window, leaf_windows, 0);
5053 /* Temporarily avoid any problems with windows that are smaller
5054 than they are supposed to be. */
5055 window_min_height = 1;
5056 window_min_width = 1;
5058 /* Kludge Alert!
5059 Mark all windows now on frame as "deleted".
5060 Restoring the new configuration "undeletes" any that are in it.
5062 Save their current buffers in their height fields, since we may
5063 need it later, if a buffer saved in the configuration is now
5064 dead. */
5065 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
5067 for (k = 0; k < saved_windows->size; k++)
5069 p = SAVED_WINDOW_N (saved_windows, k);
5070 w = XWINDOW (p->window);
5071 w->next = Qnil;
5073 if (!NILP (p->parent))
5074 w->parent = SAVED_WINDOW_N (saved_windows,
5075 XFASTINT (p->parent))->window;
5076 else
5077 w->parent = Qnil;
5079 if (!NILP (p->prev))
5081 w->prev = SAVED_WINDOW_N (saved_windows,
5082 XFASTINT (p->prev))->window;
5083 XWINDOW (w->prev)->next = p->window;
5085 else
5087 w->prev = Qnil;
5088 if (!NILP (w->parent))
5090 if (EQ (p->width, XWINDOW (w->parent)->width))
5092 XWINDOW (w->parent)->vchild = p->window;
5093 XWINDOW (w->parent)->hchild = Qnil;
5095 else
5097 XWINDOW (w->parent)->hchild = p->window;
5098 XWINDOW (w->parent)->vchild = Qnil;
5103 /* If we squirreled away the buffer in the window's height,
5104 restore it now. */
5105 if (BUFFERP (w->height))
5106 w->buffer = w->height;
5107 w->left = p->left;
5108 w->top = p->top;
5109 w->width = p->width;
5110 w->height = p->height;
5111 w->hscroll = p->hscroll;
5112 w->min_hscroll = p->min_hscroll;
5113 w->display_table = p->display_table;
5114 w->orig_top = p->orig_top;
5115 w->orig_height = p->orig_height;
5116 XSETFASTINT (w->last_modified, 0);
5117 XSETFASTINT (w->last_overlay_modified, 0);
5119 /* Reinstall the saved buffer and pointers into it. */
5120 if (NILP (p->buffer))
5121 w->buffer = p->buffer;
5122 else
5124 if (!NILP (XBUFFER (p->buffer)->name))
5125 /* If saved buffer is alive, install it. */
5127 w->buffer = p->buffer;
5128 w->start_at_line_beg = p->start_at_line_beg;
5129 set_marker_restricted (w->start, p->start, w->buffer);
5130 set_marker_restricted (w->pointm, p->pointm, w->buffer);
5131 Fset_marker (XBUFFER (w->buffer)->mark,
5132 p->mark, w->buffer);
5134 /* As documented in Fcurrent_window_configuration, don't
5135 restore the location of point in the buffer which was
5136 current when the window configuration was recorded. */
5137 if (!EQ (p->buffer, new_current_buffer)
5138 && XBUFFER (p->buffer) == current_buffer)
5139 Fgoto_char (w->pointm);
5141 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
5142 /* Else unless window has a live buffer, get one. */
5144 w->buffer = Fcdr (Fcar (Vbuffer_alist));
5145 /* This will set the markers to beginning of visible
5146 range. */
5147 set_marker_restricted (w->start, make_number (0), w->buffer);
5148 set_marker_restricted (w->pointm, make_number (0),w->buffer);
5149 w->start_at_line_beg = Qt;
5151 else
5152 /* Keeping window's old buffer; make sure the markers
5153 are real. */
5155 /* Set window markers at start of visible range. */
5156 if (XMARKER (w->start)->buffer == 0)
5157 set_marker_restricted (w->start, make_number (0),
5158 w->buffer);
5159 if (XMARKER (w->pointm)->buffer == 0)
5160 set_marker_restricted_both (w->pointm, w->buffer,
5161 BUF_PT (XBUFFER (w->buffer)),
5162 BUF_PT_BYTE (XBUFFER (w->buffer)));
5163 w->start_at_line_beg = Qt;
5168 FRAME_ROOT_WINDOW (f) = data->root_window;
5169 /* Prevent "swapping out point" in the old selected window
5170 using the buffer that has been restored into it.
5171 Use the point value from the beginning of this function
5172 since unshow_buffer (called from delete_all_subwindows)
5173 could have altered it. */
5174 selected_window = Qnil;
5175 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer))
5176 set_marker_restricted (XWINDOW (data->current_window)->pointm,
5177 make_number (old_point),
5178 XWINDOW (data->current_window)->buffer);
5180 Fselect_window (data->current_window);
5181 XBUFFER (XWINDOW (selected_window)->buffer)->last_selected_window
5182 = selected_window;
5184 if (NILP (data->focus_frame)
5185 || (FRAMEP (data->focus_frame)
5186 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
5187 Fredirect_frame_focus (frame, data->focus_frame);
5189 #if 0 /* I don't understand why this is needed, and it causes problems
5190 when the frame's old selected window has been deleted. */
5191 if (f != selected_frame && FRAME_WINDOW_P (f))
5192 do_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)),
5193 0, 0);
5194 #endif
5196 /* Set the screen height to the value it had before this function. */
5197 if (previous_frame_height != FRAME_HEIGHT (f)
5198 || previous_frame_width != FRAME_WIDTH (f))
5199 change_frame_size (f, previous_frame_height, previous_frame_width,
5200 0, 0, 0);
5201 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
5202 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
5203 x_set_menu_bar_lines (f, make_number (previous_frame_menu_bar_lines),
5204 make_number (0));
5205 #ifdef HAVE_WINDOW_SYSTEM
5206 if (previous_frame_tool_bar_lines != FRAME_TOOL_BAR_LINES (f))
5207 x_set_tool_bar_lines (f, make_number (previous_frame_tool_bar_lines),
5208 make_number (0));
5209 #endif
5210 #endif
5212 /* Now, free glyph matrices in windows that were not reused. */
5213 for (i = n = 0; i < n_leaf_windows; ++i)
5215 if (NILP (leaf_windows[i]->buffer))
5217 /* Assert it's not reused as a combination. */
5218 xassert (NILP (leaf_windows[i]->hchild)
5219 && NILP (leaf_windows[i]->vchild));
5220 free_window_matrices (leaf_windows[i]);
5222 else if (EQ (leaf_windows[i]->buffer, new_current_buffer))
5223 ++n;
5226 adjust_glyphs (f);
5228 UNBLOCK_INPUT;
5230 /* Fselect_window will have made f the selected frame, so we
5231 reselect the proper frame here. Fhandle_switch_frame will change the
5232 selected window too, but that doesn't make the call to
5233 Fselect_window above totally superfluous; it still sets f's
5234 selected window. */
5235 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
5236 do_switch_frame (data->selected_frame, 0, 0);
5238 if (! NILP (Vwindow_configuration_change_hook)
5239 && ! NILP (Vrun_hooks))
5240 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
5243 if (!NILP (new_current_buffer))
5244 Fset_buffer (new_current_buffer);
5246 /* Restore the minimum heights recorded in the configuration. */
5247 window_min_height = XINT (data->min_height);
5248 window_min_width = XINT (data->min_width);
5250 Vminibuf_scroll_window = data->minibuf_scroll_window;
5251 minibuf_selected_window = data->minibuf_selected_window;
5253 return (FRAME_LIVE_P (f) ? Qt : Qnil);
5256 /* Mark all windows now on frame as deleted
5257 by setting their buffers to nil. */
5259 void
5260 delete_all_subwindows (w)
5261 register struct window *w;
5263 if (!NILP (w->next))
5264 delete_all_subwindows (XWINDOW (w->next));
5265 if (!NILP (w->vchild))
5266 delete_all_subwindows (XWINDOW (w->vchild));
5267 if (!NILP (w->hchild))
5268 delete_all_subwindows (XWINDOW (w->hchild));
5270 w->height = w->buffer; /* See Fset_window_configuration for excuse. */
5272 if (!NILP (w->buffer))
5273 unshow_buffer (w);
5275 /* We set all three of these fields to nil, to make sure that we can
5276 distinguish this dead window from any live window. Live leaf
5277 windows will have buffer set, and combination windows will have
5278 vchild or hchild set. */
5279 w->buffer = Qnil;
5280 w->vchild = Qnil;
5281 w->hchild = Qnil;
5283 Vwindow_list = Qnil;
5286 static int
5287 count_windows (window)
5288 register struct window *window;
5290 register int count = 1;
5291 if (!NILP (window->next))
5292 count += count_windows (XWINDOW (window->next));
5293 if (!NILP (window->vchild))
5294 count += count_windows (XWINDOW (window->vchild));
5295 if (!NILP (window->hchild))
5296 count += count_windows (XWINDOW (window->hchild));
5297 return count;
5301 /* Fill vector FLAT with leaf windows under W, starting at index I.
5302 Value is last index + 1. */
5304 static int
5305 get_leaf_windows (w, flat, i)
5306 struct window *w;
5307 struct window **flat;
5308 int i;
5310 while (w)
5312 if (!NILP (w->hchild))
5313 i = get_leaf_windows (XWINDOW (w->hchild), flat, i);
5314 else if (!NILP (w->vchild))
5315 i = get_leaf_windows (XWINDOW (w->vchild), flat, i);
5316 else
5317 flat[i++] = w;
5319 w = NILP (w->next) ? 0 : XWINDOW (w->next);
5322 return i;
5326 /* Return a pointer to the glyph W's physical cursor is on. Value is
5327 null if W's current matrix is invalid, so that no meaningfull glyph
5328 can be returned. */
5330 struct glyph *
5331 get_phys_cursor_glyph (w)
5332 struct window *w;
5334 struct glyph_row *row;
5335 struct glyph *glyph;
5337 if (w->phys_cursor.vpos >= 0
5338 && w->phys_cursor.vpos < w->current_matrix->nrows
5339 && (row = MATRIX_ROW (w->current_matrix, w->phys_cursor.vpos),
5340 row->enabled_p)
5341 && row->used[TEXT_AREA] > w->phys_cursor.hpos)
5342 glyph = row->glyphs[TEXT_AREA] + w->phys_cursor.hpos;
5343 else
5344 glyph = NULL;
5346 return glyph;
5350 static int
5351 save_window_save (window, vector, i)
5352 Lisp_Object window;
5353 struct Lisp_Vector *vector;
5354 int i;
5356 register struct saved_window *p;
5357 register struct window *w;
5358 register Lisp_Object tem;
5360 for (;!NILP (window); window = w->next)
5362 p = SAVED_WINDOW_N (vector, i);
5363 w = XWINDOW (window);
5365 XSETFASTINT (w->temslot, i++);
5366 p->window = window;
5367 p->buffer = w->buffer;
5368 p->left = w->left;
5369 p->top = w->top;
5370 p->width = w->width;
5371 p->height = w->height;
5372 p->hscroll = w->hscroll;
5373 p->min_hscroll = w->min_hscroll;
5374 p->display_table = w->display_table;
5375 p->orig_top = w->orig_top;
5376 p->orig_height = w->orig_height;
5377 if (!NILP (w->buffer))
5379 /* Save w's value of point in the window configuration.
5380 If w is the selected window, then get the value of point
5381 from the buffer; pointm is garbage in the selected window. */
5382 if (EQ (window, selected_window))
5384 p->pointm = Fmake_marker ();
5385 set_marker_both (p->pointm, w->buffer,
5386 BUF_PT (XBUFFER (w->buffer)),
5387 BUF_PT_BYTE (XBUFFER (w->buffer)));
5389 else
5390 p->pointm = Fcopy_marker (w->pointm, Qnil);
5392 p->start = Fcopy_marker (w->start, Qnil);
5393 p->start_at_line_beg = w->start_at_line_beg;
5395 tem = XBUFFER (w->buffer)->mark;
5396 p->mark = Fcopy_marker (tem, Qnil);
5398 else
5400 p->pointm = Qnil;
5401 p->start = Qnil;
5402 p->mark = Qnil;
5403 p->start_at_line_beg = Qnil;
5406 if (NILP (w->parent))
5407 p->parent = Qnil;
5408 else
5409 p->parent = XWINDOW (w->parent)->temslot;
5411 if (NILP (w->prev))
5412 p->prev = Qnil;
5413 else
5414 p->prev = XWINDOW (w->prev)->temslot;
5416 if (!NILP (w->vchild))
5417 i = save_window_save (w->vchild, vector, i);
5418 if (!NILP (w->hchild))
5419 i = save_window_save (w->hchild, vector, i);
5422 return i;
5425 DEFUN ("current-window-configuration", Fcurrent_window_configuration,
5426 Scurrent_window_configuration, 0, 1, 0,
5427 doc: /* Return an object representing the current window configuration of FRAME.
5428 If FRAME is nil or omitted, use the selected frame.
5429 This describes the number of windows, their sizes and current buffers,
5430 and for each displayed buffer, where display starts, and the positions of
5431 point and mark. An exception is made for point in the current buffer:
5432 its value is -not- saved.
5433 This also records the currently selected frame, and FRAME's focus
5434 redirection (see `redirect-frame-focus'). */)
5435 (frame)
5436 Lisp_Object frame;
5438 register Lisp_Object tem;
5439 register int n_windows;
5440 register struct save_window_data *data;
5441 register struct Lisp_Vector *vec;
5442 register int i;
5443 FRAME_PTR f;
5445 if (NILP (frame))
5446 frame = selected_frame;
5447 CHECK_LIVE_FRAME (frame);
5448 f = XFRAME (frame);
5450 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
5451 vec = allocate_other_vector (VECSIZE (struct save_window_data));
5452 data = (struct save_window_data *)vec;
5454 XSETFASTINT (data->frame_width, FRAME_WIDTH (f));
5455 XSETFASTINT (data->frame_height, FRAME_HEIGHT (f));
5456 XSETFASTINT (data->frame_menu_bar_lines, FRAME_MENU_BAR_LINES (f));
5457 XSETFASTINT (data->frame_tool_bar_lines, FRAME_TOOL_BAR_LINES (f));
5458 data->selected_frame = selected_frame;
5459 data->current_window = FRAME_SELECTED_WINDOW (f);
5460 XSETBUFFER (data->current_buffer, current_buffer);
5461 data->minibuf_scroll_window = minibuf_level > 0 ? Vminibuf_scroll_window : Qnil;
5462 data->minibuf_selected_window = minibuf_level > 0 ? minibuf_selected_window : Qnil;
5463 data->root_window = FRAME_ROOT_WINDOW (f);
5464 data->focus_frame = FRAME_FOCUS_FRAME (f);
5465 XSETINT (data->min_height, window_min_height);
5466 XSETINT (data->min_width, window_min_width);
5467 tem = Fmake_vector (make_number (n_windows), Qnil);
5468 data->saved_windows = tem;
5469 for (i = 0; i < n_windows; i++)
5470 XVECTOR (tem)->contents[i]
5471 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE), Qnil);
5472 save_window_save (FRAME_ROOT_WINDOW (f), XVECTOR (tem), 0);
5473 XSETWINDOW_CONFIGURATION (tem, data);
5474 return (tem);
5477 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
5478 0, UNEVALLED, 0,
5479 doc: /* Execute body, preserving window sizes and contents.
5480 Restore which buffer appears in which window, where display starts,
5481 and the value of point and mark for each window.
5482 Also restore the choice of selected window.
5483 Also restore which buffer is current.
5484 Does not restore the value of point in current buffer.
5485 usage: (save-window-excursion BODY ...) */)
5486 (args)
5487 Lisp_Object args;
5489 register Lisp_Object val;
5490 register int count = SPECPDL_INDEX ();
5492 record_unwind_protect (Fset_window_configuration,
5493 Fcurrent_window_configuration (Qnil));
5494 val = Fprogn (args);
5495 return unbind_to (count, val);
5499 /***********************************************************************
5500 Marginal Areas
5501 ***********************************************************************/
5503 DEFUN ("set-window-margins", Fset_window_margins, Sset_window_margins,
5504 2, 3, 0,
5505 doc: /* Set width of marginal areas of window WINDOW.
5506 If window is nil, set margins of the currently selected window.
5507 First parameter LEFT-WIDTH specifies the number of character
5508 cells to reserve for the left marginal area. Second parameter
5509 RIGHT-WIDTH does the same for the right marginal area.
5510 A nil width parameter means no margin. */)
5511 (window, left, right)
5512 Lisp_Object window, left, right;
5514 struct window *w = decode_window (window);
5516 if (!NILP (left))
5517 CHECK_NUMBER_OR_FLOAT (left);
5518 if (!NILP (right))
5519 CHECK_NUMBER_OR_FLOAT (right);
5521 /* Check widths < 0 and translate a zero width to nil.
5522 Margins that are too wide have to be checked elsewhere. */
5523 if ((INTEGERP (left) && XINT (left) < 0)
5524 || (FLOATP (left) && XFLOAT_DATA (left) <= 0))
5525 XSETFASTINT (left, 0);
5526 if (INTEGERP (left) && XFASTINT (left) == 0)
5527 left = Qnil;
5529 if ((INTEGERP (right) && XINT (right) < 0)
5530 || (FLOATP (right) && XFLOAT_DATA (right) <= 0))
5531 XSETFASTINT (right, 0);
5532 if (INTEGERP (right) && XFASTINT (right) == 0)
5533 right = Qnil;
5535 w->left_margin_width = left;
5536 w->right_margin_width = right;
5538 ++windows_or_buffers_changed;
5539 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
5540 return Qnil;
5544 DEFUN ("window-margins", Fwindow_margins, Swindow_margins,
5545 0, 1, 0,
5546 doc: /* Get width of marginal areas of window WINDOW.
5547 If WINDOW is omitted or nil, use the currently selected window.
5548 Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
5549 If a marginal area does not exist, its width will be returned
5550 as nil. */)
5551 (window)
5552 Lisp_Object window;
5554 struct window *w = decode_window (window);
5555 return Fcons (w->left_margin_width, w->right_margin_width);
5560 /***********************************************************************
5561 Smooth scrolling
5562 ***********************************************************************/
5564 DEFUN ("window-vscroll", Fwindow_vscroll, Swindow_vscroll, 0, 1, 0,
5565 doc: /* Return the amount by which WINDOW is scrolled vertically.
5566 Use the selected window if WINDOW is nil or omitted.
5567 Value is a multiple of the canonical character height of WINDOW. */)
5568 (window)
5569 Lisp_Object window;
5571 Lisp_Object result;
5572 struct frame *f;
5573 struct window *w;
5575 if (NILP (window))
5576 window = selected_window;
5577 else
5578 CHECK_WINDOW (window);
5579 w = XWINDOW (window);
5580 f = XFRAME (w->frame);
5582 if (FRAME_WINDOW_P (f))
5583 result = CANON_Y_FROM_PIXEL_Y (f, -w->vscroll);
5584 else
5585 result = make_number (0);
5586 return result;
5590 DEFUN ("set-window-vscroll", Fset_window_vscroll, Sset_window_vscroll,
5591 2, 2, 0,
5592 doc: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
5593 WINDOW nil means use the selected window. VSCROLL is a non-negative
5594 multiple of the canonical character height of WINDOW. */)
5595 (window, vscroll)
5596 Lisp_Object window, vscroll;
5598 struct window *w;
5599 struct frame *f;
5601 if (NILP (window))
5602 window = selected_window;
5603 else
5604 CHECK_WINDOW (window);
5605 CHECK_NUMBER_OR_FLOAT (vscroll);
5607 w = XWINDOW (window);
5608 f = XFRAME (w->frame);
5610 if (FRAME_WINDOW_P (f))
5612 int old_dy = w->vscroll;
5614 w->vscroll = - CANON_Y_UNIT (f) * XFLOATINT (vscroll);
5615 w->vscroll = min (w->vscroll, 0);
5617 /* Adjust glyph matrix of the frame if the virtual display
5618 area becomes larger than before. */
5619 if (w->vscroll < 0 && w->vscroll < old_dy)
5620 adjust_glyphs (f);
5622 /* Prevent redisplay shortcuts. */
5623 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
5626 return Fwindow_vscroll (window);
5630 /* Call FN for all leaf windows on frame F. FN is called with the
5631 first argument being a pointer to the leaf window, and with
5632 additional argument USER_DATA. Stops when FN returns 0. */
5634 void
5635 foreach_window (f, fn, user_data)
5636 struct frame *f;
5637 int (* fn) P_ ((struct window *, void *));
5638 void *user_data;
5640 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f)), fn, user_data);
5644 /* Helper function for foreach_window. Call FN for all leaf windows
5645 reachable from W. FN is called with the first argument being a
5646 pointer to the leaf window, and with additional argument USER_DATA.
5647 Stop when FN returns 0. Value is 0 if stopped by FN. */
5649 static int
5650 foreach_window_1 (w, fn, user_data)
5651 struct window *w;
5652 int (* fn) P_ ((struct window *, void *));
5653 void *user_data;
5655 int cont;
5657 for (cont = 1; w && cont;)
5659 if (!NILP (w->hchild))
5660 cont = foreach_window_1 (XWINDOW (w->hchild), fn, user_data);
5661 else if (!NILP (w->vchild))
5662 cont = foreach_window_1 (XWINDOW (w->vchild), fn, user_data);
5663 else
5664 cont = fn (w, user_data);
5666 w = NILP (w->next) ? 0 : XWINDOW (w->next);
5669 return cont;
5673 /* Freeze or unfreeze the window start of W unless it is a
5674 mini-window or the selected window. FREEZE_P non-null means freeze
5675 the window start. */
5677 static int
5678 freeze_window_start (w, freeze_p)
5679 struct window *w;
5680 void *freeze_p;
5682 if (w == XWINDOW (selected_window)
5683 || MINI_WINDOW_P (w)
5684 || (MINI_WINDOW_P (XWINDOW (selected_window))
5685 && ! NILP (Vminibuf_scroll_window)
5686 && w == XWINDOW (Vminibuf_scroll_window)))
5687 freeze_p = NULL;
5689 w->frozen_window_start_p = freeze_p != NULL;
5690 return 1;
5694 /* Freeze or unfreeze the window starts of all leaf windows on frame
5695 F, except the selected window and a mini-window. FREEZE_P non-zero
5696 means freeze the window start. */
5698 void
5699 freeze_window_starts (f, freeze_p)
5700 struct frame *f;
5701 int freeze_p;
5703 foreach_window (f, freeze_window_start, (void *) (freeze_p ? f : 0));
5707 /***********************************************************************
5708 Initialization
5709 ***********************************************************************/
5711 /* Return 1 if window configurations C1 and C2
5712 describe the same state of affairs. This is used by Fequal. */
5715 compare_window_configurations (c1, c2, ignore_positions)
5716 Lisp_Object c1, c2;
5717 int ignore_positions;
5719 register struct save_window_data *d1, *d2;
5720 struct Lisp_Vector *sw1, *sw2;
5721 int i;
5723 if (!WINDOW_CONFIGURATIONP (c1))
5724 wrong_type_argument (Qwindow_configuration_p, c1);
5725 if (!WINDOW_CONFIGURATIONP (c2))
5726 wrong_type_argument (Qwindow_configuration_p, c2);
5728 d1 = (struct save_window_data *) XVECTOR (c1);
5729 d2 = (struct save_window_data *) XVECTOR (c2);
5730 sw1 = XVECTOR (d1->saved_windows);
5731 sw2 = XVECTOR (d2->saved_windows);
5733 if (! EQ (d1->frame_width, d2->frame_width))
5734 return 0;
5735 if (! EQ (d1->frame_height, d2->frame_height))
5736 return 0;
5737 if (! EQ (d1->frame_menu_bar_lines, d2->frame_menu_bar_lines))
5738 return 0;
5739 if (! EQ (d1->selected_frame, d2->selected_frame))
5740 return 0;
5741 /* Don't compare the current_window field directly.
5742 Instead see w1_is_current and w2_is_current, below. */
5743 if (! EQ (d1->current_buffer, d2->current_buffer))
5744 return 0;
5745 if (! ignore_positions)
5747 if (! EQ (d1->minibuf_scroll_window, d2->minibuf_scroll_window))
5748 return 0;
5749 if (! EQ (d1->minibuf_selected_window, d2->minibuf_selected_window))
5750 return 0;
5752 /* Don't compare the root_window field.
5753 We don't require the two configurations
5754 to use the same window object,
5755 and the two root windows must be equivalent
5756 if everything else compares equal. */
5757 if (! EQ (d1->focus_frame, d2->focus_frame))
5758 return 0;
5759 if (! EQ (d1->min_width, d2->min_width))
5760 return 0;
5761 if (! EQ (d1->min_height, d2->min_height))
5762 return 0;
5764 /* Verify that the two confis have the same number of windows. */
5765 if (sw1->size != sw2->size)
5766 return 0;
5768 for (i = 0; i < sw1->size; i++)
5770 struct saved_window *p1, *p2;
5771 int w1_is_current, w2_is_current;
5773 p1 = SAVED_WINDOW_N (sw1, i);
5774 p2 = SAVED_WINDOW_N (sw2, i);
5776 /* Verify that the current windows in the two
5777 configurations correspond to each other. */
5778 w1_is_current = EQ (d1->current_window, p1->window);
5779 w2_is_current = EQ (d2->current_window, p2->window);
5781 if (w1_is_current != w2_is_current)
5782 return 0;
5784 /* Verify that the corresponding windows do match. */
5785 if (! EQ (p1->buffer, p2->buffer))
5786 return 0;
5787 if (! EQ (p1->left, p2->left))
5788 return 0;
5789 if (! EQ (p1->top, p2->top))
5790 return 0;
5791 if (! EQ (p1->width, p2->width))
5792 return 0;
5793 if (! EQ (p1->height, p2->height))
5794 return 0;
5795 if (! EQ (p1->display_table, p2->display_table))
5796 return 0;
5797 if (! EQ (p1->parent, p2->parent))
5798 return 0;
5799 if (! EQ (p1->prev, p2->prev))
5800 return 0;
5801 if (! ignore_positions)
5803 if (! EQ (p1->hscroll, p2->hscroll))
5804 return 0;
5805 if (!EQ (p1->min_hscroll, p2->min_hscroll))
5806 return 0;
5807 if (! EQ (p1->start_at_line_beg, p2->start_at_line_beg))
5808 return 0;
5809 if (NILP (Fequal (p1->start, p2->start)))
5810 return 0;
5811 if (NILP (Fequal (p1->pointm, p2->pointm)))
5812 return 0;
5813 if (NILP (Fequal (p1->mark, p2->mark)))
5814 return 0;
5818 return 1;
5821 DEFUN ("compare-window-configurations", Fcompare_window_configurations,
5822 Scompare_window_configurations, 2, 2, 0,
5823 doc: /* Compare two window configurations as regards the structure of windows.
5824 This function ignores details such as the values of point and mark
5825 and scrolling positions. */)
5826 (x, y)
5827 Lisp_Object x, y;
5829 if (compare_window_configurations (x, y, 1))
5830 return Qt;
5831 return Qnil;
5834 void
5835 init_window_once ()
5837 struct frame *f = make_terminal_frame ();
5838 XSETFRAME (selected_frame, f);
5839 Vterminal_frame = selected_frame;
5840 minibuf_window = f->minibuffer_window;
5841 selected_window = f->selected_window;
5842 last_nonminibuf_frame = f;
5844 window_initialized = 1;
5847 void
5848 init_window ()
5850 Vwindow_list = Qnil;
5853 void
5854 syms_of_window ()
5856 Qwindow_size_fixed = intern ("window-size-fixed");
5857 staticpro (&Qwindow_size_fixed);
5859 staticpro (&Qwindow_configuration_change_hook);
5860 Qwindow_configuration_change_hook
5861 = intern ("window-configuration-change-hook");
5863 Qwindowp = intern ("windowp");
5864 staticpro (&Qwindowp);
5866 Qwindow_configuration_p = intern ("window-configuration-p");
5867 staticpro (&Qwindow_configuration_p);
5869 Qwindow_live_p = intern ("window-live-p");
5870 staticpro (&Qwindow_live_p);
5872 Qtemp_buffer_show_hook = intern ("temp-buffer-show-hook");
5873 staticpro (&Qtemp_buffer_show_hook);
5875 staticpro (&Vwindow_list);
5877 minibuf_selected_window = Qnil;
5878 staticpro (&minibuf_selected_window);
5880 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
5881 doc: /* Non-nil means call as function to display a help buffer.
5882 The function is called with one argument, the buffer to be displayed.
5883 Used by `with-output-to-temp-buffer'.
5884 If this function is used, then it must do the entire job of showing
5885 the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
5886 Vtemp_buffer_show_function = Qnil;
5888 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
5889 doc: /* If non-nil, function to call to handle `display-buffer'.
5890 It will receive two args, the buffer and a flag which if non-nil means
5891 that the currently selected window is not acceptable.
5892 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
5893 work using this function. */);
5894 Vdisplay_buffer_function = Qnil;
5896 DEFVAR_LISP ("even-window-heights", &Veven_window_heights,
5897 doc: /* *If non-nil, `display-buffer' should even the window heights.
5898 If nil, `display-buffer' will leave the window configuration alone. */);
5899 Veven_window_heights = Qt;
5901 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
5902 doc: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
5903 Vminibuf_scroll_window = Qnil;
5905 DEFVAR_BOOL ("mode-line-in-non-selected-windows", &mode_line_in_non_selected_windows,
5906 doc: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
5907 If the minibuffer is active, the `minibuffer-scroll-window' mode line
5908 is displayed in the `mode-line' face. */);
5909 mode_line_in_non_selected_windows = 1;
5911 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
5912 doc: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
5913 Vother_window_scroll_buffer = Qnil;
5915 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
5916 doc: /* *Non-nil means `display-buffer' should make a separate frame. */);
5917 pop_up_frames = 0;
5919 DEFVAR_BOOL ("display-buffer-reuse-frames", &display_buffer_reuse_frames,
5920 doc: /* *Non-nil means `display-buffer' should reuse frames.
5921 If the buffer in question is already displayed in a frame, raise that frame. */);
5922 display_buffer_reuse_frames = 0;
5924 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
5925 doc: /* Function to call to handle automatic new frame creation.
5926 It is called with no arguments and should return a newly created frame.
5928 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
5929 where `pop-up-frame-alist' would hold the default frame parameters. */);
5930 Vpop_up_frame_function = Qnil;
5932 DEFVAR_LISP ("special-display-buffer-names", &Vspecial_display_buffer_names,
5933 doc: /* *List of buffer names that should have their own special frames.
5934 Displaying a buffer whose name is in this list makes a special frame for it
5935 using `special-display-function'. See also `special-display-regexps'.
5937 An element of the list can be a list instead of just a string.
5938 There are two ways to use a list as an element:
5939 (BUFFER FRAME-PARAMETERS...) (BUFFER FUNCTION OTHER-ARGS...)
5940 In the first case, FRAME-PARAMETERS are used to create the frame.
5941 In the latter case, FUNCTION is called with BUFFER as the first argument,
5942 followed by OTHER-ARGS--it can display BUFFER in any way it likes.
5943 All this is done by the function found in `special-display-function'.
5945 If this variable appears \"not to work\", because you add a name to it
5946 but that buffer still appears in the selected window, look at the
5947 values of `same-window-buffer-names' and `same-window-regexps'.
5948 Those variables take precedence over this one. */);
5949 Vspecial_display_buffer_names = Qnil;
5951 DEFVAR_LISP ("special-display-regexps", &Vspecial_display_regexps,
5952 doc: /* *List of regexps saying which buffers should have their own special frames.
5953 If a buffer name matches one of these regexps, it gets its own frame.
5954 Displaying a buffer whose name is in this list makes a special frame for it
5955 using `special-display-function'.
5957 An element of the list can be a list instead of just a string.
5958 There are two ways to use a list as an element:
5959 (REGEXP FRAME-PARAMETERS...) (REGEXP FUNCTION OTHER-ARGS...)
5960 In the first case, FRAME-PARAMETERS are used to create the frame.
5961 In the latter case, FUNCTION is called with the buffer as first argument,
5962 followed by OTHER-ARGS--it can display the buffer in any way it likes.
5963 All this is done by the function found in `special-display-function'.
5965 If this variable appears \"not to work\", because you add a regexp to it
5966 but the matching buffers still appear in the selected window, look at the
5967 values of `same-window-buffer-names' and `same-window-regexps'.
5968 Those variables take precedence over this one. */);
5969 Vspecial_display_regexps = Qnil;
5971 DEFVAR_LISP ("special-display-function", &Vspecial_display_function,
5972 doc: /* Function to call to make a new frame for a special buffer.
5973 It is called with two arguments, the buffer and optional buffer specific
5974 data, and should return a window displaying that buffer.
5975 The default value normally makes a separate frame for the buffer,
5976 using `special-display-frame-alist' to specify the frame parameters.
5977 But if the buffer specific data includes (same-buffer . t) then the
5978 buffer is displayed in the current selected window.
5979 Otherwise if it includes (same-frame . t) then the buffer is displayed in
5980 a new window in the currently selected frame.
5982 A buffer is special if it is listed in `special-display-buffer-names'
5983 or matches a regexp in `special-display-regexps'. */);
5984 Vspecial_display_function = Qnil;
5986 DEFVAR_LISP ("same-window-buffer-names", &Vsame_window_buffer_names,
5987 doc: /* *List of buffer names that should appear in the selected window.
5988 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
5989 switches to it in the selected window, rather than making it appear
5990 in some other window.
5992 An element of the list can be a cons cell instead of just a string.
5993 Then the car must be a string, which specifies the buffer name.
5994 This is for compatibility with `special-display-buffer-names';
5995 the cdr of the cons cell is ignored.
5997 See also `same-window-regexps'. */);
5998 Vsame_window_buffer_names = Qnil;
6000 DEFVAR_LISP ("same-window-regexps", &Vsame_window_regexps,
6001 doc: /* *List of regexps saying which buffers should appear in the selected window.
6002 If a buffer name matches one of these regexps, then displaying it
6003 using `display-buffer' or `pop-to-buffer' switches to it
6004 in the selected window, rather than making it appear in some other window.
6006 An element of the list can be a cons cell instead of just a string.
6007 Then the car must be a string, which specifies the buffer name.
6008 This is for compatibility with `special-display-buffer-names';
6009 the cdr of the cons cell is ignored.
6011 See also `same-window-buffer-names'. */);
6012 Vsame_window_regexps = Qnil;
6014 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
6015 doc: /* *Non-nil means display-buffer should make new windows. */);
6016 pop_up_windows = 1;
6018 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
6019 doc: /* *Number of lines of continuity when scrolling by screenfuls. */);
6020 next_screen_context_lines = 2;
6022 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
6023 doc: /* *display-buffer would prefer to split the largest window if this large.
6024 If there is only one window, it is split regardless of this value. */);
6025 split_height_threshold = 500;
6027 DEFVAR_INT ("window-min-height", &window_min_height,
6028 doc: /* *Delete any window less than this tall (including its mode line). */);
6029 window_min_height = 4;
6031 DEFVAR_INT ("window-min-width", &window_min_width,
6032 doc: /* *Delete any window less than this wide. */);
6033 window_min_width = 10;
6035 DEFVAR_LISP ("scroll-preserve-screen-position",
6036 &Vscroll_preserve_screen_position,
6037 doc: /* *Non-nil means scroll commands move point to keep its screen line unchanged. */);
6038 Vscroll_preserve_screen_position = Qnil;
6040 DEFVAR_LISP ("window-configuration-change-hook",
6041 &Vwindow_configuration_change_hook,
6042 doc: /* Functions to call when window configuration changes.
6043 The selected frame is the one whose configuration has changed. */);
6044 Vwindow_configuration_change_hook = Qnil;
6046 DEFVAR_BOOL ("window-size-fixed", &window_size_fixed,
6047 doc: /* Non-nil in a buffer means windows displaying the buffer are fixed-size.
6048 Emacs won't change the size of any window displaying that buffer,
6049 unless you explicitly change the size, or Emacs has no other choice.
6050 This variable automatically becomes buffer-local when set. */);
6051 Fmake_variable_buffer_local (Qwindow_size_fixed);
6052 window_size_fixed = 0;
6054 defsubr (&Sselected_window);
6055 defsubr (&Sminibuffer_window);
6056 defsubr (&Swindow_minibuffer_p);
6057 defsubr (&Swindowp);
6058 defsubr (&Swindow_live_p);
6059 defsubr (&Spos_visible_in_window_p);
6060 defsubr (&Swindow_buffer);
6061 defsubr (&Swindow_height);
6062 defsubr (&Swindow_width);
6063 defsubr (&Swindow_hscroll);
6064 defsubr (&Sset_window_hscroll);
6065 defsubr (&Swindow_redisplay_end_trigger);
6066 defsubr (&Sset_window_redisplay_end_trigger);
6067 defsubr (&Swindow_edges);
6068 defsubr (&Scoordinates_in_window_p);
6069 defsubr (&Swindow_at);
6070 defsubr (&Swindow_point);
6071 defsubr (&Swindow_start);
6072 defsubr (&Swindow_end);
6073 defsubr (&Sset_window_point);
6074 defsubr (&Sset_window_start);
6075 defsubr (&Swindow_dedicated_p);
6076 defsubr (&Sset_window_dedicated_p);
6077 defsubr (&Swindow_display_table);
6078 defsubr (&Sset_window_display_table);
6079 defsubr (&Snext_window);
6080 defsubr (&Sprevious_window);
6081 defsubr (&Sother_window);
6082 defsubr (&Sget_lru_window);
6083 defsubr (&Sget_largest_window);
6084 defsubr (&Sget_buffer_window);
6085 defsubr (&Sdelete_other_windows);
6086 defsubr (&Sdelete_windows_on);
6087 defsubr (&Sreplace_buffer_in_windows);
6088 defsubr (&Sdelete_window);
6089 defsubr (&Sset_window_buffer);
6090 defsubr (&Sselect_window);
6091 defsubr (&Sspecial_display_p);
6092 defsubr (&Ssame_window_p);
6093 defsubr (&Sdisplay_buffer);
6094 defsubr (&Ssplit_window);
6095 defsubr (&Senlarge_window);
6096 defsubr (&Sshrink_window);
6097 defsubr (&Sscroll_up);
6098 defsubr (&Sscroll_down);
6099 defsubr (&Sscroll_left);
6100 defsubr (&Sscroll_right);
6101 defsubr (&Sother_window_for_scrolling);
6102 defsubr (&Sscroll_other_window);
6103 defsubr (&Sminibuffer_selected_window);
6104 defsubr (&Srecenter);
6105 defsubr (&Swindow_text_height);
6106 defsubr (&Smove_to_window_line);
6107 defsubr (&Swindow_configuration_p);
6108 defsubr (&Swindow_configuration_frame);
6109 defsubr (&Sset_window_configuration);
6110 defsubr (&Scurrent_window_configuration);
6111 defsubr (&Ssave_window_excursion);
6112 defsubr (&Sset_window_margins);
6113 defsubr (&Swindow_margins);
6114 defsubr (&Swindow_vscroll);
6115 defsubr (&Sset_window_vscroll);
6116 defsubr (&Scompare_window_configurations);
6117 defsubr (&Swindow_list);
6120 void
6121 keys_of_window ()
6123 initial_define_key (control_x_map, '1', "delete-other-windows");
6124 initial_define_key (control_x_map, '2', "split-window");
6125 initial_define_key (control_x_map, '0', "delete-window");
6126 initial_define_key (control_x_map, 'o', "other-window");
6127 initial_define_key (control_x_map, '^', "enlarge-window");
6128 initial_define_key (control_x_map, '<', "scroll-left");
6129 initial_define_key (control_x_map, '>', "scroll-right");
6131 initial_define_key (global_map, Ctl ('V'), "scroll-up");
6132 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
6133 initial_define_key (meta_map, 'v', "scroll-down");
6135 initial_define_key (global_map, Ctl('L'), "recenter");
6136 initial_define_key (meta_map, 'r', "move-to-window-line");