1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985,86,87,93,94,95,96,97,1998,2000, 2001, 2002
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
34 #include "dispextern.h"
35 #include "blockinput.h"
36 #include "intervals.h"
40 #endif /* HAVE_X_WINDOWS */
51 /* Values returned from coordinates_in_window. */
67 Lisp_Object Qwindowp
, Qwindow_live_p
, Qwindow_configuration_p
;
68 Lisp_Object Qwindow_size_fixed
;
69 extern Lisp_Object Qleft_margin
, Qright_margin
;
70 extern Lisp_Object Qheight
, Qwidth
;
72 static int displayed_window_lines
P_ ((struct window
*));
73 static struct window
*decode_window
P_ ((Lisp_Object
));
74 static Lisp_Object select_window_1
P_ ((Lisp_Object
, int));
75 static int count_windows
P_ ((struct window
*));
76 static int get_leaf_windows
P_ ((struct window
*, struct window
**, int));
77 static void window_scroll
P_ ((Lisp_Object
, int, int, int));
78 static void window_scroll_pixel_based
P_ ((Lisp_Object
, int, int, int));
79 static void window_scroll_line_based
P_ ((Lisp_Object
, int, int, int));
80 static int window_min_size_1
P_ ((struct window
*, int));
81 static int window_min_size
P_ ((struct window
*, int, int, int *));
82 static void size_window
P_ ((Lisp_Object
, int, int, int));
83 static int freeze_window_start
P_ ((struct window
*, void *));
84 static int window_fixed_size_p
P_ ((struct window
*, int, int));
85 static void enlarge_window
P_ ((Lisp_Object
, int, int, int));
86 static Lisp_Object window_list
P_ ((void));
87 static int add_window_to_list
P_ ((struct window
*, void *));
88 static int candidate_window_p
P_ ((Lisp_Object
, Lisp_Object
, Lisp_Object
,
90 static Lisp_Object next_window
P_ ((Lisp_Object
, Lisp_Object
,
92 static void decode_next_window_args
P_ ((Lisp_Object
*, Lisp_Object
*,
94 static int foreach_window_1
P_ ((struct window
*,
95 int (* fn
) (struct window
*, void *),
97 static Lisp_Object window_list_1
P_ ((Lisp_Object
, Lisp_Object
, Lisp_Object
));
99 /* The value of `window-size-fixed'. */
101 int window_size_fixed
;
103 /* This is the window in which the terminal's cursor should
104 be left when nothing is being done with it. This must
105 always be a leaf window, and its buffer is selected by
106 the top level editing loop at the end of each command.
108 This value is always the same as
109 FRAME_SELECTED_WINDOW (selected_frame). */
111 Lisp_Object selected_window
;
113 /* A list of all windows for use by next_window and Fwindow_list.
114 Functions creating or deleting windows should invalidate this cache
115 by setting it to nil. */
117 Lisp_Object Vwindow_list
;
119 /* The mini-buffer window of the selected frame.
120 Note that you cannot test for mini-bufferness of an arbitrary window
121 by comparing against this; but you can test for mini-bufferness of
122 the selected window. */
124 Lisp_Object minibuf_window
;
126 /* Non-nil means it is the window whose mode line should be
127 shown as the selected window when the minibuffer is selected. */
129 Lisp_Object minibuf_selected_window
;
131 /* Non-nil means it is the window for C-M-v to scroll
132 when the mini-buffer is selected. */
134 Lisp_Object Vminibuf_scroll_window
;
136 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
138 Lisp_Object Vother_window_scroll_buffer
;
140 /* Non-nil means it's function to call to display temp buffers. */
142 Lisp_Object Vtemp_buffer_show_function
;
144 /* Non-zero means to use mode-line-inactive face in all windows but the
145 selected-window and the minibuffer-scroll-window when the
146 minibuffer is active. */
147 int mode_line_in_non_selected_windows
;
149 /* If a window gets smaller than either of these, it is removed. */
151 EMACS_INT window_min_height
;
152 EMACS_INT window_min_width
;
154 /* Nonzero implies Fdisplay_buffer should create windows. */
158 /* Nonzero implies make new frames for Fdisplay_buffer. */
162 /* Nonzero means reuse existing frames for displaying buffers. */
164 int display_buffer_reuse_frames
;
166 /* Non-nil means use this function instead of default */
168 Lisp_Object Vpop_up_frame_function
;
170 /* Function to call to handle Fdisplay_buffer. */
172 Lisp_Object Vdisplay_buffer_function
;
174 /* Non-nil means that Fdisplay_buffer should even the heights of windows. */
176 Lisp_Object Veven_window_heights
;
178 /* List of buffer *names* for buffers that should have their own frames. */
180 Lisp_Object Vspecial_display_buffer_names
;
182 /* List of regexps for buffer names that should have their own frames. */
184 Lisp_Object Vspecial_display_regexps
;
186 /* Function to pop up a special frame. */
188 Lisp_Object Vspecial_display_function
;
190 /* List of buffer *names* for buffers to appear in selected window. */
192 Lisp_Object Vsame_window_buffer_names
;
194 /* List of regexps for buffer names to appear in selected window. */
196 Lisp_Object Vsame_window_regexps
;
198 /* Hook run at end of temp_output_buffer_show. */
200 Lisp_Object Qtemp_buffer_show_hook
;
202 /* Fdisplay_buffer always splits the largest window
203 if that window is more than this high. */
205 EMACS_INT split_height_threshold
;
207 /* Number of lines of continuity in scrolling by screenfuls. */
209 EMACS_INT next_screen_context_lines
;
211 /* Incremented for each window created. */
213 static int sequence_number
;
215 /* Nonzero after init_window_once has finished. */
217 static int window_initialized
;
219 /* Hook to run when window config changes. */
221 Lisp_Object Qwindow_configuration_change_hook
;
222 Lisp_Object Vwindow_configuration_change_hook
;
224 /* Nonzero means scroll commands try to put point
225 at the same screen height as previously. */
227 Lisp_Object Vscroll_preserve_screen_position
;
229 #if 0 /* This isn't used anywhere. */
230 /* Nonzero means we can split a frame even if it is "unsplittable". */
231 static int inhibit_frame_unsplittable
;
234 extern EMACS_INT scroll_margin
;
236 extern Lisp_Object Qwindow_scroll_functions
, Vwindow_scroll_functions
;
238 DEFUN ("windowp", Fwindowp
, Swindowp
, 1, 1, 0,
239 doc
: /* Returns t if OBJECT is a window. */)
243 return WINDOWP (object
) ? Qt
: Qnil
;
246 DEFUN ("window-live-p", Fwindow_live_p
, Swindow_live_p
, 1, 1, 0,
247 doc
: /* Returns t if OBJECT is a window which is currently visible. */)
251 return WINDOW_LIVE_P (object
) ? Qt
: Qnil
;
258 register struct window
*p
;
260 p
= allocate_window ();
261 XSETFASTINT (p
->sequence_number
, ++sequence_number
);
262 XSETFASTINT (p
->left
, 0);
263 XSETFASTINT (p
->top
, 0);
264 XSETFASTINT (p
->height
, 0);
265 XSETFASTINT (p
->width
, 0);
266 XSETFASTINT (p
->hscroll
, 0);
267 XSETFASTINT (p
->min_hscroll
, 0);
268 p
->orig_top
= p
->orig_height
= Qnil
;
269 p
->start
= Fmake_marker ();
270 p
->pointm
= Fmake_marker ();
271 XSETFASTINT (p
->use_time
, 0);
273 p
->display_table
= Qnil
;
275 p
->pseudo_window_p
= 0;
276 bzero (&p
->cursor
, sizeof (p
->cursor
));
277 bzero (&p
->last_cursor
, sizeof (p
->last_cursor
));
278 bzero (&p
->phys_cursor
, sizeof (p
->phys_cursor
));
279 p
->desired_matrix
= p
->current_matrix
= 0;
280 p
->phys_cursor_type
= -1;
281 p
->phys_cursor_width
= -1;
282 p
->must_be_updated_p
= 0;
283 XSETFASTINT (p
->window_end_vpos
, 0);
284 XSETFASTINT (p
->window_end_pos
, 0);
285 p
->window_end_valid
= Qnil
;
288 XSETFASTINT (p
->last_point
, 0);
289 p
->frozen_window_start_p
= 0;
290 p
->height_fixed_p
= 0;
291 p
->last_cursor_off_p
= p
->cursor_off_p
= 0;
297 DEFUN ("selected-window", Fselected_window
, Sselected_window
, 0, 0, 0,
298 doc
: /* Return the window that the cursor now appears in and commands apply to. */)
301 return selected_window
;
304 DEFUN ("minibuffer-window", Fminibuffer_window
, Sminibuffer_window
, 0, 1, 0,
305 doc
: /* Return the window used now for minibuffers.
306 If the optional argument FRAME is specified, return the minibuffer window
307 used by that frame. */)
312 frame
= selected_frame
;
313 CHECK_LIVE_FRAME (frame
);
314 return FRAME_MINIBUF_WINDOW (XFRAME (frame
));
317 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p
, Swindow_minibuffer_p
, 0, 1, 0,
318 doc
: /* Returns non-nil if WINDOW is a minibuffer window. */)
322 struct window
*w
= decode_window (window
);
323 return MINI_WINDOW_P (w
) ? Qt
: Qnil
;
327 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p
,
328 Spos_visible_in_window_p
, 0, 3, 0,
329 doc
: /* Return t if position POS is currently on the frame in WINDOW.
330 Return nil if that position is scrolled vertically out of view.
331 If a character is only partially visible, nil is returned, unless the
332 optional argument PARTIALLY is non-nil.
333 POS defaults to point in WINDOW; WINDOW defaults to the selected window. */)
334 (pos
, window
, partially
)
335 Lisp_Object pos
, window
, partially
;
337 register struct window
*w
;
339 register struct buffer
*buf
;
341 Lisp_Object in_window
;
344 w
= decode_window (window
);
345 buf
= XBUFFER (w
->buffer
);
346 SET_TEXT_POS_FROM_MARKER (top
, w
->start
);
350 CHECK_NUMBER_COERCE_MARKER (pos
);
353 else if (w
== XWINDOW (selected_window
))
356 posint
= XMARKER (w
->pointm
)->charpos
;
358 /* If position is above window start, it's not visible. */
359 if (posint
< CHARPOS (top
))
361 else if (XFASTINT (w
->last_modified
) >= BUF_MODIFF (buf
)
362 && XFASTINT (w
->last_overlay_modified
) >= BUF_OVERLAY_MODIFF (buf
)
363 && posint
< BUF_Z (buf
) - XFASTINT (w
->window_end_pos
))
365 /* If frame is up-to-date, and POSINT is < window end pos, use
366 that info. This doesn't work for POSINT == end pos, because
367 the window end pos is actually the position _after_ the last
368 char in the window. */
369 if (NILP (partially
))
371 pos_visible_p (w
, posint
, &fully_p
, NILP (partially
));
372 in_window
= fully_p
? Qt
: Qnil
;
377 else if (posint
> BUF_ZV (buf
))
379 else if (CHARPOS (top
) < BUF_BEGV (buf
) || CHARPOS (top
) > BUF_ZV (buf
))
380 /* If window start is out of range, do something reasonable. */
384 if (pos_visible_p (w
, posint
, &fully_p
, NILP (partially
)))
385 in_window
= !NILP (partially
) || fully_p
? Qt
: Qnil
;
394 static struct window
*
395 decode_window (window
)
396 register Lisp_Object window
;
399 return XWINDOW (selected_window
);
401 CHECK_LIVE_WINDOW (window
);
402 return XWINDOW (window
);
405 DEFUN ("window-buffer", Fwindow_buffer
, Swindow_buffer
, 0, 1, 0,
406 doc
: /* Return the buffer that WINDOW is displaying. */)
410 return decode_window (window
)->buffer
;
413 DEFUN ("window-height", Fwindow_height
, Swindow_height
, 0, 1, 0,
414 doc
: /* Return the number of lines in WINDOW (including its mode line). */)
418 return decode_window (window
)->height
;
421 DEFUN ("window-width", Fwindow_width
, Swindow_width
, 0, 1, 0,
422 doc
: /* Return the number of display columns in WINDOW.
423 This is the width that is usable columns available for text in WINDOW.
424 If you want to find out how many columns WINDOW takes up,
425 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))). */)
429 return make_number (window_internal_width (decode_window (window
)));
432 DEFUN ("window-hscroll", Fwindow_hscroll
, Swindow_hscroll
, 0, 1, 0,
433 doc
: /* Return the number of columns by which WINDOW is scrolled from left margin. */)
437 return decode_window (window
)->hscroll
;
440 DEFUN ("set-window-hscroll", Fset_window_hscroll
, Sset_window_hscroll
, 2, 2, 0,
441 doc
: /* Set number of columns WINDOW is scrolled from left margin to NCOL.
442 NCOL should be zero or positive.
444 Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
445 window so that the location of point becomes invisible. */)
447 Lisp_Object window
, ncol
;
449 struct window
*w
= decode_window (window
);
453 hscroll
= max (0, XINT (ncol
));
455 /* Prevent redisplay shortcuts when changing the hscroll. */
456 if (XINT (w
->hscroll
) != hscroll
)
457 XBUFFER (w
->buffer
)->prevent_redisplay_optimizations_p
= 1;
459 w
->hscroll
= make_number (hscroll
);
463 DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger
,
464 Swindow_redisplay_end_trigger
, 0, 1, 0,
465 doc
: /* Return WINDOW's redisplay end trigger value.
466 See `set-window-redisplay-end-trigger' for more information. */)
470 return decode_window (window
)->redisplay_end_trigger
;
473 DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger
,
474 Sset_window_redisplay_end_trigger
, 2, 2, 0,
475 doc
: /* Set WINDOW's redisplay end trigger value to VALUE.
476 VALUE should be a buffer position (typically a marker) or nil.
477 If it is a buffer position, then if redisplay in WINDOW reaches a position
478 beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
479 with two arguments: WINDOW, and the end trigger value.
480 Afterwards the end-trigger value is reset to nil. */)
482 register Lisp_Object window
, value
;
484 register struct window
*w
;
486 w
= decode_window (window
);
487 w
->redisplay_end_trigger
= value
;
491 DEFUN ("window-edges", Fwindow_edges
, Swindow_edges
, 0, 1, 0,
492 doc
: /* Return a list of the edge coordinates of WINDOW.
493 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
494 RIGHT is one more than the rightmost column used by WINDOW,
495 and BOTTOM is one more than the bottommost row used by WINDOW
496 and its mode-line. */)
500 register struct window
*w
= decode_window (window
);
502 return Fcons (w
->left
, Fcons (w
->top
,
503 Fcons (make_number (WINDOW_RIGHT_EDGE (w
)),
504 Fcons (make_number (XFASTINT (w
->top
)
505 + XFASTINT (w
->height
)),
509 /* Test if the character at column *X, row *Y is within window W.
510 If it is not, return 0;
511 if it is in the window's text area,
512 set *x and *y to its location relative to the upper left corner
515 if it is on the window's modeline, return 2;
516 if it is on the border between the window and its right sibling,
518 if it is on the window's top line, return 4;
519 if it is in left or right fringe of the window,
520 return 5 or 6, and convert *X and *Y to window-relative coordinates;
521 if it is in the marginal area to the left/right of the window,
522 return 7 or 8, and convert *X and *Y to window-relative coordinates.
524 X and Y are frame relative pixel coordinates. */
526 static enum window_part
527 coordinates_in_window (w
, x
, y
)
528 register struct window
*w
;
531 /* Let's make this a global enum later, instead of using numbers
533 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
534 int left_x
, right_x
, top_y
, bottom_y
;
535 enum window_part part
;
536 int ux
= CANON_X_UNIT (f
);
537 int x0
= XFASTINT (w
->left
) * ux
;
538 int x1
= x0
+ XFASTINT (w
->width
) * ux
;
539 /* The width of the area where the vertical line can be dragged.
540 (Between mode lines for instance. */
541 int grabbable_width
= ux
;
542 int lmargin_width
= 0, rmargin_width
= 0;
544 if (*x
< x0
|| *x
>= x1
)
547 /* In what's below, we subtract 1 when computing right_x because we
548 want the rightmost pixel, which is given by left_pixel+width-1. */
549 if (w
->pseudo_window_p
)
552 right_x
= XFASTINT (w
->width
) * CANON_X_UNIT (f
) - 1;
553 top_y
= WINDOW_DISPLAY_TOP_EDGE_PIXEL_Y (w
);
554 bottom_y
= WINDOW_DISPLAY_BOTTOM_EDGE_PIXEL_Y (w
);
558 left_x
= (WINDOW_DISPLAY_LEFT_EDGE_PIXEL_X (w
)
559 - FRAME_INTERNAL_BORDER_WIDTH_SAFE (f
));
560 right_x
= WINDOW_DISPLAY_RIGHT_EDGE_PIXEL_X (w
) - 1;
561 top_y
= (WINDOW_DISPLAY_TOP_EDGE_PIXEL_Y (w
)
562 - FRAME_INTERNAL_BORDER_WIDTH_SAFE (f
));
563 bottom_y
= WINDOW_DISPLAY_BOTTOM_EDGE_PIXEL_Y (w
);
566 /* On the mode line or header line? If it's near the start of
567 the mode or header line of window that's has a horizontal
568 sibling, say it's on the vertical line. That's to be able
569 to resize windows horizontally in case we're using toolkit
572 if (WINDOW_WANTS_MODELINE_P (w
)
573 && *y
>= bottom_y
- CURRENT_MODE_LINE_HEIGHT (w
)
576 /* We're somewhere on the mode line. We consider the place
577 between mode lines of horizontally adjacent mode lines
578 as the vertical border. If scroll bars on the left,
579 return the right window. */
582 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f
))
584 if (abs (*x
- x0
) < grabbable_width
)
585 part
= ON_VERTICAL_BORDER
;
587 else if (!WINDOW_RIGHTMOST_P (w
) && abs (*x
- x1
) < grabbable_width
)
588 part
= ON_VERTICAL_BORDER
;
590 else if (WINDOW_WANTS_HEADER_LINE_P (w
)
591 && *y
< top_y
+ CURRENT_HEADER_LINE_HEIGHT (w
)
594 part
= ON_HEADER_LINE
;
596 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f
))
598 if (abs (*x
- x0
) < grabbable_width
)
599 part
= ON_VERTICAL_BORDER
;
601 else if (!WINDOW_RIGHTMOST_P (w
) && abs (*x
- x1
) < grabbable_width
)
602 part
= ON_VERTICAL_BORDER
;
604 /* Outside anything interesting? */
608 - FRAME_LEFT_FRINGE_WIDTH (f
)
609 - FRAME_LEFT_SCROLL_BAR_WIDTH (f
) * ux
)
611 + FRAME_RIGHT_FRINGE_WIDTH (f
)
612 + FRAME_RIGHT_SCROLL_BAR_WIDTH (f
) * ux
))
616 else if (FRAME_WINDOW_P (f
))
618 if (!w
->pseudo_window_p
619 && !FRAME_HAS_VERTICAL_SCROLL_BARS (f
)
620 && !WINDOW_RIGHTMOST_P (w
)
621 && (abs (*x
- right_x
- FRAME_RIGHT_FRINGE_WIDTH (f
)) < grabbable_width
))
623 part
= ON_VERTICAL_BORDER
;
625 else if (*x
< left_x
|| *x
> right_x
)
627 /* Other lines than the mode line don't include fringes and
628 scroll bars on the left. */
630 /* Convert X and Y to window-relative pixel coordinates. */
633 part
= *x
< left_x
? ON_LEFT_FRINGE
: ON_RIGHT_FRINGE
;
637 lmargin_width
= window_box_width (w
, LEFT_MARGIN_AREA
);
638 rmargin_width
= window_box_width (w
, RIGHT_MARGIN_AREA
);
639 /* You can never be on a margin area if its width is zero. */
641 && *x
<= window_box_right (w
, LEFT_MARGIN_AREA
))
642 part
= ON_LEFT_MARGIN
;
643 else if (rmargin_width
644 && *x
>= window_box_left (w
, RIGHT_MARGIN_AREA
))
645 part
= ON_RIGHT_MARGIN
;
656 /* Need to say "*x > right_x" rather than >=, since on character
657 terminals, the vertical line's x coordinate is right_x. */
658 if (*x
< left_x
|| *x
> right_x
)
660 /* Other lines than the mode line don't include fringes and
661 scroll bars on the left. */
663 /* Convert X and Y to window-relative pixel coordinates. */
666 part
= *x
< left_x
? ON_LEFT_FRINGE
: ON_RIGHT_FRINGE
;
668 /* Here, too, "*x > right_x" is because of character terminals. */
669 else if (!w
->pseudo_window_p
670 && !WINDOW_RIGHTMOST_P (w
)
671 && *x
> right_x
- ux
)
673 /* On the border on the right side of the window? Assume that
674 this area begins at RIGHT_X minus a canonical char width. */
675 part
= ON_VERTICAL_BORDER
;
679 lmargin_width
= window_box_width (w
, LEFT_MARGIN_AREA
);
680 rmargin_width
= window_box_width (w
, RIGHT_MARGIN_AREA
);
681 /* You can never be on a margin area if its width is zero.
682 This is especially important for character terminals. */
684 && *x
<= window_box_right (w
, LEFT_MARGIN_AREA
))
685 part
= ON_LEFT_MARGIN
;
686 else if (rmargin_width
687 && *x
>= window_box_left (w
, RIGHT_MARGIN_AREA
))
688 part
= ON_RIGHT_MARGIN
;
692 /* Convert X and Y to window-relative pixel coordinates. */
703 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p
,
704 Scoordinates_in_window_p
, 2, 2, 0,
705 doc
: /* Return non-nil if COORDINATES are in WINDOW.
706 COORDINATES is a cons of the form (X . Y), X and Y being distances
707 measured in characters from the upper-left corner of the frame.
708 \(0 . 0) denotes the character in the upper left corner of the
710 If COORDINATES are in the text portion of WINDOW,
711 the coordinates relative to the window are returned.
712 If they are in the mode line of WINDOW, `mode-line' is returned.
713 If they are in the top mode line of WINDOW, `header-line' is returned.
714 If they are in the left fringe of WINDOW, `left-fringe' is returned.
715 If they are in the right fringe of WINDOW, `right-fringe' is returned.
716 If they are on the border between WINDOW and its right sibling,
717 `vertical-line' is returned.
718 If they are in the windows's left or right marginal areas, `left-margin'\n\
719 or `right-margin' is returned. */)
720 (coordinates
, window
)
721 register Lisp_Object coordinates
, window
;
728 CHECK_LIVE_WINDOW (window
);
729 w
= XWINDOW (window
);
730 f
= XFRAME (w
->frame
);
731 CHECK_CONS (coordinates
);
732 lx
= Fcar (coordinates
);
733 ly
= Fcdr (coordinates
);
734 CHECK_NUMBER_OR_FLOAT (lx
);
735 CHECK_NUMBER_OR_FLOAT (ly
);
736 x
= PIXEL_X_FROM_CANON_X (f
, lx
);
737 y
= PIXEL_Y_FROM_CANON_Y (f
, ly
);
739 switch (coordinates_in_window (w
, &x
, &y
))
745 /* X and Y are now window relative pixel coordinates. Convert
746 them to canonical char units before returning them. */
747 return Fcons (CANON_X_FROM_PIXEL_X (f
, x
),
748 CANON_Y_FROM_PIXEL_Y (f
, y
));
753 case ON_VERTICAL_BORDER
:
754 return Qvertical_line
;
762 case ON_RIGHT_FRINGE
:
763 return Qright_fringe
;
768 case ON_RIGHT_MARGIN
:
769 return Qright_margin
;
777 /* Callback for foreach_window, used in window_from_coordinates.
778 Check if window W contains coordinates specified by USER_DATA which
779 is actually a pointer to a struct check_window_data CW.
781 Check if window W contains coordinates *CW->x and *CW->y. If it
782 does, return W in *CW->window, as Lisp_Object, and return in
783 *CW->part the part of the window under coordinates *X,*Y. Return
784 zero from this function to stop iterating over windows. */
786 struct check_window_data
793 check_window_containing (w
, user_data
)
797 struct check_window_data
*cw
= (struct check_window_data
*) user_data
;
798 enum window_part found
;
801 found
= coordinates_in_window (w
, cw
->x
, cw
->y
);
802 if (found
!= ON_NOTHING
)
804 *cw
->part
= found
- 1;
805 XSETWINDOW (*cw
->window
, w
);
813 /* Find the window containing frame-relative pixel position X/Y and
814 return it as a Lisp_Object. If X, Y is on the window's modeline,
815 set *PART to 1; if it is on the separating line between the window
816 and its right sibling, set it to 2; otherwise set it to 0. If
817 there is no window under X, Y return nil and leave *PART
818 unmodified. TOOL_BAR_P non-zero means detect tool-bar windows.
820 This function was previously implemented with a loop cycling over
821 windows with Fnext_window, and starting with the frame's selected
822 window. It turned out that this doesn't work with an
823 implementation of next_window using Vwindow_list, because
824 FRAME_SELECTED_WINDOW (F) is not always contained in the window
825 tree of F when this function is called asynchronously from
826 note_mouse_highlight. The original loop didn't terminate in this
830 window_from_coordinates (f
, x
, y
, part
, tool_bar_p
)
837 struct check_window_data cw
;
840 cw
.window
= &window
, cw
.x
= &x
, cw
.y
= &y
; cw
.part
= part
;
841 foreach_window (f
, check_window_containing
, &cw
);
843 /* If not found above, see if it's in the tool bar window, if a tool
847 && WINDOWP (f
->tool_bar_window
)
848 && XINT (XWINDOW (f
->tool_bar_window
)->height
) > 0
849 && (coordinates_in_window (XWINDOW (f
->tool_bar_window
), &x
, &y
)
853 window
= f
->tool_bar_window
;
859 DEFUN ("window-at", Fwindow_at
, Swindow_at
, 2, 3, 0,
860 doc
: /* Return window containing coordinates X and Y on FRAME.
861 If omitted, FRAME defaults to the currently selected frame.
862 The top left corner of the frame is considered to be row 0,
865 Lisp_Object x
, y
, frame
;
871 frame
= selected_frame
;
872 CHECK_LIVE_FRAME (frame
);
875 /* Check that arguments are integers or floats. */
876 CHECK_NUMBER_OR_FLOAT (x
);
877 CHECK_NUMBER_OR_FLOAT (y
);
879 return window_from_coordinates (f
,
880 PIXEL_X_FROM_CANON_X (f
, x
),
881 PIXEL_Y_FROM_CANON_Y (f
, y
),
885 DEFUN ("window-point", Fwindow_point
, Swindow_point
, 0, 1, 0,
886 doc
: /* Return current value of point in WINDOW.
887 For a nonselected window, this is the value point would have
888 if that window were selected.
890 Note that, when WINDOW is the selected window and its buffer
891 is also currently selected, the value returned is the same as (point).
892 It would be more strictly correct to return the `top-level' value
893 of point, outside of any save-excursion forms.
894 But that is hard to define. */)
898 register struct window
*w
= decode_window (window
);
900 if (w
== XWINDOW (selected_window
)
901 && current_buffer
== XBUFFER (w
->buffer
))
903 return Fmarker_position (w
->pointm
);
906 DEFUN ("window-start", Fwindow_start
, Swindow_start
, 0, 1, 0,
907 doc
: /* Return position at which display currently starts in WINDOW.
908 This is updated by redisplay or by calling `set-window-start'. */)
912 return Fmarker_position (decode_window (window
)->start
);
915 /* This is text temporarily removed from the doc string below.
917 This function returns nil if the position is not currently known.
918 That happens when redisplay is preempted and doesn't finish.
919 If in that case you want to compute where the end of the window would
920 have been if redisplay had finished, do this:
922 (goto-char (window-start window))
923 (vertical-motion (1- (window-height window)) window)
926 DEFUN ("window-end", Fwindow_end
, Swindow_end
, 0, 2, 0,
927 doc
: /* Return position at which display currently ends in WINDOW.
928 This is updated by redisplay, when it runs to completion.
929 Simply changing the buffer text or setting `window-start'
930 does not update this value.
931 If UPDATE is non-nil, compute the up-to-date position
932 if it isn't already recorded. */)
934 Lisp_Object window
, update
;
937 struct window
*w
= decode_window (window
);
943 #if 0 /* This change broke some things. We should make it later. */
944 /* If we don't know the end position, return nil.
945 The user can compute it with vertical-motion if he wants to.
946 It would be nicer to do it automatically,
947 but that's so slow that it would probably bother people. */
948 if (NILP (w
->window_end_valid
))
953 && ! (! NILP (w
->window_end_valid
)
954 && XFASTINT (w
->last_modified
) >= MODIFF
))
956 struct text_pos startp
;
958 struct buffer
*old_buffer
= NULL
, *b
= XBUFFER (buf
);
960 /* In case W->start is out of the range, use something
961 reasonable. This situation occured when loading a file with
962 `-l' containing a call to `rmail' with subsequent other
963 commands. At the end, W->start happened to be BEG, while
964 rmail had already narrowed the buffer. */
965 if (XMARKER (w
->start
)->charpos
< BEGV
)
966 SET_TEXT_POS (startp
, BEGV
, BEGV_BYTE
);
967 else if (XMARKER (w
->start
)->charpos
> ZV
)
968 SET_TEXT_POS (startp
, ZV
, ZV_BYTE
);
970 SET_TEXT_POS_FROM_MARKER (startp
, w
->start
);
972 /* Cannot use Fvertical_motion because that function doesn't
973 cope with variable-height lines. */
974 if (b
!= current_buffer
)
976 old_buffer
= current_buffer
;
977 set_buffer_internal (b
);
980 start_display (&it
, w
, startp
);
981 move_it_vertically (&it
, window_box_height (w
));
982 if (it
.current_y
< it
.last_visible_y
)
983 move_it_past_eol (&it
);
984 value
= make_number (IT_CHARPOS (it
));
987 set_buffer_internal (old_buffer
);
990 XSETINT (value
, BUF_Z (XBUFFER (buf
)) - XFASTINT (w
->window_end_pos
));
995 DEFUN ("set-window-point", Fset_window_point
, Sset_window_point
, 2, 2, 0,
996 doc
: /* Make point value in WINDOW be at position POS in WINDOW's buffer. */)
998 Lisp_Object window
, pos
;
1000 register struct window
*w
= decode_window (window
);
1002 CHECK_NUMBER_COERCE_MARKER (pos
);
1003 if (w
== XWINDOW (selected_window
)
1004 && XBUFFER (w
->buffer
) == current_buffer
)
1007 set_marker_restricted (w
->pointm
, pos
, w
->buffer
);
1009 /* We have to make sure that redisplay updates the window to show
1010 the new value of point. */
1011 if (!EQ (window
, selected_window
))
1012 ++windows_or_buffers_changed
;
1017 DEFUN ("set-window-start", Fset_window_start
, Sset_window_start
, 2, 3, 0,
1018 doc
: /* Make display in WINDOW start at position POS in WINDOW's buffer.
1019 Optional third arg NOFORCE non-nil inhibits next redisplay
1020 from overriding motion of point in order to display at this exact start. */)
1021 (window
, pos
, noforce
)
1022 Lisp_Object window
, pos
, noforce
;
1024 register struct window
*w
= decode_window (window
);
1026 CHECK_NUMBER_COERCE_MARKER (pos
);
1027 set_marker_restricted (w
->start
, pos
, w
->buffer
);
1028 /* this is not right, but much easier than doing what is right. */
1029 w
->start_at_line_beg
= Qnil
;
1031 w
->force_start
= Qt
;
1032 w
->update_mode_line
= Qt
;
1033 XSETFASTINT (w
->last_modified
, 0);
1034 XSETFASTINT (w
->last_overlay_modified
, 0);
1035 if (!EQ (window
, selected_window
))
1036 windows_or_buffers_changed
++;
1041 DEFUN ("window-dedicated-p", Fwindow_dedicated_p
, Swindow_dedicated_p
,
1043 doc
: /* Return WINDOW's dedicated object, usually t or nil.
1044 See also `set-window-dedicated-p'. */)
1048 return decode_window (window
)->dedicated
;
1051 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p
,
1052 Sset_window_dedicated_p
, 2, 2, 0,
1053 doc
: /* Control whether WINDOW is dedicated to the buffer it displays.
1054 If it is dedicated, Emacs will not automatically change
1055 which buffer appears in it.
1056 The second argument is the new value for the dedication flag;
1057 non-nil means yes. */)
1059 Lisp_Object window
, arg
;
1061 register struct window
*w
= decode_window (window
);
1064 w
->dedicated
= Qnil
;
1068 return w
->dedicated
;
1071 DEFUN ("window-display-table", Fwindow_display_table
, Swindow_display_table
,
1073 doc
: /* Return the display-table that WINDOW is using. */)
1077 return decode_window (window
)->display_table
;
1080 /* Get the display table for use on window W. This is either W's
1081 display table or W's buffer's display table. Ignore the specified
1082 tables if they are not valid; if no valid table is specified,
1085 struct Lisp_Char_Table
*
1086 window_display_table (w
)
1089 struct Lisp_Char_Table
*dp
= NULL
;
1091 if (DISP_TABLE_P (w
->display_table
))
1092 dp
= XCHAR_TABLE (w
->display_table
);
1093 else if (BUFFERP (w
->buffer
))
1095 struct buffer
*b
= XBUFFER (w
->buffer
);
1097 if (DISP_TABLE_P (b
->display_table
))
1098 dp
= XCHAR_TABLE (b
->display_table
);
1099 else if (DISP_TABLE_P (Vstandard_display_table
))
1100 dp
= XCHAR_TABLE (Vstandard_display_table
);
1106 DEFUN ("set-window-display-table", Fset_window_display_table
, Sset_window_display_table
, 2, 2, 0,
1107 doc
: /* Set WINDOW's display-table to TABLE. */)
1109 register Lisp_Object window
, table
;
1111 register struct window
*w
;
1113 w
= decode_window (window
);
1114 w
->display_table
= table
;
1118 /* Record info on buffer window w is displaying
1119 when it is about to cease to display that buffer. */
1122 register struct window
*w
;
1129 if (b
!= XMARKER (w
->pointm
)->buffer
)
1133 if (w
== XWINDOW (selected_window
)
1134 || ! EQ (buf
, XWINDOW (selected_window
)->buffer
))
1135 /* Do this except when the selected window's buffer
1136 is being removed from some other window. */
1138 /* last_window_start records the start position that this buffer
1139 had in the last window to be disconnected from it.
1140 Now that this statement is unconditional,
1141 it is possible for the buffer to be displayed in the
1142 selected window, while last_window_start reflects another
1143 window which was recently showing the same buffer.
1144 Some people might say that might be a good thing. Let's see. */
1145 b
->last_window_start
= marker_position (w
->start
);
1147 /* Point in the selected window's buffer
1148 is actually stored in that buffer, and the window's pointm isn't used.
1149 So don't clobber point in that buffer. */
1150 if (! EQ (buf
, XWINDOW (selected_window
)->buffer
)
1151 /* This line helps to fix Horsley's testbug.el bug. */
1152 && !(WINDOWP (b
->last_selected_window
)
1153 && w
!= XWINDOW (b
->last_selected_window
)
1154 && EQ (buf
, XWINDOW (b
->last_selected_window
)->buffer
)))
1155 temp_set_point_both (b
,
1156 clip_to_bounds (BUF_BEGV (b
),
1157 XMARKER (w
->pointm
)->charpos
,
1159 clip_to_bounds (BUF_BEGV_BYTE (b
),
1160 marker_byte_position (w
->pointm
),
1163 if (WINDOWP (b
->last_selected_window
)
1164 && w
== XWINDOW (b
->last_selected_window
))
1165 b
->last_selected_window
= Qnil
;
1168 /* Put replacement into the window structure in place of old. */
1170 replace_window (old
, replacement
)
1171 Lisp_Object old
, replacement
;
1173 register Lisp_Object tem
;
1174 register struct window
*o
= XWINDOW (old
), *p
= XWINDOW (replacement
);
1176 /* If OLD is its frame's root_window, then replacement is the new
1177 root_window for that frame. */
1179 if (EQ (old
, FRAME_ROOT_WINDOW (XFRAME (o
->frame
))))
1180 FRAME_ROOT_WINDOW (XFRAME (o
->frame
)) = replacement
;
1184 p
->width
= o
->width
;
1185 p
->height
= o
->height
;
1186 p
->desired_matrix
= p
->current_matrix
= 0;
1188 bzero (&p
->cursor
, sizeof (p
->cursor
));
1189 bzero (&p
->last_cursor
, sizeof (p
->last_cursor
));
1190 bzero (&p
->phys_cursor
, sizeof (p
->phys_cursor
));
1191 p
->phys_cursor_type
= -1;
1192 p
->phys_cursor_width
= -1;
1193 p
->must_be_updated_p
= 0;
1194 p
->pseudo_window_p
= 0;
1195 XSETFASTINT (p
->window_end_vpos
, 0);
1196 XSETFASTINT (p
->window_end_pos
, 0);
1197 p
->window_end_valid
= Qnil
;
1198 p
->frozen_window_start_p
= 0;
1199 p
->orig_top
= p
->orig_height
= Qnil
;
1201 p
->next
= tem
= o
->next
;
1203 XWINDOW (tem
)->prev
= replacement
;
1205 p
->prev
= tem
= o
->prev
;
1207 XWINDOW (tem
)->next
= replacement
;
1209 p
->parent
= tem
= o
->parent
;
1212 if (EQ (XWINDOW (tem
)->vchild
, old
))
1213 XWINDOW (tem
)->vchild
= replacement
;
1214 if (EQ (XWINDOW (tem
)->hchild
, old
))
1215 XWINDOW (tem
)->hchild
= replacement
;
1218 /*** Here, if replacement is a vertical combination
1219 and so is its new parent, we should make replacement's
1220 children be children of that parent instead. ***/
1223 DEFUN ("delete-window", Fdelete_window
, Sdelete_window
, 0, 1, "",
1224 doc
: /* Remove WINDOW from the display. Default is selected window. */)
1226 register Lisp_Object window
;
1228 delete_window (window
);
1230 if (! NILP (Vwindow_configuration_change_hook
)
1231 && ! NILP (Vrun_hooks
))
1232 call1 (Vrun_hooks
, Qwindow_configuration_change_hook
);
1238 delete_window (window
)
1239 register Lisp_Object window
;
1241 register Lisp_Object tem
, parent
, sib
;
1242 register struct window
*p
;
1243 register struct window
*par
;
1246 /* Because this function is called by other C code on non-leaf
1247 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
1248 so we can't decode_window here. */
1250 window
= selected_window
;
1252 CHECK_WINDOW (window
);
1253 p
= XWINDOW (window
);
1255 /* It's okay to delete an already-deleted window. */
1256 if (NILP (p
->buffer
)
1258 && NILP (p
->vchild
))
1263 error ("Attempt to delete minibuffer or sole ordinary window");
1264 par
= XWINDOW (parent
);
1266 windows_or_buffers_changed
++;
1267 Vwindow_list
= Qnil
;
1268 f
= XFRAME (WINDOW_FRAME (p
));
1269 FRAME_WINDOW_SIZES_CHANGED (f
) = 1;
1271 /* Are we trying to delete any frame's selected window? */
1273 Lisp_Object swindow
, pwindow
;
1275 /* See if the frame's selected window is either WINDOW
1276 or any subwindow of it, by finding all that window's parents
1277 and comparing each one with WINDOW. */
1278 swindow
= FRAME_SELECTED_WINDOW (f
);
1283 while (!NILP (pwindow
))
1285 if (EQ (window
, pwindow
))
1287 pwindow
= XWINDOW (pwindow
)->parent
;
1290 /* If the window being deleted is not a parent of SWINDOW,
1291 then SWINDOW is ok as the new selected window. */
1292 if (!EQ (window
, pwindow
))
1294 /* Otherwise, try another window for SWINDOW. */
1295 swindow
= Fnext_window (swindow
, Qlambda
, Qnil
);;
1297 /* If we get back to the frame's selected window,
1298 it means there was no acceptable alternative,
1299 so we cannot delete. */
1300 if (EQ (swindow
, FRAME_SELECTED_WINDOW (f
)))
1301 error ("Cannot delete window");
1304 /* If we need to change SWINDOW, do it. */
1305 if (! EQ (swindow
, FRAME_SELECTED_WINDOW (f
)))
1307 /* If we're about to delete the selected window on the
1308 selected frame, then we should use Fselect_window to select
1309 the new window. On the other hand, if we're about to
1310 delete the selected window on any other frame, we shouldn't do
1311 anything but set the frame's selected_window slot. */
1312 if (EQ (FRAME_SELECTED_WINDOW (f
), selected_window
))
1313 Fselect_window (swindow
);
1315 FRAME_SELECTED_WINDOW (f
) = swindow
;
1320 /* tem is null for dummy parent windows
1321 (which have inferiors but not any contents themselves) */
1325 unchain_marker (p
->pointm
);
1326 unchain_marker (p
->start
);
1329 /* Free window glyph matrices. It is sure that they are allocated
1330 again when ADJUST_GLYPHS is called. Block input so that expose
1331 events and other events that access glyph matrices are not
1332 processed while we are changing them. */
1334 free_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f
)));
1338 XWINDOW (tem
)->prev
= p
->prev
;
1342 XWINDOW (tem
)->next
= p
->next
;
1344 if (EQ (window
, par
->hchild
))
1345 par
->hchild
= p
->next
;
1346 if (EQ (window
, par
->vchild
))
1347 par
->vchild
= p
->next
;
1349 /* Find one of our siblings to give our space to. */
1353 /* If p gives its space to its next sibling, that sibling needs
1354 to have its top/left side pulled back to where p's is.
1355 set_window_{height,width} will re-position the sibling's
1358 XWINDOW (sib
)->top
= p
->top
;
1359 XWINDOW (sib
)->left
= p
->left
;
1362 /* Stretch that sibling. */
1363 if (!NILP (par
->vchild
))
1364 set_window_height (sib
,
1365 XFASTINT (XWINDOW (sib
)->height
) + XFASTINT (p
->height
),
1367 if (!NILP (par
->hchild
))
1368 set_window_width (sib
,
1369 XFASTINT (XWINDOW (sib
)->width
) + XFASTINT (p
->width
),
1372 /* If parent now has only one child,
1373 put the child into the parent's place. */
1377 if (NILP (XWINDOW (tem
)->next
))
1378 replace_window (parent
, tem
);
1380 /* Since we may be deleting combination windows, we must make sure that
1381 not only p but all its children have been marked as deleted. */
1382 if (! NILP (p
->hchild
))
1383 delete_all_subwindows (XWINDOW (p
->hchild
));
1384 else if (! NILP (p
->vchild
))
1385 delete_all_subwindows (XWINDOW (p
->vchild
));
1387 /* Mark this window as deleted. */
1388 p
->buffer
= p
->hchild
= p
->vchild
= Qnil
;
1390 /* Adjust glyph matrices. */
1397 /***********************************************************************
1399 ***********************************************************************/
1401 /* Add window W to *USER_DATA. USER_DATA is actually a Lisp_Object
1402 pointer. This is a callback function for foreach_window, used in
1403 function window_list. */
1406 add_window_to_list (w
, user_data
)
1410 Lisp_Object
*list
= (Lisp_Object
*) user_data
;
1412 XSETWINDOW (window
, w
);
1413 *list
= Fcons (window
, *list
);
1418 /* Return a list of all windows, for use by next_window. If
1419 Vwindow_list is a list, return that list. Otherwise, build a new
1420 list, cache it in Vwindow_list, and return that. */
1425 if (!CONSP (Vwindow_list
))
1429 Vwindow_list
= Qnil
;
1430 for (tail
= Vframe_list
; CONSP (tail
); tail
= XCDR (tail
))
1432 Lisp_Object args
[2];
1434 /* We are visiting windows in canonical order, and add
1435 new windows at the front of args[1], which means we
1436 have to reverse this list at the end. */
1438 foreach_window (XFRAME (XCAR (tail
)), add_window_to_list
, &args
[1]);
1439 args
[0] = Vwindow_list
;
1440 args
[1] = Fnreverse (args
[1]);
1441 Vwindow_list
= Fnconc (2, args
);
1445 return Vwindow_list
;
1449 /* Value is non-zero if WINDOW satisfies the constraints given by
1450 OWINDOW, MINIBUF and ALL_FRAMES.
1452 MINIBUF t means WINDOW may be minibuffer windows.
1453 `lambda' means WINDOW may not be a minibuffer window.
1454 a window means a specific minibuffer window
1456 ALL_FRAMES t means search all frames,
1457 nil means search just current frame,
1458 `visible' means search just visible frames,
1459 0 means search visible and iconified frames,
1460 a window means search the frame that window belongs to,
1461 a frame means consider windows on that frame, only. */
1464 candidate_window_p (window
, owindow
, minibuf
, all_frames
)
1465 Lisp_Object window
, owindow
, minibuf
, all_frames
;
1467 struct window
*w
= XWINDOW (window
);
1468 struct frame
*f
= XFRAME (w
->frame
);
1469 int candidate_p
= 1;
1471 if (!BUFFERP (w
->buffer
))
1473 else if (MINI_WINDOW_P (w
)
1474 && (EQ (minibuf
, Qlambda
)
1475 || (WINDOWP (minibuf
) && !EQ (minibuf
, window
))))
1477 /* If MINIBUF is `lambda' don't consider any mini-windows.
1478 If it is a window, consider only that one. */
1481 else if (EQ (all_frames
, Qt
))
1483 else if (NILP (all_frames
))
1485 xassert (WINDOWP (owindow
));
1486 candidate_p
= EQ (w
->frame
, XWINDOW (owindow
)->frame
);
1488 else if (EQ (all_frames
, Qvisible
))
1490 FRAME_SAMPLE_VISIBILITY (f
);
1491 candidate_p
= FRAME_VISIBLE_P (f
);
1493 else if (INTEGERP (all_frames
) && XINT (all_frames
) == 0)
1495 FRAME_SAMPLE_VISIBILITY (f
);
1496 candidate_p
= FRAME_VISIBLE_P (f
) || FRAME_ICONIFIED_P (f
);
1498 else if (WINDOWP (all_frames
))
1499 candidate_p
= (EQ (FRAME_MINIBUF_WINDOW (f
), all_frames
)
1500 || EQ (XWINDOW (all_frames
)->frame
, w
->frame
)
1501 || EQ (XWINDOW (all_frames
)->frame
, FRAME_FOCUS_FRAME (f
)));
1502 else if (FRAMEP (all_frames
))
1503 candidate_p
= EQ (all_frames
, w
->frame
);
1509 /* Decode arguments as allowed by Fnext_window, Fprevious_window, and
1510 Fwindow_list. See there for the meaning of WINDOW, MINIBUF, and
1514 decode_next_window_args (window
, minibuf
, all_frames
)
1515 Lisp_Object
*window
, *minibuf
, *all_frames
;
1518 *window
= selected_window
;
1520 CHECK_LIVE_WINDOW (*window
);
1522 /* MINIBUF nil may or may not include minibuffers. Decide if it
1524 if (NILP (*minibuf
))
1525 *minibuf
= minibuf_level
? minibuf_window
: Qlambda
;
1526 else if (!EQ (*minibuf
, Qt
))
1529 /* Now *MINIBUF can be t => count all minibuffer windows, `lambda'
1530 => count none of them, or a specific minibuffer window (the
1531 active one) to count. */
1533 /* ALL_FRAMES nil doesn't specify which frames to include. */
1534 if (NILP (*all_frames
))
1535 *all_frames
= (!EQ (*minibuf
, Qlambda
)
1536 ? FRAME_MINIBUF_WINDOW (XFRAME (XWINDOW (*window
)->frame
))
1538 else if (EQ (*all_frames
, Qvisible
))
1540 else if (XFASTINT (*all_frames
) == 0)
1542 else if (FRAMEP (*all_frames
))
1544 else if (!EQ (*all_frames
, Qt
))
1547 /* Now *ALL_FRAMES is t meaning search all frames, nil meaning
1548 search just current frame, `visible' meaning search just visible
1549 frames, 0 meaning search visible and iconified frames, or a
1550 window, meaning search the frame that window belongs to, or a
1551 frame, meaning consider windows on that frame, only. */
1555 /* Return the next or previous window of WINDOW in canonical ordering
1556 of windows. NEXT_P non-zero means return the next window. See the
1557 documentation string of next-window for the meaning of MINIBUF and
1561 next_window (window
, minibuf
, all_frames
, next_p
)
1562 Lisp_Object window
, minibuf
, all_frames
;
1565 decode_next_window_args (&window
, &minibuf
, &all_frames
);
1567 /* If ALL_FRAMES is a frame, and WINDOW isn't on that frame, just
1568 return the first window on the frame. */
1569 if (FRAMEP (all_frames
)
1570 && !EQ (all_frames
, XWINDOW (window
)->frame
))
1571 return Fframe_first_window (all_frames
);
1577 /* Find WINDOW in the list of all windows. */
1578 list
= Fmemq (window
, window_list ());
1580 /* Scan forward from WINDOW to the end of the window list. */
1582 for (list
= XCDR (list
); CONSP (list
); list
= XCDR (list
))
1583 if (candidate_window_p (XCAR (list
), window
, minibuf
, all_frames
))
1586 /* Scan from the start of the window list up to WINDOW. */
1588 for (list
= Vwindow_list
;
1589 CONSP (list
) && !EQ (XCAR (list
), window
);
1591 if (candidate_window_p (XCAR (list
), window
, minibuf
, all_frames
))
1595 window
= XCAR (list
);
1599 Lisp_Object candidate
, list
;
1601 /* Scan through the list of windows for candidates. If there are
1602 candidate windows in front of WINDOW, the last one of these
1603 is the one we want. If there are candidates following WINDOW
1604 in the list, again the last one of these is the one we want. */
1606 for (list
= window_list (); CONSP (list
); list
= XCDR (list
))
1608 if (EQ (XCAR (list
), window
))
1610 if (WINDOWP (candidate
))
1613 else if (candidate_window_p (XCAR (list
), window
, minibuf
,
1615 candidate
= XCAR (list
);
1618 if (WINDOWP (candidate
))
1626 DEFUN ("next-window", Fnext_window
, Snext_window
, 0, 3, 0,
1627 doc
: /* Return next window after WINDOW in canonical ordering of windows.
1628 If omitted, WINDOW defaults to the selected window.
1630 Optional second arg MINIBUF t means count the minibuffer window even
1631 if not active. MINIBUF nil or omitted means count the minibuffer iff
1632 it is active. MINIBUF neither t nor nil means not to count the
1633 minibuffer even if it is active.
1635 Several frames may share a single minibuffer; if the minibuffer
1636 counts, all windows on all frames that share that minibuffer count
1637 too. Therefore, `next-window' can be used to iterate through the
1638 set of windows even when the minibuffer is on another frame. If the
1639 minibuffer does not count, only windows from WINDOW's frame count.
1641 Optional third arg ALL-FRAMES t means include windows on all frames.
1642 ALL-FRAMES nil or omitted means cycle within the frames as specified
1643 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1644 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1645 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1646 Anything else means restrict to WINDOW's frame.
1648 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1649 `next-window' to iterate through the entire cycle of acceptable
1650 windows, eventually ending up back at the window you started with.
1651 `previous-window' traverses the same cycle, in the reverse order. */)
1652 (window
, minibuf
, all_frames
)
1653 Lisp_Object window
, minibuf
, all_frames
;
1655 return next_window (window
, minibuf
, all_frames
, 1);
1659 DEFUN ("previous-window", Fprevious_window
, Sprevious_window
, 0, 3, 0,
1660 doc
: /* Return the window preceding WINDOW in canonical ordering of windows.
1661 If omitted, WINDOW defaults to the selected window.
1663 Optional second arg MINIBUF t means count the minibuffer window even
1664 if not active. MINIBUF nil or omitted means count the minibuffer iff
1665 it is active. MINIBUF neither t nor nil means not to count the
1666 minibuffer even if it is active.
1668 Several frames may share a single minibuffer; if the minibuffer
1669 counts, all windows on all frames that share that minibuffer count
1670 too. Therefore, `previous-window' can be used to iterate through
1671 the set of windows even when the minibuffer is on another frame. If
1672 the minibuffer does not count, only windows from WINDOW's frame count
1674 Optional third arg ALL-FRAMES t means include windows on all frames.
1675 ALL-FRAMES nil or omitted means cycle within the frames as specified
1676 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1677 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1678 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1679 Anything else means restrict to WINDOW's frame.
1681 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1682 `previous-window' to iterate through the entire cycle of acceptable
1683 windows, eventually ending up back at the window you started with.
1684 `next-window' traverses the same cycle, in the reverse order. */)
1685 (window
, minibuf
, all_frames
)
1686 Lisp_Object window
, minibuf
, all_frames
;
1688 return next_window (window
, minibuf
, all_frames
, 0);
1692 DEFUN ("other-window", Fother_window
, Sother_window
, 1, 2, "p",
1693 doc
: /* Select the ARG'th different window on this frame.
1694 All windows on current frame are arranged in a cyclic order.
1695 This command selects the window ARG steps away in that order.
1696 A negative ARG moves in the opposite order. If the optional second
1697 argument ALL_FRAMES is non-nil, cycle through all frames. */)
1699 Lisp_Object arg
, all_frames
;
1705 window
= selected_window
;
1707 for (i
= XINT (arg
); i
> 0; --i
)
1708 window
= Fnext_window (window
, Qnil
, all_frames
);
1710 window
= Fprevious_window (window
, Qnil
, all_frames
);
1712 Fselect_window (window
);
1717 DEFUN ("window-list", Fwindow_list
, Swindow_list
, 0, 3, 0,
1718 doc
: /* Return a list of windows on FRAME, starting with WINDOW.
1719 FRAME nil or omitted means use the selected frame.
1720 WINDOW nil or omitted means use the selected window.
1721 MINIBUF t means include the minibuffer window, even if it isn't active.
1722 MINIBUF nil or omitted means include the minibuffer window only
1724 MINIBUF neither nil nor t means never include the minibuffer window. */)
1725 (frame
, minibuf
, window
)
1726 Lisp_Object frame
, minibuf
, window
;
1729 window
= selected_window
;
1731 frame
= selected_frame
;
1733 if (!EQ (frame
, XWINDOW (window
)->frame
))
1734 error ("Window is on a different frame");
1736 return window_list_1 (window
, minibuf
, frame
);
1740 /* Return a list of windows in canonical ordering. Arguments are like
1741 for `next-window'. */
1744 window_list_1 (window
, minibuf
, all_frames
)
1745 Lisp_Object window
, minibuf
, all_frames
;
1747 Lisp_Object tail
, list
;
1749 decode_next_window_args (&window
, &minibuf
, &all_frames
);
1752 for (tail
= window_list (); CONSP (tail
); tail
= XCDR (tail
))
1753 if (candidate_window_p (XCAR (tail
), window
, minibuf
, all_frames
))
1754 list
= Fcons (XCAR (tail
), list
);
1756 return Fnreverse (list
);
1761 /* Look at all windows, performing an operation specified by TYPE
1763 If FRAMES is Qt, look at all frames;
1764 Qnil, look at just the selected frame;
1765 Qvisible, look at visible frames;
1766 a frame, just look at windows on that frame.
1767 If MINI is non-zero, perform the operation on minibuffer windows too. */
1772 GET_BUFFER_WINDOW
, /* Arg is buffer */
1773 GET_LRU_WINDOW
, /* Arg is t for full-width windows only */
1774 DELETE_OTHER_WINDOWS
, /* Arg is window not to delete */
1775 DELETE_BUFFER_WINDOWS
, /* Arg is buffer */
1777 UNSHOW_BUFFER
, /* Arg is buffer */
1782 window_loop (type
, obj
, mini
, frames
)
1783 enum window_loop type
;
1784 Lisp_Object obj
, frames
;
1787 Lisp_Object window
, windows
, best_window
, frame_arg
;
1789 struct gcpro gcpro1
;
1791 /* If we're only looping through windows on a particular frame,
1792 frame points to that frame. If we're looping through windows
1793 on all frames, frame is 0. */
1794 if (FRAMEP (frames
))
1795 f
= XFRAME (frames
);
1796 else if (NILP (frames
))
1797 f
= SELECTED_FRAME ();
1802 frame_arg
= Qlambda
;
1803 else if (XFASTINT (frames
) == 0)
1805 else if (EQ (frames
, Qvisible
))
1810 /* frame_arg is Qlambda to stick to one frame,
1811 Qvisible to consider all visible frames,
1814 /* Pick a window to start with. */
1818 window
= FRAME_SELECTED_WINDOW (f
);
1820 window
= FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
1822 windows
= window_list_1 (window
, mini
? Qt
: Qnil
, frame_arg
);
1826 for (; CONSP (windows
); windows
= CDR (windows
))
1830 window
= XCAR (windows
);
1831 w
= XWINDOW (window
);
1833 /* Note that we do not pay attention here to whether the frame
1834 is visible, since Fwindow_list skips non-visible frames if
1835 that is desired, under the control of frame_arg. */
1836 if (!MINI_WINDOW_P (w
)
1837 /* For UNSHOW_BUFFER, we must always consider all windows. */
1838 || type
== UNSHOW_BUFFER
1839 || (mini
&& minibuf_level
> 0))
1842 case GET_BUFFER_WINDOW
:
1843 if (EQ (w
->buffer
, obj
)
1844 /* Don't find any minibuffer window
1845 except the one that is currently in use. */
1846 && (MINI_WINDOW_P (w
)
1847 ? EQ (window
, minibuf_window
)
1850 if (NILP (best_window
))
1851 best_window
= window
;
1852 else if (EQ (window
, selected_window
))
1853 /* For compatibility with 20.x, prefer to return
1855 best_window
= window
;
1859 case GET_LRU_WINDOW
:
1860 /* t as arg means consider only full-width windows */
1861 if (!NILP (obj
) && !WINDOW_FULL_WIDTH_P (w
))
1863 /* Ignore dedicated windows and minibuffers. */
1864 if (MINI_WINDOW_P (w
) || !NILP (w
->dedicated
))
1866 if (NILP (best_window
)
1867 || (XFASTINT (XWINDOW (best_window
)->use_time
)
1868 > XFASTINT (w
->use_time
)))
1869 best_window
= window
;
1872 case DELETE_OTHER_WINDOWS
:
1873 if (!EQ (window
, obj
))
1874 Fdelete_window (window
);
1877 case DELETE_BUFFER_WINDOWS
:
1878 if (EQ (w
->buffer
, obj
))
1880 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
1882 /* If this window is dedicated, and in a frame of its own,
1884 if (EQ (window
, FRAME_ROOT_WINDOW (f
))
1885 && !NILP (w
->dedicated
)
1886 && other_visible_frames (f
))
1888 /* Skip the other windows on this frame.
1889 There might be one, the minibuffer! */
1890 while (CONSP (XCDR (windows
))
1891 && EQ (XWINDOW (XCAR (windows
))->frame
,
1892 XWINDOW (XCAR (XCDR (windows
)))->frame
))
1893 windows
= XCDR (windows
);
1895 /* Now we can safely delete the frame. */
1896 Fdelete_frame (w
->frame
, Qnil
);
1898 else if (NILP (w
->parent
))
1900 /* If we're deleting the buffer displayed in the
1901 only window on the frame, find a new buffer to
1904 buffer
= Fother_buffer (obj
, Qnil
, w
->frame
);
1905 Fset_window_buffer (window
, buffer
);
1906 if (EQ (window
, selected_window
))
1907 Fset_buffer (w
->buffer
);
1910 Fdelete_window (window
);
1914 case GET_LARGEST_WINDOW
:
1916 /* Ignore dedicated windows and minibuffers. */
1917 if (MINI_WINDOW_P (w
) || !NILP (w
->dedicated
))
1920 if (NILP (best_window
))
1921 best_window
= window
;
1924 struct window
*b
= XWINDOW (best_window
);
1925 if (XFASTINT (w
->height
) * XFASTINT (w
->width
)
1926 > XFASTINT (b
->height
) * XFASTINT (b
->width
))
1927 best_window
= window
;
1933 if (EQ (w
->buffer
, obj
))
1936 struct frame
*f
= XFRAME (w
->frame
);
1938 /* Find another buffer to show in this window. */
1939 buffer
= Fother_buffer (obj
, Qnil
, w
->frame
);
1941 /* If this window is dedicated, and in a frame of its own,
1943 if (EQ (window
, FRAME_ROOT_WINDOW (f
))
1944 && !NILP (w
->dedicated
)
1945 && other_visible_frames (f
))
1947 /* Skip the other windows on this frame.
1948 There might be one, the minibuffer! */
1949 while (CONSP (XCDR (windows
))
1950 && EQ (XWINDOW (XCAR (windows
))->frame
,
1951 XWINDOW (XCAR (XCDR (windows
)))->frame
))
1952 windows
= XCDR (windows
);
1954 /* Now we can safely delete the frame. */
1955 Fdelete_frame (w
->frame
, Qnil
);
1959 /* Otherwise show a different buffer in the window. */
1960 w
->dedicated
= Qnil
;
1961 Fset_window_buffer (window
, buffer
);
1962 if (EQ (window
, selected_window
))
1963 Fset_buffer (w
->buffer
);
1968 /* Check for a window that has a killed buffer. */
1969 case CHECK_ALL_WINDOWS
:
1970 if (! NILP (w
->buffer
)
1971 && NILP (XBUFFER (w
->buffer
)->name
))
1975 case WINDOW_LOOP_UNUSED
:
1984 /* Used for debugging. Abort if any window has a dead buffer. */
1987 check_all_windows ()
1989 window_loop (CHECK_ALL_WINDOWS
, Qnil
, 1, Qt
);
1992 DEFUN ("get-lru-window", Fget_lru_window
, Sget_lru_window
, 0, 1, 0,
1993 doc
: /* Return the window least recently selected or used for display.
1994 If optional argument FRAME is `visible', search all visible frames.
1995 If FRAME is 0, search all visible and iconified frames.
1996 If FRAME is t, search all frames.
1997 If FRAME is nil, search only the selected frame.
1998 If FRAME is a frame, search only that frame. */)
2002 register Lisp_Object w
;
2003 /* First try for a window that is full-width */
2004 w
= window_loop (GET_LRU_WINDOW
, Qt
, 0, frame
);
2005 if (!NILP (w
) && !EQ (w
, selected_window
))
2007 /* If none of them, try the rest */
2008 return window_loop (GET_LRU_WINDOW
, Qnil
, 0, frame
);
2011 DEFUN ("get-largest-window", Fget_largest_window
, Sget_largest_window
, 0, 1, 0,
2012 doc
: /* Return the largest window in area.
2013 If optional argument FRAME is `visible', search all visible frames.
2014 If FRAME is 0, search all visible and iconified frames.
2015 If FRAME is t, search all frames.
2016 If FRAME is nil, search only the selected frame.
2017 If FRAME is a frame, search only that frame. */)
2021 return window_loop (GET_LARGEST_WINDOW
, Qnil
, 0,
2025 DEFUN ("get-buffer-window", Fget_buffer_window
, Sget_buffer_window
, 1, 2, 0,
2026 doc
: /* Return a window currently displaying BUFFER, or nil if none.
2027 If optional argument FRAME is `visible', search all visible frames.
2028 If optional argument FRAME is 0, search all visible and iconified frames.
2029 If FRAME is t, search all frames.
2030 If FRAME is nil, search only the selected frame.
2031 If FRAME is a frame, search only that frame. */)
2033 Lisp_Object buffer
, frame
;
2035 buffer
= Fget_buffer (buffer
);
2036 if (BUFFERP (buffer
))
2037 return window_loop (GET_BUFFER_WINDOW
, buffer
, 1, frame
);
2042 DEFUN ("delete-other-windows", Fdelete_other_windows
, Sdelete_other_windows
,
2044 doc
: /* Make WINDOW (or the selected window) fill its frame.
2045 Only the frame WINDOW is on is affected.
2046 This function tries to reduce display jumps
2047 by keeping the text previously visible in WINDOW
2048 in the same place on the frame. Doing this depends on
2049 the value of (window-start WINDOW), so if calling this function
2050 in a program gives strange scrolling, make sure the window-start
2051 value is reasonable when this function is called. */)
2060 window
= selected_window
;
2062 CHECK_LIVE_WINDOW (window
);
2063 w
= XWINDOW (window
);
2065 startpos
= marker_position (w
->start
);
2066 top
= XFASTINT (w
->top
) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w
)));
2068 if (MINI_WINDOW_P (w
) && top
> 0)
2069 error ("Can't expand minibuffer to full frame");
2071 window_loop (DELETE_OTHER_WINDOWS
, window
, 0, WINDOW_FRAME (w
));
2073 /* Try to minimize scrolling, by setting the window start to the point
2074 will cause the text at the old window start to be at the same place
2075 on the frame. But don't try to do this if the window start is
2076 outside the visible portion (as might happen when the display is
2077 not current, due to typeahead). */
2078 new_top
= XFASTINT (w
->top
) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w
)));
2080 && startpos
>= BUF_BEGV (XBUFFER (w
->buffer
))
2081 && startpos
<= BUF_ZV (XBUFFER (w
->buffer
)))
2083 struct position pos
;
2084 struct buffer
*obuf
= current_buffer
;
2086 Fset_buffer (w
->buffer
);
2087 /* This computation used to temporarily move point, but that can
2088 have unwanted side effects due to text properties. */
2089 pos
= *vmotion (startpos
, -top
, w
);
2091 set_marker_both (w
->start
, w
->buffer
, pos
.bufpos
, pos
.bytepos
);
2092 w
->window_end_valid
= Qnil
;
2093 w
->start_at_line_beg
= ((pos
.bytepos
== BEGV_BYTE
2094 || FETCH_BYTE (pos
.bytepos
- 1) == '\n') ? Qt
2096 /* We need to do this, so that the window-scroll-functions
2098 w
->optional_new_start
= Qt
;
2100 set_buffer_internal (obuf
);
2106 DEFUN ("delete-windows-on", Fdelete_windows_on
, Sdelete_windows_on
,
2107 1, 2, "bDelete windows on (buffer): ",
2108 doc
: /* Delete all windows showing BUFFER.
2109 Optional second argument FRAME controls which frames are affected.
2110 If optional argument FRAME is `visible', search all visible frames.
2111 If FRAME is 0, search all visible and iconified frames.
2112 If FRAME is nil, search all frames.
2113 If FRAME is t, search only the selected frame.
2114 If FRAME is a frame, search only that frame. */)
2116 Lisp_Object buffer
, frame
;
2118 /* FRAME uses t and nil to mean the opposite of what window_loop
2122 else if (EQ (frame
, Qt
))
2127 buffer
= Fget_buffer (buffer
);
2128 CHECK_BUFFER (buffer
);
2129 window_loop (DELETE_BUFFER_WINDOWS
, buffer
, 0, frame
);
2135 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows
,
2136 Sreplace_buffer_in_windows
,
2137 1, 1, "bReplace buffer in windows: ",
2138 doc
: /* Replace BUFFER with some other buffer in all windows showing it. */)
2144 buffer
= Fget_buffer (buffer
);
2145 CHECK_BUFFER (buffer
);
2146 window_loop (UNSHOW_BUFFER
, buffer
, 0, Qt
);
2151 /* Replace BUFFER with some other buffer in all windows
2152 of all frames, even those on other keyboards. */
2155 replace_buffer_in_all_windows (buffer
)
2159 Lisp_Object tail
, frame
;
2161 /* A single call to window_loop won't do the job
2162 because it only considers frames on the current keyboard.
2163 So loop manually over frames, and handle each one. */
2164 FOR_EACH_FRAME (tail
, frame
)
2165 window_loop (UNSHOW_BUFFER
, buffer
, 1, frame
);
2167 window_loop (UNSHOW_BUFFER
, buffer
, 1, Qt
);
2171 /* Set the height of WINDOW and all its inferiors. */
2173 /* The smallest acceptable dimensions for a window. Anything smaller
2174 might crash Emacs. */
2176 #define MIN_SAFE_WINDOW_WIDTH (2)
2177 #define MIN_SAFE_WINDOW_HEIGHT (1)
2179 /* Make sure that window_min_height and window_min_width are
2180 not too small; if they are, set them to safe minima. */
2183 check_min_window_sizes ()
2185 /* Smaller values might permit a crash. */
2186 if (window_min_width
< MIN_SAFE_WINDOW_WIDTH
)
2187 window_min_width
= MIN_SAFE_WINDOW_WIDTH
;
2188 if (window_min_height
< MIN_SAFE_WINDOW_HEIGHT
)
2189 window_min_height
= MIN_SAFE_WINDOW_HEIGHT
;
2192 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
2193 minimum allowable size. */
2196 check_frame_size (frame
, rows
, cols
)
2200 /* For height, we have to see:
2201 how many windows the frame has at minimum (one or two),
2202 and whether it has a menu bar or other special stuff at the top. */
2204 = ((FRAME_MINIBUF_ONLY_P (frame
) || ! FRAME_HAS_MINIBUF_P (frame
))
2205 ? MIN_SAFE_WINDOW_HEIGHT
2206 : 2 * MIN_SAFE_WINDOW_HEIGHT
);
2208 if (FRAME_TOP_MARGIN (frame
) > 0)
2209 min_height
+= FRAME_TOP_MARGIN (frame
);
2211 if (*rows
< min_height
)
2213 if (*cols
< MIN_SAFE_WINDOW_WIDTH
)
2214 *cols
= MIN_SAFE_WINDOW_WIDTH
;
2218 /* Value is non-zero if window W is fixed-size. WIDTH_P non-zero means
2219 check if W's width can be changed, otherwise check W's height.
2220 CHECK_SIBLINGS_P non-zero means check resizablity of WINDOW's
2221 siblings, too. If none of the siblings is resizable, WINDOW isn't
2225 window_fixed_size_p (w
, width_p
, check_siblings_p
)
2227 int width_p
, check_siblings_p
;
2232 if (!NILP (w
->hchild
))
2234 c
= XWINDOW (w
->hchild
);
2238 /* A horiz. combination is fixed-width if all of if its
2240 while (c
&& window_fixed_size_p (c
, width_p
, 0))
2241 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2242 fixed_p
= c
== NULL
;
2246 /* A horiz. combination is fixed-height if one of if its
2248 while (c
&& !window_fixed_size_p (c
, width_p
, 0))
2249 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2250 fixed_p
= c
!= NULL
;
2253 else if (!NILP (w
->vchild
))
2255 c
= XWINDOW (w
->vchild
);
2259 /* A vert. combination is fixed-width if one of if its
2261 while (c
&& !window_fixed_size_p (c
, width_p
, 0))
2262 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2263 fixed_p
= c
!= NULL
;
2267 /* A vert. combination is fixed-height if all of if its
2269 while (c
&& window_fixed_size_p (c
, width_p
, 0))
2270 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2271 fixed_p
= c
== NULL
;
2274 else if (BUFFERP (w
->buffer
))
2276 if (w
->height_fixed_p
&& !width_p
)
2280 struct buffer
*old
= current_buffer
;
2283 current_buffer
= XBUFFER (w
->buffer
);
2284 val
= find_symbol_value (Qwindow_size_fixed
);
2285 current_buffer
= old
;
2288 if (!EQ (val
, Qunbound
))
2290 fixed_p
= !NILP (val
);
2293 && ((EQ (val
, Qheight
) && width_p
)
2294 || (EQ (val
, Qwidth
) && !width_p
)))
2299 /* Can't tell if this one is resizable without looking at
2300 siblings. If all siblings are fixed-size this one is too. */
2301 if (!fixed_p
&& check_siblings_p
&& WINDOWP (w
->parent
))
2305 for (child
= w
->prev
; !NILP (child
); child
= XWINDOW (child
)->prev
)
2306 if (!window_fixed_size_p (XWINDOW (child
), width_p
, 0))
2310 for (child
= w
->next
; !NILP (child
); child
= XWINDOW (child
)->next
)
2311 if (!window_fixed_size_p (XWINDOW (child
), width_p
, 0))
2325 /* Return the minimum size of window W, not taking fixed-width windows
2326 into account. WIDTH_P non-zero means return the minimum width,
2327 otherwise return the minimum height. If W is a combination window,
2328 compute the minimum size from the minimum sizes of W's children. */
2331 window_min_size_1 (w
, width_p
)
2338 if (!NILP (w
->hchild
))
2340 c
= XWINDOW (w
->hchild
);
2345 /* The min width of a horizontal combination is
2346 the sum of the min widths of its children. */
2349 size
+= window_min_size_1 (c
, width_p
);
2350 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2355 /* The min height a horizontal combination equals
2356 the maximum of all min height of its children. */
2359 int min_size
= window_min_size_1 (c
, width_p
);
2360 size
= max (min_size
, size
);
2361 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2365 else if (!NILP (w
->vchild
))
2367 c
= XWINDOW (w
->vchild
);
2372 /* The min width of a vertical combination is
2373 the maximum of the min widths of its children. */
2376 int min_size
= window_min_size_1 (c
, width_p
);
2377 size
= max (min_size
, size
);
2378 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2383 /* The min height of a vertical combination equals
2384 the sum of the min height of its children. */
2387 size
+= window_min_size_1 (c
, width_p
);
2388 c
= WINDOWP (c
->next
) ? XWINDOW (c
->next
) : NULL
;
2395 size
= window_min_width
;
2398 if (MINI_WINDOW_P (w
)
2399 || (!WINDOW_WANTS_MODELINE_P (w
)
2400 && !WINDOW_WANTS_HEADER_LINE_P (w
)))
2403 size
= window_min_height
;
2411 /* Return the minimum size of window W, taking fixed-size windows into
2412 account. WIDTH_P non-zero means return the minimum width,
2413 otherwise return the minimum height. IGNORE_FIXED_P non-zero means
2414 ignore if W is fixed-size. Set *FIXED to 1 if W is fixed-size
2415 unless FIXED is null. */
2418 window_min_size (w
, width_p
, ignore_fixed_p
, fixed
)
2420 int width_p
, ignore_fixed_p
, *fixed
;
2427 fixed_p
= window_fixed_size_p (w
, width_p
, 1);
2433 size
= width_p
? XFASTINT (w
->width
) : XFASTINT (w
->height
);
2435 size
= window_min_size_1 (w
, width_p
);
2441 /* Set WINDOW's height or width to SIZE. WIDTH_P non-zero means set
2442 WINDOW's width. Resize WINDOW's children, if any, so that they
2443 keep their proportionate size relative to WINDOW. Propagate
2444 WINDOW's top or left edge position to children. Delete windows
2445 that become too small unless NODELETE_P is non-zero.
2447 If NODELETE_P is 2, that means we do delete windows that are
2448 too small, even if they were too small before! */
2451 size_window (window
, size
, width_p
, nodelete_p
)
2453 int size
, width_p
, nodelete_p
;
2455 struct window
*w
= XWINDOW (window
);
2457 Lisp_Object child
, *forward
, *sideward
;
2458 int old_size
, min_size
;
2460 if (nodelete_p
== 2)
2463 check_min_window_sizes ();
2464 size
= max (0, size
);
2466 /* If the window has been "too small" at one point,
2467 don't delete it for being "too small" in the future.
2468 Preserve it as long as that is at all possible. */
2471 old_size
= XINT (w
->width
);
2472 min_size
= window_min_width
;
2476 old_size
= XINT (w
->height
);
2477 min_size
= window_min_height
;
2480 if (old_size
< min_size
&& nodelete_p
!= 2)
2481 w
->too_small_ok
= Qt
;
2483 /* Maybe delete WINDOW if it's too small. */
2484 if (nodelete_p
!= 1 && !NILP (w
->parent
))
2486 if (!MINI_WINDOW_P (w
) && !NILP (w
->too_small_ok
))
2487 min_size
= width_p
? MIN_SAFE_WINDOW_WIDTH
: MIN_SAFE_WINDOW_HEIGHT
;
2489 min_size
= width_p
? window_min_width
: window_min_height
;
2491 if (size
< min_size
)
2493 delete_window (window
);
2498 /* Set redisplay hints. */
2499 w
->last_modified
= make_number (0);
2500 w
->last_overlay_modified
= make_number (0);
2501 windows_or_buffers_changed
++;
2502 FRAME_WINDOW_SIZES_CHANGED (XFRAME (w
->frame
)) = 1;
2506 sideward
= &w
->vchild
;
2507 forward
= &w
->hchild
;
2508 w
->width
= make_number (size
);
2512 sideward
= &w
->hchild
;
2513 forward
= &w
->vchild
;
2514 w
->height
= make_number (size
);
2515 w
->orig_height
= Qnil
;
2518 if (!NILP (*sideward
))
2520 for (child
= *sideward
; !NILP (child
); child
= c
->next
)
2522 c
= XWINDOW (child
);
2527 size_window (child
, size
, width_p
, nodelete_p
);
2530 else if (!NILP (*forward
))
2532 int fixed_size
, each
, extra
, n
;
2533 int resize_fixed_p
, nfixed
;
2534 int last_pos
, first_pos
, nchildren
, total
;
2536 /* Determine the fixed-size portion of the this window, and the
2537 number of child windows. */
2538 fixed_size
= nchildren
= nfixed
= total
= 0;
2539 for (child
= *forward
; !NILP (child
); child
= c
->next
, ++nchildren
)
2543 c
= XWINDOW (child
);
2544 child_size
= width_p
? XINT (c
->width
) : XINT (c
->height
);
2545 total
+= child_size
;
2547 if (window_fixed_size_p (c
, width_p
, 0))
2549 fixed_size
+= child_size
;
2554 /* If the new size is smaller than fixed_size, or if there
2555 aren't any resizable windows, allow resizing fixed-size
2557 resize_fixed_p
= nfixed
== nchildren
|| size
< fixed_size
;
2559 /* Compute how many lines/columns to add to each child. The
2560 value of extra takes care of rounding errors. */
2561 n
= resize_fixed_p
? nchildren
: nchildren
- nfixed
;
2562 each
= (size
- total
) / n
;
2563 extra
= (size
- total
) - n
* each
;
2565 /* Compute new children heights and edge positions. */
2566 first_pos
= width_p
? XINT (w
->left
) : XINT (w
->top
);
2567 last_pos
= first_pos
;
2568 for (child
= *forward
; !NILP (child
); child
= c
->next
)
2570 int new_size
, old_size
;
2572 c
= XWINDOW (child
);
2573 old_size
= width_p
? XFASTINT (c
->width
) : XFASTINT (c
->height
);
2574 new_size
= old_size
;
2576 /* The top or left edge position of this child equals the
2577 bottom or right edge of its predecessor. */
2579 c
->left
= make_number (last_pos
);
2581 c
->top
= make_number (last_pos
);
2583 /* If this child can be resized, do it. */
2584 if (resize_fixed_p
|| !window_fixed_size_p (c
, width_p
, 0))
2586 new_size
= old_size
+ each
+ extra
;
2590 /* Set new height. Note that size_window also propagates
2591 edge positions to children, so it's not a no-op if we
2592 didn't change the child's size. */
2593 size_window (child
, new_size
, width_p
, 1);
2595 /* Remember the bottom/right edge position of this child; it
2596 will be used to set the top/left edge of the next child. */
2597 last_pos
+= new_size
;
2600 /* We should have covered the parent exactly with child windows. */
2601 xassert (size
== last_pos
- first_pos
);
2603 /* Now delete any children that became too small. */
2605 for (child
= *forward
; !NILP (child
); child
= c
->next
)
2608 c
= XWINDOW (child
);
2609 child_size
= width_p
? XINT (c
->width
) : XINT (c
->height
);
2610 size_window (child
, child_size
, width_p
, 2);
2615 /* Set WINDOW's height to HEIGHT, and recursively change the height of
2616 WINDOW's children. NODELETE non-zero means don't delete windows
2617 that become too small in the process. (The caller should check
2618 later and do so if appropriate.) */
2621 set_window_height (window
, height
, nodelete
)
2626 size_window (window
, height
, 0, nodelete
);
2630 /* Set WINDOW's width to WIDTH, and recursively change the width of
2631 WINDOW's children. NODELETE non-zero means don't delete windows
2632 that become too small in the process. (The caller should check
2633 later and do so if appropriate.) */
2636 set_window_width (window
, width
, nodelete
)
2641 size_window (window
, width
, 1, nodelete
);
2645 int window_select_count
;
2648 Fset_window_buffer_unwind (obuf
)
2656 /* Make WINDOW display BUFFER as its contents. RUN_HOOKS_P non-zero
2657 means it's allowed to run hooks. See make_frame for a case where
2658 it's not allowed. */
2661 set_window_buffer (window
, buffer
, run_hooks_p
)
2662 Lisp_Object window
, buffer
;
2665 struct window
*w
= XWINDOW (window
);
2666 struct buffer
*b
= XBUFFER (buffer
);
2667 int count
= specpdl_ptr
- specpdl
;
2671 if (EQ (window
, selected_window
))
2672 b
->last_selected_window
= window
;
2674 /* Update time stamps of buffer display. */
2675 if (INTEGERP (b
->display_count
))
2676 XSETINT (b
->display_count
, XINT (b
->display_count
) + 1);
2677 b
->display_time
= Fcurrent_time ();
2679 XSETFASTINT (w
->window_end_pos
, 0);
2680 XSETFASTINT (w
->window_end_vpos
, 0);
2681 bzero (&w
->last_cursor
, sizeof w
->last_cursor
);
2682 w
->window_end_valid
= Qnil
;
2683 w
->hscroll
= w
->min_hscroll
= make_number (0);
2685 set_marker_both (w
->pointm
, buffer
, BUF_PT (b
), BUF_PT_BYTE (b
));
2686 set_marker_restricted (w
->start
,
2687 make_number (b
->last_window_start
),
2689 w
->start_at_line_beg
= Qnil
;
2690 w
->force_start
= Qnil
;
2691 XSETFASTINT (w
->last_modified
, 0);
2692 XSETFASTINT (w
->last_overlay_modified
, 0);
2693 windows_or_buffers_changed
++;
2695 /* We must select BUFFER for running the window-scroll-functions.
2696 If WINDOW is selected, switch permanently.
2697 Otherwise, switch but go back to the ambient buffer afterward. */
2698 if (EQ (window
, selected_window
))
2699 Fset_buffer (buffer
);
2700 /* We can't check ! NILP (Vwindow_scroll_functions) here
2701 because that might itself be a local variable. */
2702 else if (window_initialized
)
2704 record_unwind_protect (Fset_window_buffer_unwind
, Fcurrent_buffer ());
2705 Fset_buffer (buffer
);
2708 /* Set left and right marginal area width from buffer. */
2709 Fset_window_margins (window
, b
->left_margin_width
, b
->right_margin_width
);
2713 if (! NILP (Vwindow_scroll_functions
))
2714 run_hook_with_args_2 (Qwindow_scroll_functions
, window
,
2715 Fmarker_position (w
->start
));
2717 if (! NILP (Vwindow_configuration_change_hook
)
2718 && ! NILP (Vrun_hooks
))
2719 call1 (Vrun_hooks
, Qwindow_configuration_change_hook
);
2722 unbind_to (count
, Qnil
);
2726 DEFUN ("set-window-buffer", Fset_window_buffer
, Sset_window_buffer
, 2, 2, 0,
2727 doc
: /* Make WINDOW display BUFFER as its contents.
2728 BUFFER can be a buffer or buffer name. */)
2730 register Lisp_Object window
, buffer
;
2732 register Lisp_Object tem
;
2733 register struct window
*w
= decode_window (window
);
2735 XSETWINDOW (window
, w
);
2736 buffer
= Fget_buffer (buffer
);
2737 CHECK_BUFFER (buffer
);
2739 if (NILP (XBUFFER (buffer
)->name
))
2740 error ("Attempt to display deleted buffer");
2744 error ("Window is deleted");
2745 else if (! EQ (tem
, Qt
)) /* w->buffer is t when the window
2746 is first being set up. */
2748 if (!NILP (w
->dedicated
) && !EQ (tem
, buffer
))
2749 error ("Window is dedicated to `%s'",
2750 XSTRING (XBUFFER (tem
)->name
)->data
);
2755 set_window_buffer (window
, buffer
, 1);
2759 DEFUN ("select-window", Fselect_window
, Sselect_window
, 1, 1, 0,
2760 doc
: /* Select WINDOW. Most editing will apply to WINDOW's buffer.
2761 If WINDOW is not already selected, also make WINDOW's buffer current.
2762 Note that the main editor command loop
2763 selects the buffer of the selected window before each command. */)
2765 register Lisp_Object window
;
2767 return select_window_1 (window
, 1);
2770 /* Note that selected_window can be nil
2771 when this is called from Fset_window_configuration. */
2774 select_window_1 (window
, recordflag
)
2775 register Lisp_Object window
;
2778 register struct window
*w
;
2779 register struct window
*ow
;
2782 CHECK_LIVE_WINDOW (window
);
2784 w
= XWINDOW (window
);
2785 w
->frozen_window_start_p
= 0;
2787 XSETFASTINT (w
->use_time
, ++window_select_count
);
2788 if (EQ (window
, selected_window
))
2791 if (!NILP (selected_window
))
2793 ow
= XWINDOW (selected_window
);
2794 if (! NILP (ow
->buffer
))
2795 set_marker_both (ow
->pointm
, ow
->buffer
,
2796 BUF_PT (XBUFFER (ow
->buffer
)),
2797 BUF_PT_BYTE (XBUFFER (ow
->buffer
)));
2800 selected_window
= window
;
2801 sf
= SELECTED_FRAME ();
2802 if (XFRAME (WINDOW_FRAME (w
)) != sf
)
2804 XFRAME (WINDOW_FRAME (w
))->selected_window
= window
;
2805 /* Use this rather than Fhandle_switch_frame
2806 so that FRAME_FOCUS_FRAME is moved appropriately as we
2807 move around in the state where a minibuffer in a separate
2809 Fselect_frame (WINDOW_FRAME (w
), Qnil
);
2812 sf
->selected_window
= window
;
2815 record_buffer (w
->buffer
);
2816 Fset_buffer (w
->buffer
);
2818 XBUFFER (w
->buffer
)->last_selected_window
= window
;
2820 /* Go to the point recorded in the window.
2821 This is important when the buffer is in more
2822 than one window. It also matters when
2823 redisplay_window has altered point after scrolling,
2824 because it makes the change only in the window. */
2826 register int new_point
= marker_position (w
->pointm
);
2827 if (new_point
< BEGV
)
2829 else if (new_point
> ZV
)
2835 windows_or_buffers_changed
++;
2839 /* Deiconify the frame containing the window WINDOW,
2840 unless it is the selected frame;
2843 The reason for the exception for the selected frame
2844 is that it seems better not to change the selected frames visibility
2845 merely because of displaying a different buffer in it.
2846 The deiconification is useful when a buffer gets shown in
2847 another frame that you were not using lately. */
2850 display_buffer_1 (window
)
2853 Lisp_Object frame
= XWINDOW (window
)->frame
;
2854 FRAME_PTR f
= XFRAME (frame
);
2856 FRAME_SAMPLE_VISIBILITY (f
);
2858 if (!EQ (frame
, selected_frame
))
2860 if (FRAME_ICONIFIED_P (f
))
2861 Fmake_frame_visible (frame
);
2862 else if (FRAME_VISIBLE_P (f
))
2863 Fraise_frame (frame
);
2869 DEFUN ("special-display-p", Fspecial_display_p
, Sspecial_display_p
, 1, 1, 0,
2870 doc
: /* Returns non-nil if a buffer named BUFFER-NAME would be created specially.
2871 The value is actually t if the frame should be called with default frame
2872 parameters, and a list of frame parameters if they were specified.
2873 See `special-display-buffer-names', and `special-display-regexps'. */)
2875 Lisp_Object buffer_name
;
2879 CHECK_STRING (buffer_name
);
2881 tem
= Fmember (buffer_name
, Vspecial_display_buffer_names
);
2885 tem
= Fassoc (buffer_name
, Vspecial_display_buffer_names
);
2889 for (tem
= Vspecial_display_regexps
; CONSP (tem
); tem
= XCDR (tem
))
2891 Lisp_Object car
= XCAR (tem
);
2893 && fast_string_match (car
, buffer_name
) >= 0)
2895 else if (CONSP (car
)
2896 && STRINGP (XCAR (car
))
2897 && fast_string_match (XCAR (car
), buffer_name
) >= 0)
2903 DEFUN ("same-window-p", Fsame_window_p
, Ssame_window_p
, 1, 1, 0,
2904 doc
: /* Returns non-nil if a new buffer named BUFFER-NAME would use the same window.
2905 See `same-window-buffer-names' and `same-window-regexps'. */)
2907 Lisp_Object buffer_name
;
2911 CHECK_STRING (buffer_name
);
2913 tem
= Fmember (buffer_name
, Vsame_window_buffer_names
);
2917 tem
= Fassoc (buffer_name
, Vsame_window_buffer_names
);
2921 for (tem
= Vsame_window_regexps
; CONSP (tem
); tem
= XCDR (tem
))
2923 Lisp_Object car
= XCAR (tem
);
2925 && fast_string_match (car
, buffer_name
) >= 0)
2927 else if (CONSP (car
)
2928 && STRINGP (XCAR (car
))
2929 && fast_string_match (XCAR (car
), buffer_name
) >= 0)
2935 /* Use B so the default is (other-buffer). */
2936 DEFUN ("display-buffer", Fdisplay_buffer
, Sdisplay_buffer
, 1, 3,
2937 "BDisplay buffer: \nP",
2938 doc
: /* Make BUFFER appear in some window but don't select it.
2939 BUFFER can be a buffer or a buffer name.
2940 If BUFFER is shown already in some window, just use that one,
2941 unless the window is the selected window and the optional second
2942 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
2943 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
2944 Returns the window displaying BUFFER.
2945 If `display-buffer-reuse-frames' is non-nil, and another frame is currently
2946 displaying BUFFER, then simply raise that frame.
2948 The variables `special-display-buffer-names', `special-display-regexps',
2949 `same-window-buffer-names', and `same-window-regexps' customize how certain
2950 buffer names are handled.
2952 If optional argument FRAME is `visible', search all visible frames.
2953 If FRAME is 0, search all visible and iconified frames.
2954 If FRAME is t, search all frames.
2955 If FRAME is a frame, search only that frame.
2956 If FRAME is nil, search only the selected frame
2957 (actually the last nonminibuffer frame),
2958 unless `pop-up-frames' or `display-buffer-reuse-frames' is non-nil,
2959 which means search visible and iconified frames.
2961 If `even-window-heights' is non-nil, window heights will be evened out
2962 if displaying the buffer causes two vertically adjacent windows to be
2964 (buffer
, not_this_window
, frame
)
2965 register Lisp_Object buffer
, not_this_window
, frame
;
2967 register Lisp_Object window
, tem
, swp
;
2971 buffer
= Fget_buffer (buffer
);
2972 CHECK_BUFFER (buffer
);
2974 if (!NILP (Vdisplay_buffer_function
))
2975 return call2 (Vdisplay_buffer_function
, buffer
, not_this_window
);
2977 if (NILP (not_this_window
)
2978 && XBUFFER (XWINDOW (selected_window
)->buffer
) == XBUFFER (buffer
))
2979 return display_buffer_1 (selected_window
);
2981 /* See if the user has specified this buffer should appear
2982 in the selected window. */
2983 if (NILP (not_this_window
))
2985 swp
= Fsame_window_p (XBUFFER (buffer
)->name
);
2986 if (!NILP (swp
) && !no_switch_window (selected_window
))
2988 Fswitch_to_buffer (buffer
, Qnil
);
2989 return display_buffer_1 (selected_window
);
2993 /* If the user wants pop-up-frames or display-buffer-reuse-frames,
2994 look for a window showing BUFFER on any visible or iconified frame.
2995 Otherwise search only the current frame. */
2998 else if (pop_up_frames
2999 || display_buffer_reuse_frames
3000 || last_nonminibuf_frame
== 0)
3001 XSETFASTINT (tem
, 0);
3003 XSETFRAME (tem
, last_nonminibuf_frame
);
3005 window
= Fget_buffer_window (buffer
, tem
);
3007 && (NILP (not_this_window
) || !EQ (window
, selected_window
)))
3008 return display_buffer_1 (window
);
3010 /* Certain buffer names get special handling. */
3011 if (!NILP (Vspecial_display_function
) && NILP (swp
))
3013 tem
= Fspecial_display_p (XBUFFER (buffer
)->name
);
3015 return call1 (Vspecial_display_function
, buffer
);
3017 return call2 (Vspecial_display_function
, buffer
, tem
);
3020 /* If there are no frames open that have more than a minibuffer,
3021 we need to create a new frame. */
3022 if (pop_up_frames
|| last_nonminibuf_frame
== 0)
3024 window
= Fframe_selected_window (call0 (Vpop_up_frame_function
));
3025 Fset_window_buffer (window
, buffer
);
3026 return display_buffer_1 (window
);
3029 f
= SELECTED_FRAME ();
3031 || FRAME_MINIBUF_ONLY_P (f
)
3032 /* If the current frame is a special display frame,
3033 don't try to reuse its windows. */
3034 || !NILP (XWINDOW (FRAME_ROOT_WINDOW (f
))->dedicated
))
3039 if (FRAME_MINIBUF_ONLY_P (f
))
3040 XSETFRAME (frames
, last_nonminibuf_frame
);
3041 /* Don't try to create a window if would get an error */
3042 if (split_height_threshold
< window_min_height
<< 1)
3043 split_height_threshold
= window_min_height
<< 1;
3045 /* Note that both Fget_largest_window and Fget_lru_window
3046 ignore minibuffers and dedicated windows.
3047 This means they can return nil. */
3049 /* If the frame we would try to split cannot be split,
3050 try other frames. */
3051 if (FRAME_NO_SPLIT_P (NILP (frames
) ? f
: last_nonminibuf_frame
))
3053 /* Try visible frames first. */
3054 window
= Fget_largest_window (Qvisible
);
3055 /* If that didn't work, try iconified frames. */
3057 window
= Fget_largest_window (make_number (0));
3059 window
= Fget_largest_window (Qt
);
3062 window
= Fget_largest_window (frames
);
3064 /* If we got a tall enough full-width window that can be split,
3067 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window
)->frame
))
3068 && window_height (window
) >= split_height_threshold
3069 && WINDOW_FULL_WIDTH_P (XWINDOW (window
)))
3070 window
= Fsplit_window (window
, Qnil
, Qnil
);
3073 Lisp_Object upper
, lower
, other
;
3075 window
= Fget_lru_window (frames
);
3076 /* If the LRU window is selected, and big enough,
3077 and can be split, split it. */
3079 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window
)->frame
))
3080 && (EQ (window
, selected_window
)
3081 || EQ (XWINDOW (window
)->parent
, Qnil
))
3082 && window_height (window
) >= window_min_height
<< 1)
3083 window
= Fsplit_window (window
, Qnil
, Qnil
);
3084 /* If Fget_lru_window returned nil, try other approaches. */
3086 /* Try visible frames first. */
3088 window
= Fget_buffer_window (buffer
, Qvisible
);
3090 window
= Fget_largest_window (Qvisible
);
3091 /* If that didn't work, try iconified frames. */
3093 window
= Fget_buffer_window (buffer
, make_number (0));
3095 window
= Fget_largest_window (make_number (0));
3096 /* Try invisible frames. */
3098 window
= Fget_buffer_window (buffer
, Qt
);
3100 window
= Fget_largest_window (Qt
);
3101 /* As a last resort, make a new frame. */
3103 window
= Fframe_selected_window (call0 (Vpop_up_frame_function
));
3104 /* If window appears above or below another,
3105 even out their heights. */
3106 other
= upper
= lower
= Qnil
;
3107 if (!NILP (XWINDOW (window
)->prev
))
3108 other
= upper
= XWINDOW (window
)->prev
, lower
= window
;
3109 if (!NILP (XWINDOW (window
)->next
))
3110 other
= lower
= XWINDOW (window
)->next
, upper
= window
;
3112 && !NILP (Veven_window_heights
)
3113 /* Check that OTHER and WINDOW are vertically arrayed. */
3114 && !EQ (XWINDOW (other
)->top
, XWINDOW (window
)->top
)
3115 && (XFASTINT (XWINDOW (other
)->height
)
3116 > XFASTINT (XWINDOW (window
)->height
)))
3118 int total
= (XFASTINT (XWINDOW (other
)->height
)
3119 + XFASTINT (XWINDOW (window
)->height
));
3120 enlarge_window (upper
,
3121 total
/ 2 - XFASTINT (XWINDOW (upper
)->height
),
3127 window
= Fget_lru_window (Qnil
);
3129 Fset_window_buffer (window
, buffer
);
3130 return display_buffer_1 (window
);
3134 temp_output_buffer_show (buf
)
3135 register Lisp_Object buf
;
3137 register struct buffer
*old
= current_buffer
;
3138 register Lisp_Object window
;
3139 register struct window
*w
;
3141 XBUFFER (buf
)->directory
= current_buffer
->directory
;
3144 BUF_SAVE_MODIFF (XBUFFER (buf
)) = MODIFF
;
3148 XBUFFER (buf
)->prevent_redisplay_optimizations_p
= 1;
3149 set_buffer_internal (old
);
3151 if (!EQ (Vtemp_buffer_show_function
, Qnil
))
3152 call1 (Vtemp_buffer_show_function
, buf
);
3155 window
= Fdisplay_buffer (buf
, Qnil
, Qnil
);
3157 if (!EQ (XWINDOW (window
)->frame
, selected_frame
))
3158 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window
)));
3159 Vminibuf_scroll_window
= window
;
3160 w
= XWINDOW (window
);
3161 XSETFASTINT (w
->hscroll
, 0);
3162 XSETFASTINT (w
->min_hscroll
, 0);
3163 set_marker_restricted_both (w
->start
, buf
, 1, 1);
3164 set_marker_restricted_both (w
->pointm
, buf
, 1, 1);
3166 /* Run temp-buffer-show-hook, with the chosen window selected
3167 and it sbuffer current. */
3168 if (!NILP (Vrun_hooks
))
3171 tem
= Fboundp (Qtemp_buffer_show_hook
);
3174 tem
= Fsymbol_value (Qtemp_buffer_show_hook
);
3177 int count
= specpdl_ptr
- specpdl
;
3178 Lisp_Object prev_window
;
3179 prev_window
= selected_window
;
3181 /* Select the window that was chosen, for running the hook. */
3182 record_unwind_protect (Fselect_window
, prev_window
);
3183 select_window_1 (window
, 0);
3184 Fset_buffer (w
->buffer
);
3185 call1 (Vrun_hooks
, Qtemp_buffer_show_hook
);
3186 select_window_1 (prev_window
, 0);
3187 unbind_to (count
, Qnil
);
3195 make_dummy_parent (window
)
3199 register struct window
*o
, *p
;
3202 o
= XWINDOW (window
);
3203 p
= allocate_window ();
3204 for (i
= 0; i
< VECSIZE (struct window
); ++i
)
3205 ((struct Lisp_Vector
*) p
)->contents
[i
]
3206 = ((struct Lisp_Vector
*)o
)->contents
[i
];
3207 XSETWINDOW (new, p
);
3209 XSETFASTINT (p
->sequence_number
, ++sequence_number
);
3211 /* Put new into window structure in place of window */
3212 replace_window (window
, new);
3225 DEFUN ("split-window", Fsplit_window
, Ssplit_window
, 0, 3, "",
3226 doc
: /* Split WINDOW, putting SIZE lines in the first of the pair.
3227 WINDOW defaults to selected one and SIZE to half its size.
3228 If optional third arg HORFLAG is non-nil, split side by side
3229 and put SIZE columns in the first of the pair. In that case,
3230 SIZE includes that window's scroll bar, or the divider column to its right. */)
3231 (window
, size
, horflag
)
3232 Lisp_Object window
, size
, horflag
;
3234 register Lisp_Object
new;
3235 register struct window
*o
, *p
;
3237 register int size_int
;
3240 window
= selected_window
;
3242 CHECK_LIVE_WINDOW (window
);
3244 o
= XWINDOW (window
);
3245 fo
= XFRAME (WINDOW_FRAME (o
));
3249 if (!NILP (horflag
))
3250 /* Calculate the size of the left-hand window, by dividing
3251 the usable space in columns by two.
3252 We round up, since the left-hand window may include
3253 a dividing line, while the right-hand may not. */
3254 size_int
= (XFASTINT (o
->width
) + 1) >> 1;
3256 size_int
= XFASTINT (o
->height
) >> 1;
3260 CHECK_NUMBER (size
);
3261 size_int
= XINT (size
);
3264 if (MINI_WINDOW_P (o
))
3265 error ("Attempt to split minibuffer window");
3266 else if (window_fixed_size_p (o
, !NILP (horflag
), 0))
3267 error ("Attempt to split fixed-size window");
3269 check_min_window_sizes ();
3273 if (size_int
< window_min_height
)
3274 error ("Window height %d too small (after splitting)", size_int
);
3275 if (size_int
+ window_min_height
> XFASTINT (o
->height
))
3276 error ("Window height %d too small (after splitting)",
3277 XFASTINT (o
->height
) - size_int
);
3278 if (NILP (o
->parent
)
3279 || NILP (XWINDOW (o
->parent
)->vchild
))
3281 make_dummy_parent (window
);
3283 XWINDOW (new)->vchild
= window
;
3288 if (size_int
< window_min_width
)
3289 error ("Window width %d too small (after splitting)", size_int
);
3291 if (size_int
+ window_min_width
> XFASTINT (o
->width
))
3292 error ("Window width %d too small (after splitting)",
3293 XFASTINT (o
->width
) - size_int
);
3294 if (NILP (o
->parent
)
3295 || NILP (XWINDOW (o
->parent
)->hchild
))
3297 make_dummy_parent (window
);
3299 XWINDOW (new)->hchild
= window
;
3303 /* Now we know that window's parent is a vertical combination
3304 if we are dividing vertically, or a horizontal combination
3305 if we are making side-by-side windows */
3307 windows_or_buffers_changed
++;
3308 FRAME_WINDOW_SIZES_CHANGED (fo
) = 1;
3309 new = make_window ();
3312 p
->frame
= o
->frame
;
3314 if (!NILP (p
->next
))
3315 XWINDOW (p
->next
)->prev
= new;
3318 p
->parent
= o
->parent
;
3320 p
->window_end_valid
= Qnil
;
3321 bzero (&p
->last_cursor
, sizeof p
->last_cursor
);
3323 /* Apportion the available frame space among the two new windows */
3325 if (!NILP (horflag
))
3327 p
->height
= o
->height
;
3329 XSETFASTINT (p
->width
, XFASTINT (o
->width
) - size_int
);
3330 XSETFASTINT (o
->width
, size_int
);
3331 XSETFASTINT (p
->left
, XFASTINT (o
->left
) + size_int
);
3336 p
->width
= o
->width
;
3337 XSETFASTINT (p
->height
, XFASTINT (o
->height
) - size_int
);
3338 XSETFASTINT (o
->height
, size_int
);
3339 XSETFASTINT (p
->top
, XFASTINT (o
->top
) + size_int
);
3342 /* Adjust glyph matrices. */
3344 Fset_window_buffer (new, o
->buffer
);
3348 DEFUN ("enlarge-window", Fenlarge_window
, Senlarge_window
, 1, 3, "p",
3349 doc
: /* Make current window ARG lines bigger.
3350 From program, optional second arg non-nil means grow sideways ARG columns.
3351 Interactively, if an argument is not given, make the window one line bigger.
3353 Optional third arg PRESERVE-BEFORE, if non-nil, means do not change the size
3354 of the siblings above or to the left of the selected window. Only
3355 siblings to the right or below are changed. */)
3356 (arg
, side
, preserve_before
)
3357 register Lisp_Object arg
, side
, preserve_before
;
3360 enlarge_window (selected_window
, XINT (arg
), !NILP (side
),
3361 !NILP (preserve_before
));
3363 if (! NILP (Vwindow_configuration_change_hook
))
3364 call1 (Vrun_hooks
, Qwindow_configuration_change_hook
);
3369 DEFUN ("shrink-window", Fshrink_window
, Sshrink_window
, 1, 2, "p",
3370 doc
: /* Make current window ARG lines smaller.
3371 From program, optional second arg non-nil means shrink sideways arg columns.
3372 Interactively, if an argument is not given, make the window one line smaller. */)
3374 register Lisp_Object arg
, side
;
3377 enlarge_window (selected_window
, -XINT (arg
), !NILP (side
), 0);
3379 if (! NILP (Vwindow_configuration_change_hook
))
3380 call1 (Vrun_hooks
, Qwindow_configuration_change_hook
);
3386 window_height (window
)
3389 register struct window
*p
= XWINDOW (window
);
3390 return XFASTINT (p
->height
);
3394 window_width (window
)
3397 register struct window
*p
= XWINDOW (window
);
3398 return XFASTINT (p
->width
);
3403 *(widthflag ? &(XWINDOW (w)->left) : &(XWINDOW (w)->top))
3405 #define CURSIZE(w) \
3406 *(widthflag ? &(XWINDOW (w)->width) : &(XWINDOW (w)->height))
3409 /* Enlarge WINDOW by DELTA. WIDTHFLAG non-zero means
3410 increase its width. Siblings of the selected window are resized to
3411 fulfill the size request. If they become too small in the process,
3412 they will be deleted.
3414 If PRESERVE_BEFORE is nonzero, that means don't alter
3415 the siblings to the left or above WINDOW. */
3418 enlarge_window (window
, delta
, widthflag
, preserve_before
)
3420 int delta
, widthflag
, preserve_before
;
3422 Lisp_Object parent
, next
, prev
;
3426 int (*sizefun
) P_ ((Lisp_Object
))
3427 = widthflag
? window_width
: window_height
;
3428 void (*setsizefun
) P_ ((Lisp_Object
, int, int))
3429 = (widthflag
? set_window_width
: set_window_height
);
3431 /* Check values of window_min_width and window_min_height for
3433 check_min_window_sizes ();
3435 /* Give up if this window cannot be resized. */
3436 if (window_fixed_size_p (XWINDOW (window
), widthflag
, 1))
3437 error ("Window is not resizable");
3439 /* Find the parent of the selected window. */
3442 p
= XWINDOW (window
);
3448 error ("No other window to side of this one");
3453 ? !NILP (XWINDOW (parent
)->hchild
)
3454 : !NILP (XWINDOW (parent
)->vchild
))
3460 sizep
= &CURSIZE (window
);
3463 register int maxdelta
;
3465 /* Compute the maximum size increment this window can have. */
3467 if (preserve_before
)
3471 maxdelta
= (*sizefun
) (parent
) - XINT (*sizep
);
3472 /* Subtract size of siblings before, since we can't take that. */
3473 maxdelta
-= XINT (CURBEG (window
)) - XINT (CURBEG (parent
));
3476 maxdelta
= (!NILP (p
->next
) ? ((*sizefun
) (p
->next
)
3477 - window_min_size (XWINDOW (p
->next
),
3482 maxdelta
= (!NILP (parent
) ? (*sizefun
) (parent
) - XINT (*sizep
)
3483 /* This is a main window followed by a minibuffer. */
3484 : !NILP (p
->next
) ? ((*sizefun
) (p
->next
)
3485 - window_min_size (XWINDOW (p
->next
),
3487 /* This is a minibuffer following a main window. */
3488 : !NILP (p
->prev
) ? ((*sizefun
) (p
->prev
)
3489 - window_min_size (XWINDOW (p
->prev
),
3491 /* This is a frame with only one window, a minibuffer-only
3492 or a minibufferless frame. */
3495 if (delta
> maxdelta
)
3496 /* This case traps trying to make the minibuffer
3497 the full frame, or make the only window aside from the
3498 minibuffer the full frame. */
3502 if (XINT (*sizep
) + delta
< window_min_size (XWINDOW (window
), widthflag
, 0, 0))
3504 delete_window (window
);
3511 /* Find the total we can get from other siblings without deleting them. */
3513 for (next
= p
->next
; ! NILP (next
); next
= XWINDOW (next
)->next
)
3514 maximum
+= (*sizefun
) (next
) - window_min_size (XWINDOW (next
),
3516 if (! preserve_before
)
3517 for (prev
= p
->prev
; ! NILP (prev
); prev
= XWINDOW (prev
)->prev
)
3518 maximum
+= (*sizefun
) (prev
) - window_min_size (XWINDOW (prev
),
3521 /* If we can get it all from them without deleting them, do so. */
3522 if (delta
<= maximum
)
3524 Lisp_Object first_unaffected
;
3525 Lisp_Object first_affected
;
3530 first_affected
= window
;
3531 /* Look at one sibling at a time,
3532 moving away from this window in both directions alternately,
3533 and take as much as we can get without deleting that sibling. */
3535 && (!NILP (next
) || (!preserve_before
&& !NILP (prev
))))
3539 int this_one
= ((*sizefun
) (next
)
3540 - window_min_size (XWINDOW (next
),
3541 widthflag
, 0, &fixed_p
));
3544 if (this_one
> delta
)
3547 (*setsizefun
) (next
, (*sizefun
) (next
) - this_one
, 0);
3548 (*setsizefun
) (window
, XINT (*sizep
) + this_one
, 0);
3553 next
= XWINDOW (next
)->next
;
3559 if (!preserve_before
&& ! NILP (prev
))
3561 int this_one
= ((*sizefun
) (prev
)
3562 - window_min_size (XWINDOW (prev
),
3563 widthflag
, 0, &fixed_p
));
3566 if (this_one
> delta
)
3569 first_affected
= prev
;
3571 (*setsizefun
) (prev
, (*sizefun
) (prev
) - this_one
, 0);
3572 (*setsizefun
) (window
, XINT (*sizep
) + this_one
, 0);
3577 prev
= XWINDOW (prev
)->prev
;
3581 xassert (delta
== 0);
3583 /* Now recalculate the edge positions of all the windows affected,
3584 based on the new sizes. */
3585 first_unaffected
= next
;
3586 prev
= first_affected
;
3587 for (next
= XWINDOW (prev
)->next
; ! EQ (next
, first_unaffected
);
3588 prev
= next
, next
= XWINDOW (next
)->next
)
3590 XSETINT (CURBEG (next
), XINT (CURBEG (prev
)) + (*sizefun
) (prev
));
3591 /* This does not change size of NEXT,
3592 but it propagates the new top edge to its children */
3593 (*setsizefun
) (next
, (*sizefun
) (next
), 0);
3598 register int delta1
;
3599 register int opht
= (*sizefun
) (parent
);
3601 if (opht
<= XINT (*sizep
) + delta
)
3603 /* If trying to grow this window to or beyond size of the parent,
3604 just delete all the sibling windows. */
3605 Lisp_Object start
, tem
, next
;
3607 start
= XWINDOW (parent
)->vchild
;
3609 start
= XWINDOW (parent
)->hchild
;
3611 /* Delete any siblings that come after WINDOW. */
3612 tem
= XWINDOW (window
)->next
;
3613 while (! NILP (tem
))
3615 next
= XWINDOW (tem
)->next
;
3616 delete_window (tem
);
3620 /* Delete any siblings that come after WINDOW.
3621 Note that if START is not WINDOW, then WINDOW still
3622 Fhas siblings, so WINDOW has not yet replaced its parent. */
3624 while (! EQ (tem
, window
))
3626 next
= XWINDOW (tem
)->next
;
3627 delete_window (tem
);
3633 /* Otherwise, make delta1 just right so that if we add
3634 delta1 lines to this window and to the parent, and then
3635 shrink the parent back to its original size, the new
3636 proportional size of this window will increase by delta.
3638 The function size_window will compute the new height h'
3639 of the window from delta1 as:
3642 x = delta1 - delta1/n * n for the 1st resizable child
3645 where n is the number of children that can be resized.
3646 We can ignore x by choosing a delta1 that is a multiple of
3647 n. We want the height of this window to come out as
3657 The number of children n rquals the number of resizable
3658 children of this window + 1 because we know window itself
3659 is resizable (otherwise we would have signalled an error. */
3661 struct window
*w
= XWINDOW (window
);
3665 for (s
= w
->next
; !NILP (s
); s
= XWINDOW (s
)->next
)
3666 if (!window_fixed_size_p (XWINDOW (s
), widthflag
, 0))
3668 for (s
= w
->prev
; !NILP (s
); s
= XWINDOW (s
)->prev
)
3669 if (!window_fixed_size_p (XWINDOW (s
), widthflag
, 0))
3674 /* Add delta1 lines or columns to this window, and to the parent,
3675 keeping things consistent while not affecting siblings. */
3676 XSETINT (CURSIZE (parent
), opht
+ delta1
);
3677 (*setsizefun
) (window
, XINT (*sizep
) + delta1
, 0);
3679 /* Squeeze out delta1 lines or columns from our parent,
3680 shriking this window and siblings proportionately.
3681 This brings parent back to correct size.
3682 Delta1 was calculated so this makes this window the desired size,
3683 taking it all out of the siblings. */
3684 (*setsizefun
) (parent
, opht
, 0);
3689 XSETFASTINT (p
->last_modified
, 0);
3690 XSETFASTINT (p
->last_overlay_modified
, 0);
3692 /* Adjust glyph matrices. */
3693 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window
))));
3701 /***********************************************************************
3702 Resizing Mini-Windows
3703 ***********************************************************************/
3705 static void shrink_window_lowest_first
P_ ((struct window
*, int));
3707 enum save_restore_action
3714 static int save_restore_orig_size
P_ ((struct window
*,
3715 enum save_restore_action
));
3717 /* Shrink windows rooted in window W to HEIGHT. Take the space needed
3718 from lowest windows first. */
3721 shrink_window_lowest_first (w
, height
)
3729 xassert (!MINI_WINDOW_P (w
));
3731 /* Set redisplay hints. */
3732 XSETFASTINT (w
->last_modified
, 0);
3733 XSETFASTINT (w
->last_overlay_modified
, 0);
3734 windows_or_buffers_changed
++;
3735 FRAME_WINDOW_SIZES_CHANGED (XFRAME (WINDOW_FRAME (w
))) = 1;
3737 old_height
= XFASTINT (w
->height
);
3738 XSETFASTINT (w
->height
, height
);
3740 if (!NILP (w
->hchild
))
3742 for (child
= w
->hchild
; !NILP (child
); child
= c
->next
)
3744 c
= XWINDOW (child
);
3746 shrink_window_lowest_first (c
, height
);
3749 else if (!NILP (w
->vchild
))
3751 Lisp_Object last_child
;
3752 int delta
= old_height
- height
;
3757 /* Find the last child. We are taking space from lowest windows
3758 first, so we iterate over children from the last child
3760 for (child
= w
->vchild
; !NILP (child
); child
= XWINDOW (child
)->next
)
3763 /* Assign new heights. We leave only MIN_SAFE_WINDOW_HEIGHT. */
3764 for (child
= last_child
; delta
&& !NILP (child
); child
= c
->prev
)
3768 c
= XWINDOW (child
);
3769 this_one
= XFASTINT (c
->height
) - MIN_SAFE_WINDOW_HEIGHT
;
3771 if (this_one
> delta
)
3774 shrink_window_lowest_first (c
, XFASTINT (c
->height
) - this_one
);
3778 /* Compute new positions. */
3779 last_top
= XINT (w
->top
);
3780 for (child
= w
->vchild
; !NILP (child
); child
= c
->next
)
3782 c
= XWINDOW (child
);
3783 c
->top
= make_number (last_top
);
3784 shrink_window_lowest_first (c
, XFASTINT (c
->height
));
3785 last_top
+= XFASTINT (c
->height
);
3791 /* Save, restore, or check positions and sizes in the window tree
3792 rooted at W. ACTION says what to do.
3794 If ACTION is CHECK_ORIG_SIZES, check if orig_top and orig_height
3795 members are valid for all windows in the window tree. Value is
3796 non-zero if they are valid.
3798 If ACTION is SAVE_ORIG_SIZES, save members top and height in
3799 orig_top and orig_height for all windows in the tree.
3801 If ACTION is RESTORE_ORIG_SIZES, restore top and height from
3802 values stored in orig_top and orig_height for all windows. */
3805 save_restore_orig_size (w
, action
)
3807 enum save_restore_action action
;
3813 if (!NILP (w
->hchild
))
3815 if (!save_restore_orig_size (XWINDOW (w
->hchild
), action
))
3818 else if (!NILP (w
->vchild
))
3820 if (!save_restore_orig_size (XWINDOW (w
->vchild
), action
))
3826 case CHECK_ORIG_SIZES
:
3827 if (!INTEGERP (w
->orig_top
) || !INTEGERP (w
->orig_height
))
3831 case SAVE_ORIG_SIZES
:
3832 w
->orig_top
= w
->top
;
3833 w
->orig_height
= w
->height
;
3834 XSETFASTINT (w
->last_modified
, 0);
3835 XSETFASTINT (w
->last_overlay_modified
, 0);
3838 case RESTORE_ORIG_SIZES
:
3839 xassert (INTEGERP (w
->orig_top
) && INTEGERP (w
->orig_height
));
3840 w
->top
= w
->orig_top
;
3841 w
->height
= w
->orig_height
;
3842 w
->orig_height
= w
->orig_top
= Qnil
;
3843 XSETFASTINT (w
->last_modified
, 0);
3844 XSETFASTINT (w
->last_overlay_modified
, 0);
3851 w
= NILP (w
->next
) ? NULL
: XWINDOW (w
->next
);
3858 /* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we can
3859 without deleting other windows. */
3862 grow_mini_window (w
, delta
)
3866 struct frame
*f
= XFRAME (w
->frame
);
3867 struct window
*root
;
3869 xassert (MINI_WINDOW_P (w
));
3870 xassert (delta
>= 0);
3872 /* Check values of window_min_width and window_min_height for
3874 check_min_window_sizes ();
3876 /* Compute how much we can enlarge the mini-window without deleting
3878 root
= XWINDOW (FRAME_ROOT_WINDOW (f
));
3881 int min_height
= window_min_size (root
, 0, 0, 0);
3882 if (XFASTINT (root
->height
) - delta
< min_height
)
3883 /* Note that the root window may already be smaller than
3885 delta
= max (0, XFASTINT (root
->height
) - min_height
);
3890 /* Save original window sizes and positions, if not already done. */
3891 if (!save_restore_orig_size (root
, CHECK_ORIG_SIZES
))
3892 save_restore_orig_size (root
, SAVE_ORIG_SIZES
);
3894 /* Shrink other windows. */
3895 shrink_window_lowest_first (root
, XFASTINT (root
->height
) - delta
);
3897 /* Grow the mini-window. */
3898 w
->top
= make_number (XFASTINT (root
->top
) + XFASTINT (root
->height
));
3899 w
->height
= make_number (XFASTINT (w
->height
) + delta
);
3900 XSETFASTINT (w
->last_modified
, 0);
3901 XSETFASTINT (w
->last_overlay_modified
, 0);
3908 /* Shrink mini-window W. If there is recorded info about window sizes
3909 before a call to grow_mini_window, restore recorded window sizes.
3910 Otherwise, if the mini-window is higher than 1 line, resize it to 1
3914 shrink_mini_window (w
)
3917 struct frame
*f
= XFRAME (w
->frame
);
3918 struct window
*root
= XWINDOW (FRAME_ROOT_WINDOW (f
));
3920 if (save_restore_orig_size (root
, CHECK_ORIG_SIZES
))
3922 save_restore_orig_size (root
, RESTORE_ORIG_SIZES
);
3924 FRAME_WINDOW_SIZES_CHANGED (f
) = 1;
3925 windows_or_buffers_changed
= 1;
3927 else if (XFASTINT (w
->height
) > 1)
3929 /* Distribute the additional lines of the mini-window
3930 among the other windows. */
3932 XSETWINDOW (window
, w
);
3933 enlarge_window (window
, 1 - XFASTINT (w
->height
), 0, 0);
3939 /* Mark window cursors off for all windows in the window tree rooted
3940 at W by setting their phys_cursor_on_p flag to zero. Called from
3941 xterm.c, e.g. when a frame is cleared and thereby all cursors on
3942 the frame are cleared. */
3945 mark_window_cursors_off (w
)
3950 if (!NILP (w
->hchild
))
3951 mark_window_cursors_off (XWINDOW (w
->hchild
));
3952 else if (!NILP (w
->vchild
))
3953 mark_window_cursors_off (XWINDOW (w
->vchild
));
3955 w
->phys_cursor_on_p
= 0;
3957 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
3962 /* Return number of lines of text (not counting mode lines) in W. */
3965 window_internal_height (w
)
3968 int ht
= XFASTINT (w
->height
);
3970 if (!MINI_WINDOW_P (w
))
3972 if (!NILP (w
->parent
)
3973 || !NILP (w
->vchild
)
3974 || !NILP (w
->hchild
)
3977 || WINDOW_WANTS_MODELINE_P (w
))
3980 if (WINDOW_WANTS_HEADER_LINE_P (w
))
3988 /* Return the number of columns in W.
3989 Don't count columns occupied by scroll bars or the vertical bar
3990 separating W from the sibling to its right. */
3993 window_internal_width (w
)
3996 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
3997 int width
= XINT (w
->width
);
3999 if (FRAME_HAS_VERTICAL_SCROLL_BARS (f
))
4000 /* Scroll bars occupy a few columns. */
4001 width
-= FRAME_SCROLL_BAR_COLS (f
);
4002 else if (!WINDOW_RIGHTMOST_P (w
) && !WINDOW_FULL_WIDTH_P (w
))
4003 /* The column of `|' characters separating side-by-side windows
4004 occupies one column only. */
4007 /* On window-systems, areas to the left and right of the window
4008 are used as fringes. */
4009 if (FRAME_WINDOW_P (f
))
4010 width
-= FRAME_FRINGE_COLS (f
);
4016 /************************************************************************
4018 ***********************************************************************/
4020 /* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
4021 N screen-fulls, which is defined as the height of the window minus
4022 next_screen_context_lines. If WHOLE is zero, scroll up N lines
4023 instead. Negative values of N mean scroll down. NOERROR non-zero
4024 means don't signal an error if we try to move over BEGV or ZV,
4028 window_scroll (window
, n
, whole
, noerror
)
4034 /* If we must, use the pixel-based version which is much slower than
4035 the line-based one but can handle varying line heights. */
4036 if (FRAME_WINDOW_P (XFRAME (XWINDOW (window
)->frame
)))
4037 window_scroll_pixel_based (window
, n
, whole
, noerror
);
4039 window_scroll_line_based (window
, n
, whole
, noerror
);
4043 /* Implementation of window_scroll that works based on pixel line
4044 heights. See the comment of window_scroll for parameter
4048 window_scroll_pixel_based (window
, n
, whole
, noerror
)
4055 struct window
*w
= XWINDOW (window
);
4056 struct text_pos start
;
4058 int this_scroll_margin
;
4060 /* True if we fiddled the window vscroll field without really scrolling. */
4063 SET_TEXT_POS_FROM_MARKER (start
, w
->start
);
4065 /* If PT is not visible in WINDOW, move back one half of
4066 the screen. Allow PT to be partially visible, otherwise
4067 something like (scroll-down 1) with PT in the line before
4068 the partially visible one would recenter. */
4069 tem
= Fpos_visible_in_window_p (make_number (PT
), window
, Qt
);
4072 /* Move backward half the height of the window. Performance note:
4073 vmotion used here is about 10% faster, but would give wrong
4074 results for variable height lines. */
4075 init_iterator (&it
, w
, PT
, PT_BYTE
, NULL
, DEFAULT_FACE_ID
);
4076 it
.current_y
= it
.last_visible_y
;
4077 move_it_vertically (&it
, - window_box_height (w
) / 2);
4079 /* The function move_iterator_vertically may move over more than
4080 the specified y-distance. If it->w is small, e.g. a
4081 mini-buffer window, we may end up in front of the window's
4082 display area. This is the case when Start displaying at the
4083 start of the line containing PT in this case. */
4084 if (it
.current_y
<= 0)
4086 init_iterator (&it
, w
, PT
, PT_BYTE
, NULL
, DEFAULT_FACE_ID
);
4087 move_it_vertically (&it
, 0);
4091 start
= it
.current
.pos
;
4094 /* If scroll_preserve_screen_position is non-zero, we try to set
4095 point in the same window line as it is now, so get that line. */
4096 if (!NILP (Vscroll_preserve_screen_position
))
4098 start_display (&it
, w
, start
);
4099 move_it_to (&it
, PT
, -1, -1, -1, MOVE_TO_POS
);
4100 preserve_y
= it
.current_y
;
4105 /* Move iterator it from start the specified distance forward or
4106 backward. The result is the new window start. */
4107 start_display (&it
, w
, start
);
4110 int screen_full
= (window_box_height (w
)
4111 - next_screen_context_lines
* CANON_Y_UNIT (it
.f
));
4112 int dy
= n
* screen_full
;
4114 /* Note that move_it_vertically always moves the iterator to the
4115 start of a line. So, if the last line doesn't have a newline,
4116 we would end up at the start of the line ending at ZV. */
4118 move_it_vertically_backward (&it
, -dy
);
4120 move_it_to (&it
, ZV
, -1, it
.current_y
+ dy
, -1,
4121 MOVE_TO_POS
| MOVE_TO_Y
);
4124 move_it_by_lines (&it
, n
, 1);
4126 /* End if we end up at ZV or BEGV. */
4127 if ((n
> 0 && IT_CHARPOS (it
) == ZV
)
4128 || (n
< 0 && IT_CHARPOS (it
) == CHARPOS (start
)))
4130 if (IT_CHARPOS (it
) == ZV
)
4132 if (it
.current_y
+ it
.max_ascent
+ it
.max_descent
4133 > it
.last_visible_y
)
4135 /* The last line was only partially visible, make it fully
4137 w
->vscroll
= (it
.last_visible_y
4138 - it
.current_y
+ it
.max_ascent
+ it
.max_descent
);
4139 adjust_glyphs (it
.f
);
4144 Fsignal (Qend_of_buffer
, Qnil
);
4148 if (w
->vscroll
!= 0)
4149 /* The first line was only partially visible, make it fully
4155 Fsignal (Qbeginning_of_buffer
, Qnil
);
4158 /* If control gets here, then we vscrolled. */
4160 XBUFFER (w
->buffer
)->prevent_redisplay_optimizations_p
= 1;
4162 /* Don't try to change the window start below. */
4168 int pos
= IT_CHARPOS (it
);
4170 /* Set the window start, and set up the window for redisplay. */
4171 set_marker_restricted (w
->start
, make_number (pos
),
4173 bytepos
= XMARKER (w
->start
)->bytepos
;
4174 w
->start_at_line_beg
= ((pos
== BEGV
|| FETCH_BYTE (bytepos
- 1) == '\n')
4176 w
->update_mode_line
= Qt
;
4177 XSETFASTINT (w
->last_modified
, 0);
4178 XSETFASTINT (w
->last_overlay_modified
, 0);
4179 /* Set force_start so that redisplay_window will run the
4180 window-scroll-functions. */
4181 w
->force_start
= Qt
;
4184 it
.current_y
= it
.vpos
= 0;
4186 /* Preserve the screen position if we must. */
4187 if (preserve_y
>= 0)
4189 move_it_to (&it
, -1, -1, preserve_y
, -1, MOVE_TO_Y
);
4190 SET_PT_BOTH (IT_CHARPOS (it
), IT_BYTEPOS (it
));
4194 /* Move PT out of scroll margins. */
4195 this_scroll_margin
= max (0, scroll_margin
);
4196 this_scroll_margin
= min (this_scroll_margin
, XFASTINT (w
->height
) / 4);
4197 this_scroll_margin
*= CANON_Y_UNIT (it
.f
);
4201 /* We moved the window start towards ZV, so PT may be now
4202 in the scroll margin at the top. */
4203 move_it_to (&it
, PT
, -1, -1, -1, MOVE_TO_POS
);
4204 while (it
.current_y
< this_scroll_margin
)
4206 int prev
= it
.current_y
;
4207 move_it_by_lines (&it
, 1, 1);
4208 if (prev
== it
.current_y
)
4211 SET_PT_BOTH (IT_CHARPOS (it
), IT_BYTEPOS (it
));
4215 int charpos
, bytepos
;
4217 /* We moved the window start towards BEGV, so PT may be now
4218 in the scroll margin at the bottom. */
4219 move_it_to (&it
, PT
, -1,
4220 it
.last_visible_y
- this_scroll_margin
- 1, -1,
4221 MOVE_TO_POS
| MOVE_TO_Y
);
4223 /* Save our position, in case it's correct. */
4224 charpos
= IT_CHARPOS (it
);
4225 bytepos
= IT_BYTEPOS (it
);
4227 /* See if point is on a partially visible line at the end. */
4228 move_it_by_lines (&it
, 1, 1);
4229 if (it
.current_y
> it
.last_visible_y
)
4230 /* The last line was only partially visible, so back up two
4231 lines to make sure we're on a fully visible line. */
4233 move_it_by_lines (&it
, -2, 0);
4234 SET_PT_BOTH (IT_CHARPOS (it
), IT_BYTEPOS (it
));
4237 /* No, the position we saved is OK, so use it. */
4238 SET_PT_BOTH (charpos
, bytepos
);
4244 /* Implementation of window_scroll that works based on screen lines.
4245 See the comment of window_scroll for parameter descriptions. */
4248 window_scroll_line_based (window
, n
, whole
, noerror
)
4254 register struct window
*w
= XWINDOW (window
);
4255 register int opoint
= PT
, opoint_byte
= PT_BYTE
;
4256 register int pos
, pos_byte
;
4257 register int ht
= window_internal_height (w
);
4258 register Lisp_Object tem
;
4262 struct position posit
;
4265 /* If scrolling screen-fulls, compute the number of lines to
4266 scroll from the window's height. */
4268 n
*= max (1, ht
- next_screen_context_lines
);
4270 startpos
= marker_position (w
->start
);
4272 posit
= *compute_motion (startpos
, 0, 0, 0,
4274 window_internal_width (w
), XINT (w
->hscroll
),
4276 original_vpos
= posit
.vpos
;
4278 XSETFASTINT (tem
, PT
);
4279 tem
= Fpos_visible_in_window_p (tem
, window
, Qnil
);
4283 Fvertical_motion (make_number (- (ht
/ 2)), window
);
4288 lose
= n
< 0 && PT
== BEGV
;
4289 Fvertical_motion (make_number (n
), window
);
4293 SET_PT_BOTH (opoint
, opoint_byte
);
4300 Fsignal (Qbeginning_of_buffer
, Qnil
);
4305 int this_scroll_margin
= scroll_margin
;
4307 /* Don't use a scroll margin that is negative or too large. */
4308 if (this_scroll_margin
< 0)
4309 this_scroll_margin
= 0;
4311 if (XINT (w
->height
) < 4 * scroll_margin
)
4312 this_scroll_margin
= XINT (w
->height
) / 4;
4314 set_marker_restricted_both (w
->start
, w
->buffer
, pos
, pos_byte
);
4315 w
->start_at_line_beg
= bolp
;
4316 w
->update_mode_line
= Qt
;
4317 XSETFASTINT (w
->last_modified
, 0);
4318 XSETFASTINT (w
->last_overlay_modified
, 0);
4319 /* Set force_start so that redisplay_window will run
4320 the window-scroll-functions. */
4321 w
->force_start
= Qt
;
4323 if (whole
&& !NILP (Vscroll_preserve_screen_position
))
4325 SET_PT_BOTH (pos
, pos_byte
);
4326 Fvertical_motion (make_number (original_vpos
), window
);
4328 /* If we scrolled forward, put point enough lines down
4329 that it is outside the scroll margin. */
4334 if (this_scroll_margin
> 0)
4336 SET_PT_BOTH (pos
, pos_byte
);
4337 Fvertical_motion (make_number (this_scroll_margin
), window
);
4343 if (top_margin
<= opoint
)
4344 SET_PT_BOTH (opoint
, opoint_byte
);
4345 else if (!NILP (Vscroll_preserve_screen_position
))
4347 SET_PT_BOTH (pos
, pos_byte
);
4348 Fvertical_motion (make_number (original_vpos
), window
);
4351 SET_PT (top_margin
);
4357 /* If we scrolled backward, put point near the end of the window
4358 but not within the scroll margin. */
4359 SET_PT_BOTH (pos
, pos_byte
);
4360 tem
= Fvertical_motion (make_number (ht
- this_scroll_margin
), window
);
4361 if (XFASTINT (tem
) == ht
- this_scroll_margin
)
4364 bottom_margin
= PT
+ 1;
4366 if (bottom_margin
> opoint
)
4367 SET_PT_BOTH (opoint
, opoint_byte
);
4370 if (!NILP (Vscroll_preserve_screen_position
))
4372 SET_PT_BOTH (pos
, pos_byte
);
4373 Fvertical_motion (make_number (original_vpos
), window
);
4376 Fvertical_motion (make_number (-1), window
);
4385 Fsignal (Qend_of_buffer
, Qnil
);
4390 /* Scroll selected_window up or down. If N is nil, scroll a
4391 screen-full which is defined as the height of the window minus
4392 next_screen_context_lines. If N is the symbol `-', scroll.
4393 DIRECTION may be 1 meaning to scroll down, or -1 meaning to scroll
4394 up. This is the guts of Fscroll_up and Fscroll_down. */
4397 scroll_command (n
, direction
)
4401 int count
= BINDING_STACK_SIZE ();
4403 xassert (abs (direction
) == 1);
4405 /* If selected window's buffer isn't current, make it current for
4406 the moment. But don't screw up if window_scroll gets an error. */
4407 if (XBUFFER (XWINDOW (selected_window
)->buffer
) != current_buffer
)
4409 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
4410 Fset_buffer (XWINDOW (selected_window
)->buffer
);
4412 /* Make redisplay consider other windows than just selected_window. */
4413 ++windows_or_buffers_changed
;
4417 window_scroll (selected_window
, direction
, 1, 0);
4418 else if (EQ (n
, Qminus
))
4419 window_scroll (selected_window
, -direction
, 1, 0);
4422 n
= Fprefix_numeric_value (n
);
4423 window_scroll (selected_window
, XINT (n
) * direction
, 0, 0);
4426 unbind_to (count
, Qnil
);
4429 DEFUN ("scroll-up", Fscroll_up
, Sscroll_up
, 0, 1, "P",
4430 doc
: /* Scroll text of current window upward ARG lines; or near full screen if no ARG.
4431 A near full screen is `next-screen-context-lines' less than a full screen.
4432 Negative ARG means scroll downward.
4433 If ARG is the atom `-', scroll downward by nearly full screen.
4434 When calling from a program, supply as argument a number, nil, or `-'. */)
4438 scroll_command (arg
, 1);
4442 DEFUN ("scroll-down", Fscroll_down
, Sscroll_down
, 0, 1, "P",
4443 doc
: /* Scroll text of current window down ARG lines; or near full screen if no ARG.
4444 A near full screen is `next-screen-context-lines' less than a full screen.
4445 Negative ARG means scroll upward.
4446 If ARG is the atom `-', scroll upward by nearly full screen.
4447 When calling from a program, supply as argument a number, nil, or `-'. */)
4451 scroll_command (arg
, -1);
4455 DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling
, Sother_window_for_scrolling
, 0, 0, 0,
4456 doc
: /* Return the other window for \"other window scroll\" commands.
4457 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4458 specifies the window.
4459 If `other-window-scroll-buffer' is non-nil, a window
4460 showing that buffer is used. */)
4465 if (MINI_WINDOW_P (XWINDOW (selected_window
))
4466 && !NILP (Vminibuf_scroll_window
))
4467 window
= Vminibuf_scroll_window
;
4468 /* If buffer is specified, scroll that buffer. */
4469 else if (!NILP (Vother_window_scroll_buffer
))
4471 window
= Fget_buffer_window (Vother_window_scroll_buffer
, Qnil
);
4473 window
= Fdisplay_buffer (Vother_window_scroll_buffer
, Qt
, Qnil
);
4477 /* Nothing specified; look for a neighboring window on the same
4479 window
= Fnext_window (selected_window
, Qnil
, Qnil
);
4481 if (EQ (window
, selected_window
))
4482 /* That didn't get us anywhere; look for a window on another
4485 window
= Fnext_window (window
, Qnil
, Qt
);
4486 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window
))))
4487 && ! EQ (window
, selected_window
));
4490 CHECK_LIVE_WINDOW (window
);
4492 if (EQ (window
, selected_window
))
4493 error ("There is no other window");
4498 DEFUN ("scroll-other-window", Fscroll_other_window
, Sscroll_other_window
, 0, 1, "P",
4499 doc
: /* Scroll next window upward ARG lines; or near full screen if no ARG.
4500 A near full screen is `next-screen-context-lines' less than a full screen.
4501 The next window is the one below the current one; or the one at the top
4502 if the current one is at the bottom. Negative ARG means scroll downward.
4503 If ARG is the atom `-', scroll downward by nearly full screen.
4504 When calling from a program, supply as argument a number, nil, or `-'.
4506 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4507 specifies the window to scroll.
4508 If `other-window-scroll-buffer' is non-nil, scroll the window
4509 showing that buffer, popping the buffer up if necessary. */)
4515 int count
= BINDING_STACK_SIZE ();
4517 window
= Fother_window_for_scrolling ();
4518 w
= XWINDOW (window
);
4520 /* Don't screw up if window_scroll gets an error. */
4521 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
4522 ++windows_or_buffers_changed
;
4524 Fset_buffer (w
->buffer
);
4525 SET_PT (marker_position (w
->pointm
));
4528 window_scroll (window
, 1, 1, 1);
4529 else if (EQ (arg
, Qminus
))
4530 window_scroll (window
, -1, 1, 1);
4536 window_scroll (window
, XINT (arg
), 0, 1);
4539 set_marker_both (w
->pointm
, Qnil
, PT
, PT_BYTE
);
4540 unbind_to (count
, Qnil
);
4545 DEFUN ("scroll-left", Fscroll_left
, Sscroll_left
, 0, 1, "P",
4546 doc
: /* Scroll selected window display ARG columns left.
4547 Default for ARG is window width minus 2.
4548 Value is the total amount of leftward horizontal scrolling in
4549 effect after the change.
4550 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4551 a lower bound for automatic scrolling, i.e. automatic scrolling
4552 will not scroll a window to a column less than the value returned
4553 by this function. */)
4555 register Lisp_Object arg
;
4559 struct window
*w
= XWINDOW (selected_window
);
4562 XSETFASTINT (arg
, window_internal_width (w
) - 2);
4564 arg
= Fprefix_numeric_value (arg
);
4566 hscroll
= XINT (w
->hscroll
) + XINT (arg
);
4567 result
= Fset_window_hscroll (selected_window
, make_number (hscroll
));
4569 if (interactive_p (0))
4570 w
->min_hscroll
= w
->hscroll
;
4575 DEFUN ("scroll-right", Fscroll_right
, Sscroll_right
, 0, 1, "P",
4576 doc
: /* Scroll selected window display ARG columns right.
4577 Default for ARG is window width minus 2.
4578 Value is the total amount of leftward horizontal scrolling in
4579 effect after the change.
4580 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4581 a lower bound for automatic scrolling, i.e. automatic scrolling
4582 will not scroll a window to a column less than the value returned
4583 by this function. */)
4585 register Lisp_Object arg
;
4589 struct window
*w
= XWINDOW (selected_window
);
4592 XSETFASTINT (arg
, window_internal_width (w
) - 2);
4594 arg
= Fprefix_numeric_value (arg
);
4596 hscroll
= XINT (w
->hscroll
) - XINT (arg
);
4597 result
= Fset_window_hscroll (selected_window
, make_number (hscroll
));
4599 if (interactive_p (0))
4600 w
->min_hscroll
= w
->hscroll
;
4605 DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window
, Sminibuffer_selected_window
, 0, 0, 0,
4606 doc
: /* Return the window which was selected when entering the minibuffer.
4607 Returns nil, if current window is not a minibuffer window. */)
4610 if (minibuf_level
> 0
4611 && MINI_WINDOW_P (XWINDOW (selected_window
))
4612 && !NILP (minibuf_selected_window
)
4613 && WINDOW_LIVE_P (minibuf_selected_window
))
4614 return minibuf_selected_window
;
4619 /* Value is the number of lines actually displayed in window W,
4620 as opposed to its height. */
4623 displayed_window_lines (w
)
4627 struct text_pos start
;
4628 int height
= window_box_height (w
);
4629 struct buffer
*old_buffer
;
4632 if (XBUFFER (w
->buffer
) != current_buffer
)
4634 old_buffer
= current_buffer
;
4635 set_buffer_internal (XBUFFER (w
->buffer
));
4640 /* In case W->start is out of the accessible range, do something
4641 reasonable. This happens in Info mode when Info-scroll-down
4642 calls (recenter -1) while W->start is 1. */
4643 if (XMARKER (w
->start
)->charpos
< BEGV
)
4644 SET_TEXT_POS (start
, BEGV
, BEGV_BYTE
);
4645 else if (XMARKER (w
->start
)->charpos
> ZV
)
4646 SET_TEXT_POS (start
, ZV
, ZV_BYTE
);
4648 SET_TEXT_POS_FROM_MARKER (start
, w
->start
);
4650 start_display (&it
, w
, start
);
4651 move_it_vertically (&it
, height
);
4652 bottom_y
= line_bottom_y (&it
);
4654 /* Add in empty lines at the bottom of the window. */
4655 if (bottom_y
< height
)
4657 int uy
= CANON_Y_UNIT (it
.f
);
4658 it
.vpos
+= (height
- bottom_y
+ uy
- 1) / uy
;
4662 set_buffer_internal (old_buffer
);
4668 DEFUN ("recenter", Frecenter
, Srecenter
, 0, 1, "P",
4669 doc
: /* Center point in window and redisplay frame.
4670 With prefix argument ARG, recenter putting point on screen line ARG
4671 relative to the current window. If ARG is negative, it counts up from the
4672 bottom of the window. (ARG should be less than the height of the window.)
4674 If ARG is omitted or nil, erase the entire frame and then
4675 redraw with point in the center of the current window.
4676 Just C-u as prefix means put point in the center of the window
4677 and redisplay normally--don't erase and redraw the frame. */)
4679 register Lisp_Object arg
;
4681 struct window
*w
= XWINDOW (selected_window
);
4682 struct buffer
*buf
= XBUFFER (w
->buffer
);
4683 struct buffer
*obuf
= current_buffer
;
4685 int charpos
, bytepos
;
4687 /* If redisplay is suppressed due to an error, try again. */
4688 obuf
->display_error_modiff
= 0;
4694 /* Invalidate pixel data calculated for all compositions. */
4695 for (i
= 0; i
< n_compositions
; i
++)
4696 composition_table
[i
]->font
= NULL
;
4698 Fredraw_frame (w
->frame
);
4699 SET_FRAME_GARBAGED (XFRAME (WINDOW_FRAME (w
)));
4702 else if (CONSP (arg
)) /* Just C-u. */
4706 arg
= Fprefix_numeric_value (arg
);
4710 set_buffer_internal (buf
);
4712 /* Handle centering on a graphical frame specially. Such frames can
4713 have variable-height lines and centering point on the basis of
4714 line counts would lead to strange effects. */
4715 if (FRAME_WINDOW_P (XFRAME (w
->frame
)))
4722 SET_TEXT_POS (pt
, PT
, PT_BYTE
);
4723 start_display (&it
, w
, pt
);
4724 move_it_vertically (&it
, - window_box_height (w
) / 2);
4725 charpos
= IT_CHARPOS (it
);
4726 bytepos
= IT_BYTEPOS (it
);
4728 else if (XINT (arg
) < 0)
4732 int y0
, y1
, h
, nlines
;
4734 SET_TEXT_POS (pt
, PT
, PT_BYTE
);
4735 start_display (&it
, w
, pt
);
4738 /* The amount of pixels we have to move back is the window
4739 height minus what's displayed in the line containing PT,
4740 and the lines below. */
4741 nlines
= - XINT (arg
) - 1;
4742 move_it_by_lines (&it
, nlines
, 1);
4744 y1
= line_bottom_y (&it
);
4746 /* If we can't move down NLINES lines because we hit
4747 the end of the buffer, count in some empty lines. */
4748 if (it
.vpos
< nlines
)
4749 y1
+= (nlines
- it
.vpos
) * CANON_Y_UNIT (it
.f
);
4751 h
= window_box_height (w
) - (y1
- y0
);
4753 start_display (&it
, w
, pt
);
4754 move_it_vertically (&it
, - h
);
4755 charpos
= IT_CHARPOS (it
);
4756 bytepos
= IT_BYTEPOS (it
);
4760 struct position pos
;
4761 pos
= *vmotion (PT
, - XINT (arg
), w
);
4762 charpos
= pos
.bufpos
;
4763 bytepos
= pos
.bytepos
;
4768 struct position pos
;
4769 int ht
= window_internal_height (w
);
4772 arg
= make_number (ht
/ 2);
4773 else if (XINT (arg
) < 0)
4774 arg
= make_number (XINT (arg
) + ht
);
4776 pos
= *vmotion (PT
, - XINT (arg
), w
);
4777 charpos
= pos
.bufpos
;
4778 bytepos
= pos
.bytepos
;
4781 /* Set the new window start. */
4782 set_marker_both (w
->start
, w
->buffer
, charpos
, bytepos
);
4783 w
->window_end_valid
= Qnil
;
4784 w
->force_start
= Qt
;
4785 if (bytepos
== BEGV_BYTE
|| FETCH_BYTE (bytepos
- 1) == '\n')
4786 w
->start_at_line_beg
= Qt
;
4788 w
->start_at_line_beg
= Qnil
;
4790 set_buffer_internal (obuf
);
4795 DEFUN ("window-text-height", Fwindow_text_height
, Swindow_text_height
,
4797 doc
: /* Return the height in lines of the text display area of WINDOW.
4798 This doesn't include the mode-line (or header-line if any) or any
4799 partial-height lines in the text display area. */)
4803 struct window
*w
= decode_window (window
);
4804 int pixel_height
= window_box_height (w
);
4805 int line_height
= pixel_height
/ CANON_Y_UNIT (XFRAME (w
->frame
));
4806 return make_number (line_height
);
4811 DEFUN ("move-to-window-line", Fmove_to_window_line
, Smove_to_window_line
,
4813 doc
: /* Position point relative to window.
4814 With no argument, position point at center of window.
4815 An argument specifies vertical position within the window;
4816 zero means top of window, negative means relative to bottom of window. */)
4820 struct window
*w
= XWINDOW (selected_window
);
4824 window
= selected_window
;
4825 start
= marker_position (w
->start
);
4826 if (start
< BEGV
|| start
> ZV
)
4828 int height
= window_internal_height (w
);
4829 Fvertical_motion (make_number (- (height
/ 2)), window
);
4830 set_marker_both (w
->start
, w
->buffer
, PT
, PT_BYTE
);
4831 w
->start_at_line_beg
= Fbolp ();
4832 w
->force_start
= Qt
;
4835 Fgoto_char (w
->start
);
4837 lines
= displayed_window_lines (w
);
4839 XSETFASTINT (arg
, lines
/ 2);
4842 arg
= Fprefix_numeric_value (arg
);
4844 XSETINT (arg
, XINT (arg
) + lines
);
4847 /* Skip past a partially visible first line. */
4849 XSETINT (arg
, XINT (arg
) + 1);
4851 return Fvertical_motion (arg
, window
);
4856 /***********************************************************************
4857 Window Configuration
4858 ***********************************************************************/
4860 struct save_window_data
4862 EMACS_INT size_from_Lisp_Vector_struct
;
4863 struct Lisp_Vector
*next_from_Lisp_Vector_struct
;
4864 Lisp_Object frame_width
, frame_height
, frame_menu_bar_lines
;
4865 Lisp_Object frame_tool_bar_lines
;
4866 Lisp_Object selected_frame
;
4867 Lisp_Object current_window
;
4868 Lisp_Object current_buffer
;
4869 Lisp_Object minibuf_scroll_window
;
4870 Lisp_Object minibuf_selected_window
;
4871 Lisp_Object root_window
;
4872 Lisp_Object focus_frame
;
4873 /* Record the values of window-min-width and window-min-height
4874 so that window sizes remain consistent with them. */
4875 Lisp_Object min_width
, min_height
;
4876 /* A vector, each of whose elements is a struct saved_window
4878 Lisp_Object saved_windows
;
4881 /* This is saved as a Lisp_Vector */
4884 /* these first two must agree with struct Lisp_Vector in lisp.h */
4885 EMACS_INT size_from_Lisp_Vector_struct
;
4886 struct Lisp_Vector
*next_from_Lisp_Vector_struct
;
4889 Lisp_Object buffer
, start
, pointm
, mark
;
4890 Lisp_Object left
, top
, width
, height
, hscroll
, min_hscroll
;
4891 Lisp_Object parent
, prev
;
4892 Lisp_Object start_at_line_beg
;
4893 Lisp_Object display_table
;
4894 Lisp_Object orig_top
, orig_height
;
4897 #define SAVED_WINDOW_VECTOR_SIZE 17 /* Arg to Fmake_vector */
4899 #define SAVED_WINDOW_N(swv,n) \
4900 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
4902 DEFUN ("window-configuration-p", Fwindow_configuration_p
, Swindow_configuration_p
, 1, 1, 0,
4903 doc
: /* Return t if OBJECT is a window-configuration object. */)
4907 if (WINDOW_CONFIGURATIONP (object
))
4912 DEFUN ("window-configuration-frame", Fwindow_configuration_frame
, Swindow_configuration_frame
, 1, 1, 0,
4913 doc
: /* Return the frame that CONFIG, a window-configuration object, is about. */)
4917 register struct save_window_data
*data
;
4918 struct Lisp_Vector
*saved_windows
;
4920 if (! WINDOW_CONFIGURATIONP (config
))
4921 wrong_type_argument (Qwindow_configuration_p
, config
);
4923 data
= (struct save_window_data
*) XVECTOR (config
);
4924 saved_windows
= XVECTOR (data
->saved_windows
);
4925 return XWINDOW (SAVED_WINDOW_N (saved_windows
, 0)->window
)->frame
;
4928 DEFUN ("set-window-configuration", Fset_window_configuration
,
4929 Sset_window_configuration
, 1, 1, 0,
4930 doc
: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
4931 CONFIGURATION must be a value previously returned
4932 by `current-window-configuration' (which see).
4933 If CONFIGURATION was made from a frame that is now deleted,
4934 only frame-independent values can be restored. In this case,
4935 the return value is nil. Otherwise the value is t. */)
4937 Lisp_Object configuration
;
4939 register struct save_window_data
*data
;
4940 struct Lisp_Vector
*saved_windows
;
4941 Lisp_Object new_current_buffer
;
4946 while (!WINDOW_CONFIGURATIONP (configuration
))
4947 wrong_type_argument (Qwindow_configuration_p
, configuration
);
4949 data
= (struct save_window_data
*) XVECTOR (configuration
);
4950 saved_windows
= XVECTOR (data
->saved_windows
);
4952 new_current_buffer
= data
->current_buffer
;
4953 if (NILP (XBUFFER (new_current_buffer
)->name
))
4954 new_current_buffer
= Qnil
;
4956 old_point
= BUF_PT (XBUFFER (new_current_buffer
));
4958 frame
= XWINDOW (SAVED_WINDOW_N (saved_windows
, 0)->window
)->frame
;
4961 /* If f is a dead frame, don't bother rebuilding its window tree.
4962 However, there is other stuff we should still try to do below. */
4963 if (FRAME_LIVE_P (f
))
4965 register struct window
*w
;
4966 register struct saved_window
*p
;
4967 struct window
*root_window
;
4968 struct window
**leaf_windows
;
4972 /* If the frame has been resized since this window configuration was
4973 made, we change the frame to the size specified in the
4974 configuration, restore the configuration, and then resize it
4975 back. We keep track of the prevailing height in these variables. */
4976 int previous_frame_height
= FRAME_HEIGHT (f
);
4977 int previous_frame_width
= FRAME_WIDTH (f
);
4978 int previous_frame_menu_bar_lines
= FRAME_MENU_BAR_LINES (f
);
4979 int previous_frame_tool_bar_lines
= FRAME_TOOL_BAR_LINES (f
);
4981 /* The mouse highlighting code could get screwed up
4982 if it runs during this. */
4985 if (XFASTINT (data
->frame_height
) != previous_frame_height
4986 || XFASTINT (data
->frame_width
) != previous_frame_width
)
4987 change_frame_size (f
, XFASTINT (data
->frame_height
),
4988 XFASTINT (data
->frame_width
), 0, 0, 0);
4989 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
4990 if (XFASTINT (data
->frame_menu_bar_lines
)
4991 != previous_frame_menu_bar_lines
)
4992 x_set_menu_bar_lines (f
, data
->frame_menu_bar_lines
, make_number (0));
4993 #ifdef HAVE_WINDOW_SYSTEM
4994 if (XFASTINT (data
->frame_tool_bar_lines
)
4995 != previous_frame_tool_bar_lines
)
4996 x_set_tool_bar_lines (f
, data
->frame_tool_bar_lines
, make_number (0));
5000 /* "Swap out" point from the selected window
5001 into its buffer. We do this now, before
5002 restoring the window contents, and prevent it from
5003 being done later on when we select a new window. */
5004 if (! NILP (XWINDOW (selected_window
)->buffer
))
5006 w
= XWINDOW (selected_window
);
5007 set_marker_both (w
->pointm
,
5009 BUF_PT (XBUFFER (w
->buffer
)),
5010 BUF_PT_BYTE (XBUFFER (w
->buffer
)));
5013 windows_or_buffers_changed
++;
5014 FRAME_WINDOW_SIZES_CHANGED (f
) = 1;
5016 /* Problem: Freeing all matrices and later allocating them again
5017 is a serious redisplay flickering problem. What we would
5018 really like to do is to free only those matrices not reused
5020 root_window
= XWINDOW (FRAME_ROOT_WINDOW (f
));
5022 = (struct window
**) alloca (count_windows (root_window
)
5023 * sizeof (struct window
*));
5024 n_leaf_windows
= get_leaf_windows (root_window
, leaf_windows
, 0);
5026 /* Temporarily avoid any problems with windows that are smaller
5027 than they are supposed to be. */
5028 window_min_height
= 1;
5029 window_min_width
= 1;
5032 Mark all windows now on frame as "deleted".
5033 Restoring the new configuration "undeletes" any that are in it.
5035 Save their current buffers in their height fields, since we may
5036 need it later, if a buffer saved in the configuration is now
5038 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f
)));
5040 for (k
= 0; k
< saved_windows
->size
; k
++)
5042 p
= SAVED_WINDOW_N (saved_windows
, k
);
5043 w
= XWINDOW (p
->window
);
5046 if (!NILP (p
->parent
))
5047 w
->parent
= SAVED_WINDOW_N (saved_windows
,
5048 XFASTINT (p
->parent
))->window
;
5052 if (!NILP (p
->prev
))
5054 w
->prev
= SAVED_WINDOW_N (saved_windows
,
5055 XFASTINT (p
->prev
))->window
;
5056 XWINDOW (w
->prev
)->next
= p
->window
;
5061 if (!NILP (w
->parent
))
5063 if (EQ (p
->width
, XWINDOW (w
->parent
)->width
))
5065 XWINDOW (w
->parent
)->vchild
= p
->window
;
5066 XWINDOW (w
->parent
)->hchild
= Qnil
;
5070 XWINDOW (w
->parent
)->hchild
= p
->window
;
5071 XWINDOW (w
->parent
)->vchild
= Qnil
;
5076 /* If we squirreled away the buffer in the window's height,
5078 if (BUFFERP (w
->height
))
5079 w
->buffer
= w
->height
;
5082 w
->width
= p
->width
;
5083 w
->height
= p
->height
;
5084 w
->hscroll
= p
->hscroll
;
5085 w
->min_hscroll
= p
->min_hscroll
;
5086 w
->display_table
= p
->display_table
;
5087 w
->orig_top
= p
->orig_top
;
5088 w
->orig_height
= p
->orig_height
;
5089 XSETFASTINT (w
->last_modified
, 0);
5090 XSETFASTINT (w
->last_overlay_modified
, 0);
5092 /* Reinstall the saved buffer and pointers into it. */
5093 if (NILP (p
->buffer
))
5094 w
->buffer
= p
->buffer
;
5097 if (!NILP (XBUFFER (p
->buffer
)->name
))
5098 /* If saved buffer is alive, install it. */
5100 w
->buffer
= p
->buffer
;
5101 w
->start_at_line_beg
= p
->start_at_line_beg
;
5102 set_marker_restricted (w
->start
, p
->start
, w
->buffer
);
5103 set_marker_restricted (w
->pointm
, p
->pointm
, w
->buffer
);
5104 Fset_marker (XBUFFER (w
->buffer
)->mark
,
5105 p
->mark
, w
->buffer
);
5107 /* As documented in Fcurrent_window_configuration, don't
5108 restore the location of point in the buffer which was
5109 current when the window configuration was recorded. */
5110 if (!EQ (p
->buffer
, new_current_buffer
)
5111 && XBUFFER (p
->buffer
) == current_buffer
)
5112 Fgoto_char (w
->pointm
);
5114 else if (NILP (w
->buffer
) || NILP (XBUFFER (w
->buffer
)->name
))
5115 /* Else unless window has a live buffer, get one. */
5117 w
->buffer
= Fcdr (Fcar (Vbuffer_alist
));
5118 /* This will set the markers to beginning of visible
5120 set_marker_restricted (w
->start
, make_number (0), w
->buffer
);
5121 set_marker_restricted (w
->pointm
, make_number (0),w
->buffer
);
5122 w
->start_at_line_beg
= Qt
;
5125 /* Keeping window's old buffer; make sure the markers
5128 /* Set window markers at start of visible range. */
5129 if (XMARKER (w
->start
)->buffer
== 0)
5130 set_marker_restricted (w
->start
, make_number (0),
5132 if (XMARKER (w
->pointm
)->buffer
== 0)
5133 set_marker_restricted_both (w
->pointm
, w
->buffer
,
5134 BUF_PT (XBUFFER (w
->buffer
)),
5135 BUF_PT_BYTE (XBUFFER (w
->buffer
)));
5136 w
->start_at_line_beg
= Qt
;
5141 FRAME_ROOT_WINDOW (f
) = data
->root_window
;
5142 /* Prevent "swapping out point" in the old selected window
5143 using the buffer that has been restored into it.
5144 Use the point value from the beginning of this function
5145 since unshow_buffer (called from delete_all_subwindows)
5146 could have altered it. */
5147 selected_window
= Qnil
;
5148 if (EQ (XWINDOW (data
->current_window
)->buffer
, new_current_buffer
))
5149 set_marker_restricted (XWINDOW (data
->current_window
)->pointm
,
5150 make_number (old_point
),
5151 XWINDOW (data
->current_window
)->buffer
);
5153 Fselect_window (data
->current_window
);
5154 XBUFFER (XWINDOW (selected_window
)->buffer
)->last_selected_window
5157 if (NILP (data
->focus_frame
)
5158 || (FRAMEP (data
->focus_frame
)
5159 && FRAME_LIVE_P (XFRAME (data
->focus_frame
))))
5160 Fredirect_frame_focus (frame
, data
->focus_frame
);
5162 #if 0 /* I don't understand why this is needed, and it causes problems
5163 when the frame's old selected window has been deleted. */
5164 if (f
!= selected_frame
&& FRAME_WINDOW_P (f
))
5165 do_switch_frame (WINDOW_FRAME (XWINDOW (data
->root_window
)),
5169 /* Set the screen height to the value it had before this function. */
5170 if (previous_frame_height
!= FRAME_HEIGHT (f
)
5171 || previous_frame_width
!= FRAME_WIDTH (f
))
5172 change_frame_size (f
, previous_frame_height
, previous_frame_width
,
5174 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
5175 if (previous_frame_menu_bar_lines
!= FRAME_MENU_BAR_LINES (f
))
5176 x_set_menu_bar_lines (f
, make_number (previous_frame_menu_bar_lines
),
5178 #ifdef HAVE_WINDOW_SYSTEM
5179 if (previous_frame_tool_bar_lines
!= FRAME_TOOL_BAR_LINES (f
))
5180 x_set_tool_bar_lines (f
, make_number (previous_frame_tool_bar_lines
),
5185 /* Now, free glyph matrices in windows that were not reused. */
5186 for (i
= n
= 0; i
< n_leaf_windows
; ++i
)
5188 if (NILP (leaf_windows
[i
]->buffer
))
5190 /* Assert it's not reused as a combination. */
5191 xassert (NILP (leaf_windows
[i
]->hchild
)
5192 && NILP (leaf_windows
[i
]->vchild
));
5193 free_window_matrices (leaf_windows
[i
]);
5195 else if (EQ (leaf_windows
[i
]->buffer
, new_current_buffer
))
5203 /* Fselect_window will have made f the selected frame, so we
5204 reselect the proper frame here. Fhandle_switch_frame will change the
5205 selected window too, but that doesn't make the call to
5206 Fselect_window above totally superfluous; it still sets f's
5208 if (FRAME_LIVE_P (XFRAME (data
->selected_frame
)))
5209 do_switch_frame (data
->selected_frame
, 0, 0);
5211 if (! NILP (Vwindow_configuration_change_hook
)
5212 && ! NILP (Vrun_hooks
))
5213 call1 (Vrun_hooks
, Qwindow_configuration_change_hook
);
5216 if (!NILP (new_current_buffer
))
5217 Fset_buffer (new_current_buffer
);
5219 /* Restore the minimum heights recorded in the configuration. */
5220 window_min_height
= XINT (data
->min_height
);
5221 window_min_width
= XINT (data
->min_width
);
5223 Vminibuf_scroll_window
= data
->minibuf_scroll_window
;
5224 minibuf_selected_window
= data
->minibuf_selected_window
;
5226 return (FRAME_LIVE_P (f
) ? Qt
: Qnil
);
5229 /* Mark all windows now on frame as deleted
5230 by setting their buffers to nil. */
5233 delete_all_subwindows (w
)
5234 register struct window
*w
;
5236 if (!NILP (w
->next
))
5237 delete_all_subwindows (XWINDOW (w
->next
));
5238 if (!NILP (w
->vchild
))
5239 delete_all_subwindows (XWINDOW (w
->vchild
));
5240 if (!NILP (w
->hchild
))
5241 delete_all_subwindows (XWINDOW (w
->hchild
));
5243 w
->height
= w
->buffer
; /* See Fset_window_configuration for excuse. */
5245 if (!NILP (w
->buffer
))
5248 /* We set all three of these fields to nil, to make sure that we can
5249 distinguish this dead window from any live window. Live leaf
5250 windows will have buffer set, and combination windows will have
5251 vchild or hchild set. */
5256 Vwindow_list
= Qnil
;
5260 count_windows (window
)
5261 register struct window
*window
;
5263 register int count
= 1;
5264 if (!NILP (window
->next
))
5265 count
+= count_windows (XWINDOW (window
->next
));
5266 if (!NILP (window
->vchild
))
5267 count
+= count_windows (XWINDOW (window
->vchild
));
5268 if (!NILP (window
->hchild
))
5269 count
+= count_windows (XWINDOW (window
->hchild
));
5274 /* Fill vector FLAT with leaf windows under W, starting at index I.
5275 Value is last index + 1. */
5278 get_leaf_windows (w
, flat
, i
)
5280 struct window
**flat
;
5285 if (!NILP (w
->hchild
))
5286 i
= get_leaf_windows (XWINDOW (w
->hchild
), flat
, i
);
5287 else if (!NILP (w
->vchild
))
5288 i
= get_leaf_windows (XWINDOW (w
->vchild
), flat
, i
);
5292 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
5299 /* Return a pointer to the glyph W's physical cursor is on. Value is
5300 null if W's current matrix is invalid, so that no meaningfull glyph
5304 get_phys_cursor_glyph (w
)
5307 struct glyph_row
*row
;
5308 struct glyph
*glyph
;
5310 if (w
->phys_cursor
.vpos
>= 0
5311 && w
->phys_cursor
.vpos
< w
->current_matrix
->nrows
5312 && (row
= MATRIX_ROW (w
->current_matrix
, w
->phys_cursor
.vpos
),
5314 && row
->used
[TEXT_AREA
] > w
->phys_cursor
.hpos
)
5315 glyph
= row
->glyphs
[TEXT_AREA
] + w
->phys_cursor
.hpos
;
5324 save_window_save (window
, vector
, i
)
5326 struct Lisp_Vector
*vector
;
5329 register struct saved_window
*p
;
5330 register struct window
*w
;
5331 register Lisp_Object tem
;
5333 for (;!NILP (window
); window
= w
->next
)
5335 p
= SAVED_WINDOW_N (vector
, i
);
5336 w
= XWINDOW (window
);
5338 XSETFASTINT (w
->temslot
, i
++);
5340 p
->buffer
= w
->buffer
;
5343 p
->width
= w
->width
;
5344 p
->height
= w
->height
;
5345 p
->hscroll
= w
->hscroll
;
5346 p
->min_hscroll
= w
->min_hscroll
;
5347 p
->display_table
= w
->display_table
;
5348 p
->orig_top
= w
->orig_top
;
5349 p
->orig_height
= w
->orig_height
;
5350 if (!NILP (w
->buffer
))
5352 /* Save w's value of point in the window configuration.
5353 If w is the selected window, then get the value of point
5354 from the buffer; pointm is garbage in the selected window. */
5355 if (EQ (window
, selected_window
))
5357 p
->pointm
= Fmake_marker ();
5358 set_marker_both (p
->pointm
, w
->buffer
,
5359 BUF_PT (XBUFFER (w
->buffer
)),
5360 BUF_PT_BYTE (XBUFFER (w
->buffer
)));
5363 p
->pointm
= Fcopy_marker (w
->pointm
, Qnil
);
5365 p
->start
= Fcopy_marker (w
->start
, Qnil
);
5366 p
->start_at_line_beg
= w
->start_at_line_beg
;
5368 tem
= XBUFFER (w
->buffer
)->mark
;
5369 p
->mark
= Fcopy_marker (tem
, Qnil
);
5376 p
->start_at_line_beg
= Qnil
;
5379 if (NILP (w
->parent
))
5382 p
->parent
= XWINDOW (w
->parent
)->temslot
;
5387 p
->prev
= XWINDOW (w
->prev
)->temslot
;
5389 if (!NILP (w
->vchild
))
5390 i
= save_window_save (w
->vchild
, vector
, i
);
5391 if (!NILP (w
->hchild
))
5392 i
= save_window_save (w
->hchild
, vector
, i
);
5398 DEFUN ("current-window-configuration", Fcurrent_window_configuration
,
5399 Scurrent_window_configuration
, 0, 1, 0,
5400 doc
: /* Return an object representing the current window configuration of FRAME.
5401 If FRAME is nil or omitted, use the selected frame.
5402 This describes the number of windows, their sizes and current buffers,
5403 and for each displayed buffer, where display starts, and the positions of
5404 point and mark. An exception is made for point in the current buffer:
5405 its value is -not- saved.
5406 This also records the currently selected frame, and FRAME's focus
5407 redirection (see `redirect-frame-focus'). */)
5411 register Lisp_Object tem
;
5412 register int n_windows
;
5413 register struct save_window_data
*data
;
5414 register struct Lisp_Vector
*vec
;
5419 frame
= selected_frame
;
5420 CHECK_LIVE_FRAME (frame
);
5423 n_windows
= count_windows (XWINDOW (FRAME_ROOT_WINDOW (f
)));
5424 vec
= allocate_other_vector (VECSIZE (struct save_window_data
));
5425 data
= (struct save_window_data
*)vec
;
5427 XSETFASTINT (data
->frame_width
, FRAME_WIDTH (f
));
5428 XSETFASTINT (data
->frame_height
, FRAME_HEIGHT (f
));
5429 XSETFASTINT (data
->frame_menu_bar_lines
, FRAME_MENU_BAR_LINES (f
));
5430 XSETFASTINT (data
->frame_tool_bar_lines
, FRAME_TOOL_BAR_LINES (f
));
5431 data
->selected_frame
= selected_frame
;
5432 data
->current_window
= FRAME_SELECTED_WINDOW (f
);
5433 XSETBUFFER (data
->current_buffer
, current_buffer
);
5434 data
->minibuf_scroll_window
= minibuf_level
> 0 ? Vminibuf_scroll_window
: Qnil
;
5435 data
->minibuf_selected_window
= minibuf_level
> 0 ? minibuf_selected_window
: Qnil
;
5436 data
->root_window
= FRAME_ROOT_WINDOW (f
);
5437 data
->focus_frame
= FRAME_FOCUS_FRAME (f
);
5438 XSETINT (data
->min_height
, window_min_height
);
5439 XSETINT (data
->min_width
, window_min_width
);
5440 tem
= Fmake_vector (make_number (n_windows
), Qnil
);
5441 data
->saved_windows
= tem
;
5442 for (i
= 0; i
< n_windows
; i
++)
5443 XVECTOR (tem
)->contents
[i
]
5444 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE
), Qnil
);
5445 save_window_save (FRAME_ROOT_WINDOW (f
), XVECTOR (tem
), 0);
5446 XSETWINDOW_CONFIGURATION (tem
, data
);
5450 DEFUN ("save-window-excursion", Fsave_window_excursion
, Ssave_window_excursion
,
5452 doc
: /* Execute body, preserving window sizes and contents.
5453 Restore which buffer appears in which window, where display starts,
5454 and the value of point and mark for each window.
5455 Also restore the choice of selected window.
5456 Also restore which buffer is current.
5457 Does not restore the value of point in current buffer.
5458 usage: (save-window-excursion BODY ...) */)
5462 register Lisp_Object val
;
5463 register int count
= specpdl_ptr
- specpdl
;
5465 record_unwind_protect (Fset_window_configuration
,
5466 Fcurrent_window_configuration (Qnil
));
5467 val
= Fprogn (args
);
5468 return unbind_to (count
, val
);
5472 /***********************************************************************
5474 ***********************************************************************/
5476 DEFUN ("set-window-margins", Fset_window_margins
, Sset_window_margins
,
5478 doc
: /* Set width of marginal areas of window WINDOW.
5479 If window is nil, set margins of the currently selected window.
5480 First parameter LEFT-WIDTH specifies the number of character
5481 cells to reserve for the left marginal area. Second parameter
5482 RIGHT-WIDTH does the same for the right marginal area.
5483 A nil width parameter means no margin. */)
5484 (window
, left
, right
)
5485 Lisp_Object window
, left
, right
;
5487 struct window
*w
= decode_window (window
);
5490 CHECK_NUMBER_OR_FLOAT (left
);
5492 CHECK_NUMBER_OR_FLOAT (right
);
5494 /* Check widths < 0 and translate a zero width to nil.
5495 Margins that are too wide have to be checked elsewhere. */
5496 if ((INTEGERP (left
) && XINT (left
) < 0)
5497 || (FLOATP (left
) && XFLOAT_DATA (left
) <= 0))
5498 XSETFASTINT (left
, 0);
5499 if (INTEGERP (left
) && XFASTINT (left
) == 0)
5502 if ((INTEGERP (right
) && XINT (right
) < 0)
5503 || (FLOATP (right
) && XFLOAT_DATA (right
) <= 0))
5504 XSETFASTINT (right
, 0);
5505 if (INTEGERP (right
) && XFASTINT (right
) == 0)
5508 w
->left_margin_width
= left
;
5509 w
->right_margin_width
= right
;
5511 ++windows_or_buffers_changed
;
5512 adjust_glyphs (XFRAME (WINDOW_FRAME (w
)));
5517 DEFUN ("window-margins", Fwindow_margins
, Swindow_margins
,
5519 doc
: /* Get width of marginal areas of window WINDOW.
5520 If WINDOW is omitted or nil, use the currently selected window.
5521 Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
5522 If a marginal area does not exist, its width will be returned
5527 struct window
*w
= decode_window (window
);
5528 return Fcons (w
->left_margin_width
, w
->right_margin_width
);
5533 /***********************************************************************
5535 ***********************************************************************/
5537 DEFUN ("window-vscroll", Fwindow_vscroll
, Swindow_vscroll
, 0, 1, 0,
5538 doc
: /* Return the amount by which WINDOW is scrolled vertically.
5539 Use the selected window if WINDOW is nil or omitted.
5540 Value is a multiple of the canonical character height of WINDOW. */)
5549 window
= selected_window
;
5551 CHECK_WINDOW (window
);
5552 w
= XWINDOW (window
);
5553 f
= XFRAME (w
->frame
);
5555 if (FRAME_WINDOW_P (f
))
5556 result
= CANON_Y_FROM_PIXEL_Y (f
, -w
->vscroll
);
5558 result
= make_number (0);
5563 DEFUN ("set-window-vscroll", Fset_window_vscroll
, Sset_window_vscroll
,
5565 doc
: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
5566 WINDOW nil means use the selected window. VSCROLL is a non-negative
5567 multiple of the canonical character height of WINDOW. */)
5569 Lisp_Object window
, vscroll
;
5575 window
= selected_window
;
5577 CHECK_WINDOW (window
);
5578 CHECK_NUMBER_OR_FLOAT (vscroll
);
5580 w
= XWINDOW (window
);
5581 f
= XFRAME (w
->frame
);
5583 if (FRAME_WINDOW_P (f
))
5585 int old_dy
= w
->vscroll
;
5587 w
->vscroll
= - CANON_Y_UNIT (f
) * XFLOATINT (vscroll
);
5588 w
->vscroll
= min (w
->vscroll
, 0);
5590 /* Adjust glyph matrix of the frame if the virtual display
5591 area becomes larger than before. */
5592 if (w
->vscroll
< 0 && w
->vscroll
< old_dy
)
5595 /* Prevent redisplay shortcuts. */
5596 XBUFFER (w
->buffer
)->prevent_redisplay_optimizations_p
= 1;
5599 return Fwindow_vscroll (window
);
5603 /* Call FN for all leaf windows on frame F. FN is called with the
5604 first argument being a pointer to the leaf window, and with
5605 additional argument USER_DATA. Stops when FN returns 0. */
5608 foreach_window (f
, fn
, user_data
)
5610 int (* fn
) P_ ((struct window
*, void *));
5613 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f
)), fn
, user_data
);
5617 /* Helper function for foreach_window. Call FN for all leaf windows
5618 reachable from W. FN is called with the first argument being a
5619 pointer to the leaf window, and with additional argument USER_DATA.
5620 Stop when FN returns 0. Value is 0 if stopped by FN. */
5623 foreach_window_1 (w
, fn
, user_data
)
5625 int (* fn
) P_ ((struct window
*, void *));
5630 for (cont
= 1; w
&& cont
;)
5632 if (!NILP (w
->hchild
))
5633 cont
= foreach_window_1 (XWINDOW (w
->hchild
), fn
, user_data
);
5634 else if (!NILP (w
->vchild
))
5635 cont
= foreach_window_1 (XWINDOW (w
->vchild
), fn
, user_data
);
5637 cont
= fn (w
, user_data
);
5639 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
5646 /* Freeze or unfreeze the window start of W unless it is a
5647 mini-window or the selected window. FREEZE_P non-null means freeze
5648 the window start. */
5651 freeze_window_start (w
, freeze_p
)
5655 if (w
== XWINDOW (selected_window
)
5656 || MINI_WINDOW_P (w
)
5657 || (MINI_WINDOW_P (XWINDOW (selected_window
))
5658 && ! NILP (Vminibuf_scroll_window
)
5659 && w
== XWINDOW (Vminibuf_scroll_window
)))
5662 w
->frozen_window_start_p
= freeze_p
!= NULL
;
5667 /* Freeze or unfreeze the window starts of all leaf windows on frame
5668 F, except the selected window and a mini-window. FREEZE_P non-zero
5669 means freeze the window start. */
5672 freeze_window_starts (f
, freeze_p
)
5676 foreach_window (f
, freeze_window_start
, (void *) (freeze_p
? f
: 0));
5680 /***********************************************************************
5682 ***********************************************************************/
5684 /* Return 1 if window configurations C1 and C2
5685 describe the same state of affairs. This is used by Fequal. */
5688 compare_window_configurations (c1
, c2
, ignore_positions
)
5690 int ignore_positions
;
5692 register struct save_window_data
*d1
, *d2
;
5693 struct Lisp_Vector
*sw1
, *sw2
;
5696 if (!WINDOW_CONFIGURATIONP (c1
))
5697 wrong_type_argument (Qwindow_configuration_p
, c1
);
5698 if (!WINDOW_CONFIGURATIONP (c2
))
5699 wrong_type_argument (Qwindow_configuration_p
, c2
);
5701 d1
= (struct save_window_data
*) XVECTOR (c1
);
5702 d2
= (struct save_window_data
*) XVECTOR (c2
);
5703 sw1
= XVECTOR (d1
->saved_windows
);
5704 sw2
= XVECTOR (d2
->saved_windows
);
5706 if (! EQ (d1
->frame_width
, d2
->frame_width
))
5708 if (! EQ (d1
->frame_height
, d2
->frame_height
))
5710 if (! EQ (d1
->frame_menu_bar_lines
, d2
->frame_menu_bar_lines
))
5712 if (! EQ (d1
->selected_frame
, d2
->selected_frame
))
5714 /* Don't compare the current_window field directly.
5715 Instead see w1_is_current and w2_is_current, below. */
5716 if (! EQ (d1
->current_buffer
, d2
->current_buffer
))
5718 if (! ignore_positions
)
5720 if (! EQ (d1
->minibuf_scroll_window
, d2
->minibuf_scroll_window
))
5722 if (! EQ (d1
->minibuf_selected_window
, d2
->minibuf_selected_window
))
5725 /* Don't compare the root_window field.
5726 We don't require the two configurations
5727 to use the same window object,
5728 and the two root windows must be equivalent
5729 if everything else compares equal. */
5730 if (! EQ (d1
->focus_frame
, d2
->focus_frame
))
5732 if (! EQ (d1
->min_width
, d2
->min_width
))
5734 if (! EQ (d1
->min_height
, d2
->min_height
))
5737 /* Verify that the two confis have the same number of windows. */
5738 if (sw1
->size
!= sw2
->size
)
5741 for (i
= 0; i
< sw1
->size
; i
++)
5743 struct saved_window
*p1
, *p2
;
5744 int w1_is_current
, w2_is_current
;
5746 p1
= SAVED_WINDOW_N (sw1
, i
);
5747 p2
= SAVED_WINDOW_N (sw2
, i
);
5749 /* Verify that the current windows in the two
5750 configurations correspond to each other. */
5751 w1_is_current
= EQ (d1
->current_window
, p1
->window
);
5752 w2_is_current
= EQ (d2
->current_window
, p2
->window
);
5754 if (w1_is_current
!= w2_is_current
)
5757 /* Verify that the corresponding windows do match. */
5758 if (! EQ (p1
->buffer
, p2
->buffer
))
5760 if (! EQ (p1
->left
, p2
->left
))
5762 if (! EQ (p1
->top
, p2
->top
))
5764 if (! EQ (p1
->width
, p2
->width
))
5766 if (! EQ (p1
->height
, p2
->height
))
5768 if (! EQ (p1
->display_table
, p2
->display_table
))
5770 if (! EQ (p1
->parent
, p2
->parent
))
5772 if (! EQ (p1
->prev
, p2
->prev
))
5774 if (! ignore_positions
)
5776 if (! EQ (p1
->hscroll
, p2
->hscroll
))
5778 if (!EQ (p1
->min_hscroll
, p2
->min_hscroll
))
5780 if (! EQ (p1
->start_at_line_beg
, p2
->start_at_line_beg
))
5782 if (NILP (Fequal (p1
->start
, p2
->start
)))
5784 if (NILP (Fequal (p1
->pointm
, p2
->pointm
)))
5786 if (NILP (Fequal (p1
->mark
, p2
->mark
)))
5794 DEFUN ("compare-window-configurations", Fcompare_window_configurations
,
5795 Scompare_window_configurations
, 2, 2, 0,
5796 doc
: /* Compare two window configurations as regards the structure of windows.
5797 This function ignores details such as the values of point and mark
5798 and scrolling positions. */)
5802 if (compare_window_configurations (x
, y
, 1))
5810 struct frame
*f
= make_terminal_frame ();
5811 XSETFRAME (selected_frame
, f
);
5812 Vterminal_frame
= selected_frame
;
5813 minibuf_window
= f
->minibuffer_window
;
5814 selected_window
= f
->selected_window
;
5815 last_nonminibuf_frame
= f
;
5817 window_initialized
= 1;
5823 Vwindow_list
= Qnil
;
5829 Qwindow_size_fixed
= intern ("window-size-fixed");
5830 staticpro (&Qwindow_size_fixed
);
5832 staticpro (&Qwindow_configuration_change_hook
);
5833 Qwindow_configuration_change_hook
5834 = intern ("window-configuration-change-hook");
5836 Qwindowp
= intern ("windowp");
5837 staticpro (&Qwindowp
);
5839 Qwindow_configuration_p
= intern ("window-configuration-p");
5840 staticpro (&Qwindow_configuration_p
);
5842 Qwindow_live_p
= intern ("window-live-p");
5843 staticpro (&Qwindow_live_p
);
5845 Qtemp_buffer_show_hook
= intern ("temp-buffer-show-hook");
5846 staticpro (&Qtemp_buffer_show_hook
);
5848 staticpro (&Vwindow_list
);
5850 minibuf_selected_window
= Qnil
;
5851 staticpro (&minibuf_selected_window
);
5853 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function
,
5854 doc
: /* Non-nil means call as function to display a help buffer.
5855 The function is called with one argument, the buffer to be displayed.
5856 Used by `with-output-to-temp-buffer'.
5857 If this function is used, then it must do the entire job of showing
5858 the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
5859 Vtemp_buffer_show_function
= Qnil
;
5861 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function
,
5862 doc
: /* If non-nil, function to call to handle `display-buffer'.
5863 It will receive two args, the buffer and a flag which if non-nil means
5864 that the currently selected window is not acceptable.
5865 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
5866 work using this function. */);
5867 Vdisplay_buffer_function
= Qnil
;
5869 DEFVAR_LISP ("even-window-heights", &Veven_window_heights
,
5870 doc
: /* *If non-nil, `display-buffer' should even the window heights.
5871 If nil, `display-buffer' will leave the window configuration alone. */);
5872 Veven_window_heights
= Qt
;
5874 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window
,
5875 doc
: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
5876 Vminibuf_scroll_window
= Qnil
;
5878 DEFVAR_BOOL ("mode-line-in-non-selected-windows", &mode_line_in_non_selected_windows
,
5879 doc
: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
5880 If the minibuffer is active, the `minibuffer-scroll-window' mode line
5881 is displayed in the `mode-line' face. */);
5882 mode_line_in_non_selected_windows
= 1;
5884 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer
,
5885 doc
: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
5886 Vother_window_scroll_buffer
= Qnil
;
5888 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames
,
5889 doc
: /* *Non-nil means `display-buffer' should make a separate frame. */);
5892 DEFVAR_BOOL ("display-buffer-reuse-frames", &display_buffer_reuse_frames
,
5893 doc
: /* *Non-nil means `display-buffer' should reuse frames.
5894 If the buffer in question is already displayed in a frame, raise that frame. */);
5895 display_buffer_reuse_frames
= 0;
5897 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function
,
5898 doc
: /* Function to call to handle automatic new frame creation.
5899 It is called with no arguments and should return a newly created frame.
5901 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
5902 where `pop-up-frame-alist' would hold the default frame parameters. */);
5903 Vpop_up_frame_function
= Qnil
;
5905 DEFVAR_LISP ("special-display-buffer-names", &Vspecial_display_buffer_names
,
5906 doc
: /* *List of buffer names that should have their own special frames.
5907 Displaying a buffer whose name is in this list makes a special frame for it
5908 using `special-display-function'. See also `special-display-regexps'.
5910 An element of the list can be a list instead of just a string.
5911 There are two ways to use a list as an element:
5912 (BUFFER FRAME-PARAMETERS...) (BUFFER FUNCTION OTHER-ARGS...)
5913 In the first case, FRAME-PARAMETERS are used to create the frame.
5914 In the latter case, FUNCTION is called with BUFFER as the first argument,
5915 followed by OTHER-ARGS--it can display BUFFER in any way it likes.
5916 All this is done by the function found in `special-display-function'.
5918 If this variable appears \"not to work\", because you add a name to it
5919 but that buffer still appears in the selected window, look at the
5920 values of `same-window-buffer-names' and `same-window-regexps'.
5921 Those variables take precedence over this one. */);
5922 Vspecial_display_buffer_names
= Qnil
;
5924 DEFVAR_LISP ("special-display-regexps", &Vspecial_display_regexps
,
5925 doc
: /* *List of regexps saying which buffers should have their own special frames.
5926 If a buffer name matches one of these regexps, it gets its own frame.
5927 Displaying a buffer whose name is in this list makes a special frame for it
5928 using `special-display-function'.
5930 An element of the list can be a list instead of just a string.
5931 There are two ways to use a list as an element:
5932 (REGEXP FRAME-PARAMETERS...) (REGEXP FUNCTION OTHER-ARGS...)
5933 In the first case, FRAME-PARAMETERS are used to create the frame.
5934 In the latter case, FUNCTION is called with the buffer as first argument,
5935 followed by OTHER-ARGS--it can display the buffer in any way it likes.
5936 All this is done by the function found in `special-display-function'.
5938 If this variable appears \"not to work\", because you add a regexp to it
5939 but the matching buffers still appear in the selected window, look at the
5940 values of `same-window-buffer-names' and `same-window-regexps'.
5941 Those variables take precedence over this one. */);
5942 Vspecial_display_regexps
= Qnil
;
5944 DEFVAR_LISP ("special-display-function", &Vspecial_display_function
,
5945 doc
: /* Function to call to make a new frame for a special buffer.
5946 It is called with two arguments, the buffer and optional buffer specific
5947 data, and should return a window displaying that buffer.
5948 The default value makes a separate frame for the buffer,
5949 using `special-display-frame-alist' to specify the frame parameters.
5951 A buffer is special if its is listed in `special-display-buffer-names'
5952 or matches a regexp in `special-display-regexps'. */);
5953 Vspecial_display_function
= Qnil
;
5955 DEFVAR_LISP ("same-window-buffer-names", &Vsame_window_buffer_names
,
5956 doc
: /* *List of buffer names that should appear in the selected window.
5957 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
5958 switches to it in the selected window, rather than making it appear
5959 in some other window.
5961 An element of the list can be a cons cell instead of just a string.
5962 Then the car must be a string, which specifies the buffer name.
5963 This is for compatibility with `special-display-buffer-names';
5964 the cdr of the cons cell is ignored.
5966 See also `same-window-regexps'. */);
5967 Vsame_window_buffer_names
= Qnil
;
5969 DEFVAR_LISP ("same-window-regexps", &Vsame_window_regexps
,
5970 doc
: /* *List of regexps saying which buffers should appear in the selected window.
5971 If a buffer name matches one of these regexps, then displaying it
5972 using `display-buffer' or `pop-to-buffer' switches to it
5973 in the selected window, rather than making it appear in some other window.
5975 An element of the list can be a cons cell instead of just a string.
5976 Then the car must be a string, which specifies the buffer name.
5977 This is for compatibility with `special-display-buffer-names';
5978 the cdr of the cons cell is ignored.
5980 See also `same-window-buffer-names'. */);
5981 Vsame_window_regexps
= Qnil
;
5983 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows
,
5984 doc
: /* *Non-nil means display-buffer should make new windows. */);
5987 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines
,
5988 doc
: /* *Number of lines of continuity when scrolling by screenfuls. */);
5989 next_screen_context_lines
= 2;
5991 DEFVAR_INT ("split-height-threshold", &split_height_threshold
,
5992 doc
: /* *display-buffer would prefer to split the largest window if this large.
5993 If there is only one window, it is split regardless of this value. */);
5994 split_height_threshold
= 500;
5996 DEFVAR_INT ("window-min-height", &window_min_height
,
5997 doc
: /* *Delete any window less than this tall (including its mode line). */);
5998 window_min_height
= 4;
6000 DEFVAR_INT ("window-min-width", &window_min_width
,
6001 doc
: /* *Delete any window less than this wide. */);
6002 window_min_width
= 10;
6004 DEFVAR_LISP ("scroll-preserve-screen-position",
6005 &Vscroll_preserve_screen_position
,
6006 doc
: /* *Non-nil means scroll commands move point to keep its screen line unchanged. */);
6007 Vscroll_preserve_screen_position
= Qnil
;
6009 DEFVAR_LISP ("window-configuration-change-hook",
6010 &Vwindow_configuration_change_hook
,
6011 doc
: /* Functions to call when window configuration changes.
6012 The selected frame is the one whose configuration has changed. */);
6013 Vwindow_configuration_change_hook
= Qnil
;
6015 DEFVAR_BOOL ("window-size-fixed", &window_size_fixed
,
6016 doc
: /* Non-nil in a buffer means windows displaying the buffer are fixed-size.
6017 Emacs won't change the size of any window displaying that buffer,
6018 unless you explicitly change the size, or Emacs has no other choice.
6019 This variable automatically becomes buffer-local when set. */);
6020 Fmake_variable_buffer_local (Qwindow_size_fixed
);
6021 window_size_fixed
= 0;
6023 defsubr (&Sselected_window
);
6024 defsubr (&Sminibuffer_window
);
6025 defsubr (&Swindow_minibuffer_p
);
6026 defsubr (&Swindowp
);
6027 defsubr (&Swindow_live_p
);
6028 defsubr (&Spos_visible_in_window_p
);
6029 defsubr (&Swindow_buffer
);
6030 defsubr (&Swindow_height
);
6031 defsubr (&Swindow_width
);
6032 defsubr (&Swindow_hscroll
);
6033 defsubr (&Sset_window_hscroll
);
6034 defsubr (&Swindow_redisplay_end_trigger
);
6035 defsubr (&Sset_window_redisplay_end_trigger
);
6036 defsubr (&Swindow_edges
);
6037 defsubr (&Scoordinates_in_window_p
);
6038 defsubr (&Swindow_at
);
6039 defsubr (&Swindow_point
);
6040 defsubr (&Swindow_start
);
6041 defsubr (&Swindow_end
);
6042 defsubr (&Sset_window_point
);
6043 defsubr (&Sset_window_start
);
6044 defsubr (&Swindow_dedicated_p
);
6045 defsubr (&Sset_window_dedicated_p
);
6046 defsubr (&Swindow_display_table
);
6047 defsubr (&Sset_window_display_table
);
6048 defsubr (&Snext_window
);
6049 defsubr (&Sprevious_window
);
6050 defsubr (&Sother_window
);
6051 defsubr (&Sget_lru_window
);
6052 defsubr (&Sget_largest_window
);
6053 defsubr (&Sget_buffer_window
);
6054 defsubr (&Sdelete_other_windows
);
6055 defsubr (&Sdelete_windows_on
);
6056 defsubr (&Sreplace_buffer_in_windows
);
6057 defsubr (&Sdelete_window
);
6058 defsubr (&Sset_window_buffer
);
6059 defsubr (&Sselect_window
);
6060 defsubr (&Sspecial_display_p
);
6061 defsubr (&Ssame_window_p
);
6062 defsubr (&Sdisplay_buffer
);
6063 defsubr (&Ssplit_window
);
6064 defsubr (&Senlarge_window
);
6065 defsubr (&Sshrink_window
);
6066 defsubr (&Sscroll_up
);
6067 defsubr (&Sscroll_down
);
6068 defsubr (&Sscroll_left
);
6069 defsubr (&Sscroll_right
);
6070 defsubr (&Sother_window_for_scrolling
);
6071 defsubr (&Sscroll_other_window
);
6072 defsubr (&Sminibuffer_selected_window
);
6073 defsubr (&Srecenter
);
6074 defsubr (&Swindow_text_height
);
6075 defsubr (&Smove_to_window_line
);
6076 defsubr (&Swindow_configuration_p
);
6077 defsubr (&Swindow_configuration_frame
);
6078 defsubr (&Sset_window_configuration
);
6079 defsubr (&Scurrent_window_configuration
);
6080 defsubr (&Ssave_window_excursion
);
6081 defsubr (&Sset_window_margins
);
6082 defsubr (&Swindow_margins
);
6083 defsubr (&Swindow_vscroll
);
6084 defsubr (&Sset_window_vscroll
);
6085 defsubr (&Scompare_window_configurations
);
6086 defsubr (&Swindow_list
);
6092 initial_define_key (control_x_map
, '1', "delete-other-windows");
6093 initial_define_key (control_x_map
, '2', "split-window");
6094 initial_define_key (control_x_map
, '0', "delete-window");
6095 initial_define_key (control_x_map
, 'o', "other-window");
6096 initial_define_key (control_x_map
, '^', "enlarge-window");
6097 initial_define_key (control_x_map
, '<', "scroll-left");
6098 initial_define_key (control_x_map
, '>', "scroll-right");
6100 initial_define_key (global_map
, Ctl ('V'), "scroll-up");
6101 initial_define_key (meta_map
, Ctl ('V'), "scroll-other-window");
6102 initial_define_key (meta_map
, 'v', "scroll-down");
6104 initial_define_key (global_map
, Ctl('L'), "recenter");
6105 initial_define_key (meta_map
, 'r', "move-to-window-line");