Merge from emacs--devo--0
[emacs.git] / src / window.c
blobd1e3225e1980d7a8f399a0b2b339f9a7128e06ba
1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1996, 1997, 1998, 2000,
4 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
5 Free Software Foundation, Inc.
7 This file is part of GNU Emacs.
9 GNU Emacs is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3, or (at your option)
12 any later version.
14 GNU Emacs is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with GNU Emacs; see the file COPYING. If not, write to
21 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA. */
24 #include <config.h>
25 #include <stdio.h>
27 #include "lisp.h"
28 #include "buffer.h"
29 #include "keyboard.h"
30 #include "keymap.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "commands.h"
34 #include "indent.h"
35 #include "termchar.h"
36 #include "disptab.h"
37 #include "dispextern.h"
38 #include "blockinput.h"
39 #include "intervals.h"
40 #include "termhooks.h" /* For FRAME_TERMINAL. */
42 #ifdef HAVE_X_WINDOWS
43 #include "xterm.h"
44 #endif /* HAVE_X_WINDOWS */
45 #ifdef WINDOWSNT
46 #include "w32term.h"
47 #endif
48 #ifdef MSDOS
49 #include "msdos.h"
50 #endif
51 #ifdef MAC_OS
52 #include "macterm.h"
53 #endif
56 Lisp_Object Qwindowp, Qwindow_live_p, Qwindow_configuration_p;
57 Lisp_Object Qscroll_up, Qscroll_down;
58 Lisp_Object Qwindow_size_fixed;
59 extern Lisp_Object Qleft_margin, Qright_margin;
61 static int displayed_window_lines P_ ((struct window *));
62 static struct window *decode_window P_ ((Lisp_Object));
63 static int count_windows P_ ((struct window *));
64 static int get_leaf_windows P_ ((struct window *, struct window **, int));
65 static void window_scroll P_ ((Lisp_Object, int, int, int));
66 static void window_scroll_pixel_based P_ ((Lisp_Object, int, int, int));
67 static void window_scroll_line_based P_ ((Lisp_Object, int, int, int));
68 static int window_min_size_1 P_ ((struct window *, int));
69 static int window_min_size_2 P_ ((struct window *, int));
70 static int window_min_size P_ ((struct window *, int, int, int *));
71 static void size_window P_ ((Lisp_Object, int, int, int, int, int));
72 static int freeze_window_start P_ ((struct window *, void *));
73 static int window_fixed_size_p P_ ((struct window *, int, int));
74 static void enlarge_window P_ ((Lisp_Object, int, int));
75 static Lisp_Object window_list P_ ((void));
76 static int add_window_to_list P_ ((struct window *, void *));
77 static int candidate_window_p P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
78 Lisp_Object));
79 static Lisp_Object next_window P_ ((Lisp_Object, Lisp_Object,
80 Lisp_Object, int));
81 static void decode_next_window_args P_ ((Lisp_Object *, Lisp_Object *,
82 Lisp_Object *));
83 static int foreach_window_1 P_ ((struct window *,
84 int (* fn) (struct window *, void *),
85 void *));
86 static Lisp_Object window_list_1 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
88 /* This is the window in which the terminal's cursor should
89 be left when nothing is being done with it. This must
90 always be a leaf window, and its buffer is selected by
91 the top level editing loop at the end of each command.
93 This value is always the same as
94 FRAME_SELECTED_WINDOW (selected_frame). */
96 Lisp_Object selected_window;
98 /* A list of all windows for use by next_window and Fwindow_list.
99 Functions creating or deleting windows should invalidate this cache
100 by setting it to nil. */
102 Lisp_Object Vwindow_list;
104 /* The mini-buffer window of the selected frame.
105 Note that you cannot test for mini-bufferness of an arbitrary window
106 by comparing against this; but you can test for mini-bufferness of
107 the selected window. */
109 Lisp_Object minibuf_window;
111 /* Non-nil means it is the window whose mode line should be
112 shown as the selected window when the minibuffer is selected. */
114 Lisp_Object minibuf_selected_window;
116 /* Non-nil means it is the window for C-M-v to scroll
117 when the mini-buffer is selected. */
119 Lisp_Object Vminibuf_scroll_window;
121 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
123 Lisp_Object Vother_window_scroll_buffer;
125 /* Non-nil means it's function to call to display temp buffers. */
127 Lisp_Object Vtemp_buffer_show_function;
129 /* Non-zero means line and page scrolling on tall lines (with images)
130 does partial scrolling by modifying window-vscroll. */
132 int auto_window_vscroll_p;
134 /* Non-zero means to use mode-line-inactive face in all windows but the
135 selected-window and the minibuffer-scroll-window when the
136 minibuffer is active. */
137 int mode_line_in_non_selected_windows;
139 /* If a window gets smaller than either of these, it is removed. */
141 EMACS_INT window_min_height;
142 EMACS_INT window_min_width;
144 /* Nonzero implies Fdisplay_buffer should create windows. */
146 int pop_up_windows;
148 /* Nonzero implies make new frames for Fdisplay_buffer. */
150 int pop_up_frames;
152 /* Nonzero means reuse existing frames for displaying buffers. */
154 int display_buffer_reuse_frames;
156 /* Non-nil means use this function instead of default */
158 Lisp_Object Vpop_up_frame_function;
160 /* Function to call to handle Fdisplay_buffer. */
162 Lisp_Object Vdisplay_buffer_function;
164 /* Non-nil means that Fdisplay_buffer should even the heights of windows. */
166 Lisp_Object Veven_window_heights;
168 /* List of buffer *names* for buffers that should have their own frames. */
170 Lisp_Object Vspecial_display_buffer_names;
172 /* List of regexps for buffer names that should have their own frames. */
174 Lisp_Object Vspecial_display_regexps;
176 /* Function to pop up a special frame. */
178 Lisp_Object Vspecial_display_function;
180 /* List of buffer *names* for buffers to appear in selected window. */
182 Lisp_Object Vsame_window_buffer_names;
184 /* List of regexps for buffer names to appear in selected window. */
186 Lisp_Object Vsame_window_regexps;
188 /* Hook run at end of temp_output_buffer_show. */
190 Lisp_Object Qtemp_buffer_show_hook;
192 /* Fdisplay_buffer always splits the largest window
193 if that window is more than this high. */
195 EMACS_INT split_height_threshold;
197 /* How to split windows (horizontally/vertically/hybrid). */
199 Lisp_Object Vsplit_window_preferred_function;
201 /* Number of lines of continuity in scrolling by screenfuls. */
203 EMACS_INT next_screen_context_lines;
205 /* Incremented for each window created. */
207 static int sequence_number;
209 /* Nonzero after init_window_once has finished. */
211 static int window_initialized;
213 /* Hook to run when window config changes. */
215 Lisp_Object Qwindow_configuration_change_hook;
216 Lisp_Object Vwindow_configuration_change_hook;
218 /* Non-nil means scroll commands try to put point
219 at the same screen height as previously. */
221 Lisp_Object Vscroll_preserve_screen_position;
223 /* Incremented by 1 whenever a window is deleted. */
225 int window_deletion_count;
227 /* Used by the function window_scroll_pixel_based */
229 static int window_scroll_pixel_based_preserve_y;
231 #if 0 /* This isn't used anywhere. */
232 /* Nonzero means we can split a frame even if it is "unsplittable". */
233 static int inhibit_frame_unsplittable;
234 #endif /* 0 */
236 extern EMACS_INT scroll_margin;
238 extern Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
240 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
241 doc: /* Returns t if OBJECT is a window. */)
242 (object)
243 Lisp_Object object;
245 return WINDOWP (object) ? Qt : Qnil;
248 DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
249 doc: /* Returns t if OBJECT is a window which is currently visible. */)
250 (object)
251 Lisp_Object object;
253 return WINDOW_LIVE_P (object) ? Qt : Qnil;
256 Lisp_Object
257 make_window ()
259 Lisp_Object val;
260 register struct window *p;
262 p = allocate_window ();
263 ++sequence_number;
264 XSETFASTINT (p->sequence_number, sequence_number);
265 XSETFASTINT (p->left_col, 0);
266 XSETFASTINT (p->top_line, 0);
267 XSETFASTINT (p->total_lines, 0);
268 XSETFASTINT (p->total_cols, 0);
269 XSETFASTINT (p->hscroll, 0);
270 XSETFASTINT (p->min_hscroll, 0);
271 p->orig_top_line = p->orig_total_lines = Qnil;
272 p->start = Fmake_marker ();
273 p->pointm = Fmake_marker ();
274 XSETFASTINT (p->use_time, 0);
275 p->frame = Qnil;
276 p->display_table = Qnil;
277 p->dedicated = Qnil;
278 p->pseudo_window_p = 0;
279 bzero (&p->cursor, sizeof (p->cursor));
280 bzero (&p->last_cursor, sizeof (p->last_cursor));
281 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
282 p->desired_matrix = p->current_matrix = 0;
283 p->nrows_scale_factor = p->ncols_scale_factor = 1;
284 p->phys_cursor_type = -1;
285 p->phys_cursor_width = -1;
286 p->must_be_updated_p = 0;
287 XSETFASTINT (p->window_end_vpos, 0);
288 XSETFASTINT (p->window_end_pos, 0);
289 p->window_end_valid = Qnil;
290 p->vscroll = 0;
291 XSETWINDOW (val, p);
292 XSETFASTINT (p->last_point, 0);
293 p->frozen_window_start_p = 0;
294 p->last_cursor_off_p = p->cursor_off_p = 0;
295 p->left_margin_cols = Qnil;
296 p->right_margin_cols = Qnil;
297 p->left_fringe_width = Qnil;
298 p->right_fringe_width = Qnil;
299 p->fringes_outside_margins = Qnil;
300 p->scroll_bar_width = Qnil;
301 p->vertical_scroll_bar_type = Qt;
303 Vwindow_list = Qnil;
304 return val;
307 DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
308 doc: /* Return the window that the cursor now appears in and commands apply to. */)
311 return selected_window;
314 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
315 doc: /* Return the window used now for minibuffers.
316 If the optional argument FRAME is specified, return the minibuffer window
317 used by that frame. */)
318 (frame)
319 Lisp_Object frame;
321 if (NILP (frame))
322 frame = selected_frame;
323 CHECK_LIVE_FRAME (frame);
324 return FRAME_MINIBUF_WINDOW (XFRAME (frame));
327 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 0, 1, 0,
328 doc: /* Returns non-nil if WINDOW is a minibuffer window.
329 WINDOW defaults to the selected window. */)
330 (window)
331 Lisp_Object window;
333 struct window *w = decode_window (window);
334 return MINI_WINDOW_P (w) ? Qt : Qnil;
338 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p,
339 Spos_visible_in_window_p, 0, 3, 0,
340 doc: /* Return non-nil if position POS is currently on the frame in WINDOW.
341 Return nil if that position is scrolled vertically out of view.
342 If a character is only partially visible, nil is returned, unless the
343 optional argument PARTIALLY is non-nil.
344 If POS is only out of view because of horizontal scrolling, return non-nil.
345 If POS is t, it specifies the position of the last visible glyph in WINDOW.
346 POS defaults to point in WINDOW; WINDOW defaults to the selected window.
348 If POS is visible, return t if PARTIALLY is nil; if PARTIALLY is non-nil,
349 return value is a list of 2 or 6 elements (X Y [RTOP RBOT ROWH VPOS]),
350 where X and Y are the pixel coordinates relative to the top left corner
351 of the window. The remaining elements are omitted if the character after
352 POS is fully visible; otherwise, RTOP and RBOT are the number of pixels
353 off-window at the top and bottom of the row, ROWH is the height of the
354 display row, and VPOS is the row number (0-based) containing POS. */)
355 (pos, window, partially)
356 Lisp_Object pos, window, partially;
358 register struct window *w;
359 register int posint;
360 register struct buffer *buf;
361 struct text_pos top;
362 Lisp_Object in_window = Qnil;
363 int rtop, rbot, rowh, vpos, fully_p = 1;
364 int x, y;
366 w = decode_window (window);
367 buf = XBUFFER (w->buffer);
368 SET_TEXT_POS_FROM_MARKER (top, w->start);
370 if (EQ (pos, Qt))
371 posint = -1;
372 else if (!NILP (pos))
374 CHECK_NUMBER_COERCE_MARKER (pos);
375 posint = XINT (pos);
377 else if (w == XWINDOW (selected_window))
378 posint = PT;
379 else
380 posint = XMARKER (w->pointm)->charpos;
382 /* If position is above window start or outside buffer boundaries,
383 or if window start is out of range, position is not visible. */
384 if ((EQ (pos, Qt)
385 || (posint >= CHARPOS (top) && posint <= BUF_ZV (buf)))
386 && CHARPOS (top) >= BUF_BEGV (buf)
387 && CHARPOS (top) <= BUF_ZV (buf)
388 && pos_visible_p (w, posint, &x, &y, &rtop, &rbot, &rowh, &vpos)
389 && (fully_p = !rtop && !rbot, (!NILP (partially) || fully_p)))
390 in_window = Qt;
392 if (!NILP (in_window) && !NILP (partially))
394 Lisp_Object part = Qnil;
395 if (!fully_p)
396 part = list4 (make_number (rtop), make_number (rbot),
397 make_number (rowh), make_number (vpos));
398 in_window = Fcons (make_number (x),
399 Fcons (make_number (y), part));
402 return in_window;
405 DEFUN ("window-line-height", Fwindow_line_height,
406 Swindow_line_height, 0, 2, 0,
407 doc: /* Return height in pixels of text line LINE in window WINDOW.
408 If WINDOW is nil or omitted, use selected window.
410 Return height of current line if LINE is omitted or nil. Return height of
411 header or mode line if LINE is `header-line' and `mode-line'.
412 Otherwise, LINE is a text line number starting from 0. A negative number
413 counts from the end of the window.
415 Value is a list (HEIGHT VPOS YPOS OFFBOT), where HEIGHT is the height
416 in pixels of the visible part of the line, VPOS and YPOS are the
417 vertical position in lines and pixels of the line, relative to the top
418 of the first text line, and OFFBOT is the number of off-window pixels at
419 the bottom of the text line. If there are off-window pixels at the top
420 of the (first) text line, YPOS is negative.
422 Return nil if window display is not up-to-date. In that case, use
423 `pos-visible-in-window-p' to obtain the information. */)
424 (line, window)
425 Lisp_Object line, window;
427 register struct window *w;
428 register struct buffer *b;
429 struct glyph_row *row, *end_row;
430 int max_y, crop, i, n;
432 w = decode_window (window);
434 if (noninteractive
435 || w->pseudo_window_p)
436 return Qnil;
438 CHECK_BUFFER (w->buffer);
439 b = XBUFFER (w->buffer);
441 /* Fail if current matrix is not up-to-date. */
442 if (NILP (w->window_end_valid)
443 || current_buffer->clip_changed
444 || current_buffer->prevent_redisplay_optimizations_p
445 || XFASTINT (w->last_modified) < BUF_MODIFF (b)
446 || XFASTINT (w->last_overlay_modified) < BUF_OVERLAY_MODIFF (b))
447 return Qnil;
449 if (NILP (line))
451 i = w->cursor.vpos;
452 if (i < 0 || i >= w->current_matrix->nrows
453 || (row = MATRIX_ROW (w->current_matrix, i), !row->enabled_p))
454 return Qnil;
455 max_y = window_text_bottom_y (w);
456 goto found_row;
459 if (EQ (line, Qheader_line))
461 if (!WINDOW_WANTS_HEADER_LINE_P (w))
462 return Qnil;
463 row = MATRIX_HEADER_LINE_ROW (w->current_matrix);
464 if (!row->enabled_p)
465 return Qnil;
466 return list4 (make_number (row->height),
467 make_number (0), make_number (0),
468 make_number (0));
471 if (EQ (line, Qmode_line))
473 row = MATRIX_MODE_LINE_ROW (w->current_matrix);
474 if (!row->enabled_p)
475 return Qnil;
476 return list4 (make_number (row->height),
477 make_number (0), /* not accurate */
478 make_number (WINDOW_HEADER_LINE_HEIGHT (w)
479 + window_text_bottom_y (w)),
480 make_number (0));
483 CHECK_NUMBER (line);
484 n = XINT (line);
486 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
487 end_row = MATRIX_BOTTOM_TEXT_ROW (w->current_matrix, w);
488 max_y = window_text_bottom_y (w);
489 i = 0;
491 while ((n < 0 || i < n)
492 && row <= end_row && row->enabled_p
493 && row->y + row->height < max_y)
494 row++, i++;
496 if (row > end_row || !row->enabled_p)
497 return Qnil;
499 if (++n < 0)
501 if (-n > i)
502 return Qnil;
503 row += n;
504 i += n;
507 found_row:
508 crop = max (0, (row->y + row->height) - max_y);
509 return list4 (make_number (row->height + min (0, row->y) - crop),
510 make_number (i),
511 make_number (row->y),
512 make_number (crop));
517 static struct window *
518 decode_window (window)
519 register Lisp_Object window;
521 if (NILP (window))
522 return XWINDOW (selected_window);
524 CHECK_LIVE_WINDOW (window);
525 return XWINDOW (window);
528 static struct window *
529 decode_any_window (window)
530 register Lisp_Object window;
532 if (NILP (window))
533 return XWINDOW (selected_window);
535 CHECK_WINDOW (window);
536 return XWINDOW (window);
539 DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
540 doc: /* Return the buffer that WINDOW is displaying.
541 WINDOW defaults to the selected window. */)
542 (window)
543 Lisp_Object window;
545 return decode_window (window)->buffer;
548 DEFUN ("window-height", Fwindow_height, Swindow_height, 0, 1, 0,
549 doc: /* Return the number of lines in WINDOW (including its mode line).
550 WINDOW defaults to the selected window. */)
551 (window)
552 Lisp_Object window;
554 return decode_any_window (window)->total_lines;
557 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
558 doc: /* Return the number of display columns in WINDOW.
559 This is the width that is usable columns available for text in WINDOW.
560 If you want to find out how many columns WINDOW takes up,
561 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))). */)
562 (window)
563 Lisp_Object window;
565 return make_number (window_box_text_cols (decode_any_window (window)));
568 DEFUN ("window-full-width-p", Fwindow_full_width_p, Swindow_full_width_p, 0, 1, 0,
569 doc: /* Return t if WINDOW is as wide as its frame.
570 WINDOW defaults to the selected window. */)
571 (window)
572 Lisp_Object window;
574 return WINDOW_FULL_WIDTH_P (decode_any_window (window)) ? Qt : Qnil;
577 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
578 doc: /* Return the number of columns by which WINDOW is scrolled from left margin.
579 WINDOW defaults to the selected window. */)
580 (window)
581 Lisp_Object window;
583 return decode_window (window)->hscroll;
586 DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
587 doc: /* Set number of columns WINDOW is scrolled from left margin to NCOL.
588 Return NCOL. NCOL should be zero or positive.
590 Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
591 window so that the location of point moves off-window. */)
592 (window, ncol)
593 Lisp_Object window, ncol;
595 struct window *w = decode_window (window);
596 int hscroll;
598 CHECK_NUMBER (ncol);
599 hscroll = max (0, XINT (ncol));
601 /* Prevent redisplay shortcuts when changing the hscroll. */
602 if (XINT (w->hscroll) != hscroll)
603 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
605 w->hscroll = make_number (hscroll);
606 return ncol;
609 DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger,
610 Swindow_redisplay_end_trigger, 0, 1, 0,
611 doc: /* Return WINDOW's redisplay end trigger value.
612 WINDOW defaults to the selected window.
613 See `set-window-redisplay-end-trigger' for more information. */)
614 (window)
615 Lisp_Object window;
617 return decode_window (window)->redisplay_end_trigger;
620 DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger,
621 Sset_window_redisplay_end_trigger, 2, 2, 0,
622 doc: /* Set WINDOW's redisplay end trigger value to VALUE.
623 VALUE should be a buffer position (typically a marker) or nil.
624 If it is a buffer position, then if redisplay in WINDOW reaches a position
625 beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
626 with two arguments: WINDOW, and the end trigger value.
627 Afterwards the end-trigger value is reset to nil. */)
628 (window, value)
629 register Lisp_Object window, value;
631 register struct window *w;
633 w = decode_window (window);
634 w->redisplay_end_trigger = value;
635 return value;
638 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
639 doc: /* Return a list of the edge coordinates of WINDOW.
640 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
641 RIGHT is one more than the rightmost column occupied by WINDOW,
642 and BOTTOM is one more than the bottommost row occupied by WINDOW.
643 The edges include the space used by the window's scroll bar,
644 display margins, fringes, header line, and mode line, if it has them.
645 To get the edges of the actual text area, use `window-inside-edges'. */)
646 (window)
647 Lisp_Object window;
649 register struct window *w = decode_any_window (window);
651 return Fcons (make_number (WINDOW_LEFT_EDGE_COL (w)),
652 Fcons (make_number (WINDOW_TOP_EDGE_LINE (w)),
653 Fcons (make_number (WINDOW_RIGHT_EDGE_COL (w)),
654 Fcons (make_number (WINDOW_BOTTOM_EDGE_LINE (w)),
655 Qnil))));
658 DEFUN ("window-pixel-edges", Fwindow_pixel_edges, Swindow_pixel_edges, 0, 1, 0,
659 doc: /* Return a list of the edge pixel coordinates of WINDOW.
660 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
661 RIGHT is one more than the rightmost x position occupied by WINDOW,
662 and BOTTOM is one more than the bottommost y position occupied by WINDOW.
663 The pixel edges include the space used by the window's scroll bar,
664 display margins, fringes, header line, and mode line, if it has them.
665 To get the edges of the actual text area, use `window-inside-pixel-edges'. */)
666 (window)
667 Lisp_Object window;
669 register struct window *w = decode_any_window (window);
671 return Fcons (make_number (WINDOW_LEFT_EDGE_X (w)),
672 Fcons (make_number (WINDOW_TOP_EDGE_Y (w)),
673 Fcons (make_number (WINDOW_RIGHT_EDGE_X (w)),
674 Fcons (make_number (WINDOW_BOTTOM_EDGE_Y (w)),
675 Qnil))));
678 DEFUN ("window-inside-edges", Fwindow_inside_edges, Swindow_inside_edges, 0, 1, 0,
679 doc: /* Return a list of the edge coordinates of WINDOW.
680 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
681 RIGHT is one more than the rightmost column used by text in WINDOW,
682 and BOTTOM is one more than the bottommost row used by text in WINDOW.
683 The inside edges do not include the space used by the window's scroll bar,
684 display margins, fringes, header line, and/or mode line. */)
685 (window)
686 Lisp_Object window;
688 register struct window *w = decode_any_window (window);
690 return list4 (make_number (WINDOW_BOX_LEFT_EDGE_COL (w)
691 + WINDOW_LEFT_MARGIN_COLS (w)
692 + WINDOW_LEFT_FRINGE_COLS (w)),
693 make_number (WINDOW_TOP_EDGE_LINE (w)
694 + WINDOW_HEADER_LINE_LINES (w)),
695 make_number (WINDOW_BOX_RIGHT_EDGE_COL (w)
696 - WINDOW_RIGHT_MARGIN_COLS (w)
697 - WINDOW_RIGHT_FRINGE_COLS (w)),
698 make_number (WINDOW_BOTTOM_EDGE_LINE (w)
699 - WINDOW_MODE_LINE_LINES (w)));
702 DEFUN ("window-inside-pixel-edges", Fwindow_inside_pixel_edges, Swindow_inside_pixel_edges, 0, 1, 0,
703 doc: /* Return a list of the edge pixel coordinates of WINDOW.
704 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
705 RIGHT is one more than the rightmost x position used by text in WINDOW,
706 and BOTTOM is one more than the bottommost y position used by text in WINDOW.
707 The inside edges do not include the space used by the window's scroll bar,
708 display margins, fringes, header line, and/or mode line. */)
709 (window)
710 Lisp_Object window;
712 register struct window *w = decode_any_window (window);
714 return list4 (make_number (WINDOW_BOX_LEFT_EDGE_X (w)
715 + WINDOW_LEFT_MARGIN_WIDTH (w)
716 + WINDOW_LEFT_FRINGE_WIDTH (w)),
717 make_number (WINDOW_TOP_EDGE_Y (w)
718 + WINDOW_HEADER_LINE_HEIGHT (w)),
719 make_number (WINDOW_BOX_RIGHT_EDGE_X (w)
720 - WINDOW_RIGHT_MARGIN_WIDTH (w)
721 - WINDOW_RIGHT_FRINGE_WIDTH (w)),
722 make_number (WINDOW_BOTTOM_EDGE_Y (w)
723 - WINDOW_MODE_LINE_HEIGHT (w)));
726 /* Test if the character at column *X, row *Y is within window W.
727 If it is not, return ON_NOTHING;
728 if it is in the window's text area,
729 set *x and *y to its location relative to the upper left corner
730 of the window, and
731 return ON_TEXT;
732 if it is on the window's modeline, return ON_MODE_LINE;
733 if it is on the border between the window and its right sibling,
734 return ON_VERTICAL_BORDER.
735 if it is on a scroll bar,
736 return ON_SCROLL_BAR.
737 if it is on the window's top line, return ON_HEADER_LINE;
738 if it is in left or right fringe of the window,
739 return ON_LEFT_FRINGE or ON_RIGHT_FRINGE, and convert *X and *Y
740 to window-relative coordinates;
741 if it is in the marginal area to the left/right of the window,
742 return ON_LEFT_MARGIN or ON_RIGHT_MARGIN, and convert *X and *Y
743 to window-relative coordinates.
745 X and Y are frame relative pixel coordinates. */
747 static enum window_part
748 coordinates_in_window (w, x, y)
749 register struct window *w;
750 register int *x, *y;
752 struct frame *f = XFRAME (WINDOW_FRAME (w));
753 int left_x, right_x, top_y, bottom_y;
754 enum window_part part;
755 int ux = FRAME_COLUMN_WIDTH (f);
756 int x0 = WINDOW_LEFT_EDGE_X (w);
757 int x1 = WINDOW_RIGHT_EDGE_X (w);
758 /* The width of the area where the vertical line can be dragged.
759 (Between mode lines for instance. */
760 int grabbable_width = ux;
761 int lmargin_width, rmargin_width, text_left, text_right;
763 /* In what's below, we subtract 1 when computing right_x because we
764 want the rightmost pixel, which is given by left_pixel+width-1. */
765 if (w->pseudo_window_p)
767 left_x = 0;
768 right_x = WINDOW_TOTAL_WIDTH (w) - 1;
769 top_y = WINDOW_TOP_EDGE_Y (w);
770 bottom_y = WINDOW_BOTTOM_EDGE_Y (w);
772 else
774 left_x = WINDOW_BOX_LEFT_EDGE_X (w);
775 right_x = WINDOW_BOX_RIGHT_EDGE_X (w) - 1;
776 top_y = WINDOW_TOP_EDGE_Y (w);
777 bottom_y = WINDOW_BOTTOM_EDGE_Y (w);
780 /* Outside any interesting row? */
781 if (*y < top_y || *y >= bottom_y)
782 return ON_NOTHING;
784 /* On the mode line or header line? If it's near the start of
785 the mode or header line of window that's has a horizontal
786 sibling, say it's on the vertical line. That's to be able
787 to resize windows horizontally in case we're using toolkit
788 scroll bars. */
790 if (WINDOW_WANTS_MODELINE_P (w)
791 && *y >= bottom_y - CURRENT_MODE_LINE_HEIGHT (w))
793 part = ON_MODE_LINE;
795 header_vertical_border_check:
796 /* We're somewhere on the mode line. We consider the place
797 between mode lines of horizontally adjacent mode lines
798 as the vertical border. If scroll bars on the left,
799 return the right window. */
800 if (WINDOW_HAS_VERTICAL_SCROLL_BAR_ON_LEFT (w)
801 || WINDOW_RIGHTMOST_P (w))
803 if (!WINDOW_LEFTMOST_P (w) && eabs (*x - x0) < grabbable_width)
805 /* Convert X and Y to window relative coordinates.
806 Vertical border is at the left edge of window. */
807 *x = max (0, *x - x0);
808 *y -= top_y;
809 return ON_VERTICAL_BORDER;
812 else
814 if (eabs (*x - x1) < grabbable_width)
816 /* Convert X and Y to window relative coordinates.
817 Vertical border is at the right edge of window. */
818 *x = min (x1, *x) - x0;
819 *y -= top_y;
820 return ON_VERTICAL_BORDER;
824 if (*x < x0 || *x >= x1)
825 return ON_NOTHING;
827 /* Convert X and Y to window relative coordinates.
828 Mode line starts at left edge of window. */
829 *x -= x0;
830 *y -= top_y;
831 return part;
834 if (WINDOW_WANTS_HEADER_LINE_P (w)
835 && *y < top_y + CURRENT_HEADER_LINE_HEIGHT (w))
837 part = ON_HEADER_LINE;
838 goto header_vertical_border_check;
841 if (*x < x0 || *x >= x1)
842 return ON_NOTHING;
844 /* Outside any interesting column? */
845 if (*x < left_x || *x > right_x)
847 *y -= top_y;
848 return ON_SCROLL_BAR;
851 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
852 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
854 text_left = window_box_left (w, TEXT_AREA);
855 text_right = text_left + window_box_width (w, TEXT_AREA);
857 if (FRAME_WINDOW_P (f))
859 if (!w->pseudo_window_p
860 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
861 && !WINDOW_RIGHTMOST_P (w)
862 && (eabs (*x - right_x) < grabbable_width))
864 /* Convert X and Y to window relative coordinates.
865 Vertical border is at the right edge of window. */
866 *x = min (right_x, *x) - left_x;
867 *y -= top_y;
868 return ON_VERTICAL_BORDER;
871 else
873 /* Need to say "*x > right_x" rather than >=, since on character
874 terminals, the vertical line's x coordinate is right_x. */
875 if (!w->pseudo_window_p
876 && !WINDOW_RIGHTMOST_P (w)
877 && *x > right_x - ux)
879 /* On the border on the right side of the window? Assume that
880 this area begins at RIGHT_X minus a canonical char width. */
881 *x = min (right_x, *x) - left_x;
882 *y -= top_y;
883 return ON_VERTICAL_BORDER;
887 if (*x < text_left)
889 if (lmargin_width > 0
890 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
891 ? (*x >= left_x + WINDOW_LEFT_FRINGE_WIDTH (w))
892 : (*x < left_x + lmargin_width)))
894 *x -= left_x;
895 if (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w))
896 *x -= WINDOW_LEFT_FRINGE_WIDTH (w);
897 *y -= top_y;
898 return ON_LEFT_MARGIN;
901 /* Convert X and Y to window-relative pixel coordinates. */
902 *x -= left_x;
903 *y -= top_y;
904 return ON_LEFT_FRINGE;
907 if (*x >= text_right)
909 if (rmargin_width > 0
910 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
911 ? (*x < right_x - WINDOW_RIGHT_FRINGE_WIDTH (w))
912 : (*x >= right_x - rmargin_width)))
914 *x -= right_x - rmargin_width;
915 if (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w))
916 *x += WINDOW_RIGHT_FRINGE_WIDTH (w);
917 *y -= top_y;
918 return ON_RIGHT_MARGIN;
921 /* Convert X and Y to window-relative pixel coordinates. */
922 *x -= left_x + WINDOW_LEFT_FRINGE_WIDTH (w);
923 *y -= top_y;
924 return ON_RIGHT_FRINGE;
927 /* Everything special ruled out - must be on text area */
928 *x -= text_left;
929 *y -= top_y;
930 return ON_TEXT;
934 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
935 Scoordinates_in_window_p, 2, 2, 0,
936 doc: /* Return non-nil if COORDINATES are in WINDOW.
937 COORDINATES is a cons of the form (X . Y), X and Y being distances
938 measured in characters from the upper-left corner of the frame.
939 \(0 . 0) denotes the character in the upper left corner of the
940 frame.
941 If COORDINATES are in the text portion of WINDOW,
942 the coordinates relative to the window are returned.
943 If they are in the mode line of WINDOW, `mode-line' is returned.
944 If they are in the top mode line of WINDOW, `header-line' is returned.
945 If they are in the left fringe of WINDOW, `left-fringe' is returned.
946 If they are in the right fringe of WINDOW, `right-fringe' is returned.
947 If they are on the border between WINDOW and its right sibling,
948 `vertical-line' is returned.
949 If they are in the windows's left or right marginal areas, `left-margin'\n\
950 or `right-margin' is returned. */)
951 (coordinates, window)
952 register Lisp_Object coordinates, window;
954 struct window *w;
955 struct frame *f;
956 int x, y;
957 Lisp_Object lx, ly;
959 CHECK_WINDOW (window);
960 w = XWINDOW (window);
961 f = XFRAME (w->frame);
962 CHECK_CONS (coordinates);
963 lx = Fcar (coordinates);
964 ly = Fcdr (coordinates);
965 CHECK_NUMBER_OR_FLOAT (lx);
966 CHECK_NUMBER_OR_FLOAT (ly);
967 x = FRAME_PIXEL_X_FROM_CANON_X (f, lx) + FRAME_INTERNAL_BORDER_WIDTH (f);
968 y = FRAME_PIXEL_Y_FROM_CANON_Y (f, ly) + FRAME_INTERNAL_BORDER_WIDTH (f);
970 switch (coordinates_in_window (w, &x, &y))
972 case ON_NOTHING:
973 return Qnil;
975 case ON_TEXT:
976 /* X and Y are now window relative pixel coordinates. Convert
977 them to canonical char units before returning them. */
978 return Fcons (FRAME_CANON_X_FROM_PIXEL_X (f, x),
979 FRAME_CANON_Y_FROM_PIXEL_Y (f, y));
981 case ON_MODE_LINE:
982 return Qmode_line;
984 case ON_VERTICAL_BORDER:
985 return Qvertical_line;
987 case ON_HEADER_LINE:
988 return Qheader_line;
990 case ON_LEFT_FRINGE:
991 return Qleft_fringe;
993 case ON_RIGHT_FRINGE:
994 return Qright_fringe;
996 case ON_LEFT_MARGIN:
997 return Qleft_margin;
999 case ON_RIGHT_MARGIN:
1000 return Qright_margin;
1002 case ON_SCROLL_BAR:
1003 /* Historically we are supposed to return nil in this case. */
1004 return Qnil;
1006 default:
1007 abort ();
1012 /* Callback for foreach_window, used in window_from_coordinates.
1013 Check if window W contains coordinates specified by USER_DATA which
1014 is actually a pointer to a struct check_window_data CW.
1016 Check if window W contains coordinates *CW->x and *CW->y. If it
1017 does, return W in *CW->window, as Lisp_Object, and return in
1018 *CW->part the part of the window under coordinates *X,*Y. Return
1019 zero from this function to stop iterating over windows. */
1021 struct check_window_data
1023 Lisp_Object *window;
1024 int *x, *y;
1025 enum window_part *part;
1028 static int
1029 check_window_containing (w, user_data)
1030 struct window *w;
1031 void *user_data;
1033 struct check_window_data *cw = (struct check_window_data *) user_data;
1034 enum window_part found;
1035 int continue_p = 1;
1037 found = coordinates_in_window (w, cw->x, cw->y);
1038 if (found != ON_NOTHING)
1040 *cw->part = found;
1041 XSETWINDOW (*cw->window, w);
1042 continue_p = 0;
1045 return continue_p;
1049 /* Find the window containing frame-relative pixel position X/Y and
1050 return it as a Lisp_Object.
1052 If X, Y is on one of the window's special `window_part' elements,
1053 set *PART to the id of that element, and return X and Y converted
1054 to window relative coordinates in WX and WY.
1056 If there is no window under X, Y return nil and leave *PART
1057 unmodified. TOOL_BAR_P non-zero means detect tool-bar windows.
1059 This function was previously implemented with a loop cycling over
1060 windows with Fnext_window, and starting with the frame's selected
1061 window. It turned out that this doesn't work with an
1062 implementation of next_window using Vwindow_list, because
1063 FRAME_SELECTED_WINDOW (F) is not always contained in the window
1064 tree of F when this function is called asynchronously from
1065 note_mouse_highlight. The original loop didn't terminate in this
1066 case. */
1068 Lisp_Object
1069 window_from_coordinates (f, x, y, part, wx, wy, tool_bar_p)
1070 struct frame *f;
1071 int x, y;
1072 enum window_part *part;
1073 int *wx, *wy;
1074 int tool_bar_p;
1076 Lisp_Object window;
1077 struct check_window_data cw;
1078 enum window_part dummy;
1080 if (part == 0)
1081 part = &dummy;
1083 window = Qnil;
1084 cw.window = &window, cw.x = &x, cw.y = &y; cw.part = part;
1085 foreach_window (f, check_window_containing, &cw);
1087 /* If not found above, see if it's in the tool bar window, if a tool
1088 bar exists. */
1089 if (NILP (window)
1090 && tool_bar_p
1091 && WINDOWP (f->tool_bar_window)
1092 && WINDOW_TOTAL_LINES (XWINDOW (f->tool_bar_window)) > 0
1093 && (coordinates_in_window (XWINDOW (f->tool_bar_window), &x, &y)
1094 != ON_NOTHING))
1096 *part = ON_TEXT;
1097 window = f->tool_bar_window;
1100 if (wx) *wx = x;
1101 if (wy) *wy = y;
1103 return window;
1106 DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
1107 doc: /* Return window containing coordinates X and Y on FRAME.
1108 If omitted, FRAME defaults to the currently selected frame.
1109 The top left corner of the frame is considered to be row 0,
1110 column 0. */)
1111 (x, y, frame)
1112 Lisp_Object x, y, frame;
1114 struct frame *f;
1116 if (NILP (frame))
1117 frame = selected_frame;
1118 CHECK_LIVE_FRAME (frame);
1119 f = XFRAME (frame);
1121 /* Check that arguments are integers or floats. */
1122 CHECK_NUMBER_OR_FLOAT (x);
1123 CHECK_NUMBER_OR_FLOAT (y);
1125 return window_from_coordinates (f,
1126 (FRAME_PIXEL_X_FROM_CANON_X (f, x)
1127 + FRAME_INTERNAL_BORDER_WIDTH (f)),
1128 (FRAME_PIXEL_Y_FROM_CANON_Y (f, y)
1129 + FRAME_INTERNAL_BORDER_WIDTH (f)),
1130 0, 0, 0, 0);
1133 DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
1134 doc: /* Return current value of point in WINDOW.
1135 WINDOW defaults to the selected window.
1137 For a nonselected window, this is the value point would have
1138 if that window were selected.
1140 Note that, when WINDOW is the selected window and its buffer
1141 is also currently selected, the value returned is the same as (point).
1142 It would be more strictly correct to return the `top-level' value
1143 of point, outside of any save-excursion forms.
1144 But that is hard to define. */)
1145 (window)
1146 Lisp_Object window;
1148 register struct window *w = decode_window (window);
1150 if (w == XWINDOW (selected_window)
1151 && current_buffer == XBUFFER (w->buffer))
1152 return Fpoint ();
1153 return Fmarker_position (w->pointm);
1156 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
1157 doc: /* Return position at which display currently starts in WINDOW.
1158 WINDOW defaults to the selected window.
1159 This is updated by redisplay or by calling `set-window-start'. */)
1160 (window)
1161 Lisp_Object window;
1163 return Fmarker_position (decode_window (window)->start);
1166 /* This is text temporarily removed from the doc string below.
1168 This function returns nil if the position is not currently known.
1169 That happens when redisplay is preempted and doesn't finish.
1170 If in that case you want to compute where the end of the window would
1171 have been if redisplay had finished, do this:
1172 (save-excursion
1173 (goto-char (window-start window))
1174 (vertical-motion (1- (window-height window)) window)
1175 (point))") */
1177 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 2, 0,
1178 doc: /* Return position at which display currently ends in WINDOW.
1179 WINDOW defaults to the selected window.
1180 This is updated by redisplay, when it runs to completion.
1181 Simply changing the buffer text or setting `window-start'
1182 does not update this value.
1183 Return nil if there is no recorded value. \(This can happen if the
1184 last redisplay of WINDOW was preempted, and did not finish.)
1185 If UPDATE is non-nil, compute the up-to-date position
1186 if it isn't already recorded. */)
1187 (window, update)
1188 Lisp_Object window, update;
1190 Lisp_Object value;
1191 struct window *w = decode_window (window);
1192 Lisp_Object buf;
1193 struct buffer *b;
1195 buf = w->buffer;
1196 CHECK_BUFFER (buf);
1197 b = XBUFFER (buf);
1199 #if 0 /* This change broke some things. We should make it later. */
1200 /* If we don't know the end position, return nil.
1201 The user can compute it with vertical-motion if he wants to.
1202 It would be nicer to do it automatically,
1203 but that's so slow that it would probably bother people. */
1204 if (NILP (w->window_end_valid))
1205 return Qnil;
1206 #endif
1208 if (! NILP (update)
1209 && ! (! NILP (w->window_end_valid)
1210 && XFASTINT (w->last_modified) >= BUF_MODIFF (b)
1211 && XFASTINT (w->last_overlay_modified) >= BUF_OVERLAY_MODIFF (b))
1212 && !noninteractive)
1214 struct text_pos startp;
1215 struct it it;
1216 struct buffer *old_buffer = NULL;
1218 /* Cannot use Fvertical_motion because that function doesn't
1219 cope with variable-height lines. */
1220 if (b != current_buffer)
1222 old_buffer = current_buffer;
1223 set_buffer_internal (b);
1226 /* In case W->start is out of the range, use something
1227 reasonable. This situation occurred when loading a file with
1228 `-l' containing a call to `rmail' with subsequent other
1229 commands. At the end, W->start happened to be BEG, while
1230 rmail had already narrowed the buffer. */
1231 if (XMARKER (w->start)->charpos < BEGV)
1232 SET_TEXT_POS (startp, BEGV, BEGV_BYTE);
1233 else if (XMARKER (w->start)->charpos > ZV)
1234 SET_TEXT_POS (startp, ZV, ZV_BYTE);
1235 else
1236 SET_TEXT_POS_FROM_MARKER (startp, w->start);
1238 start_display (&it, w, startp);
1239 move_it_vertically (&it, window_box_height (w));
1240 if (it.current_y < it.last_visible_y)
1241 move_it_past_eol (&it);
1242 value = make_number (IT_CHARPOS (it));
1244 if (old_buffer)
1245 set_buffer_internal (old_buffer);
1247 else
1248 XSETINT (value, BUF_Z (b) - XFASTINT (w->window_end_pos));
1250 return value;
1253 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
1254 doc: /* Make point value in WINDOW be at position POS in WINDOW's buffer.
1255 Return POS. */)
1256 (window, pos)
1257 Lisp_Object window, pos;
1259 register struct window *w = decode_window (window);
1261 CHECK_NUMBER_COERCE_MARKER (pos);
1262 if (w == XWINDOW (selected_window)
1263 && XBUFFER (w->buffer) == current_buffer)
1264 Fgoto_char (pos);
1265 else
1266 set_marker_restricted (w->pointm, pos, w->buffer);
1268 /* We have to make sure that redisplay updates the window to show
1269 the new value of point. */
1270 if (!EQ (window, selected_window))
1271 ++windows_or_buffers_changed;
1273 return pos;
1276 DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
1277 doc: /* Make display in WINDOW start at position POS in WINDOW's buffer.
1278 Return POS.
1279 Optional third arg NOFORCE non-nil inhibits next redisplay
1280 from overriding motion of point in order to display at this exact start. */)
1281 (window, pos, noforce)
1282 Lisp_Object window, pos, noforce;
1284 register struct window *w = decode_window (window);
1286 CHECK_NUMBER_COERCE_MARKER (pos);
1287 set_marker_restricted (w->start, pos, w->buffer);
1288 /* this is not right, but much easier than doing what is right. */
1289 w->start_at_line_beg = Qnil;
1290 if (NILP (noforce))
1291 w->force_start = Qt;
1292 w->update_mode_line = Qt;
1293 XSETFASTINT (w->last_modified, 0);
1294 XSETFASTINT (w->last_overlay_modified, 0);
1295 if (!EQ (window, selected_window))
1296 windows_or_buffers_changed++;
1298 return pos;
1301 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
1302 1, 1, 0,
1303 doc: /* Return WINDOW's dedicated object, usually t or nil.
1304 See also `set-window-dedicated-p'. */)
1305 (window)
1306 Lisp_Object window;
1308 return decode_window (window)->dedicated;
1311 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
1312 Sset_window_dedicated_p, 2, 2, 0,
1313 doc: /* Control whether WINDOW is dedicated to the buffer it displays.
1314 If it is dedicated, Emacs will not automatically change
1315 which buffer appears in it.
1316 The second argument is the new value for the dedication flag;
1317 non-nil means yes. */)
1318 (window, arg)
1319 Lisp_Object window, arg;
1321 register struct window *w = decode_window (window);
1323 w->dedicated = arg;
1325 return w->dedicated;
1328 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
1329 0, 1, 0,
1330 doc: /* Return the display-table that WINDOW is using.
1331 WINDOW defaults to the selected window. */)
1332 (window)
1333 Lisp_Object window;
1335 return decode_window (window)->display_table;
1338 /* Get the display table for use on window W. This is either W's
1339 display table or W's buffer's display table. Ignore the specified
1340 tables if they are not valid; if no valid table is specified,
1341 return 0. */
1343 struct Lisp_Char_Table *
1344 window_display_table (w)
1345 struct window *w;
1347 struct Lisp_Char_Table *dp = NULL;
1349 if (DISP_TABLE_P (w->display_table))
1350 dp = XCHAR_TABLE (w->display_table);
1351 else if (BUFFERP (w->buffer))
1353 struct buffer *b = XBUFFER (w->buffer);
1355 if (DISP_TABLE_P (b->display_table))
1356 dp = XCHAR_TABLE (b->display_table);
1357 else if (DISP_TABLE_P (Vstandard_display_table))
1358 dp = XCHAR_TABLE (Vstandard_display_table);
1361 return dp;
1364 DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
1365 doc: /* Set WINDOW's display-table to TABLE. */)
1366 (window, table)
1367 register Lisp_Object window, table;
1369 register struct window *w;
1371 w = decode_window (window);
1372 w->display_table = table;
1373 return table;
1376 /* Record info on buffer window w is displaying
1377 when it is about to cease to display that buffer. */
1378 static void
1379 unshow_buffer (w)
1380 register struct window *w;
1382 Lisp_Object buf;
1383 struct buffer *b;
1385 buf = w->buffer;
1386 b = XBUFFER (buf);
1387 if (b != XMARKER (w->pointm)->buffer)
1388 abort ();
1390 #if 0
1391 if (w == XWINDOW (selected_window)
1392 || ! EQ (buf, XWINDOW (selected_window)->buffer))
1393 /* Do this except when the selected window's buffer
1394 is being removed from some other window. */
1395 #endif
1396 /* last_window_start records the start position that this buffer
1397 had in the last window to be disconnected from it.
1398 Now that this statement is unconditional,
1399 it is possible for the buffer to be displayed in the
1400 selected window, while last_window_start reflects another
1401 window which was recently showing the same buffer.
1402 Some people might say that might be a good thing. Let's see. */
1403 b->last_window_start = marker_position (w->start);
1405 /* Point in the selected window's buffer
1406 is actually stored in that buffer, and the window's pointm isn't used.
1407 So don't clobber point in that buffer. */
1408 if (! EQ (buf, XWINDOW (selected_window)->buffer)
1409 /* This line helps to fix Horsley's testbug.el bug. */
1410 && !(WINDOWP (b->last_selected_window)
1411 && w != XWINDOW (b->last_selected_window)
1412 && EQ (buf, XWINDOW (b->last_selected_window)->buffer)))
1413 temp_set_point_both (b,
1414 clip_to_bounds (BUF_BEGV (b),
1415 XMARKER (w->pointm)->charpos,
1416 BUF_ZV (b)),
1417 clip_to_bounds (BUF_BEGV_BYTE (b),
1418 marker_byte_position (w->pointm),
1419 BUF_ZV_BYTE (b)));
1421 if (WINDOWP (b->last_selected_window)
1422 && w == XWINDOW (b->last_selected_window))
1423 b->last_selected_window = Qnil;
1426 /* Put replacement into the window structure in place of old. */
1427 static void
1428 replace_window (old, replacement)
1429 Lisp_Object old, replacement;
1431 register Lisp_Object tem;
1432 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
1434 /* If OLD is its frame's root_window, then replacement is the new
1435 root_window for that frame. */
1437 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
1438 FRAME_ROOT_WINDOW (XFRAME (o->frame)) = replacement;
1440 p->left_col = o->left_col;
1441 p->top_line = o->top_line;
1442 p->total_cols = o->total_cols;
1443 p->total_lines = o->total_lines;
1444 p->desired_matrix = p->current_matrix = 0;
1445 p->vscroll = 0;
1446 bzero (&p->cursor, sizeof (p->cursor));
1447 bzero (&p->last_cursor, sizeof (p->last_cursor));
1448 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
1449 p->phys_cursor_type = -1;
1450 p->phys_cursor_width = -1;
1451 p->must_be_updated_p = 0;
1452 p->pseudo_window_p = 0;
1453 XSETFASTINT (p->window_end_vpos, 0);
1454 XSETFASTINT (p->window_end_pos, 0);
1455 p->window_end_valid = Qnil;
1456 p->frozen_window_start_p = 0;
1457 p->orig_top_line = p->orig_total_lines = Qnil;
1459 p->next = tem = o->next;
1460 if (!NILP (tem))
1461 XWINDOW (tem)->prev = replacement;
1463 p->prev = tem = o->prev;
1464 if (!NILP (tem))
1465 XWINDOW (tem)->next = replacement;
1467 p->parent = tem = o->parent;
1468 if (!NILP (tem))
1470 if (EQ (XWINDOW (tem)->vchild, old))
1471 XWINDOW (tem)->vchild = replacement;
1472 if (EQ (XWINDOW (tem)->hchild, old))
1473 XWINDOW (tem)->hchild = replacement;
1476 /*** Here, if replacement is a vertical combination
1477 and so is its new parent, we should make replacement's
1478 children be children of that parent instead. ***/
1481 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
1482 doc: /* Remove WINDOW from the display. Default is selected window. */)
1483 (window)
1484 register Lisp_Object window;
1486 delete_window (window);
1488 if (! NILP (Vwindow_configuration_change_hook)
1489 && ! NILP (Vrun_hooks))
1490 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
1492 return Qnil;
1495 void
1496 delete_window (window)
1497 register Lisp_Object window;
1499 register Lisp_Object tem, parent, sib;
1500 register struct window *p;
1501 register struct window *par;
1502 struct frame *f;
1504 /* Because this function is called by other C code on non-leaf
1505 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
1506 so we can't decode_window here. */
1507 if (NILP (window))
1508 window = selected_window;
1509 else
1510 CHECK_WINDOW (window);
1511 p = XWINDOW (window);
1513 /* It's a no-op to delete an already-deleted window. */
1514 if (NILP (p->buffer)
1515 && NILP (p->hchild)
1516 && NILP (p->vchild))
1517 return;
1519 parent = p->parent;
1520 if (NILP (parent))
1521 error ("Attempt to delete minibuffer or sole ordinary window");
1522 par = XWINDOW (parent);
1524 windows_or_buffers_changed++;
1525 Vwindow_list = Qnil;
1526 f = XFRAME (WINDOW_FRAME (p));
1527 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
1529 /* Are we trying to delete any frame's selected window? */
1531 Lisp_Object swindow, pwindow;
1533 /* See if the frame's selected window is either WINDOW
1534 or any subwindow of it, by finding all that window's parents
1535 and comparing each one with WINDOW. */
1536 swindow = FRAME_SELECTED_WINDOW (f);
1538 while (1)
1540 pwindow = swindow;
1541 while (!NILP (pwindow))
1543 if (EQ (window, pwindow))
1544 break;
1545 pwindow = XWINDOW (pwindow)->parent;
1548 /* If the window being deleted is not a parent of SWINDOW,
1549 then SWINDOW is ok as the new selected window. */
1550 if (!EQ (window, pwindow))
1551 break;
1552 /* Otherwise, try another window for SWINDOW. */
1553 swindow = Fnext_window (swindow, Qlambda, Qnil);
1555 /* If we get back to the frame's selected window,
1556 it means there was no acceptable alternative,
1557 so we cannot delete. */
1558 if (EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1559 error ("Cannot delete window");
1562 /* If we need to change SWINDOW, do it. */
1563 if (! EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1565 /* If we're about to delete the selected window on the
1566 selected frame, then we should use Fselect_window to select
1567 the new window. On the other hand, if we're about to
1568 delete the selected window on any other frame, we shouldn't do
1569 anything but set the frame's selected_window slot. */
1570 if (EQ (FRAME_SELECTED_WINDOW (f), selected_window))
1571 Fselect_window (swindow, Qnil);
1572 else
1573 FRAME_SELECTED_WINDOW (f) = swindow;
1577 /* Now we know we can delete this one. */
1578 window_deletion_count++;
1580 tem = p->buffer;
1581 /* tem is null for dummy parent windows
1582 (which have inferiors but not any contents themselves) */
1583 if (!NILP (tem))
1585 unshow_buffer (p);
1586 unchain_marker (XMARKER (p->pointm));
1587 unchain_marker (XMARKER (p->start));
1590 /* Free window glyph matrices. It is sure that they are allocated
1591 again when ADJUST_GLYPHS is called. Block input so that expose
1592 events and other events that access glyph matrices are not
1593 processed while we are changing them. */
1594 BLOCK_INPUT;
1595 free_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f)));
1597 tem = p->next;
1598 if (!NILP (tem))
1599 XWINDOW (tem)->prev = p->prev;
1601 tem = p->prev;
1602 if (!NILP (tem))
1603 XWINDOW (tem)->next = p->next;
1605 if (EQ (window, par->hchild))
1606 par->hchild = p->next;
1607 if (EQ (window, par->vchild))
1608 par->vchild = p->next;
1610 /* Find one of our siblings to give our space to. */
1611 sib = p->prev;
1612 if (NILP (sib))
1614 /* If p gives its space to its next sibling, that sibling needs
1615 to have its top/left side pulled back to where p's is.
1616 set_window_{height,width} will re-position the sibling's
1617 children. */
1618 sib = p->next;
1619 XWINDOW (sib)->top_line = p->top_line;
1620 XWINDOW (sib)->left_col = p->left_col;
1623 /* Stretch that sibling. */
1624 if (!NILP (par->vchild))
1625 set_window_height (sib,
1626 XFASTINT (XWINDOW (sib)->total_lines) + XFASTINT (p->total_lines),
1628 if (!NILP (par->hchild))
1629 set_window_width (sib,
1630 XFASTINT (XWINDOW (sib)->total_cols) + XFASTINT (p->total_cols),
1633 /* If parent now has only one child,
1634 put the child into the parent's place. */
1635 tem = par->hchild;
1636 if (NILP (tem))
1637 tem = par->vchild;
1638 if (NILP (XWINDOW (tem)->next)) {
1639 replace_window (parent, tem);
1640 par = XWINDOW (tem);
1643 /* Since we may be deleting combination windows, we must make sure that
1644 not only p but all its children have been marked as deleted. */
1645 if (! NILP (p->hchild))
1646 delete_all_subwindows (XWINDOW (p->hchild));
1647 else if (! NILP (p->vchild))
1648 delete_all_subwindows (XWINDOW (p->vchild));
1650 /* Mark this window as deleted. */
1651 p->buffer = p->hchild = p->vchild = Qnil;
1653 if (! NILP (par->parent))
1654 par = XWINDOW (par->parent);
1656 /* Check if we have a v/hchild with a v/hchild. In that case remove
1657 one of them. */
1659 if (! NILP (par->vchild) && ! NILP (XWINDOW (par->vchild)->vchild))
1661 p = XWINDOW (par->vchild);
1662 par->vchild = p->vchild;
1663 tem = p->vchild;
1665 else if (! NILP (par->hchild) && ! NILP (XWINDOW (par->hchild)->hchild))
1667 p = XWINDOW (par->hchild);
1668 par->hchild = p->hchild;
1669 tem = p->hchild;
1671 else
1672 p = 0;
1674 if (p)
1676 while (! NILP (tem)) {
1677 XWINDOW (tem)->parent = p->parent;
1678 if (NILP (XWINDOW (tem)->next))
1679 break;
1680 tem = XWINDOW (tem)->next;
1682 if (! NILP (tem)) {
1683 /* The next of the v/hchild we are removing is now the next of the
1684 last child for the v/hchild:
1685 Before v/hchild -> v/hchild -> next1 -> next2
1687 -> next3
1688 After: v/hchild -> next1 -> next2 -> next3
1690 XWINDOW (tem)->next = p->next;
1691 if (! NILP (p->next))
1692 XWINDOW (p->next)->prev = tem;
1694 p->next = p->prev = p->vchild = p->hchild = p->buffer = Qnil;
1698 /* Adjust glyph matrices. */
1699 adjust_glyphs (f);
1700 UNBLOCK_INPUT;
1705 /***********************************************************************
1706 Window List
1707 ***********************************************************************/
1709 /* Add window W to *USER_DATA. USER_DATA is actually a Lisp_Object
1710 pointer. This is a callback function for foreach_window, used in
1711 function window_list. */
1713 static int
1714 add_window_to_list (w, user_data)
1715 struct window *w;
1716 void *user_data;
1718 Lisp_Object *list = (Lisp_Object *) user_data;
1719 Lisp_Object window;
1720 XSETWINDOW (window, w);
1721 *list = Fcons (window, *list);
1722 return 1;
1726 /* Return a list of all windows, for use by next_window. If
1727 Vwindow_list is a list, return that list. Otherwise, build a new
1728 list, cache it in Vwindow_list, and return that. */
1730 static Lisp_Object
1731 window_list ()
1733 if (!CONSP (Vwindow_list))
1735 Lisp_Object tail;
1737 Vwindow_list = Qnil;
1738 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1740 Lisp_Object args[2];
1742 /* We are visiting windows in canonical order, and add
1743 new windows at the front of args[1], which means we
1744 have to reverse this list at the end. */
1745 args[1] = Qnil;
1746 foreach_window (XFRAME (XCAR (tail)), add_window_to_list, &args[1]);
1747 args[0] = Vwindow_list;
1748 args[1] = Fnreverse (args[1]);
1749 Vwindow_list = Fnconc (2, args);
1753 return Vwindow_list;
1757 /* Value is non-zero if WINDOW satisfies the constraints given by
1758 OWINDOW, MINIBUF and ALL_FRAMES.
1760 MINIBUF t means WINDOW may be minibuffer windows.
1761 `lambda' means WINDOW may not be a minibuffer window.
1762 a window means a specific minibuffer window
1764 ALL_FRAMES t means search all frames,
1765 nil means search just current frame,
1766 `visible' means search just visible frames,
1767 0 means search visible and iconified frames,
1768 a window means search the frame that window belongs to,
1769 a frame means consider windows on that frame, only. */
1771 static int
1772 candidate_window_p (window, owindow, minibuf, all_frames)
1773 Lisp_Object window, owindow, minibuf, all_frames;
1775 struct window *w = XWINDOW (window);
1776 struct frame *f = XFRAME (w->frame);
1777 int candidate_p = 1;
1779 if (!BUFFERP (w->buffer))
1780 candidate_p = 0;
1781 else if (MINI_WINDOW_P (w)
1782 && (EQ (minibuf, Qlambda)
1783 || (WINDOWP (minibuf) && !EQ (minibuf, window))))
1785 /* If MINIBUF is `lambda' don't consider any mini-windows.
1786 If it is a window, consider only that one. */
1787 candidate_p = 0;
1789 else if (EQ (all_frames, Qt))
1790 candidate_p = 1;
1791 else if (NILP (all_frames))
1793 xassert (WINDOWP (owindow));
1794 candidate_p = EQ (w->frame, XWINDOW (owindow)->frame);
1796 else if (EQ (all_frames, Qvisible))
1798 FRAME_SAMPLE_VISIBILITY (f);
1799 candidate_p = FRAME_VISIBLE_P (f)
1800 && (FRAME_TERMINAL (XFRAME (w->frame))
1801 == FRAME_TERMINAL (XFRAME (selected_frame)));
1804 else if (INTEGERP (all_frames) && XINT (all_frames) == 0)
1806 FRAME_SAMPLE_VISIBILITY (f);
1807 candidate_p = (FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f)
1808 #ifdef HAVE_X_WINDOWS
1809 /* Yuck!! If we've just created the frame and the
1810 window-manager requested the user to place it
1811 manually, the window may still not be considered
1812 `visible'. I'd argue it should be at least
1813 something like `iconified', but don't know how to do
1814 that yet. --Stef */
1815 || (FRAME_X_P (f) && f->output_data.x->asked_for_visible
1816 && !f->output_data.x->has_been_visible)
1817 #endif
1819 && (FRAME_TERMINAL (XFRAME (w->frame))
1820 == FRAME_TERMINAL (XFRAME (selected_frame)));
1822 else if (WINDOWP (all_frames))
1823 candidate_p = (EQ (FRAME_MINIBUF_WINDOW (f), all_frames)
1824 || EQ (XWINDOW (all_frames)->frame, w->frame)
1825 || EQ (XWINDOW (all_frames)->frame, FRAME_FOCUS_FRAME (f)));
1826 else if (FRAMEP (all_frames))
1827 candidate_p = EQ (all_frames, w->frame);
1829 return candidate_p;
1833 /* Decode arguments as allowed by Fnext_window, Fprevious_window, and
1834 Fwindow_list. See there for the meaning of WINDOW, MINIBUF, and
1835 ALL_FRAMES. */
1837 static void
1838 decode_next_window_args (window, minibuf, all_frames)
1839 Lisp_Object *window, *minibuf, *all_frames;
1841 if (NILP (*window))
1842 *window = selected_window;
1843 else
1844 CHECK_LIVE_WINDOW (*window);
1846 /* MINIBUF nil may or may not include minibuffers. Decide if it
1847 does. */
1848 if (NILP (*minibuf))
1849 *minibuf = minibuf_level ? minibuf_window : Qlambda;
1850 else if (!EQ (*minibuf, Qt))
1851 *minibuf = Qlambda;
1853 /* Now *MINIBUF can be t => count all minibuffer windows, `lambda'
1854 => count none of them, or a specific minibuffer window (the
1855 active one) to count. */
1857 /* ALL_FRAMES nil doesn't specify which frames to include. */
1858 if (NILP (*all_frames))
1859 *all_frames = (!EQ (*minibuf, Qlambda)
1860 ? FRAME_MINIBUF_WINDOW (XFRAME (XWINDOW (*window)->frame))
1861 : Qnil);
1862 else if (EQ (*all_frames, Qvisible))
1864 else if (EQ (*all_frames, make_number (0)))
1866 else if (FRAMEP (*all_frames))
1868 else if (!EQ (*all_frames, Qt))
1869 *all_frames = Qnil;
1871 /* Now *ALL_FRAMES is t meaning search all frames, nil meaning
1872 search just current frame, `visible' meaning search just visible
1873 frames, 0 meaning search visible and iconified frames, or a
1874 window, meaning search the frame that window belongs to, or a
1875 frame, meaning consider windows on that frame, only. */
1879 /* Return the next or previous window of WINDOW in canonical ordering
1880 of windows. NEXT_P non-zero means return the next window. See the
1881 documentation string of next-window for the meaning of MINIBUF and
1882 ALL_FRAMES. */
1884 static Lisp_Object
1885 next_window (window, minibuf, all_frames, next_p)
1886 Lisp_Object window, minibuf, all_frames;
1887 int next_p;
1889 decode_next_window_args (&window, &minibuf, &all_frames);
1891 /* If ALL_FRAMES is a frame, and WINDOW isn't on that frame, just
1892 return the first window on the frame. */
1893 if (FRAMEP (all_frames)
1894 && !EQ (all_frames, XWINDOW (window)->frame))
1895 return Fframe_first_window (all_frames);
1897 if (next_p)
1899 Lisp_Object list;
1901 /* Find WINDOW in the list of all windows. */
1902 list = Fmemq (window, window_list ());
1904 /* Scan forward from WINDOW to the end of the window list. */
1905 if (CONSP (list))
1906 for (list = XCDR (list); CONSP (list); list = XCDR (list))
1907 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1908 break;
1910 /* Scan from the start of the window list up to WINDOW. */
1911 if (!CONSP (list))
1912 for (list = Vwindow_list;
1913 CONSP (list) && !EQ (XCAR (list), window);
1914 list = XCDR (list))
1915 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1916 break;
1918 if (CONSP (list))
1919 window = XCAR (list);
1921 else
1923 Lisp_Object candidate, list;
1925 /* Scan through the list of windows for candidates. If there are
1926 candidate windows in front of WINDOW, the last one of these
1927 is the one we want. If there are candidates following WINDOW
1928 in the list, again the last one of these is the one we want. */
1929 candidate = Qnil;
1930 for (list = window_list (); CONSP (list); list = XCDR (list))
1932 if (EQ (XCAR (list), window))
1934 if (WINDOWP (candidate))
1935 break;
1937 else if (candidate_window_p (XCAR (list), window, minibuf,
1938 all_frames))
1939 candidate = XCAR (list);
1942 if (WINDOWP (candidate))
1943 window = candidate;
1946 return window;
1950 DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
1951 doc: /* Return next window after WINDOW in canonical ordering of windows.
1952 If omitted, WINDOW defaults to the selected window.
1954 Optional second arg MINIBUF t means count the minibuffer window even
1955 if not active. MINIBUF nil or omitted means count the minibuffer iff
1956 it is active. MINIBUF neither t nor nil means not to count the
1957 minibuffer even if it is active.
1959 Several frames may share a single minibuffer; if the minibuffer
1960 counts, all windows on all frames that share that minibuffer count
1961 too. Therefore, `next-window' can be used to iterate through the
1962 set of windows even when the minibuffer is on another frame. If the
1963 minibuffer does not count, only windows from WINDOW's frame count.
1965 Optional third arg ALL-FRAMES t means include windows on all frames.
1966 ALL-FRAMES nil or omitted means cycle within the frames as specified
1967 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1968 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1969 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1970 Anything else means restrict to WINDOW's frame.
1972 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1973 `next-window' to iterate through the entire cycle of acceptable
1974 windows, eventually ending up back at the window you started with.
1975 `previous-window' traverses the same cycle, in the reverse order. */)
1976 (window, minibuf, all_frames)
1977 Lisp_Object window, minibuf, all_frames;
1979 return next_window (window, minibuf, all_frames, 1);
1983 DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
1984 doc: /* Return the window preceding WINDOW in canonical ordering of windows.
1985 If omitted, WINDOW defaults to the selected window.
1987 Optional second arg MINIBUF t means count the minibuffer window even
1988 if not active. MINIBUF nil or omitted means count the minibuffer iff
1989 it is active. MINIBUF neither t nor nil means not to count the
1990 minibuffer even if it is active.
1992 Several frames may share a single minibuffer; if the minibuffer
1993 counts, all windows on all frames that share that minibuffer count
1994 too. Therefore, `previous-window' can be used to iterate through
1995 the set of windows even when the minibuffer is on another frame. If
1996 the minibuffer does not count, only windows from WINDOW's frame count
1998 Optional third arg ALL-FRAMES t means include windows on all frames.
1999 ALL-FRAMES nil or omitted means cycle within the frames as specified
2000 above. ALL-FRAMES = `visible' means include windows on all visible frames.
2001 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
2002 If ALL-FRAMES is a frame, restrict search to windows on that frame.
2003 Anything else means restrict to WINDOW's frame.
2005 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
2006 `previous-window' to iterate through the entire cycle of acceptable
2007 windows, eventually ending up back at the window you started with.
2008 `next-window' traverses the same cycle, in the reverse order. */)
2009 (window, minibuf, all_frames)
2010 Lisp_Object window, minibuf, all_frames;
2012 return next_window (window, minibuf, all_frames, 0);
2016 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
2017 doc: /* Select the ARG'th different window on this frame.
2018 All windows on current frame are arranged in a cyclic order.
2019 This command selects the window ARG steps away in that order.
2020 A negative ARG moves in the opposite order. The optional second
2021 argument ALL-FRAMES has the same meaning as in `next-window', which see. */)
2022 (arg, all_frames)
2023 Lisp_Object arg, all_frames;
2025 Lisp_Object window;
2026 int i;
2028 CHECK_NUMBER (arg);
2029 window = selected_window;
2031 for (i = XINT (arg); i > 0; --i)
2032 window = Fnext_window (window, Qnil, all_frames);
2033 for (; i < 0; ++i)
2034 window = Fprevious_window (window, Qnil, all_frames);
2036 Fselect_window (window, Qnil);
2037 return Qnil;
2041 DEFUN ("window-list", Fwindow_list, Swindow_list, 0, 3, 0,
2042 doc: /* Return a list of windows on FRAME, starting with WINDOW.
2043 FRAME nil or omitted means use the selected frame.
2044 WINDOW nil or omitted means use the selected window.
2045 MINIBUF t means include the minibuffer window, even if it isn't active.
2046 MINIBUF nil or omitted means include the minibuffer window only
2047 if it's active.
2048 MINIBUF neither nil nor t means never include the minibuffer window. */)
2049 (frame, minibuf, window)
2050 Lisp_Object frame, minibuf, window;
2052 if (NILP (window))
2053 window = FRAMEP (frame) ? XFRAME (frame)->selected_window : selected_window;
2054 CHECK_WINDOW (window);
2055 if (NILP (frame))
2056 frame = selected_frame;
2058 if (!EQ (frame, XWINDOW (window)->frame))
2059 error ("Window is on a different frame");
2061 return window_list_1 (window, minibuf, frame);
2065 /* Return a list of windows in canonical ordering. Arguments are like
2066 for `next-window'. */
2068 static Lisp_Object
2069 window_list_1 (window, minibuf, all_frames)
2070 Lisp_Object window, minibuf, all_frames;
2072 Lisp_Object tail, list, rest;
2074 decode_next_window_args (&window, &minibuf, &all_frames);
2075 list = Qnil;
2077 for (tail = window_list (); CONSP (tail); tail = XCDR (tail))
2078 if (candidate_window_p (XCAR (tail), window, minibuf, all_frames))
2079 list = Fcons (XCAR (tail), list);
2081 /* Rotate the list to start with WINDOW. */
2082 list = Fnreverse (list);
2083 rest = Fmemq (window, list);
2084 if (!NILP (rest) && !EQ (rest, list))
2086 for (tail = list; !EQ (XCDR (tail), rest); tail = XCDR (tail))
2088 XSETCDR (tail, Qnil);
2089 list = nconc2 (rest, list);
2091 return list;
2096 /* Look at all windows, performing an operation specified by TYPE
2097 with argument OBJ.
2098 If FRAMES is Qt, look at all frames;
2099 Qnil, look at just the selected frame;
2100 Qvisible, look at visible frames;
2101 a frame, just look at windows on that frame.
2102 If MINI is non-zero, perform the operation on minibuffer windows too. */
2104 enum window_loop
2106 WINDOW_LOOP_UNUSED,
2107 GET_BUFFER_WINDOW, /* Arg is buffer */
2108 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
2109 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
2110 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
2111 GET_LARGEST_WINDOW,
2112 UNSHOW_BUFFER, /* Arg is buffer */
2113 REDISPLAY_BUFFER_WINDOWS, /* Arg is buffer */
2114 CHECK_ALL_WINDOWS
2117 static Lisp_Object
2118 window_loop (type, obj, mini, frames)
2119 enum window_loop type;
2120 Lisp_Object obj, frames;
2121 int mini;
2123 Lisp_Object window, windows, best_window, frame_arg;
2124 struct frame *f;
2125 struct gcpro gcpro1;
2127 /* If we're only looping through windows on a particular frame,
2128 frame points to that frame. If we're looping through windows
2129 on all frames, frame is 0. */
2130 if (FRAMEP (frames))
2131 f = XFRAME (frames);
2132 else if (NILP (frames))
2133 f = SELECTED_FRAME ();
2134 else
2135 f = NULL;
2137 if (f)
2138 frame_arg = Qlambda;
2139 else if (EQ (frames, make_number (0)))
2140 frame_arg = frames;
2141 else if (EQ (frames, Qvisible))
2142 frame_arg = frames;
2143 else
2144 frame_arg = Qt;
2146 /* frame_arg is Qlambda to stick to one frame,
2147 Qvisible to consider all visible frames,
2148 or Qt otherwise. */
2150 /* Pick a window to start with. */
2151 if (WINDOWP (obj))
2152 window = obj;
2153 else if (f)
2154 window = FRAME_SELECTED_WINDOW (f);
2155 else
2156 window = FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
2158 windows = window_list_1 (window, mini ? Qt : Qnil, frame_arg);
2159 GCPRO1 (windows);
2160 best_window = Qnil;
2162 for (; CONSP (windows); windows = XCDR (windows))
2164 struct window *w;
2166 window = XCAR (windows);
2167 w = XWINDOW (window);
2169 /* Note that we do not pay attention here to whether the frame
2170 is visible, since Fwindow_list skips non-visible frames if
2171 that is desired, under the control of frame_arg. */
2172 if (!MINI_WINDOW_P (w)
2173 /* For UNSHOW_BUFFER, we must always consider all windows. */
2174 || type == UNSHOW_BUFFER
2175 || (mini && minibuf_level > 0))
2176 switch (type)
2178 case GET_BUFFER_WINDOW:
2179 if (EQ (w->buffer, obj)
2180 /* Don't find any minibuffer window
2181 except the one that is currently in use. */
2182 && (MINI_WINDOW_P (w)
2183 ? EQ (window, minibuf_window)
2184 : 1))
2186 if (NILP (best_window))
2187 best_window = window;
2188 else if (EQ (window, selected_window))
2189 /* Prefer to return selected-window. */
2190 RETURN_UNGCPRO (window);
2191 else if (EQ (Fwindow_frame (window), selected_frame))
2192 /* Prefer windows on the current frame. */
2193 best_window = window;
2195 break;
2197 case GET_LRU_WINDOW:
2198 /* `obj' is an integer encoding a bitvector.
2199 `obj & 1' means consider only full-width windows.
2200 `obj & 2' means consider also dedicated windows. */
2201 if (((XINT (obj) & 1) && !WINDOW_FULL_WIDTH_P (w))
2202 || (!(XINT (obj) & 2) && !NILP (w->dedicated))
2203 /* Minibuffer windows are always ignored. */
2204 || MINI_WINDOW_P (w))
2205 break;
2206 if (NILP (best_window)
2207 || (XFASTINT (XWINDOW (best_window)->use_time)
2208 > XFASTINT (w->use_time)))
2209 best_window = window;
2210 break;
2212 case DELETE_OTHER_WINDOWS:
2213 if (!EQ (window, obj))
2214 Fdelete_window (window);
2215 break;
2217 case DELETE_BUFFER_WINDOWS:
2218 if (EQ (w->buffer, obj))
2220 struct frame *f = XFRAME (WINDOW_FRAME (w));
2222 /* If this window is dedicated, and in a frame of its own,
2223 kill the frame. */
2224 if (EQ (window, FRAME_ROOT_WINDOW (f))
2225 && !NILP (w->dedicated)
2226 && other_visible_frames (f))
2228 /* Skip the other windows on this frame.
2229 There might be one, the minibuffer! */
2230 while (CONSP (XCDR (windows))
2231 && EQ (XWINDOW (XCAR (windows))->frame,
2232 XWINDOW (XCAR (XCDR (windows)))->frame))
2233 windows = XCDR (windows);
2235 /* Now we can safely delete the frame. */
2236 Fdelete_frame (w->frame, Qnil);
2238 else if (NILP (w->parent))
2240 /* If we're deleting the buffer displayed in the
2241 only window on the frame, find a new buffer to
2242 display there. */
2243 Lisp_Object buffer;
2244 buffer = Fother_buffer (obj, Qnil, w->frame);
2245 Fset_window_buffer (window, buffer, Qnil);
2246 if (EQ (window, selected_window))
2247 Fset_buffer (w->buffer);
2249 else
2250 Fdelete_window (window);
2252 break;
2254 case GET_LARGEST_WINDOW:
2255 { /* nil `obj' means to ignore dedicated windows. */
2256 /* Ignore dedicated windows and minibuffers. */
2257 if (MINI_WINDOW_P (w) || (NILP (obj) && !NILP (w->dedicated)))
2258 break;
2260 if (NILP (best_window))
2261 best_window = window;
2262 else
2264 struct window *b = XWINDOW (best_window);
2265 if (XFASTINT (w->total_lines) * XFASTINT (w->total_cols)
2266 > XFASTINT (b->total_lines) * XFASTINT (b->total_cols))
2267 best_window = window;
2270 break;
2272 case UNSHOW_BUFFER:
2273 if (EQ (w->buffer, obj))
2275 Lisp_Object buffer;
2276 struct frame *f = XFRAME (w->frame);
2278 /* Find another buffer to show in this window. */
2279 buffer = Fother_buffer (obj, Qnil, w->frame);
2281 /* If this window is dedicated, and in a frame of its own,
2282 kill the frame. */
2283 if (EQ (window, FRAME_ROOT_WINDOW (f))
2284 && !NILP (w->dedicated)
2285 && other_visible_frames (f))
2287 /* Skip the other windows on this frame.
2288 There might be one, the minibuffer! */
2289 while (CONSP (XCDR (windows))
2290 && EQ (XWINDOW (XCAR (windows))->frame,
2291 XWINDOW (XCAR (XCDR (windows)))->frame))
2292 windows = XCDR (windows);
2294 /* Now we can safely delete the frame. */
2295 Fdelete_frame (w->frame, Qnil);
2297 else if (!NILP (w->dedicated) && !NILP (w->parent))
2299 Lisp_Object window;
2300 XSETWINDOW (window, w);
2301 /* If this window is dedicated and not the only window
2302 in its frame, then kill it. */
2303 Fdelete_window (window);
2305 else
2307 /* Otherwise show a different buffer in the window. */
2308 w->dedicated = Qnil;
2309 Fset_window_buffer (window, buffer, Qnil);
2310 if (EQ (window, selected_window))
2311 Fset_buffer (w->buffer);
2314 break;
2316 case REDISPLAY_BUFFER_WINDOWS:
2317 if (EQ (w->buffer, obj))
2319 mark_window_display_accurate (window, 0);
2320 w->update_mode_line = Qt;
2321 XBUFFER (obj)->prevent_redisplay_optimizations_p = 1;
2322 ++update_mode_lines;
2323 best_window = window;
2325 break;
2327 /* Check for a window that has a killed buffer. */
2328 case CHECK_ALL_WINDOWS:
2329 if (! NILP (w->buffer)
2330 && NILP (XBUFFER (w->buffer)->name))
2331 abort ();
2332 break;
2334 case WINDOW_LOOP_UNUSED:
2335 break;
2339 UNGCPRO;
2340 return best_window;
2343 /* Used for debugging. Abort if any window has a dead buffer. */
2345 void
2346 check_all_windows ()
2348 window_loop (CHECK_ALL_WINDOWS, Qnil, 1, Qt);
2351 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 2, 0,
2352 doc: /* Return the window least recently selected or used for display.
2353 \(LRU means Least Recently Used.)
2355 Return a full-width window if possible.
2356 A minibuffer window is never a candidate.
2357 A dedicated window is never a candidate, unless DEDICATED is non-nil,
2358 so if all windows are dedicated, the value is nil.
2359 If optional argument FRAME is `visible', search all visible frames.
2360 If FRAME is 0, search all visible and iconified frames.
2361 If FRAME is t, search all frames.
2362 If FRAME is nil, search only the selected frame.
2363 If FRAME is a frame, search only that frame. */)
2364 (frame, dedicated)
2365 Lisp_Object frame, dedicated;
2367 register Lisp_Object w;
2368 /* First try for a window that is full-width */
2369 w = window_loop (GET_LRU_WINDOW,
2370 NILP (dedicated) ? make_number (1) : make_number (3),
2371 0, frame);
2372 if (!NILP (w) && !EQ (w, selected_window))
2373 return w;
2374 /* If none of them, try the rest */
2375 return window_loop (GET_LRU_WINDOW,
2376 NILP (dedicated) ? make_number (0) : make_number (2),
2377 0, frame);
2380 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 2, 0,
2381 doc: /* Return the largest window in area.
2382 A minibuffer window is never a candidate.
2383 A dedicated window is never a candidate unless DEDICATED is non-nil,
2384 so if all windows are dedicated, the value is nil.
2385 If optional argument FRAME is `visible', search all visible frames.
2386 If FRAME is 0, search all visible and iconified frames.
2387 If FRAME is t, search all frames.
2388 If FRAME is nil, search only the selected frame.
2389 If FRAME is a frame, search only that frame. */)
2390 (frame, dedicated)
2391 Lisp_Object frame, dedicated;
2393 return window_loop (GET_LARGEST_WINDOW, dedicated, 0,
2394 frame);
2397 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
2398 doc: /* Return a window currently displaying BUFFER, or nil if none.
2399 BUFFER can be a buffer or a buffer name.
2400 If optional argument FRAME is `visible', search all visible frames.
2401 If optional argument FRAME is 0, search all visible and iconified frames.
2402 If FRAME is t, search all frames.
2403 If FRAME is nil, search only the selected frame.
2404 If FRAME is a frame, search only that frame. */)
2405 (buffer, frame)
2406 Lisp_Object buffer, frame;
2408 buffer = Fget_buffer (buffer);
2409 if (BUFFERP (buffer))
2410 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
2411 else
2412 return Qnil;
2415 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
2416 0, 1, "",
2417 doc: /* Make WINDOW (or the selected window) fill its frame.
2418 Only the frame WINDOW is on is affected.
2419 This function tries to reduce display jumps
2420 by keeping the text previously visible in WINDOW
2421 in the same place on the frame. Doing this depends on
2422 the value of (window-start WINDOW), so if calling this function
2423 in a program gives strange scrolling, make sure the window-start
2424 value is reasonable when this function is called. */)
2425 (window)
2426 Lisp_Object window;
2428 struct window *w;
2429 int startpos;
2430 int top, new_top;
2432 if (NILP (window))
2433 window = selected_window;
2434 else
2435 CHECK_LIVE_WINDOW (window);
2436 w = XWINDOW (window);
2438 startpos = marker_position (w->start);
2439 top = WINDOW_TOP_EDGE_LINE (w) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2441 if (MINI_WINDOW_P (w) && top > 0)
2442 error ("Can't expand minibuffer to full frame");
2444 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
2446 /* Try to minimize scrolling, by setting the window start to the point
2447 will cause the text at the old window start to be at the same place
2448 on the frame. But don't try to do this if the window start is
2449 outside the visible portion (as might happen when the display is
2450 not current, due to typeahead). */
2451 new_top = WINDOW_TOP_EDGE_LINE (w) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2452 if (new_top != top
2453 && startpos >= BUF_BEGV (XBUFFER (w->buffer))
2454 && startpos <= BUF_ZV (XBUFFER (w->buffer)))
2456 struct position pos;
2457 struct buffer *obuf = current_buffer;
2459 Fset_buffer (w->buffer);
2460 /* This computation used to temporarily move point, but that can
2461 have unwanted side effects due to text properties. */
2462 pos = *vmotion (startpos, -top, w);
2464 set_marker_both (w->start, w->buffer, pos.bufpos, pos.bytepos);
2465 w->window_end_valid = Qnil;
2466 w->start_at_line_beg = ((pos.bytepos == BEGV_BYTE
2467 || FETCH_BYTE (pos.bytepos - 1) == '\n') ? Qt
2468 : Qnil);
2469 /* We need to do this, so that the window-scroll-functions
2470 get called. */
2471 w->optional_new_start = Qt;
2473 set_buffer_internal (obuf);
2476 return Qnil;
2479 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
2480 1, 2, "bDelete windows on (buffer): ",
2481 doc: /* Delete all windows showing BUFFER.
2482 BUFFER must be a buffer or the name of an existing buffer.
2483 Optional second argument FRAME controls which frames are affected.
2484 If optional argument FRAME is `visible', search all visible frames.
2485 If FRAME is 0, search all visible and iconified frames.
2486 If FRAME is nil, search all frames.
2487 If FRAME is t, search only the selected frame.
2488 If FRAME is a frame, search only that frame. */)
2489 (buffer, frame)
2490 Lisp_Object buffer, frame;
2492 /* FRAME uses t and nil to mean the opposite of what window_loop
2493 expects. */
2494 if (NILP (frame))
2495 frame = Qt;
2496 else if (EQ (frame, Qt))
2497 frame = Qnil;
2499 if (!NILP (buffer))
2501 buffer = Fget_buffer (buffer);
2502 CHECK_BUFFER (buffer);
2503 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
2506 return Qnil;
2509 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
2510 Sreplace_buffer_in_windows,
2511 1, 1, "bReplace buffer in windows: ",
2512 doc: /* Replace BUFFER with some other buffer in all windows showing it.
2513 BUFFER may be a buffer or the name of an existing buffer. */)
2514 (buffer)
2515 Lisp_Object buffer;
2517 if (!NILP (buffer))
2519 buffer = Fget_buffer (buffer);
2520 CHECK_BUFFER (buffer);
2521 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
2523 return Qnil;
2526 /* Replace BUFFER with some other buffer in all windows
2527 of all frames, even those on other keyboards. */
2529 void
2530 replace_buffer_in_all_windows (buffer)
2531 Lisp_Object buffer;
2533 #ifdef MULTI_KBOARD
2534 Lisp_Object tail, frame;
2536 /* A single call to window_loop won't do the job
2537 because it only considers frames on the current keyboard.
2538 So loop manually over frames, and handle each one. */
2539 FOR_EACH_FRAME (tail, frame)
2540 window_loop (UNSHOW_BUFFER, buffer, 1, frame);
2541 #else
2542 window_loop (UNSHOW_BUFFER, buffer, 1, Qt);
2543 #endif
2546 /* Set the height of WINDOW and all its inferiors. */
2548 /* The smallest acceptable dimensions for a window. Anything smaller
2549 might crash Emacs. */
2551 #define MIN_SAFE_WINDOW_WIDTH (2)
2552 #define MIN_SAFE_WINDOW_HEIGHT (1)
2554 /* Make sure that window_min_height and window_min_width are
2555 not too small; if they are, set them to safe minima. */
2557 static void
2558 check_min_window_sizes ()
2560 /* Smaller values might permit a crash. */
2561 if (window_min_width < MIN_SAFE_WINDOW_WIDTH)
2562 window_min_width = MIN_SAFE_WINDOW_WIDTH;
2563 if (window_min_height < MIN_SAFE_WINDOW_HEIGHT)
2564 window_min_height = MIN_SAFE_WINDOW_HEIGHT;
2567 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
2568 minimum allowable size. */
2570 void
2571 check_frame_size (frame, rows, cols)
2572 FRAME_PTR frame;
2573 int *rows, *cols;
2575 /* For height, we have to see:
2576 how many windows the frame has at minimum (one or two),
2577 and whether it has a menu bar or other special stuff at the top. */
2578 int min_height
2579 = ((FRAME_MINIBUF_ONLY_P (frame) || ! FRAME_HAS_MINIBUF_P (frame))
2580 ? MIN_SAFE_WINDOW_HEIGHT
2581 : 2 * MIN_SAFE_WINDOW_HEIGHT);
2583 if (FRAME_TOP_MARGIN (frame) > 0)
2584 min_height += FRAME_TOP_MARGIN (frame);
2586 if (*rows < min_height)
2587 *rows = min_height;
2588 if (*cols < MIN_SAFE_WINDOW_WIDTH)
2589 *cols = MIN_SAFE_WINDOW_WIDTH;
2592 /* Value is non-zero if window W is fixed-size. WIDTH_P non-zero means
2593 check if W's width can be changed, otherwise check W's height.
2594 CHECK_SIBLINGS_P non-zero means check resizablity of WINDOW's
2595 siblings, too. If none of the siblings is resizable, WINDOW isn't
2596 either. */
2598 static int
2599 window_fixed_size_p (w, width_p, check_siblings_p)
2600 struct window *w;
2601 int width_p, check_siblings_p;
2603 int fixed_p;
2604 struct window *c;
2606 if (!NILP (w->hchild))
2608 c = XWINDOW (w->hchild);
2610 if (width_p)
2612 /* A horiz. combination is fixed-width if all of if its
2613 children are. */
2614 while (c && window_fixed_size_p (c, width_p, 0))
2615 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2616 fixed_p = c == NULL;
2618 else
2620 /* A horiz. combination is fixed-height if one of if its
2621 children is. */
2622 while (c && !window_fixed_size_p (c, width_p, 0))
2623 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2624 fixed_p = c != NULL;
2627 else if (!NILP (w->vchild))
2629 c = XWINDOW (w->vchild);
2631 if (width_p)
2633 /* A vert. combination is fixed-width if one of if its
2634 children is. */
2635 while (c && !window_fixed_size_p (c, width_p, 0))
2636 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2637 fixed_p = c != NULL;
2639 else
2641 /* A vert. combination is fixed-height if all of if its
2642 children are. */
2643 while (c && window_fixed_size_p (c, width_p, 0))
2644 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2645 fixed_p = c == NULL;
2648 else if (BUFFERP (w->buffer))
2650 struct buffer *old = current_buffer;
2651 Lisp_Object val;
2653 current_buffer = XBUFFER (w->buffer);
2654 val = find_symbol_value (Qwindow_size_fixed);
2655 current_buffer = old;
2657 fixed_p = 0;
2658 if (!EQ (val, Qunbound))
2660 fixed_p = !NILP (val);
2662 if (fixed_p
2663 && ((EQ (val, Qheight) && width_p)
2664 || (EQ (val, Qwidth) && !width_p)))
2665 fixed_p = 0;
2668 /* Can't tell if this one is resizable without looking at
2669 siblings. If all siblings are fixed-size this one is too. */
2670 if (!fixed_p && check_siblings_p && WINDOWP (w->parent))
2672 Lisp_Object child;
2674 for (child = w->prev; WINDOWP (child); child = XWINDOW (child)->prev)
2675 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2676 break;
2678 if (NILP (child))
2679 for (child = w->next; WINDOWP (child); child = XWINDOW (child)->next)
2680 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2681 break;
2683 if (NILP (child))
2684 fixed_p = 1;
2687 else
2688 fixed_p = 1;
2690 return fixed_p;
2693 /* Return the minimum size for leaf window W. WIDTH_P non-zero means
2694 take into account fringes and the scrollbar of W. WIDTH_P zero means
2695 take into account mode-line of W. Return 1 for the minibuffer. */
2697 static int
2698 window_min_size_2 (w, width_p)
2699 struct window *w;
2700 int width_p;
2702 int size;
2704 if (width_p)
2705 size = max (window_min_width,
2706 (MIN_SAFE_WINDOW_WIDTH
2707 + WINDOW_FRINGE_COLS (w)
2708 + WINDOW_SCROLL_BAR_COLS (w)));
2709 else if (MINI_WINDOW_P (w))
2710 size = 1;
2711 else
2712 size = max (window_min_height,
2713 (MIN_SAFE_WINDOW_HEIGHT
2714 /* Don't count the header-line here. It would break
2715 splitting a window with a header-line when the new
2716 window shall have a height of two (calculator does
2717 that). */
2718 + (WINDOW_WANTS_MODELINE_P (w) ? 1 : 0)));
2720 return size;
2723 /* Return the minimum size of window W, not taking fixed-width windows
2724 into account. WIDTH_P non-zero means return the minimum width,
2725 otherwise return the minimum height. If W is a combination window,
2726 compute the minimum size from the minimum sizes of W's children. */
2728 static int
2729 window_min_size_1 (w, width_p)
2730 struct window *w;
2731 int width_p;
2733 struct window *c;
2734 int size;
2736 if (!NILP (w->hchild))
2738 c = XWINDOW (w->hchild);
2739 size = 0;
2741 if (width_p)
2743 /* The min width of a horizontal combination is
2744 the sum of the min widths of its children. */
2745 while (c)
2747 size += window_min_size_1 (c, width_p);
2748 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2751 else
2753 /* The min height a horizontal combination equals
2754 the maximum of all min height of its children. */
2755 while (c)
2757 int min_size = window_min_size_1 (c, width_p);
2758 size = max (min_size, size);
2759 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2763 else if (!NILP (w->vchild))
2765 c = XWINDOW (w->vchild);
2766 size = 0;
2768 if (width_p)
2770 /* The min width of a vertical combination is
2771 the maximum of the min widths of its children. */
2772 while (c)
2774 int min_size = window_min_size_1 (c, width_p);
2775 size = max (min_size, size);
2776 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2779 else
2781 /* The min height of a vertical combination equals
2782 the sum of the min height of its children. */
2783 while (c)
2785 size += window_min_size_1 (c, width_p);
2786 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2790 else
2791 size = window_min_size_2 (w, width_p);
2793 return size;
2797 /* Return the minimum size of window W, taking fixed-size windows into
2798 account. WIDTH_P non-zero means return the minimum width,
2799 otherwise return the minimum height. IGNORE_FIXED_P non-zero means
2800 ignore if W is fixed-size. Set *FIXED to 1 if W is fixed-size
2801 unless FIXED is null. */
2803 static int
2804 window_min_size (w, width_p, ignore_fixed_p, fixed)
2805 struct window *w;
2806 int width_p, ignore_fixed_p, *fixed;
2808 int size, fixed_p;
2810 if (ignore_fixed_p)
2811 fixed_p = 0;
2812 else
2813 fixed_p = window_fixed_size_p (w, width_p, 1);
2815 if (fixed)
2816 *fixed = fixed_p;
2818 if (fixed_p)
2819 size = width_p ? XFASTINT (w->total_cols) : XFASTINT (w->total_lines);
2820 else
2821 size = window_min_size_1 (w, width_p);
2823 return size;
2827 /* Adjust the margins of window W if text area is too small.
2828 Return 1 if window width is ok after adjustment; 0 if window
2829 is still too narrow. */
2831 static int
2832 adjust_window_margins (w)
2833 struct window *w;
2835 int box_cols = (WINDOW_TOTAL_COLS (w)
2836 - WINDOW_FRINGE_COLS (w)
2837 - WINDOW_SCROLL_BAR_COLS (w));
2838 int margin_cols = (WINDOW_LEFT_MARGIN_COLS (w)
2839 + WINDOW_RIGHT_MARGIN_COLS (w));
2841 if (box_cols - margin_cols >= MIN_SAFE_WINDOW_WIDTH)
2842 return 1;
2844 if (margin_cols < 0 || box_cols < MIN_SAFE_WINDOW_WIDTH)
2845 return 0;
2847 /* Window's text area is too narrow, but reducing the window
2848 margins will fix that. */
2849 margin_cols = box_cols - MIN_SAFE_WINDOW_WIDTH;
2850 if (WINDOW_RIGHT_MARGIN_COLS (w) > 0)
2852 if (WINDOW_LEFT_MARGIN_COLS (w) > 0)
2853 w->left_margin_cols = w->right_margin_cols
2854 = make_number (margin_cols/2);
2855 else
2856 w->right_margin_cols = make_number (margin_cols);
2858 else
2859 w->left_margin_cols = make_number (margin_cols);
2860 return 1;
2863 /* Calculate new sizes for windows in the list FORWARD when the window size
2864 goes from TOTAL to SIZE. TOTAL must be greater than SIZE.
2865 The number of windows in FORWARD is NCHILDREN, and the number that
2866 can shrink is SHRINKABLE.
2867 The minimum size a window can have is MIN_SIZE.
2868 If we are shrinking fixed windows, RESIZE_FIXED_P is non-zero.
2869 If we are shrinking columns, WIDTH_P is non-zero, otherwise we are
2870 shrinking rows.
2872 This function returns an allocated array of new sizes that the caller
2873 must free. The size -1 means the window is fixed and RESIZE_FIXED_P
2874 is zero. Array index 0 refers to the first window in FORWARD, 1 to
2875 the second, and so on.
2877 This function tries to keep windows at least at the minimum size
2878 and resize other windows before it resizes any window to zero (i.e.
2879 delete that window).
2881 Windows are resized proportional to their size, so bigger windows
2882 shrink more than smaller windows. */
2883 static int *
2884 shrink_windows (total, size, nchildren, shrinkable,
2885 min_size, resize_fixed_p, forward, width_p)
2886 int total, size, nchildren, shrinkable, min_size;
2887 int resize_fixed_p, width_p;
2888 Lisp_Object forward;
2890 int available_resize = 0;
2891 int *new_sizes;
2892 struct window *c;
2893 Lisp_Object child;
2894 int smallest = total;
2895 int total_removed = 0;
2896 int total_shrink = total - size;
2897 int i;
2899 new_sizes = xmalloc (sizeof (*new_sizes) * nchildren);
2901 for (i = 0, child = forward; !NILP (child); child = c->next, ++i)
2903 int child_size;
2905 c = XWINDOW (child);
2906 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
2908 if (! resize_fixed_p && window_fixed_size_p (c, width_p, 0))
2909 new_sizes[i] = -1;
2910 else
2912 new_sizes[i] = child_size;
2913 if (child_size > min_size)
2914 available_resize += child_size - min_size;
2917 /* We might need to shrink some windows to zero. Find the smallest
2918 windows and set them to 0 until we can fulfil the new size. */
2920 while (shrinkable > 1 && size + available_resize < total)
2922 for (i = 0; i < nchildren; ++i)
2923 if (new_sizes[i] > 0 && smallest > new_sizes[i])
2924 smallest = new_sizes[i];
2926 for (i = 0; i < nchildren; ++i)
2927 if (new_sizes[i] == smallest)
2929 /* Resize this window down to zero. */
2930 new_sizes[i] = 0;
2931 if (smallest > min_size)
2932 available_resize -= smallest - min_size;
2933 available_resize += smallest;
2934 --shrinkable;
2935 total_removed += smallest;
2937 /* We don't know what the smallest is now. */
2938 smallest = total;
2940 /* Out of for, just remove one window at the time and
2941 check again if we have enough space. */
2942 break;
2946 /* Now, calculate the new sizes. Try to shrink each window
2947 proportional to its size. */
2948 for (i = 0; i < nchildren; ++i)
2950 if (new_sizes[i] > min_size)
2952 int to_shrink = total_shrink*new_sizes[i]/total;
2953 if (new_sizes[i] - to_shrink < min_size)
2954 to_shrink = new_sizes[i] - min_size;
2955 new_sizes[i] -= to_shrink;
2956 total_removed += to_shrink;
2960 /* Any reminder due to rounding, we just subtract from windows
2961 that are left and still can be shrunk. */
2962 while (total_shrink > total_removed)
2964 int nonzero_sizes = 0;
2965 int nonzero_idx = -1;
2967 for (i = 0; i < nchildren; ++i)
2968 if (new_sizes[i] > 0)
2970 ++nonzero_sizes;
2971 nonzero_idx = i;
2974 for (i = 0; i < nchildren; ++i)
2975 if (new_sizes[i] > min_size)
2977 --new_sizes[i];
2978 ++total_removed;
2980 /* Out of for, just shrink one window at the time and
2981 check again if we have enough space. */
2982 break;
2986 /* Special case, only one window left. */
2987 if (nonzero_sizes == 1)
2988 break;
2991 /* Any surplus due to rounding, we add to windows that are left. */
2992 while (total_shrink < total_removed)
2994 for (i = 0; i < nchildren; ++i)
2996 if (new_sizes[i] != 0 && total_shrink < total_removed)
2998 ++new_sizes[i];
2999 --total_removed;
3000 break;
3005 return new_sizes;
3008 /* Set WINDOW's height or width to SIZE. WIDTH_P non-zero means set
3009 WINDOW's width. Resize WINDOW's children, if any, so that they
3010 keep their proportionate size relative to WINDOW.
3012 If FIRST_ONLY is 1, change only the first of WINDOW's children when
3013 they are in series. If LAST_ONLY is 1, change only the last of
3014 WINDOW's children when they are in series.
3016 Propagate WINDOW's top or left edge position to children. Delete
3017 windows that become too small unless NODELETE_P is non-zero.
3019 If NODELETE_P is 2, that means we do delete windows that are
3020 too small, even if they were too small before! */
3022 static void
3023 size_window (window, size, width_p, nodelete_p, first_only, last_only)
3024 Lisp_Object window;
3025 int size, width_p, nodelete_p;
3026 int first_only, last_only;
3028 struct window *w = XWINDOW (window);
3029 struct window *c;
3030 Lisp_Object child, *forward, *sideward;
3031 int old_size, min_size, safe_min_size;
3033 check_min_window_sizes ();
3034 size = max (0, size);
3036 /* If the window has been "too small" at one point,
3037 don't delete it for being "too small" in the future.
3038 Preserve it as long as that is at all possible. */
3039 if (width_p)
3041 old_size = WINDOW_TOTAL_COLS (w);
3042 min_size = window_min_width;
3043 safe_min_size = window_min_size_2 (w, 1);
3045 else
3047 old_size = XINT (w->total_lines);
3048 min_size = window_min_height;
3049 safe_min_size = window_min_size_2 (w, 0);
3052 if (old_size < min_size && nodelete_p != 2)
3053 w->too_small_ok = Qt;
3055 /* Move the following test here since otherwise the
3056 preceding test doesn't make sense. martin. */
3057 if (nodelete_p == 2)
3058 nodelete_p = 0;
3060 /* Maybe delete WINDOW if it's too small. */
3061 if (nodelete_p != 1 && !NILP (w->parent))
3063 if (!MINI_WINDOW_P (w) && !NILP (w->too_small_ok))
3064 min_size = width_p ? MIN_SAFE_WINDOW_WIDTH : MIN_SAFE_WINDOW_HEIGHT;
3065 if (min_size < safe_min_size)
3066 min_size = safe_min_size;
3067 if (size < min_size)
3069 delete_window (window);
3070 return;
3074 /* Set redisplay hints. */
3075 w->last_modified = make_number (0);
3076 w->last_overlay_modified = make_number (0);
3077 windows_or_buffers_changed++;
3078 FRAME_WINDOW_SIZES_CHANGED (XFRAME (w->frame)) = 1;
3080 if (width_p)
3082 sideward = &w->vchild;
3083 forward = &w->hchild;
3084 w->total_cols = make_number (size);
3085 adjust_window_margins (w);
3087 else
3089 sideward = &w->hchild;
3090 forward = &w->vchild;
3091 w->total_lines = make_number (size);
3092 w->orig_total_lines = Qnil;
3095 if (!NILP (*sideward))
3097 /* We have a chain of parallel siblings whose size should all change. */
3098 for (child = *sideward; !NILP (child); child = c->next)
3100 c = XWINDOW (child);
3101 if (width_p)
3102 c->left_col = w->left_col;
3103 else
3104 c->top_line = w->top_line;
3105 size_window (child, size, width_p, nodelete_p,
3106 first_only, last_only);
3109 else if (!NILP (*forward) && last_only)
3111 /* Change the last in a series of siblings. */
3112 Lisp_Object last_child;
3113 int child_size;
3115 for (child = *forward; !NILP (child); child = c->next)
3117 c = XWINDOW (child);
3118 last_child = child;
3121 child_size = XINT (width_p ? c->total_cols : c->total_lines);
3122 size_window (last_child,
3123 size - old_size + child_size,
3124 width_p, nodelete_p, first_only, last_only);
3126 else if (!NILP (*forward) && first_only)
3128 /* Change the first in a series of siblings. */
3129 int child_size;
3131 child = *forward;
3132 c = XWINDOW (child);
3134 if (width_p)
3135 c->left_col = w->left_col;
3136 else
3137 c->top_line = w->top_line;
3139 child_size = XINT (width_p ? c->total_cols : c->total_lines);
3140 size_window (child,
3141 size - old_size + child_size,
3142 width_p, nodelete_p, first_only, last_only);
3144 else if (!NILP (*forward))
3146 int fixed_size, each, extra, n;
3147 int resize_fixed_p, nfixed;
3148 int last_pos, first_pos, nchildren, total;
3149 int *new_sizes = NULL;
3151 /* Determine the fixed-size portion of this window, and the
3152 number of child windows. */
3153 fixed_size = nchildren = nfixed = total = 0;
3154 for (child = *forward; !NILP (child); child = c->next, ++nchildren)
3156 int child_size;
3158 c = XWINDOW (child);
3159 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
3160 total += child_size;
3162 if (window_fixed_size_p (c, width_p, 0))
3164 fixed_size += child_size;
3165 ++nfixed;
3169 /* If the new size is smaller than fixed_size, or if there
3170 aren't any resizable windows, allow resizing fixed-size
3171 windows. */
3172 resize_fixed_p = nfixed == nchildren || size < fixed_size;
3174 /* Compute how many lines/columns to add/remove to each child. The
3175 value of extra takes care of rounding errors. */
3176 n = resize_fixed_p ? nchildren : nchildren - nfixed;
3177 if (size < total && n > 1)
3178 new_sizes = shrink_windows (total, size, nchildren, n, min_size,
3179 resize_fixed_p, *forward, width_p);
3180 else
3182 each = (size - total) / n;
3183 extra = (size - total) - n * each;
3186 /* Compute new children heights and edge positions. */
3187 first_pos = width_p ? XINT (w->left_col) : XINT (w->top_line);
3188 last_pos = first_pos;
3189 for (n = 0, child = *forward; !NILP (child); child = c->next, ++n)
3191 int new_size, old_size;
3193 c = XWINDOW (child);
3194 old_size = width_p ? XFASTINT (c->total_cols) : XFASTINT (c->total_lines);
3195 new_size = old_size;
3197 /* The top or left edge position of this child equals the
3198 bottom or right edge of its predecessor. */
3199 if (width_p)
3200 c->left_col = make_number (last_pos);
3201 else
3202 c->top_line = make_number (last_pos);
3204 /* If this child can be resized, do it. */
3205 if (resize_fixed_p || !window_fixed_size_p (c, width_p, 0))
3207 new_size = new_sizes ? new_sizes[n] : old_size + each + extra;
3208 extra = 0;
3211 /* Set new height. Note that size_window also propagates
3212 edge positions to children, so it's not a no-op if we
3213 didn't change the child's size. */
3214 size_window (child, new_size, width_p, 1, first_only, last_only);
3216 /* Remember the bottom/right edge position of this child; it
3217 will be used to set the top/left edge of the next child. */
3218 last_pos += new_size;
3221 if (new_sizes) xfree (new_sizes);
3223 /* We should have covered the parent exactly with child windows. */
3224 xassert (size == last_pos - first_pos);
3226 /* Now delete any children that became too small. */
3227 if (!nodelete_p)
3228 for (child = *forward; !NILP (child); child = c->next)
3230 int child_size;
3231 c = XWINDOW (child);
3232 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
3233 size_window (child, child_size, width_p, 2, first_only, last_only);
3238 /* Set WINDOW's height to HEIGHT, and recursively change the height of
3239 WINDOW's children. NODELETE non-zero means don't delete windows
3240 that become too small in the process. (The caller should check
3241 later and do so if appropriate.) */
3243 void
3244 set_window_height (window, height, nodelete)
3245 Lisp_Object window;
3246 int height;
3247 int nodelete;
3249 size_window (window, height, 0, nodelete, 0, 0);
3253 /* Set WINDOW's width to WIDTH, and recursively change the width of
3254 WINDOW's children. NODELETE non-zero means don't delete windows
3255 that become too small in the process. (The caller should check
3256 later and do so if appropriate.) */
3258 void
3259 set_window_width (window, width, nodelete)
3260 Lisp_Object window;
3261 int width;
3262 int nodelete;
3264 size_window (window, width, 1, nodelete, 0, 0);
3267 /* Change window heights in windows rooted in WINDOW by N lines. */
3269 void
3270 change_window_heights (window, n)
3271 Lisp_Object window;
3272 int n;
3274 struct window *w = XWINDOW (window);
3276 XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n);
3277 XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n);
3279 if (INTEGERP (w->orig_top_line))
3280 XSETFASTINT (w->orig_top_line, XFASTINT (w->orig_top_line) + n);
3281 if (INTEGERP (w->orig_total_lines))
3282 XSETFASTINT (w->orig_total_lines, XFASTINT (w->orig_total_lines) - n);
3284 /* Handle just the top child in a vertical split. */
3285 if (!NILP (w->vchild))
3286 change_window_heights (w->vchild, n);
3288 /* Adjust all children in a horizontal split. */
3289 for (window = w->hchild; !NILP (window); window = w->next)
3291 w = XWINDOW (window);
3292 change_window_heights (window, n);
3297 int window_select_count;
3299 Lisp_Object
3300 Fset_window_buffer_unwind (obuf)
3301 Lisp_Object obuf;
3303 Fset_buffer (obuf);
3304 return Qnil;
3307 EXFUN (Fset_window_fringes, 4);
3308 EXFUN (Fset_window_scroll_bars, 4);
3310 void
3311 run_window_configuration_change_hook (struct frame *f)
3313 if (! NILP (Vwindow_configuration_change_hook)
3314 && ! NILP (Vrun_hooks))
3316 int count = SPECPDL_INDEX ();
3317 if (SELECTED_FRAME () != f)
3319 Lisp_Object frame;
3320 XSETFRAME (frame, f);
3321 record_unwind_protect (Fselect_frame, Fselected_frame ());
3322 Fselect_frame (frame);
3324 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3325 unbind_to (count, Qnil);
3329 /* Make WINDOW display BUFFER as its contents. RUN_HOOKS_P non-zero
3330 means it's allowed to run hooks. See make_frame for a case where
3331 it's not allowed. KEEP_MARGINS_P non-zero means that the current
3332 margins, fringes, and scroll-bar settings of the window are not
3333 reset from the buffer's local settings. */
3335 void
3336 set_window_buffer (window, buffer, run_hooks_p, keep_margins_p)
3337 Lisp_Object window, buffer;
3338 int run_hooks_p, keep_margins_p;
3340 struct window *w = XWINDOW (window);
3341 struct buffer *b = XBUFFER (buffer);
3342 int count = SPECPDL_INDEX ();
3343 int samebuf = EQ (buffer, w->buffer);
3345 w->buffer = buffer;
3347 if (EQ (window, selected_window))
3348 b->last_selected_window = window;
3350 /* Let redisplay errors through. */
3351 b->display_error_modiff = 0;
3353 /* Update time stamps of buffer display. */
3354 if (INTEGERP (b->display_count))
3355 XSETINT (b->display_count, XINT (b->display_count) + 1);
3356 b->display_time = Fcurrent_time ();
3358 XSETFASTINT (w->window_end_pos, 0);
3359 XSETFASTINT (w->window_end_vpos, 0);
3360 bzero (&w->last_cursor, sizeof w->last_cursor);
3361 w->window_end_valid = Qnil;
3362 if (!(keep_margins_p && samebuf))
3363 { /* If we're not actually changing the buffer, Don't reset hscroll and
3364 vscroll. This case happens for example when called from
3365 change_frame_size_1, where we use a dummy call to
3366 Fset_window_buffer on the frame's selected window (and no other)
3367 just in order to run window-configuration-change-hook.
3368 Resetting hscroll and vscroll here is problematic for things like
3369 image-mode and doc-view-mode since it resets the image's position
3370 whenever we resize the frame. */
3371 w->hscroll = w->min_hscroll = make_number (0);
3372 w->vscroll = 0;
3373 set_marker_both (w->pointm, buffer, BUF_PT (b), BUF_PT_BYTE (b));
3374 set_marker_restricted (w->start,
3375 make_number (b->last_window_start),
3376 buffer);
3377 w->start_at_line_beg = Qnil;
3378 w->force_start = Qnil;
3379 XSETFASTINT (w->last_modified, 0);
3380 XSETFASTINT (w->last_overlay_modified, 0);
3382 /* Maybe we could move this into the `if' but it's not obviously safe and
3383 I doubt it's worth the trouble. */
3384 windows_or_buffers_changed++;
3386 /* We must select BUFFER for running the window-scroll-functions.
3387 If WINDOW is selected, switch permanently.
3388 Otherwise, switch but go back to the ambient buffer afterward. */
3389 if (EQ (window, selected_window))
3390 Fset_buffer (buffer);
3391 /* We can't check ! NILP (Vwindow_scroll_functions) here
3392 because that might itself be a local variable. */
3393 else if (window_initialized)
3395 record_unwind_protect (Fset_window_buffer_unwind, Fcurrent_buffer ());
3396 Fset_buffer (buffer);
3399 if (!keep_margins_p)
3401 /* Set left and right marginal area width etc. from buffer. */
3403 /* This may call adjust_window_margins three times, so
3404 temporarily disable window margins. */
3405 Lisp_Object save_left = w->left_margin_cols;
3406 Lisp_Object save_right = w->right_margin_cols;
3408 w->left_margin_cols = w->right_margin_cols = Qnil;
3410 Fset_window_fringes (window,
3411 b->left_fringe_width, b->right_fringe_width,
3412 b->fringes_outside_margins);
3414 Fset_window_scroll_bars (window,
3415 b->scroll_bar_width,
3416 b->vertical_scroll_bar_type, Qnil);
3418 w->left_margin_cols = save_left;
3419 w->right_margin_cols = save_right;
3421 Fset_window_margins (window,
3422 b->left_margin_cols, b->right_margin_cols);
3425 if (run_hooks_p)
3427 if (! NILP (Vwindow_scroll_functions))
3428 run_hook_with_args_2 (Qwindow_scroll_functions, window,
3429 Fmarker_position (w->start));
3430 run_window_configuration_change_hook (XFRAME (WINDOW_FRAME (w)));
3433 unbind_to (count, Qnil);
3437 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 3, 0,
3438 doc: /* Make WINDOW display BUFFER as its contents.
3439 BUFFER can be a buffer or the name of an existing buffer.
3440 Optional third arg KEEP-MARGINS non-nil means that WINDOW's current
3441 display margins, fringe widths, and scroll bar settings are maintained;
3442 the default is to reset these from BUFFER's local settings or the frame
3443 defaults.
3445 This function runs the hook `window-scroll-functions'. */)
3446 (window, buffer, keep_margins)
3447 register Lisp_Object window, buffer, keep_margins;
3449 register Lisp_Object tem;
3450 register struct window *w = decode_window (window);
3452 XSETWINDOW (window, w);
3453 buffer = Fget_buffer (buffer);
3454 CHECK_BUFFER (buffer);
3456 if (NILP (XBUFFER (buffer)->name))
3457 error ("Attempt to display deleted buffer");
3459 tem = w->buffer;
3460 if (NILP (tem))
3461 error ("Window is deleted");
3462 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
3463 is first being set up. */
3465 if (!NILP (w->dedicated) && !EQ (tem, buffer))
3466 error ("Window is dedicated to `%s'",
3467 SDATA (XBUFFER (tem)->name));
3469 unshow_buffer (w);
3472 set_window_buffer (window, buffer, 1, !NILP (keep_margins));
3473 return Qnil;
3476 /* Note that selected_window can be nil
3477 when this is called from Fset_window_configuration. */
3479 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 2, 0,
3480 doc: /* Select WINDOW. Most editing will apply to WINDOW's buffer.
3481 If WINDOW is not already selected, make WINDOW's buffer current
3482 and make WINDOW the frame's selected window. Return WINDOW.
3483 Optional second arg NORECORD non-nil means
3484 do not put this buffer at the front of the list of recently selected ones.
3486 Note that the main editor command loop
3487 selects the buffer of the selected window before each command. */)
3488 (window, norecord)
3489 register Lisp_Object window, norecord;
3491 register struct window *w;
3492 register struct window *ow;
3493 struct frame *sf;
3495 CHECK_LIVE_WINDOW (window);
3497 w = XWINDOW (window);
3498 w->frozen_window_start_p = 0;
3500 ++window_select_count;
3501 XSETFASTINT (w->use_time, window_select_count);
3502 if (EQ (window, selected_window))
3503 return window;
3505 sf = SELECTED_FRAME ();
3506 if (XFRAME (WINDOW_FRAME (w)) != sf)
3508 XFRAME (WINDOW_FRAME (w))->selected_window = window;
3509 /* Use this rather than Fhandle_switch_frame
3510 so that FRAME_FOCUS_FRAME is moved appropriately as we
3511 move around in the state where a minibuffer in a separate
3512 frame is active. */
3513 Fselect_frame (WINDOW_FRAME (w));
3514 /* Fselect_frame called us back so we've done all the work already. */
3515 eassert (EQ (window, selected_window));
3516 return window;
3518 else
3519 sf->selected_window = window;
3521 /* Store the current buffer's actual point into the
3522 old selected window. It belongs to that window,
3523 and when the window is not selected, must be in the window. */
3524 if (!NILP (selected_window))
3526 ow = XWINDOW (selected_window);
3527 if (! NILP (ow->buffer))
3528 set_marker_both (ow->pointm, ow->buffer,
3529 BUF_PT (XBUFFER (ow->buffer)),
3530 BUF_PT_BYTE (XBUFFER (ow->buffer)));
3533 selected_window = window;
3535 if (NILP (norecord))
3536 record_buffer (w->buffer);
3537 Fset_buffer (w->buffer);
3539 XBUFFER (w->buffer)->last_selected_window = window;
3541 /* Go to the point recorded in the window.
3542 This is important when the buffer is in more
3543 than one window. It also matters when
3544 redisplay_window has altered point after scrolling,
3545 because it makes the change only in the window. */
3547 register int new_point = marker_position (w->pointm);
3548 if (new_point < BEGV)
3549 SET_PT (BEGV);
3550 else if (new_point > ZV)
3551 SET_PT (ZV);
3552 else
3553 SET_PT (new_point);
3556 windows_or_buffers_changed++;
3557 return window;
3560 static Lisp_Object
3561 select_window_norecord (window)
3562 Lisp_Object window;
3564 return Fselect_window (window, Qt);
3567 /* Deiconify the frame containing the window WINDOW,
3568 unless it is the selected frame;
3569 then return WINDOW.
3571 The reason for the exception for the selected frame
3572 is that it seems better not to change the selected frames visibility
3573 merely because of displaying a different buffer in it.
3574 The deiconification is useful when a buffer gets shown in
3575 another frame that you were not using lately. */
3577 static Lisp_Object
3578 display_buffer_1 (window)
3579 Lisp_Object window;
3581 Lisp_Object frame = XWINDOW (window)->frame;
3582 FRAME_PTR f = XFRAME (frame);
3584 FRAME_SAMPLE_VISIBILITY (f);
3586 if (EQ (frame, selected_frame))
3587 ; /* Assume the selected frame is already visible enough. */
3588 else if (minibuf_level > 0
3589 && MINI_WINDOW_P (XWINDOW (selected_window))
3590 && WINDOW_LIVE_P (minibuf_selected_window)
3591 && EQ (frame, WINDOW_FRAME (XWINDOW (minibuf_selected_window))))
3592 ; /* Assume the frame from which we invoked the minibuffer is visible. */
3593 else
3595 if (FRAME_ICONIFIED_P (f))
3596 Fmake_frame_visible (frame);
3597 else if (FRAME_VISIBLE_P (f))
3598 Fraise_frame (frame);
3601 return window;
3604 DEFUN ("special-display-p", Fspecial_display_p, Sspecial_display_p, 1, 1, 0,
3605 doc: /* Returns non-nil if a buffer named BUFFER-NAME gets a special frame.
3606 If the value is t, `display-buffer' or `pop-to-buffer' would create a
3607 special frame for that buffer using the default frame parameters.
3609 If the value is a list, it is a list of frame parameters that would be used
3610 to make a frame for that buffer.
3611 The variables `special-display-buffer-names'
3612 and `special-display-regexps' control this. */)
3613 (buffer_name)
3614 Lisp_Object buffer_name;
3616 Lisp_Object tem;
3618 CHECK_STRING (buffer_name);
3620 tem = Fmember (buffer_name, Vspecial_display_buffer_names);
3621 if (!NILP (tem))
3622 return Qt;
3624 tem = Fassoc (buffer_name, Vspecial_display_buffer_names);
3625 if (!NILP (tem))
3626 return XCDR (tem);
3628 for (tem = Vspecial_display_regexps; CONSP (tem); tem = XCDR (tem))
3630 Lisp_Object car = XCAR (tem);
3631 if (STRINGP (car)
3632 && fast_string_match (car, buffer_name) >= 0)
3633 return Qt;
3634 else if (CONSP (car)
3635 && STRINGP (XCAR (car))
3636 && fast_string_match (XCAR (car), buffer_name) >= 0)
3637 return XCDR (car);
3639 return Qnil;
3642 DEFUN ("same-window-p", Fsame_window_p, Ssame_window_p, 1, 1, 0,
3643 doc: /* Returns non-nil if a buffer named BUFFER-NAME would use the same window.
3644 More precisely, if `display-buffer' or `pop-to-buffer' would display
3645 that buffer in the selected window rather than (as usual) in some other window.
3646 See `same-window-buffer-names' and `same-window-regexps'. */)
3647 (buffer_name)
3648 Lisp_Object buffer_name;
3650 Lisp_Object tem;
3652 CHECK_STRING (buffer_name);
3654 tem = Fmember (buffer_name, Vsame_window_buffer_names);
3655 if (!NILP (tem))
3656 return Qt;
3658 tem = Fassoc (buffer_name, Vsame_window_buffer_names);
3659 if (!NILP (tem))
3660 return Qt;
3662 for (tem = Vsame_window_regexps; CONSP (tem); tem = XCDR (tem))
3664 Lisp_Object car = XCAR (tem);
3665 if (STRINGP (car)
3666 && fast_string_match (car, buffer_name) >= 0)
3667 return Qt;
3668 else if (CONSP (car)
3669 && STRINGP (XCAR (car))
3670 && fast_string_match (XCAR (car), buffer_name) >= 0)
3671 return Qt;
3673 return Qnil;
3676 /* Use B so the default is (other-buffer). */
3677 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 3,
3678 "BDisplay buffer: \nP",
3679 doc: /* Make BUFFER appear in some window but don't select it.
3680 BUFFER must be the name of an existing buffer, or, when called from Lisp,
3681 a buffer.
3682 If BUFFER is shown already in some window, just use that one,
3683 unless the window is the selected window and the optional second
3684 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
3685 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
3686 Returns the window displaying BUFFER.
3687 If `display-buffer-reuse-frames' is non-nil, and another frame is currently
3688 displaying BUFFER, then simply raise that frame.
3690 The variables `special-display-buffer-names',
3691 `special-display-regexps', `same-window-buffer-names', and
3692 `same-window-regexps' customize how certain buffer names are handled.
3693 The latter two take effect only if NOT-THIS-WINDOW is nil.
3695 If optional argument FRAME is `visible', check all visible frames
3696 for a window to use.
3697 If FRAME is 0, check all visible and iconified frames.
3698 If FRAME is t, check all frames.
3699 If FRAME is a frame, check only that frame.
3700 If FRAME is nil, check only the selected frame
3701 (actually the last nonminibuffer frame),
3702 unless `pop-up-frames' or `display-buffer-reuse-frames' is non-nil,
3703 which means search visible and iconified frames.
3705 If a full-width window on a splittable frame is available to display
3706 the buffer, it may be split, subject to the value of the variable
3707 `split-height-threshold'.
3709 If `even-window-heights' is non-nil, window heights will be evened out
3710 if displaying the buffer causes two vertically adjacent windows to be
3711 displayed. */)
3712 (buffer, not_this_window, frame)
3713 Lisp_Object buffer, not_this_window, frame;
3715 register Lisp_Object window, tem, swp;
3716 struct frame *f;
3718 swp = Qnil;
3719 buffer = Fget_buffer (buffer);
3720 CHECK_BUFFER (buffer);
3722 if (!NILP (Vdisplay_buffer_function))
3723 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
3725 if (NILP (not_this_window)
3726 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
3727 return display_buffer_1 (selected_window);
3729 /* See if the user has specified this buffer should appear
3730 in the selected window. */
3731 if (NILP (not_this_window))
3733 swp = Fsame_window_p (XBUFFER (buffer)->name);
3734 if (!NILP (swp) && !no_switch_window (selected_window))
3736 Fswitch_to_buffer (buffer, Qnil);
3737 return display_buffer_1 (selected_window);
3741 /* If the user wants pop-up-frames or display-buffer-reuse-frames,
3742 look for a window showing BUFFER on any visible or iconified frame.
3743 Otherwise search only the current frame. */
3744 if (! NILP (frame))
3745 tem = frame;
3746 else if (pop_up_frames
3747 || display_buffer_reuse_frames
3748 || last_nonminibuf_frame == 0)
3749 XSETFASTINT (tem, 0);
3750 else
3751 XSETFRAME (tem, last_nonminibuf_frame);
3753 window = Fget_buffer_window (buffer, tem);
3754 if (!NILP (window)
3755 && (NILP (not_this_window) || !EQ (window, selected_window)))
3756 return display_buffer_1 (window);
3758 /* Certain buffer names get special handling. */
3759 if (!NILP (Vspecial_display_function) && NILP (swp))
3761 tem = Fspecial_display_p (XBUFFER (buffer)->name);
3762 if (EQ (tem, Qt))
3763 return call1 (Vspecial_display_function, buffer);
3764 if (CONSP (tem))
3765 return call2 (Vspecial_display_function, buffer, tem);
3768 /* If there are no frames open that have more than a minibuffer,
3769 we need to create a new frame. */
3770 if (pop_up_frames || last_nonminibuf_frame == 0)
3772 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3773 Fset_window_buffer (window, buffer, Qnil);
3774 return display_buffer_1 (window);
3777 f = SELECTED_FRAME ();
3778 if (pop_up_windows
3779 || FRAME_MINIBUF_ONLY_P (f)
3780 /* If the current frame is a special display frame,
3781 don't try to reuse its windows. */
3782 || !NILP (XWINDOW (FRAME_ROOT_WINDOW (f))->dedicated))
3784 Lisp_Object frames;
3785 struct gcpro gcpro1;
3786 GCPRO1 (buffer);
3788 frames = Qnil;
3789 if (FRAME_MINIBUF_ONLY_P (f))
3790 XSETFRAME (frames, last_nonminibuf_frame);
3792 /* Note that both Fget_largest_window and Fget_lru_window
3793 ignore minibuffers and dedicated windows.
3794 This means they can return nil. */
3796 /* If the frame we would try to split cannot be split,
3797 try other frames. */
3798 if (FRAME_NO_SPLIT_P (NILP (frames) ? f : last_nonminibuf_frame))
3800 /* Try visible frames first. */
3801 window = Fget_largest_window (Qvisible, Qt);
3802 /* If that didn't work, try iconified frames. */
3803 if (NILP (window))
3804 window = Fget_largest_window (make_number (0), Qt);
3805 #if 0 /* Don't try windows on other displays. */
3806 if (NILP (window))
3807 window = Fget_largest_window (Qt, Qt);
3808 #endif
3810 else
3811 window = Fget_largest_window (frames, Qt);
3813 /* If the largest window is tall enough, full-width, and either eligible
3814 for splitting or the only window, split it. */
3815 if (!NILP (window)
3816 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3817 && WINDOW_FULL_WIDTH_P (XWINDOW (window))
3818 && (window_height (window) >= split_height_threshold
3819 || (NILP (XWINDOW (window)->parent)))
3820 && (window_height (window)
3821 >= (2 * window_min_size_2 (XWINDOW (window), 0))))
3822 window = call1 (Vsplit_window_preferred_function, window);
3823 else
3825 Lisp_Object upper, other;
3827 window = Fget_lru_window (frames, Qt);
3828 /* If the LRU window is tall enough, and either eligible for
3829 splitting and selected or the only window, split it. */
3830 if (!NILP (window)
3831 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3832 && ((EQ (window, selected_window)
3833 && window_height (window) >= split_height_threshold)
3834 || (NILP (XWINDOW (window)->parent)))
3835 && (window_height (window)
3836 >= (2 * window_min_size_2 (XWINDOW (window), 0))))
3837 window = call1 (Vsplit_window_preferred_function, window);
3838 else
3839 window = Fget_lru_window (frames, Qnil);
3840 /* If Fget_lru_window returned nil, try other approaches. */
3842 /* Try visible frames first. */
3843 if (NILP (window))
3844 window = Fget_buffer_window (buffer, Qvisible);
3845 if (NILP (window))
3846 window = Fget_largest_window (Qvisible, Qnil);
3847 /* If that didn't work, try iconified frames. */
3848 if (NILP (window))
3849 window = Fget_buffer_window (buffer, make_number (0));
3850 if (NILP (window))
3851 window = Fget_largest_window (make_number (0), Qnil);
3853 #if 0 /* Don't try frames on other displays. */
3854 if (NILP (window))
3855 window = Fget_buffer_window (buffer, Qt);
3856 if (NILP (window))
3857 window = Fget_largest_window (Qt, Qnil);
3858 #endif
3859 /* As a last resort, make a new frame. */
3860 if (NILP (window))
3861 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3862 /* If window appears above or below another,
3863 even out their heights. */
3864 other = upper = Qnil;
3865 if (!NILP (XWINDOW (window)->prev))
3866 other = upper = XWINDOW (window)->prev;
3867 if (!NILP (XWINDOW (window)->next))
3868 other = XWINDOW (window)->next, upper = window;
3869 if (!NILP (other)
3870 && !NILP (Veven_window_heights)
3871 /* Check that OTHER and WINDOW are vertically arrayed. */
3872 && !EQ (XWINDOW (other)->top_line, XWINDOW (window)->top_line)
3873 && (XFASTINT (XWINDOW (other)->total_lines)
3874 > XFASTINT (XWINDOW (window)->total_lines)))
3876 int total = (XFASTINT (XWINDOW (other)->total_lines)
3877 + XFASTINT (XWINDOW (window)->total_lines));
3878 enlarge_window (upper,
3879 total / 2 - XFASTINT (XWINDOW (upper)->total_lines),
3883 UNGCPRO;
3885 else
3886 window = Fget_lru_window (Qnil, Qnil);
3888 Fset_window_buffer (window, buffer, Qnil);
3889 return display_buffer_1 (window);
3893 DEFUN ("force-window-update", Fforce_window_update, Sforce_window_update,
3894 0, 1, 0,
3895 doc: /* Force all windows to be updated on next redisplay.
3896 If optional arg OBJECT is a window, force redisplay of that window only.
3897 If OBJECT is a buffer or buffer name, force redisplay of all windows
3898 displaying that buffer. */)
3899 (object)
3900 Lisp_Object object;
3902 if (NILP (object))
3904 windows_or_buffers_changed++;
3905 update_mode_lines++;
3906 return Qt;
3909 if (WINDOWP (object))
3911 struct window *w = XWINDOW (object);
3912 mark_window_display_accurate (object, 0);
3913 w->update_mode_line = Qt;
3914 if (BUFFERP (w->buffer))
3915 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
3916 ++update_mode_lines;
3917 return Qt;
3920 if (STRINGP (object))
3921 object = Fget_buffer (object);
3922 if (BUFFERP (object) && !NILP (XBUFFER (object)->name))
3924 /* Walk all windows looking for buffer, and force update
3925 of each of those windows. */
3927 object = window_loop (REDISPLAY_BUFFER_WINDOWS, object, 0, Qvisible);
3928 return NILP (object) ? Qnil : Qt;
3931 /* If nothing suitable was found, just return.
3932 We could signal an error, but this feature will typically be used
3933 asynchronously in timers or process sentinels, so we don't. */
3934 return Qnil;
3938 void
3939 temp_output_buffer_show (buf)
3940 register Lisp_Object buf;
3942 register struct buffer *old = current_buffer;
3943 register Lisp_Object window;
3944 register struct window *w;
3946 XBUFFER (buf)->directory = current_buffer->directory;
3948 Fset_buffer (buf);
3949 BUF_SAVE_MODIFF (XBUFFER (buf)) = MODIFF;
3950 BEGV = BEG;
3951 ZV = Z;
3952 SET_PT (BEG);
3953 #if 0 /* rms: there should be no reason for this. */
3954 XBUFFER (buf)->prevent_redisplay_optimizations_p = 1;
3955 #endif
3956 set_buffer_internal (old);
3958 if (!NILP (Vtemp_buffer_show_function))
3959 call1 (Vtemp_buffer_show_function, buf);
3960 else
3962 window = Fdisplay_buffer (buf, Qnil, Qnil);
3964 if (!EQ (XWINDOW (window)->frame, selected_frame))
3965 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
3966 Vminibuf_scroll_window = window;
3967 w = XWINDOW (window);
3968 XSETFASTINT (w->hscroll, 0);
3969 XSETFASTINT (w->min_hscroll, 0);
3970 set_marker_restricted_both (w->start, buf, BEG, BEG);
3971 set_marker_restricted_both (w->pointm, buf, BEG, BEG);
3973 /* Run temp-buffer-show-hook, with the chosen window selected
3974 and its buffer current. */
3976 if (!NILP (Vrun_hooks)
3977 && !NILP (Fboundp (Qtemp_buffer_show_hook))
3978 && !NILP (Fsymbol_value (Qtemp_buffer_show_hook)))
3980 int count = SPECPDL_INDEX ();
3981 Lisp_Object prev_window, prev_buffer;
3982 prev_window = selected_window;
3983 XSETBUFFER (prev_buffer, old);
3985 /* Select the window that was chosen, for running the hook.
3986 Note: Both Fselect_window and select_window_norecord may
3987 set-buffer to the buffer displayed in the window,
3988 so we need to save the current buffer. --stef */
3989 record_unwind_protect (Fset_buffer, prev_buffer);
3990 record_unwind_protect (select_window_norecord, prev_window);
3991 Fselect_window (window, Qt);
3992 Fset_buffer (w->buffer);
3993 call1 (Vrun_hooks, Qtemp_buffer_show_hook);
3994 unbind_to (count, Qnil);
3999 static void
4000 make_dummy_parent (window)
4001 Lisp_Object window;
4003 Lisp_Object new;
4004 register struct window *o, *p;
4005 int i;
4007 o = XWINDOW (window);
4008 p = allocate_window ();
4009 for (i = 0; i < VECSIZE (struct window); ++i)
4010 ((struct Lisp_Vector *) p)->contents[i]
4011 = ((struct Lisp_Vector *)o)->contents[i];
4012 XSETWINDOW (new, p);
4014 ++sequence_number;
4015 XSETFASTINT (p->sequence_number, sequence_number);
4017 /* Put new into window structure in place of window */
4018 replace_window (window, new);
4020 o->next = Qnil;
4021 o->prev = Qnil;
4022 o->vchild = Qnil;
4023 o->hchild = Qnil;
4024 o->parent = new;
4026 p->start = Qnil;
4027 p->pointm = Qnil;
4028 p->buffer = Qnil;
4031 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
4032 doc: /* Split WINDOW, putting SIZE lines in the first of the pair.
4033 WINDOW defaults to selected one and SIZE to half its size.
4034 If optional third arg HORFLAG is non-nil, split side by side
4035 and put SIZE columns in the first of the pair. In that case,
4036 SIZE includes that window's scroll bar, or the divider column to its right.
4037 Interactively, all arguments are nil.
4039 Returns the newly created window (which is the lower or rightmost one).
4040 The upper or leftmost window is the original one, and remains selected
4041 if it was selected before.
4043 See Info node `(elisp)Splitting Windows' for more details and examples.*/)
4044 (window, size, horflag)
4045 Lisp_Object window, size, horflag;
4047 register Lisp_Object new;
4048 register struct window *o, *p;
4049 FRAME_PTR fo;
4050 register int size_int;
4052 if (NILP (window))
4053 window = selected_window;
4054 else
4055 CHECK_LIVE_WINDOW (window);
4057 o = XWINDOW (window);
4058 fo = XFRAME (WINDOW_FRAME (o));
4060 if (NILP (size))
4062 if (!NILP (horflag))
4063 /* Calculate the size of the left-hand window, by dividing
4064 the usable space in columns by two.
4065 We round up, since the left-hand window may include
4066 a dividing line, while the right-hand may not. */
4067 size_int = (XFASTINT (o->total_cols) + 1) >> 1;
4068 else
4069 size_int = XFASTINT (o->total_lines) >> 1;
4071 else
4073 CHECK_NUMBER (size);
4074 size_int = XINT (size);
4077 if (MINI_WINDOW_P (o))
4078 error ("Attempt to split minibuffer window");
4079 else if (window_fixed_size_p (o, !NILP (horflag), 0))
4080 error ("Attempt to split fixed-size window");
4082 check_min_window_sizes ();
4084 if (NILP (horflag))
4086 int window_safe_height = window_min_size_2 (o, 0);
4088 if (size_int < window_safe_height)
4089 error ("Window height %d too small (after splitting)", size_int);
4090 if (size_int + window_safe_height > XFASTINT (o->total_lines))
4091 error ("Window height %d too small (after splitting)",
4092 XFASTINT (o->total_lines) - size_int);
4093 if (NILP (o->parent)
4094 || NILP (XWINDOW (o->parent)->vchild))
4096 make_dummy_parent (window);
4097 new = o->parent;
4098 XWINDOW (new)->vchild = window;
4101 else
4103 int window_safe_width = window_min_size_2 (o, 1);
4105 if (size_int < window_safe_width)
4106 error ("Window width %d too small (after splitting)", size_int);
4107 if (size_int + window_safe_width > XFASTINT (o->total_cols))
4108 error ("Window width %d too small (after splitting)",
4109 XFASTINT (o->total_cols) - size_int);
4110 if (NILP (o->parent)
4111 || NILP (XWINDOW (o->parent)->hchild))
4113 make_dummy_parent (window);
4114 new = o->parent;
4115 XWINDOW (new)->hchild = window;
4119 /* Now we know that window's parent is a vertical combination
4120 if we are dividing vertically, or a horizontal combination
4121 if we are making side-by-side windows */
4123 windows_or_buffers_changed++;
4124 FRAME_WINDOW_SIZES_CHANGED (fo) = 1;
4125 new = make_window ();
4126 p = XWINDOW (new);
4128 p->frame = o->frame;
4129 p->next = o->next;
4130 if (!NILP (p->next))
4131 XWINDOW (p->next)->prev = new;
4132 p->prev = window;
4133 o->next = new;
4134 p->parent = o->parent;
4135 p->buffer = Qt;
4136 p->window_end_valid = Qnil;
4137 bzero (&p->last_cursor, sizeof p->last_cursor);
4139 /* Duplicate special geometry settings. */
4141 p->left_margin_cols = o->left_margin_cols;
4142 p->right_margin_cols = o->right_margin_cols;
4143 p->left_fringe_width = o->left_fringe_width;
4144 p->right_fringe_width = o->right_fringe_width;
4145 p->fringes_outside_margins = o->fringes_outside_margins;
4146 p->scroll_bar_width = o->scroll_bar_width;
4147 p->vertical_scroll_bar_type = o->vertical_scroll_bar_type;
4149 /* Apportion the available frame space among the two new windows */
4151 if (!NILP (horflag))
4153 p->total_lines = o->total_lines;
4154 p->top_line = o->top_line;
4155 XSETFASTINT (p->total_cols, XFASTINT (o->total_cols) - size_int);
4156 XSETFASTINT (o->total_cols, size_int);
4157 XSETFASTINT (p->left_col, XFASTINT (o->left_col) + size_int);
4158 adjust_window_margins (p);
4159 adjust_window_margins (o);
4161 else
4163 p->left_col = o->left_col;
4164 p->total_cols = o->total_cols;
4165 XSETFASTINT (p->total_lines, XFASTINT (o->total_lines) - size_int);
4166 XSETFASTINT (o->total_lines, size_int);
4167 XSETFASTINT (p->top_line, XFASTINT (o->top_line) + size_int);
4170 /* Adjust glyph matrices. */
4171 adjust_glyphs (fo);
4173 Fset_window_buffer (new, o->buffer, Qt);
4174 return new;
4177 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 2, "p",
4178 doc: /* Make current window ARG lines bigger.
4179 From program, optional second arg non-nil means grow sideways ARG columns.
4180 Interactively, if an argument is not given, make the window one line bigger.
4181 If HORIZONTAL is non-nil, enlarge horizontally instead of vertically.
4182 This function can delete windows, even the second window, if they get
4183 too small. */)
4184 (arg, horizontal)
4185 Lisp_Object arg, horizontal;
4187 CHECK_NUMBER (arg);
4188 enlarge_window (selected_window, XINT (arg), !NILP (horizontal));
4190 if (! NILP (Vwindow_configuration_change_hook))
4191 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4193 return Qnil;
4196 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
4197 doc: /* Make current window ARG lines smaller.
4198 From program, optional second arg non-nil means shrink sideways arg columns.
4199 Interactively, if an argument is not given, make the window one line smaller.
4200 Only siblings to the right or below are changed. */)
4201 (arg, side)
4202 Lisp_Object arg, side;
4204 CHECK_NUMBER (arg);
4205 enlarge_window (selected_window, -XINT (arg), !NILP (side));
4207 if (! NILP (Vwindow_configuration_change_hook))
4208 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4210 return Qnil;
4214 window_height (window)
4215 Lisp_Object window;
4217 register struct window *p = XWINDOW (window);
4218 return WINDOW_TOTAL_LINES (p);
4222 window_width (window)
4223 Lisp_Object window;
4225 register struct window *p = XWINDOW (window);
4226 return WINDOW_TOTAL_COLS (p);
4230 #define CURBEG(w) \
4231 *(horiz_flag ? &(XWINDOW (w)->left_col) : &(XWINDOW (w)->top_line))
4233 #define CURSIZE(w) \
4234 *(horiz_flag ? &(XWINDOW (w)->total_cols) : &(XWINDOW (w)->total_lines))
4237 /* Enlarge WINDOW by DELTA.
4238 HORIZ_FLAG nonzero means enlarge it horizontally;
4239 zero means do it vertically.
4241 Siblings of the selected window are resized to fulfill the size
4242 request. If they become too small in the process, they will be
4243 deleted. */
4245 static void
4246 enlarge_window (window, delta, horiz_flag)
4247 Lisp_Object window;
4248 int delta, horiz_flag;
4250 Lisp_Object parent, next, prev;
4251 struct window *p;
4252 Lisp_Object *sizep;
4253 int maximum;
4254 int (*sizefun) P_ ((Lisp_Object))
4255 = horiz_flag ? window_width : window_height;
4256 void (*setsizefun) P_ ((Lisp_Object, int, int))
4257 = (horiz_flag ? set_window_width : set_window_height);
4259 /* Check values of window_min_width and window_min_height for
4260 validity. */
4261 check_min_window_sizes ();
4263 /* Give up if this window cannot be resized. */
4264 if (window_fixed_size_p (XWINDOW (window), horiz_flag, 1))
4265 error ("Window is not resizable");
4267 /* Find the parent of the selected window. */
4268 while (1)
4270 p = XWINDOW (window);
4271 parent = p->parent;
4273 if (NILP (parent))
4275 if (horiz_flag)
4276 error ("No other window to side of this one");
4277 break;
4280 if (horiz_flag
4281 ? !NILP (XWINDOW (parent)->hchild)
4282 : !NILP (XWINDOW (parent)->vchild))
4283 break;
4285 window = parent;
4288 sizep = &CURSIZE (window);
4291 register int maxdelta;
4293 /* Compute the maximum size increment this window can have. */
4295 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - XINT (*sizep)
4296 /* This is a main window followed by a minibuffer. */
4297 : !NILP (p->next) ? ((*sizefun) (p->next)
4298 - window_min_size (XWINDOW (p->next),
4299 horiz_flag, 0, 0))
4300 /* This is a minibuffer following a main window. */
4301 : !NILP (p->prev) ? ((*sizefun) (p->prev)
4302 - window_min_size (XWINDOW (p->prev),
4303 horiz_flag, 0, 0))
4304 /* This is a frame with only one window, a minibuffer-only
4305 or a minibufferless frame. */
4306 : (delta = 0));
4308 if (delta > maxdelta)
4309 /* This case traps trying to make the minibuffer
4310 the full frame, or make the only window aside from the
4311 minibuffer the full frame. */
4312 delta = maxdelta;
4315 if (XINT (*sizep) + delta < window_min_size (XWINDOW (window), horiz_flag, 0, 0))
4317 delete_window (window);
4318 return;
4321 if (delta == 0)
4322 return;
4324 /* Find the total we can get from other siblings without deleting them. */
4325 maximum = 0;
4326 for (next = p->next; WINDOWP (next); next = XWINDOW (next)->next)
4327 maximum += (*sizefun) (next) - window_min_size (XWINDOW (next),
4328 horiz_flag, 0, 0);
4329 for (prev = p->prev; WINDOWP (prev); prev = XWINDOW (prev)->prev)
4330 maximum += (*sizefun) (prev) - window_min_size (XWINDOW (prev),
4331 horiz_flag, 0, 0);
4333 /* If we can get it all from them without deleting them, do so. */
4334 if (delta <= maximum)
4336 Lisp_Object first_unaffected;
4337 Lisp_Object first_affected;
4338 int fixed_p;
4340 next = p->next;
4341 prev = p->prev;
4342 first_affected = window;
4343 /* Look at one sibling at a time,
4344 moving away from this window in both directions alternately,
4345 and take as much as we can get without deleting that sibling. */
4346 while (delta != 0
4347 && (!NILP (next) || !NILP (prev)))
4349 if (! NILP (next))
4351 int this_one = ((*sizefun) (next)
4352 - window_min_size (XWINDOW (next),
4353 horiz_flag, 0, &fixed_p));
4354 if (!fixed_p)
4356 if (this_one > delta)
4357 this_one = delta;
4359 (*setsizefun) (next, (*sizefun) (next) - this_one, 0);
4360 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
4362 delta -= this_one;
4365 next = XWINDOW (next)->next;
4368 if (delta == 0)
4369 break;
4371 if (! NILP (prev))
4373 int this_one = ((*sizefun) (prev)
4374 - window_min_size (XWINDOW (prev),
4375 horiz_flag, 0, &fixed_p));
4376 if (!fixed_p)
4378 if (this_one > delta)
4379 this_one = delta;
4381 first_affected = prev;
4383 (*setsizefun) (prev, (*sizefun) (prev) - this_one, 0);
4384 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
4386 delta -= this_one;
4389 prev = XWINDOW (prev)->prev;
4393 xassert (delta == 0);
4395 /* Now recalculate the edge positions of all the windows affected,
4396 based on the new sizes. */
4397 first_unaffected = next;
4398 prev = first_affected;
4399 for (next = XWINDOW (prev)->next; ! EQ (next, first_unaffected);
4400 prev = next, next = XWINDOW (next)->next)
4402 XSETINT (CURBEG (next), XINT (CURBEG (prev)) + (*sizefun) (prev));
4403 /* This does not change size of NEXT,
4404 but it propagates the new top edge to its children */
4405 (*setsizefun) (next, (*sizefun) (next), 0);
4408 else
4410 register int delta1;
4411 register int opht = (*sizefun) (parent);
4413 if (opht <= XINT (*sizep) + delta)
4415 /* If trying to grow this window to or beyond size of the parent,
4416 just delete all the sibling windows. */
4417 Lisp_Object start, tem, next;
4419 start = XWINDOW (parent)->vchild;
4420 if (NILP (start))
4421 start = XWINDOW (parent)->hchild;
4423 /* Delete any siblings that come after WINDOW. */
4424 tem = XWINDOW (window)->next;
4425 while (! NILP (tem))
4427 next = XWINDOW (tem)->next;
4428 delete_window (tem);
4429 tem = next;
4432 /* Delete any siblings that come after WINDOW.
4433 Note that if START is not WINDOW, then WINDOW still
4434 Fhas siblings, so WINDOW has not yet replaced its parent. */
4435 tem = start;
4436 while (! EQ (tem, window))
4438 next = XWINDOW (tem)->next;
4439 delete_window (tem);
4440 tem = next;
4443 else
4445 /* Otherwise, make delta1 just right so that if we add
4446 delta1 lines to this window and to the parent, and then
4447 shrink the parent back to its original size, the new
4448 proportional size of this window will increase by delta.
4450 The function size_window will compute the new height h'
4451 of the window from delta1 as:
4453 e = delta1/n
4454 x = delta1 - delta1/n * n for the 1st resizable child
4455 h' = h + e + x
4457 where n is the number of children that can be resized.
4458 We can ignore x by choosing a delta1 that is a multiple of
4459 n. We want the height of this window to come out as
4461 h' = h + delta
4463 So, delta1 must be
4465 h + e = h + delta
4466 delta1/n = delta
4467 delta1 = n * delta.
4469 The number of children n equals the number of resizable
4470 children of this window + 1 because we know window itself
4471 is resizable (otherwise we would have signalled an error). */
4473 struct window *w = XWINDOW (window);
4474 Lisp_Object s;
4475 int n = 1;
4477 for (s = w->next; WINDOWP (s); s = XWINDOW (s)->next)
4478 if (!window_fixed_size_p (XWINDOW (s), horiz_flag, 0))
4479 ++n;
4480 for (s = w->prev; WINDOWP (s); s = XWINDOW (s)->prev)
4481 if (!window_fixed_size_p (XWINDOW (s), horiz_flag, 0))
4482 ++n;
4484 delta1 = n * delta;
4486 /* Add delta1 lines or columns to this window, and to the parent,
4487 keeping things consistent while not affecting siblings. */
4488 XSETINT (CURSIZE (parent), opht + delta1);
4489 (*setsizefun) (window, XINT (*sizep) + delta1, 0);
4491 /* Squeeze out delta1 lines or columns from our parent,
4492 shriking this window and siblings proportionately.
4493 This brings parent back to correct size.
4494 Delta1 was calculated so this makes this window the desired size,
4495 taking it all out of the siblings. */
4496 (*setsizefun) (parent, opht, 0);
4501 XSETFASTINT (p->last_modified, 0);
4502 XSETFASTINT (p->last_overlay_modified, 0);
4504 /* Adjust glyph matrices. */
4505 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
4509 /* Adjust the size of WINDOW by DELTA, moving only its trailing edge.
4510 HORIZ_FLAG nonzero means adjust the width, moving the right edge.
4511 zero means adjust the height, moving the bottom edge.
4513 Following siblings of the selected window are resized to fulfill
4514 the size request. If they become too small in the process, they
4515 are not deleted; instead, we signal an error. */
4517 static void
4518 adjust_window_trailing_edge (window, delta, horiz_flag)
4519 Lisp_Object window;
4520 int delta, horiz_flag;
4522 Lisp_Object parent, child;
4523 struct window *p;
4524 Lisp_Object old_config = Fcurrent_window_configuration (Qnil);
4525 int delcount = window_deletion_count;
4527 /* Check values of window_min_width and window_min_height for
4528 validity. */
4529 check_min_window_sizes ();
4531 if (NILP (window))
4532 window = Fselected_window ();
4534 CHECK_WINDOW (window);
4536 /* Give up if this window cannot be resized. */
4537 if (window_fixed_size_p (XWINDOW (window), horiz_flag, 1))
4538 error ("Window is not resizable");
4540 while (1)
4542 Lisp_Object first_parallel = Qnil;
4544 if (NILP (window))
4546 /* This happens if WINDOW on the previous iteration was
4547 at top level of the window tree. */
4548 Fset_window_configuration (old_config);
4549 error ("Specified window edge is fixed");
4552 p = XWINDOW (window);
4553 parent = p->parent;
4555 /* See if this level has windows in parallel in the specified
4556 direction. If so, set FIRST_PARALLEL to the first one. */
4557 if (horiz_flag)
4559 if (! NILP (parent) && !NILP (XWINDOW (parent)->vchild))
4560 first_parallel = XWINDOW (parent)->vchild;
4561 else if (NILP (parent) && !NILP (p->next))
4563 /* Handle the vertical chain of main window and minibuffer
4564 which has no parent. */
4565 first_parallel = window;
4566 while (! NILP (XWINDOW (first_parallel)->prev))
4567 first_parallel = XWINDOW (first_parallel)->prev;
4570 else
4572 if (! NILP (parent) && !NILP (XWINDOW (parent)->hchild))
4573 first_parallel = XWINDOW (parent)->hchild;
4576 /* If this level's succession is in the desired dimension,
4577 and this window is the last one, and there is no higher level,
4578 its trailing edge is fixed. */
4579 if (NILP (XWINDOW (window)->next) && NILP (first_parallel)
4580 && NILP (parent))
4582 Fset_window_configuration (old_config);
4583 error ("Specified window edge is fixed");
4586 /* Don't make this window too small. */
4587 if (XINT (CURSIZE (window)) + delta
4588 < window_min_size_2 (XWINDOW (window), horiz_flag))
4590 Fset_window_configuration (old_config);
4591 error ("Cannot adjust window size as specified");
4594 /* Clear out some redisplay caches. */
4595 XSETFASTINT (p->last_modified, 0);
4596 XSETFASTINT (p->last_overlay_modified, 0);
4598 /* Adjust this window's edge. */
4599 XSETINT (CURSIZE (window),
4600 XINT (CURSIZE (window)) + delta);
4602 /* If this window has following siblings in the desired dimension,
4603 make them smaller, and exit the loop.
4605 (If we reach the top of the tree and can never do this,
4606 we will fail and report an error, above.) */
4607 if (NILP (first_parallel))
4609 if (!NILP (p->next))
4611 /* This may happen for the minibuffer. In that case
4612 the window_deletion_count check below does not work. */
4613 if (XINT (CURSIZE (p->next)) - delta <= 0)
4615 Fset_window_configuration (old_config);
4616 error ("Cannot adjust window size as specified");
4619 XSETINT (CURBEG (p->next),
4620 XINT (CURBEG (p->next)) + delta);
4621 size_window (p->next, XINT (CURSIZE (p->next)) - delta,
4622 horiz_flag, 0, 1, 0);
4623 break;
4626 else
4627 /* Here we have a chain of parallel siblings, in the other dimension.
4628 Change the size of the other siblings. */
4629 for (child = first_parallel;
4630 ! NILP (child);
4631 child = XWINDOW (child)->next)
4632 if (! EQ (child, window))
4633 size_window (child, XINT (CURSIZE (child)) + delta,
4634 horiz_flag, 0, 0, 1);
4636 window = parent;
4639 /* If we made a window so small it got deleted,
4640 we failed. Report failure. */
4641 if (delcount != window_deletion_count)
4643 Fset_window_configuration (old_config);
4644 error ("Cannot adjust window size as specified");
4647 /* Adjust glyph matrices. */
4648 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
4651 #undef CURBEG
4652 #undef CURSIZE
4654 DEFUN ("adjust-window-trailing-edge", Fadjust_window_trailing_edge,
4655 Sadjust_window_trailing_edge, 3, 3, 0,
4656 doc: /* Adjust the bottom or right edge of WINDOW by DELTA.
4657 If HORIZONTAL is non-nil, that means adjust the width, moving the right edge.
4658 Otherwise, adjust the height, moving the bottom edge.
4660 Following siblings of the selected window are resized to fulfill
4661 the size request. If they become too small in the process, they
4662 are not deleted; instead, we signal an error. */)
4663 (window, delta, horizontal)
4664 Lisp_Object window, delta, horizontal;
4666 CHECK_NUMBER (delta);
4667 adjust_window_trailing_edge (window, XINT (delta), !NILP (horizontal));
4669 if (! NILP (Vwindow_configuration_change_hook))
4670 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4672 return Qnil;
4677 /***********************************************************************
4678 Resizing Mini-Windows
4679 ***********************************************************************/
4681 static void shrink_window_lowest_first P_ ((struct window *, int));
4683 enum save_restore_action
4685 CHECK_ORIG_SIZES,
4686 SAVE_ORIG_SIZES,
4687 RESTORE_ORIG_SIZES
4690 static int save_restore_orig_size P_ ((struct window *,
4691 enum save_restore_action));
4693 /* Shrink windows rooted in window W to HEIGHT. Take the space needed
4694 from lowest windows first. */
4696 static void
4697 shrink_window_lowest_first (w, height)
4698 struct window *w;
4699 int height;
4701 struct window *c;
4702 Lisp_Object child;
4703 int old_height;
4705 xassert (!MINI_WINDOW_P (w));
4707 /* Set redisplay hints. */
4708 XSETFASTINT (w->last_modified, 0);
4709 XSETFASTINT (w->last_overlay_modified, 0);
4710 windows_or_buffers_changed++;
4711 FRAME_WINDOW_SIZES_CHANGED (XFRAME (WINDOW_FRAME (w))) = 1;
4713 old_height = XFASTINT (w->total_lines);
4714 XSETFASTINT (w->total_lines, height);
4716 if (!NILP (w->hchild))
4718 for (child = w->hchild; !NILP (child); child = c->next)
4720 c = XWINDOW (child);
4721 c->top_line = w->top_line;
4722 shrink_window_lowest_first (c, height);
4725 else if (!NILP (w->vchild))
4727 Lisp_Object last_child;
4728 int delta = old_height - height;
4729 int last_top;
4731 last_child = Qnil;
4733 /* Find the last child. We are taking space from lowest windows
4734 first, so we iterate over children from the last child
4735 backwards. */
4736 for (child = w->vchild; WINDOWP (child); child = XWINDOW (child)->next)
4737 last_child = child;
4739 /* Assign new heights. We leave only MIN_SAFE_WINDOW_HEIGHT. */
4740 for (child = last_child; delta && !NILP (child); child = c->prev)
4742 int this_one;
4744 c = XWINDOW (child);
4745 this_one = XFASTINT (c->total_lines) - MIN_SAFE_WINDOW_HEIGHT;
4747 if (this_one > delta)
4748 this_one = delta;
4750 shrink_window_lowest_first (c, XFASTINT (c->total_lines) - this_one);
4751 delta -= this_one;
4754 /* Compute new positions. */
4755 last_top = XINT (w->top_line);
4756 for (child = w->vchild; !NILP (child); child = c->next)
4758 c = XWINDOW (child);
4759 c->top_line = make_number (last_top);
4760 shrink_window_lowest_first (c, XFASTINT (c->total_lines));
4761 last_top += XFASTINT (c->total_lines);
4767 /* Save, restore, or check positions and sizes in the window tree
4768 rooted at W. ACTION says what to do.
4770 If ACTION is CHECK_ORIG_SIZES, check if orig_top_line and
4771 orig_total_lines members are valid for all windows in the window
4772 tree. Value is non-zero if they are valid.
4774 If ACTION is SAVE_ORIG_SIZES, save members top and height in
4775 orig_top_line and orig_total_lines for all windows in the tree.
4777 If ACTION is RESTORE_ORIG_SIZES, restore top and height from values
4778 stored in orig_top_line and orig_total_lines for all windows. */
4780 static int
4781 save_restore_orig_size (w, action)
4782 struct window *w;
4783 enum save_restore_action action;
4785 int success_p = 1;
4787 while (w)
4789 if (!NILP (w->hchild))
4791 if (!save_restore_orig_size (XWINDOW (w->hchild), action))
4792 success_p = 0;
4794 else if (!NILP (w->vchild))
4796 if (!save_restore_orig_size (XWINDOW (w->vchild), action))
4797 success_p = 0;
4800 switch (action)
4802 case CHECK_ORIG_SIZES:
4803 if (!INTEGERP (w->orig_top_line) || !INTEGERP (w->orig_total_lines))
4804 return 0;
4805 break;
4807 case SAVE_ORIG_SIZES:
4808 w->orig_top_line = w->top_line;
4809 w->orig_total_lines = w->total_lines;
4810 XSETFASTINT (w->last_modified, 0);
4811 XSETFASTINT (w->last_overlay_modified, 0);
4812 break;
4814 case RESTORE_ORIG_SIZES:
4815 xassert (INTEGERP (w->orig_top_line) && INTEGERP (w->orig_total_lines));
4816 w->top_line = w->orig_top_line;
4817 w->total_lines = w->orig_total_lines;
4818 w->orig_total_lines = w->orig_top_line = Qnil;
4819 XSETFASTINT (w->last_modified, 0);
4820 XSETFASTINT (w->last_overlay_modified, 0);
4821 break;
4823 default:
4824 abort ();
4827 w = NILP (w->next) ? NULL : XWINDOW (w->next);
4830 return success_p;
4834 /* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we can
4835 without deleting other windows. */
4837 void
4838 grow_mini_window (w, delta)
4839 struct window *w;
4840 int delta;
4842 struct frame *f = XFRAME (w->frame);
4843 struct window *root;
4845 xassert (MINI_WINDOW_P (w));
4846 xassert (delta >= 0);
4848 /* Check values of window_min_width and window_min_height for
4849 validity. */
4850 check_min_window_sizes ();
4852 /* Compute how much we can enlarge the mini-window without deleting
4853 other windows. */
4854 root = XWINDOW (FRAME_ROOT_WINDOW (f));
4855 if (delta)
4857 int min_height = window_min_size (root, 0, 0, 0);
4858 if (XFASTINT (root->total_lines) - delta < min_height)
4859 /* Note that the root window may already be smaller than
4860 min_height. */
4861 delta = max (0, XFASTINT (root->total_lines) - min_height);
4864 if (delta)
4866 /* Save original window sizes and positions, if not already done. */
4867 if (!save_restore_orig_size (root, CHECK_ORIG_SIZES))
4868 save_restore_orig_size (root, SAVE_ORIG_SIZES);
4870 /* Shrink other windows. */
4871 shrink_window_lowest_first (root, XFASTINT (root->total_lines) - delta);
4873 /* Grow the mini-window. */
4874 w->top_line = make_number (XFASTINT (root->top_line) + XFASTINT (root->total_lines));
4875 w->total_lines = make_number (XFASTINT (w->total_lines) + delta);
4876 XSETFASTINT (w->last_modified, 0);
4877 XSETFASTINT (w->last_overlay_modified, 0);
4879 adjust_glyphs (f);
4884 /* Shrink mini-window W. If there is recorded info about window sizes
4885 before a call to grow_mini_window, restore recorded window sizes.
4886 Otherwise, if the mini-window is higher than 1 line, resize it to 1
4887 line. */
4889 void
4890 shrink_mini_window (w)
4891 struct window *w;
4893 struct frame *f = XFRAME (w->frame);
4894 struct window *root = XWINDOW (FRAME_ROOT_WINDOW (f));
4896 if (save_restore_orig_size (root, CHECK_ORIG_SIZES))
4898 save_restore_orig_size (root, RESTORE_ORIG_SIZES);
4899 adjust_glyphs (f);
4900 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
4901 windows_or_buffers_changed = 1;
4903 else if (XFASTINT (w->total_lines) > 1)
4905 /* Distribute the additional lines of the mini-window
4906 among the other windows. */
4907 Lisp_Object window;
4908 XSETWINDOW (window, w);
4909 enlarge_window (window, 1 - XFASTINT (w->total_lines), 0);
4915 /* Mark window cursors off for all windows in the window tree rooted
4916 at W by setting their phys_cursor_on_p flag to zero. Called from
4917 xterm.c, e.g. when a frame is cleared and thereby all cursors on
4918 the frame are cleared. */
4920 void
4921 mark_window_cursors_off (w)
4922 struct window *w;
4924 while (w)
4926 if (!NILP (w->hchild))
4927 mark_window_cursors_off (XWINDOW (w->hchild));
4928 else if (!NILP (w->vchild))
4929 mark_window_cursors_off (XWINDOW (w->vchild));
4930 else
4931 w->phys_cursor_on_p = 0;
4933 w = NILP (w->next) ? 0 : XWINDOW (w->next);
4938 /* Return number of lines of text (not counting mode lines) in W. */
4941 window_internal_height (w)
4942 struct window *w;
4944 int ht = XFASTINT (w->total_lines);
4946 if (!MINI_WINDOW_P (w))
4948 if (!NILP (w->parent)
4949 || !NILP (w->vchild)
4950 || !NILP (w->hchild)
4951 || !NILP (w->next)
4952 || !NILP (w->prev)
4953 || WINDOW_WANTS_MODELINE_P (w))
4954 --ht;
4956 if (WINDOW_WANTS_HEADER_LINE_P (w))
4957 --ht;
4960 return ht;
4964 /* Return the number of columns in W.
4965 Don't count columns occupied by scroll bars or the vertical bar
4966 separating W from the sibling to its right. */
4969 window_box_text_cols (w)
4970 struct window *w;
4972 struct frame *f = XFRAME (WINDOW_FRAME (w));
4973 int width = XINT (w->total_cols);
4975 if (WINDOW_HAS_VERTICAL_SCROLL_BAR (w))
4976 /* Scroll bars occupy a few columns. */
4977 width -= WINDOW_CONFIG_SCROLL_BAR_COLS (w);
4978 else if (!FRAME_WINDOW_P (f)
4979 && !WINDOW_RIGHTMOST_P (w) && !WINDOW_FULL_WIDTH_P (w))
4980 /* The column of `|' characters separating side-by-side windows
4981 occupies one column only. */
4982 width -= 1;
4984 if (FRAME_WINDOW_P (f))
4985 /* On window-systems, fringes and display margins cannot be
4986 used for normal text. */
4987 width -= (WINDOW_FRINGE_COLS (w)
4988 + WINDOW_LEFT_MARGIN_COLS (w)
4989 + WINDOW_RIGHT_MARGIN_COLS (w));
4991 return width;
4995 /************************************************************************
4996 Window Scrolling
4997 ***********************************************************************/
4999 /* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
5000 N screen-fulls, which is defined as the height of the window minus
5001 next_screen_context_lines. If WHOLE is zero, scroll up N lines
5002 instead. Negative values of N mean scroll down. NOERROR non-zero
5003 means don't signal an error if we try to move over BEGV or ZV,
5004 respectively. */
5006 static void
5007 window_scroll (window, n, whole, noerror)
5008 Lisp_Object window;
5009 int n;
5010 int whole;
5011 int noerror;
5013 immediate_quit = 1;
5015 /* If we must, use the pixel-based version which is much slower than
5016 the line-based one but can handle varying line heights. */
5017 if (FRAME_WINDOW_P (XFRAME (XWINDOW (window)->frame)))
5018 window_scroll_pixel_based (window, n, whole, noerror);
5019 else
5020 window_scroll_line_based (window, n, whole, noerror);
5022 immediate_quit = 0;
5026 /* Implementation of window_scroll that works based on pixel line
5027 heights. See the comment of window_scroll for parameter
5028 descriptions. */
5030 static void
5031 window_scroll_pixel_based (window, n, whole, noerror)
5032 Lisp_Object window;
5033 int n;
5034 int whole;
5035 int noerror;
5037 struct it it;
5038 struct window *w = XWINDOW (window);
5039 struct text_pos start;
5040 int this_scroll_margin;
5041 /* True if we fiddled the window vscroll field without really scrolling. */
5042 int vscrolled = 0;
5043 int x, y, rtop, rbot, rowh, vpos;
5045 SET_TEXT_POS_FROM_MARKER (start, w->start);
5047 /* If PT is not visible in WINDOW, move back one half of
5048 the screen. Allow PT to be partially visible, otherwise
5049 something like (scroll-down 1) with PT in the line before
5050 the partially visible one would recenter. */
5052 if (!pos_visible_p (w, PT, &x, &y, &rtop, &rbot, &rowh, &vpos))
5054 /* Move backward half the height of the window. Performance note:
5055 vmotion used here is about 10% faster, but would give wrong
5056 results for variable height lines. */
5057 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
5058 it.current_y = it.last_visible_y;
5059 move_it_vertically_backward (&it, window_box_height (w) / 2);
5061 /* The function move_iterator_vertically may move over more than
5062 the specified y-distance. If it->w is small, e.g. a
5063 mini-buffer window, we may end up in front of the window's
5064 display area. This is the case when Start displaying at the
5065 start of the line containing PT in this case. */
5066 if (it.current_y <= 0)
5068 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
5069 move_it_vertically_backward (&it, 0);
5070 it.current_y = 0;
5073 start = it.current.pos;
5075 else if (auto_window_vscroll_p)
5077 if (rtop || rbot) /* partially visible */
5079 int px;
5080 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
5081 if (whole)
5082 dy = max ((window_box_height (w)
5083 - next_screen_context_lines * dy),
5084 dy);
5085 dy *= n;
5087 if (n < 0)
5089 /* Only vscroll backwards if already vscrolled forwards. */
5090 if (w->vscroll < 0 && rtop > 0)
5092 px = max (0, -w->vscroll - min (rtop, -dy));
5093 Fset_window_vscroll (window, make_number (px), Qt);
5094 return;
5097 if (n > 0)
5099 /* Do vscroll if already vscrolled or only display line. */
5100 if (rbot > 0 && (w->vscroll < 0 || vpos == 0))
5102 px = max (0, -w->vscroll + min (rbot, dy));
5103 Fset_window_vscroll (window, make_number (px), Qt);
5104 return;
5107 /* Maybe modify window start instead of scrolling. */
5108 if (rbot > 0 || w->vscroll < 0)
5110 int spos;
5112 Fset_window_vscroll (window, make_number (0), Qt);
5113 /* If there are other text lines above the current row,
5114 move window start to current row. Else to next row. */
5115 if (rbot > 0)
5116 spos = XINT (Fline_beginning_position (Qnil));
5117 else
5118 spos = min (XINT (Fline_end_position (Qnil)) + 1, ZV);
5119 set_marker_restricted (w->start, make_number (spos),
5120 w->buffer);
5121 w->start_at_line_beg = Qt;
5122 w->update_mode_line = Qt;
5123 XSETFASTINT (w->last_modified, 0);
5124 XSETFASTINT (w->last_overlay_modified, 0);
5125 /* Set force_start so that redisplay_window will run the
5126 window-scroll-functions. */
5127 w->force_start = Qt;
5128 return;
5132 /* Cancel previous vscroll. */
5133 Fset_window_vscroll (window, make_number (0), Qt);
5136 /* If scroll_preserve_screen_position is non-nil, we try to set
5137 point in the same window line as it is now, so get that line. */
5138 if (!NILP (Vscroll_preserve_screen_position))
5140 /* We preserve the goal pixel coordinate across consecutive
5141 calls to scroll-up or scroll-down. This avoids the
5142 possibility of point becoming "stuck" on a tall line when
5143 scrolling by one line. */
5144 if (window_scroll_pixel_based_preserve_y < 0
5145 || (!EQ (current_kboard->Vlast_command, Qscroll_up)
5146 && !EQ (current_kboard->Vlast_command, Qscroll_down)))
5148 start_display (&it, w, start);
5149 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
5150 window_scroll_pixel_based_preserve_y = it.current_y;
5153 else
5154 window_scroll_pixel_based_preserve_y = -1;
5156 /* Move iterator it from start the specified distance forward or
5157 backward. The result is the new window start. */
5158 start_display (&it, w, start);
5159 if (whole)
5161 int start_pos = IT_CHARPOS (it);
5162 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
5163 dy = max ((window_box_height (w)
5164 - next_screen_context_lines * dy),
5165 dy) * n;
5167 /* Note that move_it_vertically always moves the iterator to the
5168 start of a line. So, if the last line doesn't have a newline,
5169 we would end up at the start of the line ending at ZV. */
5170 if (dy <= 0)
5172 move_it_vertically_backward (&it, -dy);
5173 /* Ensure we actually do move, e.g. in case we are currently
5174 looking at an image that is taller that the window height. */
5175 while (start_pos == IT_CHARPOS (it)
5176 && start_pos > BEGV)
5177 move_it_by_lines (&it, -1, 1);
5179 else if (dy > 0)
5181 move_it_to (&it, ZV, -1, it.current_y + dy, -1,
5182 MOVE_TO_POS | MOVE_TO_Y);
5183 /* Ensure we actually do move, e.g. in case we are currently
5184 looking at an image that is taller that the window height. */
5185 while (start_pos == IT_CHARPOS (it)
5186 && start_pos < ZV)
5187 move_it_by_lines (&it, 1, 1);
5190 else
5191 move_it_by_lines (&it, n, 1);
5193 /* We failed if we find ZV is already on the screen (scrolling up,
5194 means there's nothing past the end), or if we can't start any
5195 earlier (scrolling down, means there's nothing past the top). */
5196 if ((n > 0 && IT_CHARPOS (it) == ZV)
5197 || (n < 0 && IT_CHARPOS (it) == CHARPOS (start)))
5199 if (IT_CHARPOS (it) == ZV)
5201 if (it.current_y < it.last_visible_y
5202 && (it.current_y + it.max_ascent + it.max_descent
5203 > it.last_visible_y))
5205 /* The last line was only partially visible, make it fully
5206 visible. */
5207 w->vscroll = (it.last_visible_y
5208 - it.current_y + it.max_ascent + it.max_descent);
5209 adjust_glyphs (it.f);
5211 else if (noerror)
5212 return;
5213 else if (n < 0) /* could happen with empty buffers */
5214 xsignal0 (Qbeginning_of_buffer);
5215 else
5216 xsignal0 (Qend_of_buffer);
5218 else
5220 if (w->vscroll != 0)
5221 /* The first line was only partially visible, make it fully
5222 visible. */
5223 w->vscroll = 0;
5224 else if (noerror)
5225 return;
5226 else
5227 xsignal0 (Qbeginning_of_buffer);
5230 /* If control gets here, then we vscrolled. */
5232 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
5234 /* Don't try to change the window start below. */
5235 vscrolled = 1;
5238 if (! vscrolled)
5240 int pos = IT_CHARPOS (it);
5241 int bytepos;
5243 /* If in the middle of a multi-glyph character move forward to
5244 the next character. */
5245 if (in_display_vector_p (&it))
5247 ++pos;
5248 move_it_to (&it, pos, -1, -1, -1, MOVE_TO_POS);
5251 /* Set the window start, and set up the window for redisplay. */
5252 set_marker_restricted (w->start, make_number (pos),
5253 w->buffer);
5254 bytepos = XMARKER (w->start)->bytepos;
5255 w->start_at_line_beg = ((pos == BEGV || FETCH_BYTE (bytepos - 1) == '\n')
5256 ? Qt : Qnil);
5257 w->update_mode_line = Qt;
5258 XSETFASTINT (w->last_modified, 0);
5259 XSETFASTINT (w->last_overlay_modified, 0);
5260 /* Set force_start so that redisplay_window will run the
5261 window-scroll-functions. */
5262 w->force_start = Qt;
5265 /* The rest of this function uses current_y in a nonstandard way,
5266 not including the height of the header line if any. */
5267 it.current_y = it.vpos = 0;
5269 /* Move PT out of scroll margins.
5270 This code wants current_y to be zero at the window start position
5271 even if there is a header line. */
5272 this_scroll_margin = max (0, scroll_margin);
5273 this_scroll_margin = min (this_scroll_margin, XFASTINT (w->total_lines) / 4);
5274 this_scroll_margin *= FRAME_LINE_HEIGHT (it.f);
5276 if (n > 0)
5278 /* We moved the window start towards ZV, so PT may be now
5279 in the scroll margin at the top. */
5280 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
5281 if (IT_CHARPOS (it) == PT && it.current_y >= this_scroll_margin
5282 && (NILP (Vscroll_preserve_screen_position)
5283 || EQ (Vscroll_preserve_screen_position, Qt)))
5284 /* We found PT at a legitimate height. Leave it alone. */
5286 else if (window_scroll_pixel_based_preserve_y >= 0)
5288 /* If we have a header line, take account of it.
5289 This is necessary because we set it.current_y to 0, above. */
5290 move_it_to (&it, -1, -1,
5291 window_scroll_pixel_based_preserve_y
5292 - (WINDOW_WANTS_HEADER_LINE_P (w) ? 1 : 0 ),
5293 -1, MOVE_TO_Y);
5294 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5296 else
5298 while (it.current_y < this_scroll_margin)
5300 int prev = it.current_y;
5301 move_it_by_lines (&it, 1, 1);
5302 if (prev == it.current_y)
5303 break;
5305 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5308 else if (n < 0)
5310 int charpos, bytepos;
5311 int partial_p;
5313 /* Save our position, for the
5314 window_scroll_pixel_based_preserve_y case. */
5315 charpos = IT_CHARPOS (it);
5316 bytepos = IT_BYTEPOS (it);
5318 /* We moved the window start towards BEGV, so PT may be now
5319 in the scroll margin at the bottom. */
5320 move_it_to (&it, PT, -1,
5321 (it.last_visible_y - CURRENT_HEADER_LINE_HEIGHT (w)
5322 - this_scroll_margin - 1),
5324 MOVE_TO_POS | MOVE_TO_Y);
5326 /* Save our position, in case it's correct. */
5327 charpos = IT_CHARPOS (it);
5328 bytepos = IT_BYTEPOS (it);
5330 /* See if point is on a partially visible line at the end. */
5331 if (it.what == IT_EOB)
5332 partial_p = it.current_y + it.ascent + it.descent > it.last_visible_y;
5333 else
5335 move_it_by_lines (&it, 1, 1);
5336 partial_p = it.current_y > it.last_visible_y;
5339 if (charpos == PT && !partial_p
5340 && (NILP (Vscroll_preserve_screen_position)
5341 || EQ (Vscroll_preserve_screen_position, Qt)))
5342 /* We found PT before we found the display margin, so PT is ok. */
5344 else if (window_scroll_pixel_based_preserve_y >= 0)
5346 SET_TEXT_POS_FROM_MARKER (start, w->start);
5347 start_display (&it, w, start);
5348 /* It would be wrong to subtract CURRENT_HEADER_LINE_HEIGHT
5349 here because we called start_display again and did not
5350 alter it.current_y this time. */
5351 move_it_to (&it, -1, -1, window_scroll_pixel_based_preserve_y, -1,
5352 MOVE_TO_Y);
5353 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5355 else
5357 if (partial_p)
5358 /* The last line was only partially visible, so back up two
5359 lines to make sure we're on a fully visible line. */
5361 move_it_by_lines (&it, -2, 0);
5362 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5364 else
5365 /* No, the position we saved is OK, so use it. */
5366 SET_PT_BOTH (charpos, bytepos);
5372 /* Implementation of window_scroll that works based on screen lines.
5373 See the comment of window_scroll for parameter descriptions. */
5375 static void
5376 window_scroll_line_based (window, n, whole, noerror)
5377 Lisp_Object window;
5378 int n;
5379 int whole;
5380 int noerror;
5382 register struct window *w = XWINDOW (window);
5383 register int opoint = PT, opoint_byte = PT_BYTE;
5384 register int pos, pos_byte;
5385 register int ht = window_internal_height (w);
5386 register Lisp_Object tem;
5387 int lose;
5388 Lisp_Object bolp;
5389 int startpos;
5390 struct position posit;
5391 int original_vpos;
5393 /* If scrolling screen-fulls, compute the number of lines to
5394 scroll from the window's height. */
5395 if (whole)
5396 n *= max (1, ht - next_screen_context_lines);
5398 startpos = marker_position (w->start);
5400 posit = *compute_motion (startpos, 0, 0, 0,
5401 PT, ht, 0,
5402 -1, XINT (w->hscroll),
5403 0, w);
5404 original_vpos = posit.vpos;
5406 XSETFASTINT (tem, PT);
5407 tem = Fpos_visible_in_window_p (tem, window, Qnil);
5409 if (NILP (tem))
5411 Fvertical_motion (make_number (- (ht / 2)), window);
5412 startpos = PT;
5415 SET_PT (startpos);
5416 lose = n < 0 && PT == BEGV;
5417 Fvertical_motion (make_number (n), window);
5418 pos = PT;
5419 pos_byte = PT_BYTE;
5420 bolp = Fbolp ();
5421 SET_PT_BOTH (opoint, opoint_byte);
5423 if (lose)
5425 if (noerror)
5426 return;
5427 else
5428 xsignal0 (Qbeginning_of_buffer);
5431 if (pos < ZV)
5433 int this_scroll_margin = scroll_margin;
5435 /* Don't use a scroll margin that is negative or too large. */
5436 if (this_scroll_margin < 0)
5437 this_scroll_margin = 0;
5439 if (XINT (w->total_lines) < 4 * scroll_margin)
5440 this_scroll_margin = XINT (w->total_lines) / 4;
5442 set_marker_restricted_both (w->start, w->buffer, pos, pos_byte);
5443 w->start_at_line_beg = bolp;
5444 w->update_mode_line = Qt;
5445 XSETFASTINT (w->last_modified, 0);
5446 XSETFASTINT (w->last_overlay_modified, 0);
5447 /* Set force_start so that redisplay_window will run
5448 the window-scroll-functions. */
5449 w->force_start = Qt;
5451 if (!NILP (Vscroll_preserve_screen_position)
5452 && (whole || !EQ (Vscroll_preserve_screen_position, Qt)))
5454 SET_PT_BOTH (pos, pos_byte);
5455 Fvertical_motion (make_number (original_vpos), window);
5457 /* If we scrolled forward, put point enough lines down
5458 that it is outside the scroll margin. */
5459 else if (n > 0)
5461 int top_margin;
5463 if (this_scroll_margin > 0)
5465 SET_PT_BOTH (pos, pos_byte);
5466 Fvertical_motion (make_number (this_scroll_margin), window);
5467 top_margin = PT;
5469 else
5470 top_margin = pos;
5472 if (top_margin <= opoint)
5473 SET_PT_BOTH (opoint, opoint_byte);
5474 else if (!NILP (Vscroll_preserve_screen_position))
5476 SET_PT_BOTH (pos, pos_byte);
5477 Fvertical_motion (make_number (original_vpos), window);
5479 else
5480 SET_PT (top_margin);
5482 else if (n < 0)
5484 int bottom_margin;
5486 /* If we scrolled backward, put point near the end of the window
5487 but not within the scroll margin. */
5488 SET_PT_BOTH (pos, pos_byte);
5489 tem = Fvertical_motion (make_number (ht - this_scroll_margin), window);
5490 if (XFASTINT (tem) == ht - this_scroll_margin)
5491 bottom_margin = PT;
5492 else
5493 bottom_margin = PT + 1;
5495 if (bottom_margin > opoint)
5496 SET_PT_BOTH (opoint, opoint_byte);
5497 else
5499 if (!NILP (Vscroll_preserve_screen_position))
5501 SET_PT_BOTH (pos, pos_byte);
5502 Fvertical_motion (make_number (original_vpos), window);
5504 else
5505 Fvertical_motion (make_number (-1), window);
5509 else
5511 if (noerror)
5512 return;
5513 else
5514 xsignal0 (Qend_of_buffer);
5519 /* Scroll selected_window up or down. If N is nil, scroll a
5520 screen-full which is defined as the height of the window minus
5521 next_screen_context_lines. If N is the symbol `-', scroll.
5522 DIRECTION may be 1 meaning to scroll down, or -1 meaning to scroll
5523 up. This is the guts of Fscroll_up and Fscroll_down. */
5525 static void
5526 scroll_command (n, direction)
5527 Lisp_Object n;
5528 int direction;
5530 int count = SPECPDL_INDEX ();
5532 xassert (eabs (direction) == 1);
5534 /* If selected window's buffer isn't current, make it current for
5535 the moment. But don't screw up if window_scroll gets an error. */
5536 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
5538 record_unwind_protect (save_excursion_restore, save_excursion_save ());
5539 Fset_buffer (XWINDOW (selected_window)->buffer);
5541 /* Make redisplay consider other windows than just selected_window. */
5542 ++windows_or_buffers_changed;
5545 if (NILP (n))
5546 window_scroll (selected_window, direction, 1, 0);
5547 else if (EQ (n, Qminus))
5548 window_scroll (selected_window, -direction, 1, 0);
5549 else
5551 n = Fprefix_numeric_value (n);
5552 window_scroll (selected_window, XINT (n) * direction, 0, 0);
5555 unbind_to (count, Qnil);
5558 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
5559 doc: /* Scroll text of current window upward ARG lines.
5560 If ARG is omitted or nil, scroll upward by a near full screen.
5561 A near full screen is `next-screen-context-lines' less than a full screen.
5562 Negative ARG means scroll downward.
5563 If ARG is the atom `-', scroll downward by nearly full screen.
5564 When calling from a program, supply as argument a number, nil, or `-'. */)
5565 (arg)
5566 Lisp_Object arg;
5568 scroll_command (arg, 1);
5569 return Qnil;
5572 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
5573 doc: /* Scroll text of current window down ARG lines.
5574 If ARG is omitted or nil, scroll down by a near full screen.
5575 A near full screen is `next-screen-context-lines' less than a full screen.
5576 Negative ARG means scroll upward.
5577 If ARG is the atom `-', scroll upward by nearly full screen.
5578 When calling from a program, supply as argument a number, nil, or `-'. */)
5579 (arg)
5580 Lisp_Object arg;
5582 scroll_command (arg, -1);
5583 return Qnil;
5586 DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling, Sother_window_for_scrolling, 0, 0, 0,
5587 doc: /* Return the other window for \"other window scroll\" commands.
5588 If `other-window-scroll-buffer' is non-nil, a window
5589 showing that buffer is used.
5590 If in the minibuffer, `minibuffer-scroll-window' if non-nil
5591 specifies the window. This takes precedence over
5592 `other-window-scroll-buffer'. */)
5595 Lisp_Object window;
5597 if (MINI_WINDOW_P (XWINDOW (selected_window))
5598 && !NILP (Vminibuf_scroll_window))
5599 window = Vminibuf_scroll_window;
5600 /* If buffer is specified, scroll that buffer. */
5601 else if (!NILP (Vother_window_scroll_buffer))
5603 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
5604 if (NILP (window))
5605 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt, Qnil);
5607 else
5609 /* Nothing specified; look for a neighboring window on the same
5610 frame. */
5611 window = Fnext_window (selected_window, Qnil, Qnil);
5613 if (EQ (window, selected_window))
5614 /* That didn't get us anywhere; look for a window on another
5615 visible frame. */
5617 window = Fnext_window (window, Qnil, Qt);
5618 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
5619 && ! EQ (window, selected_window));
5622 CHECK_LIVE_WINDOW (window);
5624 if (EQ (window, selected_window))
5625 error ("There is no other window");
5627 return window;
5630 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
5631 doc: /* Scroll next window upward ARG lines; or near full screen if no ARG.
5632 A near full screen is `next-screen-context-lines' less than a full screen.
5633 The next window is the one below the current one; or the one at the top
5634 if the current one is at the bottom. Negative ARG means scroll downward.
5635 If ARG is the atom `-', scroll downward by nearly full screen.
5636 When calling from a program, supply as argument a number, nil, or `-'.
5638 If `other-window-scroll-buffer' is non-nil, scroll the window
5639 showing that buffer, popping the buffer up if necessary.
5640 If in the minibuffer, `minibuffer-scroll-window' if non-nil
5641 specifies the window to scroll. This takes precedence over
5642 `other-window-scroll-buffer'. */)
5643 (arg)
5644 Lisp_Object arg;
5646 Lisp_Object window;
5647 struct window *w;
5648 int count = SPECPDL_INDEX ();
5650 window = Fother_window_for_scrolling ();
5651 w = XWINDOW (window);
5653 /* Don't screw up if window_scroll gets an error. */
5654 record_unwind_protect (save_excursion_restore, save_excursion_save ());
5655 ++windows_or_buffers_changed;
5657 Fset_buffer (w->buffer);
5658 SET_PT (marker_position (w->pointm));
5660 if (NILP (arg))
5661 window_scroll (window, 1, 1, 1);
5662 else if (EQ (arg, Qminus))
5663 window_scroll (window, -1, 1, 1);
5664 else
5666 if (CONSP (arg))
5667 arg = Fcar (arg);
5668 CHECK_NUMBER (arg);
5669 window_scroll (window, XINT (arg), 0, 1);
5672 set_marker_both (w->pointm, Qnil, PT, PT_BYTE);
5673 unbind_to (count, Qnil);
5675 return Qnil;
5678 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 2, "P\np",
5679 doc: /* Scroll selected window display ARG columns left.
5680 Default for ARG is window width minus 2.
5681 Value is the total amount of leftward horizontal scrolling in
5682 effect after the change.
5683 If SET_MINIMUM is non-nil, the new scroll amount becomes the
5684 lower bound for automatic scrolling, i.e. automatic scrolling
5685 will not scroll a window to a column less than the value returned
5686 by this function. This happens in an interactive call. */)
5687 (arg, set_minimum)
5688 register Lisp_Object arg, set_minimum;
5690 Lisp_Object result;
5691 int hscroll;
5692 struct window *w = XWINDOW (selected_window);
5694 if (NILP (arg))
5695 XSETFASTINT (arg, window_box_text_cols (w) - 2);
5696 else
5697 arg = Fprefix_numeric_value (arg);
5699 hscroll = XINT (w->hscroll) + XINT (arg);
5700 result = Fset_window_hscroll (selected_window, make_number (hscroll));
5702 if (!NILP (set_minimum))
5703 w->min_hscroll = w->hscroll;
5705 return result;
5708 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 2, "P\np",
5709 doc: /* Scroll selected window display ARG columns right.
5710 Default for ARG is window width minus 2.
5711 Value is the total amount of leftward horizontal scrolling in
5712 effect after the change.
5713 If SET_MINIMUM is non-nil, the new scroll amount becomes the
5714 lower bound for automatic scrolling, i.e. automatic scrolling
5715 will not scroll a window to a column less than the value returned
5716 by this function. This happens in an interactive call. */)
5717 (arg, set_minimum)
5718 register Lisp_Object arg, set_minimum;
5720 Lisp_Object result;
5721 int hscroll;
5722 struct window *w = XWINDOW (selected_window);
5724 if (NILP (arg))
5725 XSETFASTINT (arg, window_box_text_cols (w) - 2);
5726 else
5727 arg = Fprefix_numeric_value (arg);
5729 hscroll = XINT (w->hscroll) - XINT (arg);
5730 result = Fset_window_hscroll (selected_window, make_number (hscroll));
5732 if (!NILP (set_minimum))
5733 w->min_hscroll = w->hscroll;
5735 return result;
5738 DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window, Sminibuffer_selected_window, 0, 0, 0,
5739 doc: /* Return the window which was selected when entering the minibuffer.
5740 Returns nil, if current window is not a minibuffer window. */)
5743 if (minibuf_level > 0
5744 && MINI_WINDOW_P (XWINDOW (selected_window))
5745 && WINDOW_LIVE_P (minibuf_selected_window))
5746 return minibuf_selected_window;
5748 return Qnil;
5751 /* Value is the number of lines actually displayed in window W,
5752 as opposed to its height. */
5754 static int
5755 displayed_window_lines (w)
5756 struct window *w;
5758 struct it it;
5759 struct text_pos start;
5760 int height = window_box_height (w);
5761 struct buffer *old_buffer;
5762 int bottom_y;
5764 if (XBUFFER (w->buffer) != current_buffer)
5766 old_buffer = current_buffer;
5767 set_buffer_internal (XBUFFER (w->buffer));
5769 else
5770 old_buffer = NULL;
5772 /* In case W->start is out of the accessible range, do something
5773 reasonable. This happens in Info mode when Info-scroll-down
5774 calls (recenter -1) while W->start is 1. */
5775 if (XMARKER (w->start)->charpos < BEGV)
5776 SET_TEXT_POS (start, BEGV, BEGV_BYTE);
5777 else if (XMARKER (w->start)->charpos > ZV)
5778 SET_TEXT_POS (start, ZV, ZV_BYTE);
5779 else
5780 SET_TEXT_POS_FROM_MARKER (start, w->start);
5782 start_display (&it, w, start);
5783 move_it_vertically (&it, height);
5784 bottom_y = line_bottom_y (&it);
5786 /* rms: On a non-window display,
5787 the value of it.vpos at the bottom of the screen
5788 seems to be 1 larger than window_box_height (w).
5789 This kludge fixes a bug whereby (move-to-window-line -1)
5790 when ZV is on the last screen line
5791 moves to the previous screen line instead of the last one. */
5792 if (! FRAME_WINDOW_P (XFRAME (w->frame)))
5793 height++;
5795 /* Add in empty lines at the bottom of the window. */
5796 if (bottom_y < height)
5798 int uy = FRAME_LINE_HEIGHT (it.f);
5799 it.vpos += (height - bottom_y + uy - 1) / uy;
5802 if (old_buffer)
5803 set_buffer_internal (old_buffer);
5805 return it.vpos;
5809 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
5810 doc: /* Center point in window and redisplay frame.
5811 With prefix argument ARG, recenter putting point on screen line ARG
5812 relative to the current window. If ARG is negative, it counts up from the
5813 bottom of the window. (ARG should be less than the height of the window.)
5815 If ARG is omitted or nil, erase the entire frame and then redraw with point
5816 in the center of the current window. If `auto-resize-tool-bars' is set to
5817 `grow-only', this resets the tool-bar's height to the minimum height needed.
5819 Just C-u as prefix means put point in the center of the window
5820 and redisplay normally--don't erase and redraw the frame. */)
5821 (arg)
5822 register Lisp_Object arg;
5824 struct window *w = XWINDOW (selected_window);
5825 struct buffer *buf = XBUFFER (w->buffer);
5826 struct buffer *obuf = current_buffer;
5827 int center_p = 0;
5828 int charpos, bytepos;
5829 int iarg;
5830 int this_scroll_margin;
5832 /* If redisplay is suppressed due to an error, try again. */
5833 obuf->display_error_modiff = 0;
5835 if (NILP (arg))
5837 int i;
5839 /* Invalidate pixel data calculated for all compositions. */
5840 for (i = 0; i < n_compositions; i++)
5841 composition_table[i]->font = NULL;
5843 WINDOW_XFRAME (w)->minimize_tool_bar_window_p = 1;
5845 Fredraw_frame (WINDOW_FRAME (w));
5846 SET_FRAME_GARBAGED (WINDOW_XFRAME (w));
5847 center_p = 1;
5849 else if (CONSP (arg)) /* Just C-u. */
5850 center_p = 1;
5851 else
5853 arg = Fprefix_numeric_value (arg);
5854 CHECK_NUMBER (arg);
5855 iarg = XINT (arg);
5858 set_buffer_internal (buf);
5860 /* Do this after making BUF current
5861 in case scroll_margin is buffer-local. */
5862 this_scroll_margin = max (0, scroll_margin);
5863 this_scroll_margin = min (this_scroll_margin,
5864 XFASTINT (w->total_lines) / 4);
5866 /* Handle centering on a graphical frame specially. Such frames can
5867 have variable-height lines and centering point on the basis of
5868 line counts would lead to strange effects. */
5869 if (FRAME_WINDOW_P (XFRAME (w->frame)))
5871 if (center_p)
5873 struct it it;
5874 struct text_pos pt;
5876 SET_TEXT_POS (pt, PT, PT_BYTE);
5877 start_display (&it, w, pt);
5878 move_it_vertically_backward (&it, window_box_height (w) / 2);
5879 charpos = IT_CHARPOS (it);
5880 bytepos = IT_BYTEPOS (it);
5882 else if (iarg < 0)
5884 struct it it;
5885 struct text_pos pt;
5886 int nlines = -iarg;
5887 int extra_line_spacing;
5888 int h = window_box_height (w);
5890 iarg = - max (-iarg, this_scroll_margin);
5892 SET_TEXT_POS (pt, PT, PT_BYTE);
5893 start_display (&it, w, pt);
5895 /* Be sure we have the exact height of the full line containing PT. */
5896 move_it_by_lines (&it, 0, 1);
5898 /* The amount of pixels we have to move back is the window
5899 height minus what's displayed in the line containing PT,
5900 and the lines below. */
5901 it.current_y = 0;
5902 it.vpos = 0;
5903 move_it_by_lines (&it, nlines, 1);
5905 if (it.vpos == nlines)
5906 h -= it.current_y;
5907 else
5909 /* Last line has no newline */
5910 h -= line_bottom_y (&it);
5911 it.vpos++;
5914 /* Don't reserve space for extra line spacing of last line. */
5915 extra_line_spacing = it.max_extra_line_spacing;
5917 /* If we can't move down NLINES lines because we hit
5918 the end of the buffer, count in some empty lines. */
5919 if (it.vpos < nlines)
5921 nlines -= it.vpos;
5922 extra_line_spacing = it.extra_line_spacing;
5923 h -= nlines * (FRAME_LINE_HEIGHT (it.f) + extra_line_spacing);
5925 if (h <= 0)
5926 return Qnil;
5928 /* Now find the new top line (starting position) of the window. */
5929 start_display (&it, w, pt);
5930 it.current_y = 0;
5931 move_it_vertically_backward (&it, h);
5933 /* If extra line spacing is present, we may move too far
5934 back. This causes the last line to be only partially
5935 visible (which triggers redisplay to recenter that line
5936 in the middle), so move forward.
5937 But ignore extra line spacing on last line, as it is not
5938 considered to be part of the visible height of the line.
5940 h += extra_line_spacing;
5941 while (-it.current_y > h)
5942 move_it_by_lines (&it, 1, 1);
5944 charpos = IT_CHARPOS (it);
5945 bytepos = IT_BYTEPOS (it);
5947 else
5949 struct position pos;
5951 iarg = max (iarg, this_scroll_margin);
5953 pos = *vmotion (PT, -iarg, w);
5954 charpos = pos.bufpos;
5955 bytepos = pos.bytepos;
5958 else
5960 struct position pos;
5961 int ht = window_internal_height (w);
5963 if (center_p)
5964 iarg = ht / 2;
5965 else if (iarg < 0)
5966 iarg += ht;
5968 /* Don't let it get into the margin at either top or bottom. */
5969 iarg = max (iarg, this_scroll_margin);
5970 iarg = min (iarg, ht - this_scroll_margin - 1);
5972 pos = *vmotion (PT, - iarg, w);
5973 charpos = pos.bufpos;
5974 bytepos = pos.bytepos;
5977 /* Set the new window start. */
5978 set_marker_both (w->start, w->buffer, charpos, bytepos);
5979 w->window_end_valid = Qnil;
5981 w->optional_new_start = Qt;
5983 if (bytepos == BEGV_BYTE || FETCH_BYTE (bytepos - 1) == '\n')
5984 w->start_at_line_beg = Qt;
5985 else
5986 w->start_at_line_beg = Qnil;
5988 set_buffer_internal (obuf);
5989 return Qnil;
5993 DEFUN ("window-text-height", Fwindow_text_height, Swindow_text_height,
5994 0, 1, 0,
5995 doc: /* Return the height in lines of the text display area of WINDOW.
5996 WINDOW defaults to the selected window.
5997 This doesn't include the mode-line (or header-line if any) or any
5998 partial-height lines in the text display area. */)
5999 (window)
6000 Lisp_Object window;
6002 struct window *w = decode_window (window);
6003 int pixel_height = window_box_height (w);
6004 int line_height = pixel_height / FRAME_LINE_HEIGHT (XFRAME (w->frame));
6005 return make_number (line_height);
6010 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
6011 1, 1, "P",
6012 doc: /* Position point relative to window.
6013 With no argument, position point at center of window.
6014 An argument specifies vertical position within the window;
6015 zero means top of window, negative means relative to bottom of window. */)
6016 (arg)
6017 Lisp_Object arg;
6019 struct window *w = XWINDOW (selected_window);
6020 int lines, start;
6021 Lisp_Object window;
6022 #if 0
6023 int this_scroll_margin;
6024 #endif
6026 window = selected_window;
6027 start = marker_position (w->start);
6028 if (start < BEGV || start > ZV)
6030 int height = window_internal_height (w);
6031 Fvertical_motion (make_number (- (height / 2)), window);
6032 set_marker_both (w->start, w->buffer, PT, PT_BYTE);
6033 w->start_at_line_beg = Fbolp ();
6034 w->force_start = Qt;
6036 else
6037 Fgoto_char (w->start);
6039 lines = displayed_window_lines (w);
6041 #if 0
6042 this_scroll_margin = max (0, scroll_margin);
6043 this_scroll_margin = min (this_scroll_margin, lines / 4);
6044 #endif
6046 if (NILP (arg))
6047 XSETFASTINT (arg, lines / 2);
6048 else
6050 int iarg = XINT (Fprefix_numeric_value (arg));
6052 if (iarg < 0)
6053 iarg = iarg + lines;
6055 #if 0 /* This code would prevent move-to-window-line from moving point
6056 to a place inside the scroll margins (which would cause the
6057 next redisplay to scroll). I wrote this code, but then concluded
6058 it is probably better not to install it. However, it is here
6059 inside #if 0 so as not to lose it. -- rms. */
6061 /* Don't let it get into the margin at either top or bottom. */
6062 iarg = max (iarg, this_scroll_margin);
6063 iarg = min (iarg, lines - this_scroll_margin - 1);
6064 #endif
6066 arg = make_number (iarg);
6069 /* Skip past a partially visible first line. */
6070 if (w->vscroll)
6071 XSETINT (arg, XINT (arg) + 1);
6073 return Fvertical_motion (arg, window);
6078 /***********************************************************************
6079 Window Configuration
6080 ***********************************************************************/
6082 struct save_window_data
6084 EMACS_UINT size;
6085 struct Lisp_Vector *next_from_Lisp_Vector_struct;
6086 Lisp_Object selected_frame;
6087 Lisp_Object current_window;
6088 Lisp_Object current_buffer;
6089 Lisp_Object minibuf_scroll_window;
6090 Lisp_Object minibuf_selected_window;
6091 Lisp_Object root_window;
6092 Lisp_Object focus_frame;
6093 /* A vector, each of whose elements is a struct saved_window
6094 for one window. */
6095 Lisp_Object saved_windows;
6097 /* All fields above are traced by the GC.
6098 From `fame-cols' down, the fields are ignored by the GC. */
6100 int frame_cols, frame_lines, frame_menu_bar_lines;
6101 int frame_tool_bar_lines;
6102 /* Record the values of window-min-width and window-min-height
6103 so that window sizes remain consistent with them. */
6104 int min_width, min_height;
6107 /* This is saved as a Lisp_Vector */
6108 struct saved_window
6110 /* these first two must agree with struct Lisp_Vector in lisp.h */
6111 EMACS_UINT size;
6112 struct Lisp_Vector *next_from_Lisp_Vector_struct;
6114 Lisp_Object window;
6115 Lisp_Object buffer, start, pointm, mark;
6116 Lisp_Object left_col, top_line, total_cols, total_lines;
6117 Lisp_Object hscroll, min_hscroll;
6118 Lisp_Object parent, prev;
6119 Lisp_Object start_at_line_beg;
6120 Lisp_Object display_table;
6121 Lisp_Object orig_top_line, orig_total_lines;
6122 Lisp_Object left_margin_cols, right_margin_cols;
6123 Lisp_Object left_fringe_width, right_fringe_width, fringes_outside_margins;
6124 Lisp_Object scroll_bar_width, vertical_scroll_bar_type;
6125 Lisp_Object dedicated;
6128 #define SAVED_WINDOW_N(swv,n) \
6129 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
6131 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
6132 doc: /* Return t if OBJECT is a window-configuration object. */)
6133 (object)
6134 Lisp_Object object;
6136 return WINDOW_CONFIGURATIONP (object) ? Qt : Qnil;
6139 DEFUN ("window-configuration-frame", Fwindow_configuration_frame, Swindow_configuration_frame, 1, 1, 0,
6140 doc: /* Return the frame that CONFIG, a window-configuration object, is about. */)
6141 (config)
6142 Lisp_Object config;
6144 register struct save_window_data *data;
6145 struct Lisp_Vector *saved_windows;
6147 CHECK_WINDOW_CONFIGURATION (config);
6149 data = (struct save_window_data *) XVECTOR (config);
6150 saved_windows = XVECTOR (data->saved_windows);
6151 return XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
6154 DEFUN ("set-window-configuration", Fset_window_configuration,
6155 Sset_window_configuration, 1, 1, 0,
6156 doc: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
6157 CONFIGURATION must be a value previously returned
6158 by `current-window-configuration' (which see).
6159 If CONFIGURATION was made from a frame that is now deleted,
6160 only frame-independent values can be restored. In this case,
6161 the return value is nil. Otherwise the value is t. */)
6162 (configuration)
6163 Lisp_Object configuration;
6165 register struct save_window_data *data;
6166 struct Lisp_Vector *saved_windows;
6167 Lisp_Object new_current_buffer;
6168 Lisp_Object frame;
6169 FRAME_PTR f;
6170 int old_point = -1;
6172 CHECK_WINDOW_CONFIGURATION (configuration);
6174 data = (struct save_window_data *) XVECTOR (configuration);
6175 saved_windows = XVECTOR (data->saved_windows);
6177 new_current_buffer = data->current_buffer;
6178 if (NILP (XBUFFER (new_current_buffer)->name))
6179 new_current_buffer = Qnil;
6180 else
6182 if (XBUFFER (new_current_buffer) == current_buffer)
6183 /* The code further down "preserves point" by saving here PT in
6184 old_point and then setting it later back into PT. When the
6185 current-selected-window and the final-selected-window both show
6186 the current buffer, this suffers from the problem that the
6187 current PT is the window-point of the current-selected-window,
6188 while the final PT is the point of the final-selected-window, so
6189 this copy from one PT to the other would end up moving the
6190 window-point of the final-selected-window to the window-point of
6191 the current-selected-window. So we have to be careful which
6192 point of the current-buffer we copy into old_point. */
6193 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer)
6194 && WINDOWP (selected_window)
6195 && EQ (XWINDOW (selected_window)->buffer, new_current_buffer)
6196 && !EQ (selected_window, data->current_window))
6197 old_point = XMARKER (XWINDOW (data->current_window)->pointm)->charpos;
6198 else
6199 old_point = PT;
6200 else
6201 /* BUF_PT (XBUFFER (new_current_buffer)) gives us the position of
6202 point in new_current_buffer as of the last time this buffer was
6203 used. This can be non-deterministic since it can be changed by
6204 things like jit-lock by mere temporary selection of some random
6205 window that happens to show this buffer.
6206 So if possible we want this arbitrary choice of "which point" to
6207 be the one from the to-be-selected-window so as to prevent this
6208 window's cursor from being copied from another window. */
6209 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer)
6210 /* If current_window = selected_window, its point is in BUF_PT. */
6211 && !EQ (selected_window, data->current_window))
6212 old_point = XMARKER (XWINDOW (data->current_window)->pointm)->charpos;
6213 else
6214 old_point = BUF_PT (XBUFFER (new_current_buffer));
6217 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
6218 f = XFRAME (frame);
6220 /* If f is a dead frame, don't bother rebuilding its window tree.
6221 However, there is other stuff we should still try to do below. */
6222 if (FRAME_LIVE_P (f))
6224 register struct window *w;
6225 register struct saved_window *p;
6226 struct window *root_window;
6227 struct window **leaf_windows;
6228 int n_leaf_windows;
6229 int k, i, n;
6231 /* If the frame has been resized since this window configuration was
6232 made, we change the frame to the size specified in the
6233 configuration, restore the configuration, and then resize it
6234 back. We keep track of the prevailing height in these variables. */
6235 int previous_frame_lines = FRAME_LINES (f);
6236 int previous_frame_cols = FRAME_COLS (f);
6237 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
6238 int previous_frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
6240 /* The mouse highlighting code could get screwed up
6241 if it runs during this. */
6242 BLOCK_INPUT;
6244 if (data->frame_lines != previous_frame_lines
6245 || data->frame_cols != previous_frame_cols)
6246 change_frame_size (f, data->frame_lines,
6247 data->frame_cols, 0, 0, 0);
6248 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
6249 if (data->frame_menu_bar_lines
6250 != previous_frame_menu_bar_lines)
6251 x_set_menu_bar_lines (f, make_number (data->frame_menu_bar_lines),
6252 make_number (0));
6253 #ifdef HAVE_WINDOW_SYSTEM
6254 if (data->frame_tool_bar_lines
6255 != previous_frame_tool_bar_lines)
6256 x_set_tool_bar_lines (f, make_number (data->frame_tool_bar_lines),
6257 make_number (0));
6258 #endif
6259 #endif
6261 /* "Swap out" point from the selected window's buffer
6262 into the window itself. (Normally the pointm of the selected
6263 window holds garbage.) We do this now, before
6264 restoring the window contents, and prevent it from
6265 being done later on when we select a new window. */
6266 if (! NILP (XWINDOW (selected_window)->buffer))
6268 w = XWINDOW (selected_window);
6269 set_marker_both (w->pointm,
6270 w->buffer,
6271 BUF_PT (XBUFFER (w->buffer)),
6272 BUF_PT_BYTE (XBUFFER (w->buffer)));
6275 windows_or_buffers_changed++;
6276 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
6278 /* Problem: Freeing all matrices and later allocating them again
6279 is a serious redisplay flickering problem. What we would
6280 really like to do is to free only those matrices not reused
6281 below. */
6282 root_window = XWINDOW (FRAME_ROOT_WINDOW (f));
6283 leaf_windows
6284 = (struct window **) alloca (count_windows (root_window)
6285 * sizeof (struct window *));
6286 n_leaf_windows = get_leaf_windows (root_window, leaf_windows, 0);
6288 /* Temporarily avoid any problems with windows that are smaller
6289 than they are supposed to be. */
6290 window_min_height = 1;
6291 window_min_width = 1;
6293 /* Kludge Alert!
6294 Mark all windows now on frame as "deleted".
6295 Restoring the new configuration "undeletes" any that are in it.
6297 Save their current buffers in their height fields, since we may
6298 need it later, if a buffer saved in the configuration is now
6299 dead. */
6300 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
6302 for (k = 0; k < saved_windows->size; k++)
6304 p = SAVED_WINDOW_N (saved_windows, k);
6305 w = XWINDOW (p->window);
6306 w->next = Qnil;
6308 if (!NILP (p->parent))
6309 w->parent = SAVED_WINDOW_N (saved_windows,
6310 XFASTINT (p->parent))->window;
6311 else
6312 w->parent = Qnil;
6314 if (!NILP (p->prev))
6316 w->prev = SAVED_WINDOW_N (saved_windows,
6317 XFASTINT (p->prev))->window;
6318 XWINDOW (w->prev)->next = p->window;
6320 else
6322 w->prev = Qnil;
6323 if (!NILP (w->parent))
6325 if (EQ (p->total_cols, XWINDOW (w->parent)->total_cols))
6327 XWINDOW (w->parent)->vchild = p->window;
6328 XWINDOW (w->parent)->hchild = Qnil;
6330 else
6332 XWINDOW (w->parent)->hchild = p->window;
6333 XWINDOW (w->parent)->vchild = Qnil;
6338 /* If we squirreled away the buffer in the window's height,
6339 restore it now. */
6340 if (BUFFERP (w->total_lines))
6341 w->buffer = w->total_lines;
6342 w->left_col = p->left_col;
6343 w->top_line = p->top_line;
6344 w->total_cols = p->total_cols;
6345 w->total_lines = p->total_lines;
6346 w->hscroll = p->hscroll;
6347 w->min_hscroll = p->min_hscroll;
6348 w->display_table = p->display_table;
6349 w->orig_top_line = p->orig_top_line;
6350 w->orig_total_lines = p->orig_total_lines;
6351 w->left_margin_cols = p->left_margin_cols;
6352 w->right_margin_cols = p->right_margin_cols;
6353 w->left_fringe_width = p->left_fringe_width;
6354 w->right_fringe_width = p->right_fringe_width;
6355 w->fringes_outside_margins = p->fringes_outside_margins;
6356 w->scroll_bar_width = p->scroll_bar_width;
6357 w->vertical_scroll_bar_type = p->vertical_scroll_bar_type;
6358 w->dedicated = p->dedicated;
6359 XSETFASTINT (w->last_modified, 0);
6360 XSETFASTINT (w->last_overlay_modified, 0);
6362 /* Reinstall the saved buffer and pointers into it. */
6363 if (NILP (p->buffer))
6364 w->buffer = p->buffer;
6365 else
6367 if (!NILP (XBUFFER (p->buffer)->name))
6368 /* If saved buffer is alive, install it. */
6370 w->buffer = p->buffer;
6371 w->start_at_line_beg = p->start_at_line_beg;
6372 set_marker_restricted (w->start, p->start, w->buffer);
6373 set_marker_restricted (w->pointm, p->pointm, w->buffer);
6374 Fset_marker (XBUFFER (w->buffer)->mark,
6375 p->mark, w->buffer);
6377 /* As documented in Fcurrent_window_configuration, don't
6378 restore the location of point in the buffer which was
6379 current when the window configuration was recorded. */
6380 if (!EQ (p->buffer, new_current_buffer)
6381 && XBUFFER (p->buffer) == current_buffer)
6382 Fgoto_char (w->pointm);
6384 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
6385 /* Else unless window has a live buffer, get one. */
6387 w->buffer = Fcdr (Fcar (Vbuffer_alist));
6388 /* This will set the markers to beginning of visible
6389 range. */
6390 set_marker_restricted (w->start, make_number (0), w->buffer);
6391 set_marker_restricted (w->pointm, make_number (0),w->buffer);
6392 w->start_at_line_beg = Qt;
6394 else
6395 /* Keeping window's old buffer; make sure the markers
6396 are real. */
6398 /* Set window markers at start of visible range. */
6399 if (XMARKER (w->start)->buffer == 0)
6400 set_marker_restricted (w->start, make_number (0),
6401 w->buffer);
6402 if (XMARKER (w->pointm)->buffer == 0)
6403 set_marker_restricted_both (w->pointm, w->buffer,
6404 BUF_PT (XBUFFER (w->buffer)),
6405 BUF_PT_BYTE (XBUFFER (w->buffer)));
6406 w->start_at_line_beg = Qt;
6411 FRAME_ROOT_WINDOW (f) = data->root_window;
6412 /* Prevent "swapping out point" in the old selected window
6413 using the buffer that has been restored into it.
6414 We already swapped out point that from that window's old buffer. */
6415 selected_window = Qnil;
6417 /* Arrange *not* to restore point in the buffer that was
6418 current when the window configuration was saved. */
6419 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer))
6420 set_marker_restricted (XWINDOW (data->current_window)->pointm,
6421 make_number (old_point),
6422 XWINDOW (data->current_window)->buffer);
6424 Fselect_window (data->current_window, Qnil);
6425 XBUFFER (XWINDOW (selected_window)->buffer)->last_selected_window
6426 = selected_window;
6428 if (NILP (data->focus_frame)
6429 || (FRAMEP (data->focus_frame)
6430 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
6431 Fredirect_frame_focus (frame, data->focus_frame);
6433 #if 0 /* I don't understand why this is needed, and it causes problems
6434 when the frame's old selected window has been deleted. */
6435 if (f != selected_frame && FRAME_WINDOW_P (f))
6436 do_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)),
6437 0, 0);
6438 #endif
6440 /* Set the screen height to the value it had before this function. */
6441 if (previous_frame_lines != FRAME_LINES (f)
6442 || previous_frame_cols != FRAME_COLS (f))
6443 change_frame_size (f, previous_frame_lines, previous_frame_cols,
6444 0, 0, 0);
6445 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
6446 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
6447 x_set_menu_bar_lines (f, make_number (previous_frame_menu_bar_lines),
6448 make_number (0));
6449 #ifdef HAVE_WINDOW_SYSTEM
6450 if (previous_frame_tool_bar_lines != FRAME_TOOL_BAR_LINES (f))
6451 x_set_tool_bar_lines (f, make_number (previous_frame_tool_bar_lines),
6452 make_number (0));
6453 #endif
6454 #endif
6456 /* Now, free glyph matrices in windows that were not reused. */
6457 for (i = n = 0; i < n_leaf_windows; ++i)
6459 if (NILP (leaf_windows[i]->buffer))
6461 /* Assert it's not reused as a combination. */
6462 xassert (NILP (leaf_windows[i]->hchild)
6463 && NILP (leaf_windows[i]->vchild));
6464 free_window_matrices (leaf_windows[i]);
6466 else if (EQ (leaf_windows[i]->buffer, new_current_buffer))
6467 ++n;
6470 adjust_glyphs (f);
6472 UNBLOCK_INPUT;
6474 /* Fselect_window will have made f the selected frame, so we
6475 reselect the proper frame here. Fhandle_switch_frame will change the
6476 selected window too, but that doesn't make the call to
6477 Fselect_window above totally superfluous; it still sets f's
6478 selected window. */
6479 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
6480 do_switch_frame (data->selected_frame, 0, 0);
6482 if (! NILP (Vwindow_configuration_change_hook)
6483 && ! NILP (Vrun_hooks))
6484 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
6487 if (!NILP (new_current_buffer))
6488 Fset_buffer (new_current_buffer);
6490 /* Restore the minimum heights recorded in the configuration. */
6491 window_min_height = data->min_height;
6492 window_min_width = data->min_width;
6494 Vminibuf_scroll_window = data->minibuf_scroll_window;
6495 minibuf_selected_window = data->minibuf_selected_window;
6497 return (FRAME_LIVE_P (f) ? Qt : Qnil);
6500 /* Mark all windows now on frame as deleted
6501 by setting their buffers to nil. */
6503 void
6504 delete_all_subwindows (w)
6505 register struct window *w;
6507 if (!NILP (w->next))
6508 delete_all_subwindows (XWINDOW (w->next));
6509 if (!NILP (w->vchild))
6510 delete_all_subwindows (XWINDOW (w->vchild));
6511 if (!NILP (w->hchild))
6512 delete_all_subwindows (XWINDOW (w->hchild));
6514 w->total_lines = w->buffer; /* See Fset_window_configuration for excuse. */
6516 if (!NILP (w->buffer))
6517 unshow_buffer (w);
6519 /* We set all three of these fields to nil, to make sure that we can
6520 distinguish this dead window from any live window. Live leaf
6521 windows will have buffer set, and combination windows will have
6522 vchild or hchild set. */
6523 w->buffer = Qnil;
6524 w->vchild = Qnil;
6525 w->hchild = Qnil;
6527 Vwindow_list = Qnil;
6530 static int
6531 count_windows (window)
6532 register struct window *window;
6534 register int count = 1;
6535 if (!NILP (window->next))
6536 count += count_windows (XWINDOW (window->next));
6537 if (!NILP (window->vchild))
6538 count += count_windows (XWINDOW (window->vchild));
6539 if (!NILP (window->hchild))
6540 count += count_windows (XWINDOW (window->hchild));
6541 return count;
6545 /* Fill vector FLAT with leaf windows under W, starting at index I.
6546 Value is last index + 1. */
6548 static int
6549 get_leaf_windows (w, flat, i)
6550 struct window *w;
6551 struct window **flat;
6552 int i;
6554 while (w)
6556 if (!NILP (w->hchild))
6557 i = get_leaf_windows (XWINDOW (w->hchild), flat, i);
6558 else if (!NILP (w->vchild))
6559 i = get_leaf_windows (XWINDOW (w->vchild), flat, i);
6560 else
6561 flat[i++] = w;
6563 w = NILP (w->next) ? 0 : XWINDOW (w->next);
6566 return i;
6570 /* Return a pointer to the glyph W's physical cursor is on. Value is
6571 null if W's current matrix is invalid, so that no meaningfull glyph
6572 can be returned. */
6574 struct glyph *
6575 get_phys_cursor_glyph (w)
6576 struct window *w;
6578 struct glyph_row *row;
6579 struct glyph *glyph;
6581 if (w->phys_cursor.vpos >= 0
6582 && w->phys_cursor.vpos < w->current_matrix->nrows
6583 && (row = MATRIX_ROW (w->current_matrix, w->phys_cursor.vpos),
6584 row->enabled_p)
6585 && row->used[TEXT_AREA] > w->phys_cursor.hpos)
6586 glyph = row->glyphs[TEXT_AREA] + w->phys_cursor.hpos;
6587 else
6588 glyph = NULL;
6590 return glyph;
6594 static int
6595 save_window_save (window, vector, i)
6596 Lisp_Object window;
6597 struct Lisp_Vector *vector;
6598 int i;
6600 register struct saved_window *p;
6601 register struct window *w;
6602 register Lisp_Object tem;
6604 for (;!NILP (window); window = w->next)
6606 p = SAVED_WINDOW_N (vector, i);
6607 w = XWINDOW (window);
6609 XSETFASTINT (w->temslot, i); i++;
6610 p->window = window;
6611 p->buffer = w->buffer;
6612 p->left_col = w->left_col;
6613 p->top_line = w->top_line;
6614 p->total_cols = w->total_cols;
6615 p->total_lines = w->total_lines;
6616 p->hscroll = w->hscroll;
6617 p->min_hscroll = w->min_hscroll;
6618 p->display_table = w->display_table;
6619 p->orig_top_line = w->orig_top_line;
6620 p->orig_total_lines = w->orig_total_lines;
6621 p->left_margin_cols = w->left_margin_cols;
6622 p->right_margin_cols = w->right_margin_cols;
6623 p->left_fringe_width = w->left_fringe_width;
6624 p->right_fringe_width = w->right_fringe_width;
6625 p->fringes_outside_margins = w->fringes_outside_margins;
6626 p->scroll_bar_width = w->scroll_bar_width;
6627 p->vertical_scroll_bar_type = w->vertical_scroll_bar_type;
6628 p->dedicated = w->dedicated;
6629 if (!NILP (w->buffer))
6631 /* Save w's value of point in the window configuration.
6632 If w is the selected window, then get the value of point
6633 from the buffer; pointm is garbage in the selected window. */
6634 if (EQ (window, selected_window))
6636 p->pointm = Fmake_marker ();
6637 set_marker_both (p->pointm, w->buffer,
6638 BUF_PT (XBUFFER (w->buffer)),
6639 BUF_PT_BYTE (XBUFFER (w->buffer)));
6641 else
6642 p->pointm = Fcopy_marker (w->pointm, Qnil);
6644 p->start = Fcopy_marker (w->start, Qnil);
6645 p->start_at_line_beg = w->start_at_line_beg;
6647 tem = XBUFFER (w->buffer)->mark;
6648 p->mark = Fcopy_marker (tem, Qnil);
6650 else
6652 p->pointm = Qnil;
6653 p->start = Qnil;
6654 p->mark = Qnil;
6655 p->start_at_line_beg = Qnil;
6658 if (NILP (w->parent))
6659 p->parent = Qnil;
6660 else
6661 p->parent = XWINDOW (w->parent)->temslot;
6663 if (NILP (w->prev))
6664 p->prev = Qnil;
6665 else
6666 p->prev = XWINDOW (w->prev)->temslot;
6668 if (!NILP (w->vchild))
6669 i = save_window_save (w->vchild, vector, i);
6670 if (!NILP (w->hchild))
6671 i = save_window_save (w->hchild, vector, i);
6674 return i;
6677 DEFUN ("current-window-configuration", Fcurrent_window_configuration,
6678 Scurrent_window_configuration, 0, 1, 0,
6679 doc: /* Return an object representing the current window configuration of FRAME.
6680 If FRAME is nil or omitted, use the selected frame.
6681 This describes the number of windows, their sizes and current buffers,
6682 and for each displayed buffer, where display starts, and the positions of
6683 point and mark. An exception is made for point in the current buffer:
6684 its value is -not- saved.
6685 This also records the currently selected frame, and FRAME's focus
6686 redirection (see `redirect-frame-focus'). */)
6687 (frame)
6688 Lisp_Object frame;
6690 register Lisp_Object tem;
6691 register int n_windows;
6692 register struct save_window_data *data;
6693 register int i;
6694 FRAME_PTR f;
6696 if (NILP (frame))
6697 frame = selected_frame;
6698 CHECK_LIVE_FRAME (frame);
6699 f = XFRAME (frame);
6701 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
6702 data = ALLOCATE_PSEUDOVECTOR (struct save_window_data, frame_cols,
6703 PVEC_WINDOW_CONFIGURATION);
6705 data->frame_cols = FRAME_COLS (f);
6706 data->frame_lines = FRAME_LINES (f);
6707 data->frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
6708 data->frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
6709 data->selected_frame = selected_frame;
6710 data->current_window = FRAME_SELECTED_WINDOW (f);
6711 XSETBUFFER (data->current_buffer, current_buffer);
6712 data->minibuf_scroll_window = minibuf_level > 0 ? Vminibuf_scroll_window : Qnil;
6713 data->minibuf_selected_window = minibuf_level > 0 ? minibuf_selected_window : Qnil;
6714 data->root_window = FRAME_ROOT_WINDOW (f);
6715 data->focus_frame = FRAME_FOCUS_FRAME (f);
6716 data->min_height = window_min_height;
6717 data->min_width = window_min_width;
6718 tem = Fmake_vector (make_number (n_windows), Qnil);
6719 data->saved_windows = tem;
6720 for (i = 0; i < n_windows; i++)
6721 XVECTOR (tem)->contents[i]
6722 = Fmake_vector (make_number (VECSIZE (struct saved_window)), Qnil);
6723 save_window_save (FRAME_ROOT_WINDOW (f), XVECTOR (tem), 0);
6724 XSETWINDOW_CONFIGURATION (tem, data);
6725 return (tem);
6728 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
6729 0, UNEVALLED, 0,
6730 doc: /* Execute BODY, preserving window sizes and contents.
6731 Return the value of the last form in BODY.
6732 Restore which buffer appears in which window, where display starts,
6733 and the value of point and mark for each window.
6734 Also restore the choice of selected window.
6735 Also restore which buffer is current.
6736 Does not restore the value of point in current buffer.
6737 usage: (save-window-excursion BODY...) */)
6738 (args)
6739 Lisp_Object args;
6741 register Lisp_Object val;
6742 register int count = SPECPDL_INDEX ();
6744 record_unwind_protect (Fset_window_configuration,
6745 Fcurrent_window_configuration (Qnil));
6746 val = Fprogn (args);
6747 return unbind_to (count, val);
6752 /***********************************************************************
6753 Window Split Tree
6754 ***********************************************************************/
6756 static Lisp_Object
6757 window_tree (w)
6758 struct window *w;
6760 Lisp_Object tail = Qnil;
6761 Lisp_Object result = Qnil;
6763 while (w)
6765 Lisp_Object wn;
6767 XSETWINDOW (wn, w);
6768 if (!NILP (w->hchild))
6769 wn = Fcons (Qnil, Fcons (Fwindow_edges (wn),
6770 window_tree (XWINDOW (w->hchild))));
6771 else if (!NILP (w->vchild))
6772 wn = Fcons (Qt, Fcons (Fwindow_edges (wn),
6773 window_tree (XWINDOW (w->vchild))));
6775 if (NILP (result))
6777 result = tail = Fcons (wn, Qnil);
6779 else
6781 XSETCDR (tail, Fcons (wn, Qnil));
6782 tail = XCDR (tail);
6785 w = NILP (w->next) ? 0 : XWINDOW (w->next);
6788 return result;
6793 DEFUN ("window-tree", Fwindow_tree, Swindow_tree,
6794 0, 1, 0,
6795 doc: /* Return the window tree for frame FRAME.
6797 The return value is a list of the form (ROOT MINI), where ROOT
6798 represents the window tree of the frame's root window, and MINI
6799 is the frame's minibuffer window.
6801 If the root window is not split, ROOT is the root window itself.
6802 Otherwise, ROOT is a list (DIR EDGES W1 W2 ...) where DIR is nil for a
6803 horizontal split, and t for a vertical split, EDGES gives the combined
6804 size and position of the subwindows in the split, and the rest of the
6805 elements are the subwindows in the split. Each of the subwindows may
6806 again be a window or a list representing a window split, and so on.
6807 EDGES is a list \(LEFT TOP RIGHT BOTTOM) as returned by `window-edges'.
6809 If FRAME is nil or omitted, return information on the currently
6810 selected frame. */)
6811 (frame)
6812 Lisp_Object frame;
6814 FRAME_PTR f;
6816 if (NILP (frame))
6817 frame = selected_frame;
6819 CHECK_FRAME (frame);
6820 f = XFRAME (frame);
6822 if (!FRAME_LIVE_P (f))
6823 return Qnil;
6825 return window_tree (XWINDOW (FRAME_ROOT_WINDOW (f)));
6829 /***********************************************************************
6830 Marginal Areas
6831 ***********************************************************************/
6833 DEFUN ("set-window-margins", Fset_window_margins, Sset_window_margins,
6834 2, 3, 0,
6835 doc: /* Set width of marginal areas of window WINDOW.
6836 If WINDOW is nil, set margins of the currently selected window.
6837 Second arg LEFT-WIDTH specifies the number of character cells to
6838 reserve for the left marginal area. Optional third arg RIGHT-WIDTH
6839 does the same for the right marginal area. A nil width parameter
6840 means no margin. */)
6841 (window, left_width, right_width)
6842 Lisp_Object window, left_width, right_width;
6844 struct window *w = decode_window (window);
6846 /* Translate negative or zero widths to nil.
6847 Margins that are too wide have to be checked elsewhere. */
6849 if (!NILP (left_width))
6851 CHECK_NUMBER (left_width);
6852 if (XINT (left_width) <= 0)
6853 left_width = Qnil;
6856 if (!NILP (right_width))
6858 CHECK_NUMBER (right_width);
6859 if (XINT (right_width) <= 0)
6860 right_width = Qnil;
6863 if (!EQ (w->left_margin_cols, left_width)
6864 || !EQ (w->right_margin_cols, right_width))
6866 w->left_margin_cols = left_width;
6867 w->right_margin_cols = right_width;
6869 adjust_window_margins (w);
6871 ++windows_or_buffers_changed;
6872 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
6875 return Qnil;
6879 DEFUN ("window-margins", Fwindow_margins, Swindow_margins,
6880 0, 1, 0,
6881 doc: /* Get width of marginal areas of window WINDOW.
6882 If WINDOW is omitted or nil, use the currently selected window.
6883 Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
6884 If a marginal area does not exist, its width will be returned
6885 as nil. */)
6886 (window)
6887 Lisp_Object window;
6889 struct window *w = decode_window (window);
6890 return Fcons (w->left_margin_cols, w->right_margin_cols);
6895 /***********************************************************************
6896 Fringes
6897 ***********************************************************************/
6899 DEFUN ("set-window-fringes", Fset_window_fringes, Sset_window_fringes,
6900 2, 4, 0,
6901 doc: /* Set the fringe widths of window WINDOW.
6902 If WINDOW is nil, set the fringe widths of the currently selected
6903 window.
6904 Second arg LEFT-WIDTH specifies the number of pixels to reserve for
6905 the left fringe. Optional third arg RIGHT-WIDTH specifies the right
6906 fringe width. If a fringe width arg is nil, that means to use the
6907 frame's default fringe width. Default fringe widths can be set with
6908 the command `set-fringe-style'.
6909 If optional fourth arg OUTSIDE-MARGINS is non-nil, draw the fringes
6910 outside of the display margins. By default, fringes are drawn between
6911 display marginal areas and the text area. */)
6912 (window, left_width, right_width, outside_margins)
6913 Lisp_Object window, left_width, right_width, outside_margins;
6915 struct window *w = decode_window (window);
6917 if (!NILP (left_width))
6918 CHECK_NATNUM (left_width);
6919 if (!NILP (right_width))
6920 CHECK_NATNUM (right_width);
6922 /* Do nothing on a tty. */
6923 if (FRAME_WINDOW_P (WINDOW_XFRAME (w))
6924 && (!EQ (w->left_fringe_width, left_width)
6925 || !EQ (w->right_fringe_width, right_width)
6926 || !EQ (w->fringes_outside_margins, outside_margins)))
6928 w->left_fringe_width = left_width;
6929 w->right_fringe_width = right_width;
6930 w->fringes_outside_margins = outside_margins;
6932 adjust_window_margins (w);
6934 clear_glyph_matrix (w->current_matrix);
6935 w->window_end_valid = Qnil;
6937 ++windows_or_buffers_changed;
6938 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
6941 return Qnil;
6945 DEFUN ("window-fringes", Fwindow_fringes, Swindow_fringes,
6946 0, 1, 0,
6947 doc: /* Get width of fringes of window WINDOW.
6948 If WINDOW is omitted or nil, use the currently selected window.
6949 Value is a list of the form (LEFT-WIDTH RIGHT-WIDTH OUTSIDE-MARGINS). */)
6950 (window)
6951 Lisp_Object window;
6953 struct window *w = decode_window (window);
6955 return Fcons (make_number (WINDOW_LEFT_FRINGE_WIDTH (w)),
6956 Fcons (make_number (WINDOW_RIGHT_FRINGE_WIDTH (w)),
6957 Fcons ((WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
6958 ? Qt : Qnil), Qnil)));
6963 /***********************************************************************
6964 Scroll bars
6965 ***********************************************************************/
6967 DEFUN ("set-window-scroll-bars", Fset_window_scroll_bars, Sset_window_scroll_bars,
6968 2, 4, 0,
6969 doc: /* Set width and type of scroll bars of window WINDOW.
6970 If window is nil, set scroll bars of the currently selected window.
6971 Second parameter WIDTH specifies the pixel width for the scroll bar;
6972 this is automatically adjusted to a multiple of the frame column width.
6973 Third parameter VERTICAL-TYPE specifies the type of the vertical scroll
6974 bar: left, right, or nil.
6975 If WIDTH is nil, use the frame's scroll-bar width.
6976 If VERTICAL-TYPE is t, use the frame's scroll-bar type.
6977 Fourth parameter HORIZONTAL-TYPE is currently unused. */)
6978 (window, width, vertical_type, horizontal_type)
6979 Lisp_Object window, width, vertical_type, horizontal_type;
6981 struct window *w = decode_window (window);
6983 if (!NILP (width))
6985 CHECK_NATNUM (width);
6987 if (XINT (width) == 0)
6988 vertical_type = Qnil;
6991 if (!(NILP (vertical_type)
6992 || EQ (vertical_type, Qleft)
6993 || EQ (vertical_type, Qright)
6994 || EQ (vertical_type, Qt)))
6995 error ("Invalid type of vertical scroll bar");
6997 if (!EQ (w->scroll_bar_width, width)
6998 || !EQ (w->vertical_scroll_bar_type, vertical_type))
7000 w->scroll_bar_width = width;
7001 w->vertical_scroll_bar_type = vertical_type;
7003 adjust_window_margins (w);
7005 clear_glyph_matrix (w->current_matrix);
7006 w->window_end_valid = Qnil;
7008 ++windows_or_buffers_changed;
7009 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
7012 return Qnil;
7016 DEFUN ("window-scroll-bars", Fwindow_scroll_bars, Swindow_scroll_bars,
7017 0, 1, 0,
7018 doc: /* Get width and type of scroll bars of window WINDOW.
7019 If WINDOW is omitted or nil, use the currently selected window.
7020 Value is a list of the form (WIDTH COLS VERTICAL-TYPE HORIZONTAL-TYPE).
7021 If WIDTH is nil or TYPE is t, the window is using the frame's corresponding
7022 value. */)
7023 (window)
7024 Lisp_Object window;
7026 struct window *w = decode_window (window);
7027 return Fcons (make_number ((WINDOW_CONFIG_SCROLL_BAR_WIDTH (w)
7028 ? WINDOW_CONFIG_SCROLL_BAR_WIDTH (w)
7029 : WINDOW_SCROLL_BAR_AREA_WIDTH (w))),
7030 Fcons (make_number (WINDOW_SCROLL_BAR_COLS (w)),
7031 Fcons (w->vertical_scroll_bar_type,
7032 Fcons (Qnil, Qnil))));
7037 /***********************************************************************
7038 Smooth scrolling
7039 ***********************************************************************/
7041 DEFUN ("window-vscroll", Fwindow_vscroll, Swindow_vscroll, 0, 2, 0,
7042 doc: /* Return the amount by which WINDOW is scrolled vertically.
7043 Use the selected window if WINDOW is nil or omitted.
7044 Normally, value is a multiple of the canonical character height of WINDOW;
7045 optional second arg PIXELS-P means value is measured in pixels. */)
7046 (window, pixels_p)
7047 Lisp_Object window, pixels_p;
7049 Lisp_Object result;
7050 struct frame *f;
7051 struct window *w;
7053 if (NILP (window))
7054 window = selected_window;
7055 else
7056 CHECK_WINDOW (window);
7057 w = XWINDOW (window);
7058 f = XFRAME (w->frame);
7060 if (FRAME_WINDOW_P (f))
7061 result = (NILP (pixels_p)
7062 ? FRAME_CANON_Y_FROM_PIXEL_Y (f, -w->vscroll)
7063 : make_number (-w->vscroll));
7064 else
7065 result = make_number (0);
7066 return result;
7070 DEFUN ("set-window-vscroll", Fset_window_vscroll, Sset_window_vscroll,
7071 2, 3, 0,
7072 doc: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
7073 WINDOW nil means use the selected window. Normally, VSCROLL is a
7074 non-negative multiple of the canonical character height of WINDOW;
7075 optional third arg PIXELS-P non-nil means that VSCROLL is in pixels.
7076 If PIXELS-P is nil, VSCROLL may have to be rounded so that it
7077 corresponds to an integral number of pixels. The return value is the
7078 result of this rounding.
7079 If PIXELS-P is non-nil, the return value is VSCROLL. */)
7080 (window, vscroll, pixels_p)
7081 Lisp_Object window, vscroll, pixels_p;
7083 struct window *w;
7084 struct frame *f;
7086 if (NILP (window))
7087 window = selected_window;
7088 else
7089 CHECK_WINDOW (window);
7090 CHECK_NUMBER_OR_FLOAT (vscroll);
7092 w = XWINDOW (window);
7093 f = XFRAME (w->frame);
7095 if (FRAME_WINDOW_P (f))
7097 int old_dy = w->vscroll;
7099 w->vscroll = - (NILP (pixels_p)
7100 ? FRAME_LINE_HEIGHT (f) * XFLOATINT (vscroll)
7101 : XFLOATINT (vscroll));
7102 w->vscroll = min (w->vscroll, 0);
7104 if (w->vscroll != old_dy)
7106 /* Adjust glyph matrix of the frame if the virtual display
7107 area becomes larger than before. */
7108 if (w->vscroll < 0 && w->vscroll < old_dy)
7109 adjust_glyphs (f);
7111 /* Prevent redisplay shortcuts. */
7112 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
7116 return Fwindow_vscroll (window, pixels_p);
7120 /* Call FN for all leaf windows on frame F. FN is called with the
7121 first argument being a pointer to the leaf window, and with
7122 additional argument USER_DATA. Stops when FN returns 0. */
7124 void
7125 foreach_window (f, fn, user_data)
7126 struct frame *f;
7127 int (* fn) P_ ((struct window *, void *));
7128 void *user_data;
7130 /* Fdelete_frame may set FRAME_ROOT_WINDOW (f) to Qnil. */
7131 if (WINDOWP (FRAME_ROOT_WINDOW (f)))
7132 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f)), fn, user_data);
7136 /* Helper function for foreach_window. Call FN for all leaf windows
7137 reachable from W. FN is called with the first argument being a
7138 pointer to the leaf window, and with additional argument USER_DATA.
7139 Stop when FN returns 0. Value is 0 if stopped by FN. */
7141 static int
7142 foreach_window_1 (w, fn, user_data)
7143 struct window *w;
7144 int (* fn) P_ ((struct window *, void *));
7145 void *user_data;
7147 int cont;
7149 for (cont = 1; w && cont;)
7151 if (!NILP (w->hchild))
7152 cont = foreach_window_1 (XWINDOW (w->hchild), fn, user_data);
7153 else if (!NILP (w->vchild))
7154 cont = foreach_window_1 (XWINDOW (w->vchild), fn, user_data);
7155 else
7156 cont = fn (w, user_data);
7158 w = NILP (w->next) ? 0 : XWINDOW (w->next);
7161 return cont;
7165 /* Freeze or unfreeze the window start of W unless it is a
7166 mini-window or the selected window. FREEZE_P non-null means freeze
7167 the window start. */
7169 static int
7170 freeze_window_start (w, freeze_p)
7171 struct window *w;
7172 void *freeze_p;
7174 if (MINI_WINDOW_P (w)
7175 || (WINDOWP (selected_window) /* Can be nil in corner cases. */
7176 && (w == XWINDOW (selected_window)
7177 || (MINI_WINDOW_P (XWINDOW (selected_window))
7178 && ! NILP (Vminibuf_scroll_window)
7179 && w == XWINDOW (Vminibuf_scroll_window)))))
7180 freeze_p = NULL;
7182 w->frozen_window_start_p = freeze_p != NULL;
7183 return 1;
7187 /* Freeze or unfreeze the window starts of all leaf windows on frame
7188 F, except the selected window and a mini-window. FREEZE_P non-zero
7189 means freeze the window start. */
7191 void
7192 freeze_window_starts (f, freeze_p)
7193 struct frame *f;
7194 int freeze_p;
7196 foreach_window (f, freeze_window_start, (void *) (freeze_p ? f : 0));
7200 /***********************************************************************
7201 Initialization
7202 ***********************************************************************/
7204 /* Return 1 if window configurations C1 and C2
7205 describe the same state of affairs. This is used by Fequal. */
7208 compare_window_configurations (c1, c2, ignore_positions)
7209 Lisp_Object c1, c2;
7210 int ignore_positions;
7212 register struct save_window_data *d1, *d2;
7213 struct Lisp_Vector *sw1, *sw2;
7214 int i;
7216 CHECK_WINDOW_CONFIGURATION (c1);
7217 CHECK_WINDOW_CONFIGURATION (c2);
7219 d1 = (struct save_window_data *) XVECTOR (c1);
7220 d2 = (struct save_window_data *) XVECTOR (c2);
7221 sw1 = XVECTOR (d1->saved_windows);
7222 sw2 = XVECTOR (d2->saved_windows);
7224 if (d1->frame_cols != d2->frame_cols)
7225 return 0;
7226 if (d1->frame_lines != d2->frame_lines)
7227 return 0;
7228 if (d1->frame_menu_bar_lines != d2->frame_menu_bar_lines)
7229 return 0;
7230 if (! EQ (d1->selected_frame, d2->selected_frame))
7231 return 0;
7232 /* Don't compare the current_window field directly.
7233 Instead see w1_is_current and w2_is_current, below. */
7234 if (! EQ (d1->current_buffer, d2->current_buffer))
7235 return 0;
7236 if (! ignore_positions)
7238 if (! EQ (d1->minibuf_scroll_window, d2->minibuf_scroll_window))
7239 return 0;
7240 if (! EQ (d1->minibuf_selected_window, d2->minibuf_selected_window))
7241 return 0;
7243 /* Don't compare the root_window field.
7244 We don't require the two configurations
7245 to use the same window object,
7246 and the two root windows must be equivalent
7247 if everything else compares equal. */
7248 if (! EQ (d1->focus_frame, d2->focus_frame))
7249 return 0;
7250 if (d1->min_width != d2->min_width)
7251 return 0;
7252 if (d1->min_height != d2->min_height)
7253 return 0;
7255 /* Verify that the two confis have the same number of windows. */
7256 if (sw1->size != sw2->size)
7257 return 0;
7259 for (i = 0; i < sw1->size; i++)
7261 struct saved_window *p1, *p2;
7262 int w1_is_current, w2_is_current;
7264 p1 = SAVED_WINDOW_N (sw1, i);
7265 p2 = SAVED_WINDOW_N (sw2, i);
7267 /* Verify that the current windows in the two
7268 configurations correspond to each other. */
7269 w1_is_current = EQ (d1->current_window, p1->window);
7270 w2_is_current = EQ (d2->current_window, p2->window);
7272 if (w1_is_current != w2_is_current)
7273 return 0;
7275 /* Verify that the corresponding windows do match. */
7276 if (! EQ (p1->buffer, p2->buffer))
7277 return 0;
7278 if (! EQ (p1->left_col, p2->left_col))
7279 return 0;
7280 if (! EQ (p1->top_line, p2->top_line))
7281 return 0;
7282 if (! EQ (p1->total_cols, p2->total_cols))
7283 return 0;
7284 if (! EQ (p1->total_lines, p2->total_lines))
7285 return 0;
7286 if (! EQ (p1->display_table, p2->display_table))
7287 return 0;
7288 if (! EQ (p1->parent, p2->parent))
7289 return 0;
7290 if (! EQ (p1->prev, p2->prev))
7291 return 0;
7292 if (! ignore_positions)
7294 if (! EQ (p1->hscroll, p2->hscroll))
7295 return 0;
7296 if (!EQ (p1->min_hscroll, p2->min_hscroll))
7297 return 0;
7298 if (! EQ (p1->start_at_line_beg, p2->start_at_line_beg))
7299 return 0;
7300 if (NILP (Fequal (p1->start, p2->start)))
7301 return 0;
7302 if (NILP (Fequal (p1->pointm, p2->pointm)))
7303 return 0;
7304 if (NILP (Fequal (p1->mark, p2->mark)))
7305 return 0;
7307 if (! EQ (p1->left_margin_cols, p2->left_margin_cols))
7308 return 0;
7309 if (! EQ (p1->right_margin_cols, p2->right_margin_cols))
7310 return 0;
7311 if (! EQ (p1->left_fringe_width, p2->left_fringe_width))
7312 return 0;
7313 if (! EQ (p1->right_fringe_width, p2->right_fringe_width))
7314 return 0;
7315 if (! EQ (p1->fringes_outside_margins, p2->fringes_outside_margins))
7316 return 0;
7317 if (! EQ (p1->scroll_bar_width, p2->scroll_bar_width))
7318 return 0;
7319 if (! EQ (p1->vertical_scroll_bar_type, p2->vertical_scroll_bar_type))
7320 return 0;
7323 return 1;
7326 DEFUN ("compare-window-configurations", Fcompare_window_configurations,
7327 Scompare_window_configurations, 2, 2, 0,
7328 doc: /* Compare two window configurations as regards the structure of windows.
7329 This function ignores details such as the values of point and mark
7330 and scrolling positions. */)
7331 (x, y)
7332 Lisp_Object x, y;
7334 if (compare_window_configurations (x, y, 1))
7335 return Qt;
7336 return Qnil;
7339 void
7340 init_window_once ()
7342 struct frame *f = make_initial_frame ();
7343 XSETFRAME (selected_frame, f);
7344 Vterminal_frame = selected_frame;
7345 minibuf_window = f->minibuffer_window;
7346 selected_window = f->selected_window;
7347 last_nonminibuf_frame = f;
7349 window_initialized = 1;
7352 void
7353 init_window ()
7355 Vwindow_list = Qnil;
7358 void
7359 syms_of_window ()
7361 Qscroll_up = intern ("scroll-up");
7362 staticpro (&Qscroll_up);
7364 Qscroll_down = intern ("scroll-down");
7365 staticpro (&Qscroll_down);
7367 Qwindow_size_fixed = intern ("window-size-fixed");
7368 staticpro (&Qwindow_size_fixed);
7369 Fset (Qwindow_size_fixed, Qnil);
7371 staticpro (&Qwindow_configuration_change_hook);
7372 Qwindow_configuration_change_hook
7373 = intern ("window-configuration-change-hook");
7375 Qwindowp = intern ("windowp");
7376 staticpro (&Qwindowp);
7378 Qwindow_configuration_p = intern ("window-configuration-p");
7379 staticpro (&Qwindow_configuration_p);
7381 Qwindow_live_p = intern ("window-live-p");
7382 staticpro (&Qwindow_live_p);
7384 Qtemp_buffer_show_hook = intern ("temp-buffer-show-hook");
7385 staticpro (&Qtemp_buffer_show_hook);
7387 staticpro (&Vwindow_list);
7389 minibuf_selected_window = Qnil;
7390 staticpro (&minibuf_selected_window);
7392 window_scroll_pixel_based_preserve_y = -1;
7394 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
7395 doc: /* Non-nil means call as function to display a help buffer.
7396 The function is called with one argument, the buffer to be displayed.
7397 Used by `with-output-to-temp-buffer'.
7398 If this function is used, then it must do the entire job of showing
7399 the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
7400 Vtemp_buffer_show_function = Qnil;
7402 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
7403 doc: /* If non-nil, function to call to handle `display-buffer'.
7404 It will receive two args, the buffer and a flag which if non-nil means
7405 that the currently selected window is not acceptable.
7406 It should choose or create a window, display the specified buffer in it,
7407 and return the window.
7408 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
7409 work using this function. */);
7410 Vdisplay_buffer_function = Qnil;
7412 DEFVAR_LISP ("even-window-heights", &Veven_window_heights,
7413 doc: /* *If non-nil, `display-buffer' should even the window heights.
7414 If nil, `display-buffer' will leave the window configuration alone. */);
7415 Veven_window_heights = Qt;
7417 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
7418 doc: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
7419 Vminibuf_scroll_window = Qnil;
7421 DEFVAR_BOOL ("mode-line-in-non-selected-windows", &mode_line_in_non_selected_windows,
7422 doc: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
7423 If the minibuffer is active, the `minibuffer-scroll-window' mode line
7424 is displayed in the `mode-line' face. */);
7425 mode_line_in_non_selected_windows = 1;
7427 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
7428 doc: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
7429 Vother_window_scroll_buffer = Qnil;
7431 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
7432 doc: /* *Non-nil means `display-buffer' should make a separate frame. */);
7433 pop_up_frames = 0;
7435 DEFVAR_BOOL ("auto-window-vscroll", &auto_window_vscroll_p,
7436 doc: /* *Non-nil means to automatically adjust `window-vscroll' to view tall lines. */);
7437 auto_window_vscroll_p = 1;
7439 DEFVAR_BOOL ("display-buffer-reuse-frames", &display_buffer_reuse_frames,
7440 doc: /* *Non-nil means `display-buffer' should reuse frames.
7441 If the buffer in question is already displayed in a frame, raise that frame. */);
7442 display_buffer_reuse_frames = 0;
7444 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
7445 doc: /* Function to call to handle automatic new frame creation.
7446 It is called with no arguments and should return a newly created frame.
7448 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
7449 where `pop-up-frame-alist' would hold the default frame parameters. */);
7450 Vpop_up_frame_function = Qnil;
7452 DEFVAR_LISP ("special-display-buffer-names", &Vspecial_display_buffer_names,
7453 doc: /* *List of buffer names that should have their own special frames.
7454 Displaying a buffer with `display-buffer' or `pop-to-buffer',
7455 if its name is in this list, makes a special frame for it
7456 using `special-display-function'. See also `special-display-regexps'.
7458 An element of the list can be a list instead of just a string.
7459 There are two ways to use a list as an element:
7460 (BUFFER FRAME-PARAMETERS...) (BUFFER FUNCTION OTHER-ARGS...)
7461 In the first case, the FRAME-PARAMETERS are pairs of the form
7462 \(PARAMETER . VALUE); these parameter values are used to create the frame.
7463 In the second case, FUNCTION is called with BUFFER as the first argument,
7464 followed by the OTHER-ARGS--it can display BUFFER in any way it likes.
7465 All this is done by the function found in `special-display-function'.
7467 If the specified frame parameters include (same-buffer . t), the
7468 buffer is displayed in the currently selected window. Otherwise, if
7469 they include (same-frame . t), the buffer is displayed in a new window
7470 in the currently selected frame.
7472 If this variable appears \"not to work\", because you add a name to it
7473 but that buffer still appears in the selected window, look at the
7474 values of `same-window-buffer-names' and `same-window-regexps'.
7475 Those variables take precedence over this one. */);
7476 Vspecial_display_buffer_names = Qnil;
7478 DEFVAR_LISP ("special-display-regexps", &Vspecial_display_regexps,
7479 doc: /* *List of regexps saying which buffers should have their own special frames.
7480 When displaying a buffer with `display-buffer' or `pop-to-buffer',
7481 if any regexp in this list matches the buffer name, it makes a
7482 special frame for the buffer by calling `special-display-function'.
7484 An element of the list can be a list instead of just a string.
7485 There are two ways to use a list as an element:
7486 (REGEXP FRAME-PARAMETERS...) (REGEXP FUNCTION OTHER-ARGS...)
7487 In the first case, the FRAME-PARAMETERS are pairs of the form
7488 \(PARAMETER . VALUE); these parameter values are used to create the frame.
7489 In the second case, FUNCTION is called with BUFFER as the first argument,
7490 followed by the OTHER-ARGS--it can display the buffer in any way it likes.
7491 All this is done by the function found in `special-display-function'.
7493 If the specified frame parameters include (same-buffer . t), the
7494 buffer is displayed in the currently selected window. Otherwise, if
7495 they include (same-frame . t), the buffer is displayed in a new window
7496 in the currently selected frame.
7498 If this variable appears \"not to work\", because you add a regexp to it
7499 but the matching buffers still appear in the selected window, look at the
7500 values of `same-window-buffer-names' and `same-window-regexps'.
7501 Those variables take precedence over this one. */);
7502 Vspecial_display_regexps = Qnil;
7504 DEFVAR_LISP ("special-display-function", &Vspecial_display_function,
7505 doc: /* Function to call to make a new frame for a special buffer.
7506 It is called with two arguments, the buffer and optional buffer specific
7507 data, and should return a window displaying that buffer.
7508 The default value normally makes a separate frame for the buffer,
7509 using `special-display-frame-alist' to specify the frame parameters.
7510 But if the buffer specific data includes (same-buffer . t) then the
7511 buffer is displayed in the current selected window.
7512 Otherwise if it includes (same-frame . t) then the buffer is displayed in
7513 a new window in the currently selected frame.
7515 A buffer is special if it is listed in `special-display-buffer-names'
7516 or matches a regexp in `special-display-regexps'. */);
7517 Vspecial_display_function = Qnil;
7519 DEFVAR_LISP ("same-window-buffer-names", &Vsame_window_buffer_names,
7520 doc: /* *List of buffer names that should appear in the selected window.
7521 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
7522 switches to it in the selected window, rather than making it appear
7523 in some other window.
7525 An element of the list can be a cons cell instead of just a string.
7526 Then the car must be a string, which specifies the buffer name.
7527 This is for compatibility with `special-display-buffer-names';
7528 the cdr of the cons cell is ignored.
7530 See also `same-window-regexps'. */);
7531 Vsame_window_buffer_names = Qnil;
7533 DEFVAR_LISP ("same-window-regexps", &Vsame_window_regexps,
7534 doc: /* *List of regexps saying which buffers should appear in the selected window.
7535 If a buffer name matches one of these regexps, then displaying it
7536 using `display-buffer' or `pop-to-buffer' switches to it
7537 in the selected window, rather than making it appear in some other window.
7539 An element of the list can be a cons cell instead of just a string.
7540 Then the car must be a string, which specifies the buffer name.
7541 This is for compatibility with `special-display-buffer-names';
7542 the cdr of the cons cell is ignored.
7544 See also `same-window-buffer-names'. */);
7545 Vsame_window_regexps = Qnil;
7547 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
7548 doc: /* *Non-nil means display-buffer should make new windows. */);
7549 pop_up_windows = 1;
7551 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
7552 doc: /* *Number of lines of continuity when scrolling by screenfuls. */);
7553 next_screen_context_lines = 2;
7555 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
7556 doc: /* *A window must be at least this tall to be eligible for splitting
7557 by `display-buffer'. The value is in line units.
7558 If there is only one window, it is split regardless of this value. */);
7559 split_height_threshold = 500;
7561 DEFVAR_LISP ("split-window-preferred-function",
7562 &Vsplit_window_preferred_function,
7563 doc: /* Function to use to split a window.
7564 This is used by `display-buffer' to allow the user to choose whether
7565 to split windows horizontally or vertically or some mix of the two.
7566 It is called with a window as single argument and should split it in two
7567 and return the new window. */);
7568 Vsplit_window_preferred_function = intern ("split-window");
7570 DEFVAR_INT ("window-min-height", &window_min_height,
7571 doc: /* *Delete any window less than this tall (including its mode line).
7572 The value is in line units. */);
7573 window_min_height = 4;
7575 DEFVAR_INT ("window-min-width", &window_min_width,
7576 doc: /* *Delete any window less than this wide (measured in characters). */);
7577 window_min_width = 10;
7579 DEFVAR_LISP ("scroll-preserve-screen-position",
7580 &Vscroll_preserve_screen_position,
7581 doc: /* *Controls if scroll commands move point to keep its screen line unchanged.
7582 A value of nil means point does not keep its screen position except
7583 at the scroll margin or window boundary respectively.
7584 A value of t means point keeps its screen position if the scroll
7585 command moved it vertically out of the window, e.g. when scrolling
7586 by full screens.
7587 Any other value means point always keeps its screen position. */);
7588 Vscroll_preserve_screen_position = Qnil;
7590 DEFVAR_LISP ("window-configuration-change-hook",
7591 &Vwindow_configuration_change_hook,
7592 doc: /* Functions to call when window configuration changes.
7593 The selected frame is the one whose configuration has changed. */);
7594 Vwindow_configuration_change_hook = Qnil;
7596 defsubr (&Sselected_window);
7597 defsubr (&Sminibuffer_window);
7598 defsubr (&Swindow_minibuffer_p);
7599 defsubr (&Swindowp);
7600 defsubr (&Swindow_live_p);
7601 defsubr (&Spos_visible_in_window_p);
7602 defsubr (&Swindow_line_height);
7603 defsubr (&Swindow_buffer);
7604 defsubr (&Swindow_height);
7605 defsubr (&Swindow_width);
7606 defsubr (&Swindow_full_width_p);
7607 defsubr (&Swindow_hscroll);
7608 defsubr (&Sset_window_hscroll);
7609 defsubr (&Swindow_redisplay_end_trigger);
7610 defsubr (&Sset_window_redisplay_end_trigger);
7611 defsubr (&Swindow_edges);
7612 defsubr (&Swindow_pixel_edges);
7613 defsubr (&Swindow_inside_edges);
7614 defsubr (&Swindow_inside_pixel_edges);
7615 defsubr (&Scoordinates_in_window_p);
7616 defsubr (&Swindow_at);
7617 defsubr (&Swindow_point);
7618 defsubr (&Swindow_start);
7619 defsubr (&Swindow_end);
7620 defsubr (&Sset_window_point);
7621 defsubr (&Sset_window_start);
7622 defsubr (&Swindow_dedicated_p);
7623 defsubr (&Sset_window_dedicated_p);
7624 defsubr (&Swindow_display_table);
7625 defsubr (&Sset_window_display_table);
7626 defsubr (&Snext_window);
7627 defsubr (&Sprevious_window);
7628 defsubr (&Sother_window);
7629 defsubr (&Sget_lru_window);
7630 defsubr (&Sget_largest_window);
7631 defsubr (&Sget_buffer_window);
7632 defsubr (&Sdelete_other_windows);
7633 defsubr (&Sdelete_windows_on);
7634 defsubr (&Sreplace_buffer_in_windows);
7635 defsubr (&Sdelete_window);
7636 defsubr (&Sset_window_buffer);
7637 defsubr (&Sselect_window);
7638 defsubr (&Sspecial_display_p);
7639 defsubr (&Ssame_window_p);
7640 defsubr (&Sdisplay_buffer);
7641 defsubr (&Sforce_window_update);
7642 defsubr (&Ssplit_window);
7643 defsubr (&Senlarge_window);
7644 defsubr (&Sshrink_window);
7645 defsubr (&Sadjust_window_trailing_edge);
7646 defsubr (&Sscroll_up);
7647 defsubr (&Sscroll_down);
7648 defsubr (&Sscroll_left);
7649 defsubr (&Sscroll_right);
7650 defsubr (&Sother_window_for_scrolling);
7651 defsubr (&Sscroll_other_window);
7652 defsubr (&Sminibuffer_selected_window);
7653 defsubr (&Srecenter);
7654 defsubr (&Swindow_text_height);
7655 defsubr (&Smove_to_window_line);
7656 defsubr (&Swindow_configuration_p);
7657 defsubr (&Swindow_configuration_frame);
7658 defsubr (&Sset_window_configuration);
7659 defsubr (&Scurrent_window_configuration);
7660 defsubr (&Ssave_window_excursion);
7661 defsubr (&Swindow_tree);
7662 defsubr (&Sset_window_margins);
7663 defsubr (&Swindow_margins);
7664 defsubr (&Sset_window_fringes);
7665 defsubr (&Swindow_fringes);
7666 defsubr (&Sset_window_scroll_bars);
7667 defsubr (&Swindow_scroll_bars);
7668 defsubr (&Swindow_vscroll);
7669 defsubr (&Sset_window_vscroll);
7670 defsubr (&Scompare_window_configurations);
7671 defsubr (&Swindow_list);
7674 void
7675 keys_of_window ()
7677 initial_define_key (control_x_map, '1', "delete-other-windows");
7678 initial_define_key (control_x_map, '2', "split-window");
7679 initial_define_key (control_x_map, '0', "delete-window");
7680 initial_define_key (control_x_map, 'o', "other-window");
7681 initial_define_key (control_x_map, '^', "enlarge-window");
7682 initial_define_key (control_x_map, '<', "scroll-left");
7683 initial_define_key (control_x_map, '>', "scroll-right");
7685 initial_define_key (global_map, Ctl ('V'), "scroll-up");
7686 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
7687 initial_define_key (meta_map, 'v', "scroll-down");
7689 initial_define_key (global_map, Ctl('L'), "recenter");
7690 initial_define_key (meta_map, 'r', "move-to-window-line");
7693 /* arch-tag: 90a9c576-0590-48f1-a5f1-6c96a0452d9f
7694 (do not change this comment) */