]> code.delx.au - gnu-emacs/blob - src/window.c
* macfns.c (validate_x_resource_name): Use SSET.
[gnu-emacs] / src / window.c
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.
5
6 This file is part of GNU Emacs.
7
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
12
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.
17
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. */
22
23 #include <config.h>
24 #include "lisp.h"
25 #include "buffer.h"
26 #include "keyboard.h"
27 #include "keymap.h"
28 #include "frame.h"
29 #include "window.h"
30 #include "commands.h"
31 #include "indent.h"
32 #include "termchar.h"
33 #include "disptab.h"
34 #include "dispextern.h"
35 #include "blockinput.h"
36 #include "intervals.h"
37
38 #ifdef HAVE_X_WINDOWS
39 #include "xterm.h"
40 #endif /* HAVE_X_WINDOWS */
41 #ifdef WINDOWSNT
42 #include "w32term.h"
43 #endif
44 #ifdef MSDOS
45 #include "msdos.h"
46 #endif
47 #ifdef MAC_OS
48 #include "macterm.h"
49 #endif
50
51 /* Values returned from coordinates_in_window. */
52
53 enum window_part
54 {
55 ON_NOTHING,
56 ON_TEXT,
57 ON_MODE_LINE,
58 ON_VERTICAL_BORDER,
59 ON_HEADER_LINE,
60 ON_LEFT_FRINGE,
61 ON_RIGHT_FRINGE,
62 ON_LEFT_MARGIN,
63 ON_RIGHT_MARGIN
64 };
65
66
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;
71
72 static int displayed_window_lines P_ ((struct window *));
73 static struct window *decode_window P_ ((Lisp_Object));
74 static Lisp_Object select_window_1 P_ ((Lisp_Object, int));
75 static int count_windows P_ ((struct window *));
76 static int get_leaf_windows P_ ((struct window *, struct window **, int));
77 static void window_scroll P_ ((Lisp_Object, int, int, int));
78 static void window_scroll_pixel_based P_ ((Lisp_Object, int, int, int));
79 static void window_scroll_line_based P_ ((Lisp_Object, int, int, int));
80 static int window_min_size_1 P_ ((struct window *, int));
81 static int window_min_size P_ ((struct window *, int, int, int *));
82 static void size_window P_ ((Lisp_Object, int, int, int));
83 static int freeze_window_start P_ ((struct window *, void *));
84 static int window_fixed_size_p P_ ((struct window *, int, int));
85 static void enlarge_window P_ ((Lisp_Object, int, int, int));
86 static Lisp_Object window_list P_ ((void));
87 static int add_window_to_list P_ ((struct window *, void *));
88 static int candidate_window_p P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
89 Lisp_Object));
90 static Lisp_Object next_window P_ ((Lisp_Object, Lisp_Object,
91 Lisp_Object, int));
92 static void decode_next_window_args P_ ((Lisp_Object *, Lisp_Object *,
93 Lisp_Object *));
94 static int foreach_window_1 P_ ((struct window *,
95 int (* fn) (struct window *, void *),
96 void *));
97 static Lisp_Object window_list_1 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
98
99 /* The value of `window-size-fixed'. */
100
101 int window_size_fixed;
102
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.
107
108 This value is always the same as
109 FRAME_SELECTED_WINDOW (selected_frame). */
110
111 Lisp_Object selected_window;
112
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. */
116
117 Lisp_Object Vwindow_list;
118
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. */
123
124 Lisp_Object minibuf_window;
125
126 /* Non-nil means it is the window whose mode line should be
127 shown as the selected window when the minibuffer is selected. */
128
129 Lisp_Object minibuf_selected_window;
130
131 /* Non-nil means it is the window for C-M-v to scroll
132 when the mini-buffer is selected. */
133
134 Lisp_Object Vminibuf_scroll_window;
135
136 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
137
138 Lisp_Object Vother_window_scroll_buffer;
139
140 /* Non-nil means it's function to call to display temp buffers. */
141
142 Lisp_Object Vtemp_buffer_show_function;
143
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;
148
149 /* If a window gets smaller than either of these, it is removed. */
150
151 EMACS_INT window_min_height;
152 EMACS_INT window_min_width;
153
154 /* Nonzero implies Fdisplay_buffer should create windows. */
155
156 int pop_up_windows;
157
158 /* Nonzero implies make new frames for Fdisplay_buffer. */
159
160 int pop_up_frames;
161
162 /* Nonzero means reuse existing frames for displaying buffers. */
163
164 int display_buffer_reuse_frames;
165
166 /* Non-nil means use this function instead of default */
167
168 Lisp_Object Vpop_up_frame_function;
169
170 /* Function to call to handle Fdisplay_buffer. */
171
172 Lisp_Object Vdisplay_buffer_function;
173
174 /* Non-nil means that Fdisplay_buffer should even the heights of windows. */
175
176 Lisp_Object Veven_window_heights;
177
178 /* List of buffer *names* for buffers that should have their own frames. */
179
180 Lisp_Object Vspecial_display_buffer_names;
181
182 /* List of regexps for buffer names that should have their own frames. */
183
184 Lisp_Object Vspecial_display_regexps;
185
186 /* Function to pop up a special frame. */
187
188 Lisp_Object Vspecial_display_function;
189
190 /* List of buffer *names* for buffers to appear in selected window. */
191
192 Lisp_Object Vsame_window_buffer_names;
193
194 /* List of regexps for buffer names to appear in selected window. */
195
196 Lisp_Object Vsame_window_regexps;
197
198 /* Hook run at end of temp_output_buffer_show. */
199
200 Lisp_Object Qtemp_buffer_show_hook;
201
202 /* Fdisplay_buffer always splits the largest window
203 if that window is more than this high. */
204
205 EMACS_INT split_height_threshold;
206
207 /* Number of lines of continuity in scrolling by screenfuls. */
208
209 EMACS_INT next_screen_context_lines;
210
211 /* Incremented for each window created. */
212
213 static int sequence_number;
214
215 /* Nonzero after init_window_once has finished. */
216
217 static int window_initialized;
218
219 /* Hook to run when window config changes. */
220
221 Lisp_Object Qwindow_configuration_change_hook;
222 Lisp_Object Vwindow_configuration_change_hook;
223
224 /* Nonzero means scroll commands try to put point
225 at the same screen height as previously. */
226
227 Lisp_Object Vscroll_preserve_screen_position;
228
229 #if 0 /* This isn't used anywhere. */
230 /* Nonzero means we can split a frame even if it is "unsplittable". */
231 static int inhibit_frame_unsplittable;
232 #endif /* 0 */
233
234 extern EMACS_INT scroll_margin;
235
236 extern Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
237 \f
238 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
239 doc: /* Returns t if OBJECT is a window. */)
240 (object)
241 Lisp_Object object;
242 {
243 return WINDOWP (object) ? Qt : Qnil;
244 }
245
246 DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
247 doc: /* Returns t if OBJECT is a window which is currently visible. */)
248 (object)
249 Lisp_Object object;
250 {
251 return WINDOW_LIVE_P (object) ? Qt : Qnil;
252 }
253
254 Lisp_Object
255 make_window ()
256 {
257 Lisp_Object val;
258 register struct window *p;
259
260 p = allocate_window ();
261 XSETFASTINT (p->sequence_number, ++sequence_number);
262 XSETFASTINT (p->left, 0);
263 XSETFASTINT (p->top, 0);
264 XSETFASTINT (p->height, 0);
265 XSETFASTINT (p->width, 0);
266 XSETFASTINT (p->hscroll, 0);
267 XSETFASTINT (p->min_hscroll, 0);
268 p->orig_top = p->orig_height = Qnil;
269 p->start = Fmake_marker ();
270 p->pointm = Fmake_marker ();
271 XSETFASTINT (p->use_time, 0);
272 p->frame = Qnil;
273 p->display_table = Qnil;
274 p->dedicated = Qnil;
275 p->pseudo_window_p = 0;
276 bzero (&p->cursor, sizeof (p->cursor));
277 bzero (&p->last_cursor, sizeof (p->last_cursor));
278 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
279 p->desired_matrix = p->current_matrix = 0;
280 p->phys_cursor_type = -1;
281 p->phys_cursor_width = -1;
282 p->must_be_updated_p = 0;
283 XSETFASTINT (p->window_end_vpos, 0);
284 XSETFASTINT (p->window_end_pos, 0);
285 p->window_end_valid = Qnil;
286 p->vscroll = 0;
287 XSETWINDOW (val, p);
288 XSETFASTINT (p->last_point, 0);
289 p->frozen_window_start_p = 0;
290 p->height_fixed_p = 0;
291 p->last_cursor_off_p = p->cursor_off_p = 0;
292
293 Vwindow_list = Qnil;
294 return val;
295 }
296
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. */)
299 ()
300 {
301 return selected_window;
302 }
303
304 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
305 doc: /* Return the window used now for minibuffers.
306 If the optional argument FRAME is specified, return the minibuffer window
307 used by that frame. */)
308 (frame)
309 Lisp_Object frame;
310 {
311 if (NILP (frame))
312 frame = selected_frame;
313 CHECK_LIVE_FRAME (frame);
314 return FRAME_MINIBUF_WINDOW (XFRAME (frame));
315 }
316
317 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 0, 1, 0,
318 doc: /* Returns non-nil if WINDOW is a minibuffer window. */)
319 (window)
320 Lisp_Object window;
321 {
322 struct window *w = decode_window (window);
323 return MINI_WINDOW_P (w) ? Qt : Qnil;
324 }
325
326
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;
336 {
337 register struct window *w;
338 register int posint;
339 register struct buffer *buf;
340 struct text_pos top;
341 Lisp_Object in_window;
342 int fully_p;
343
344 w = decode_window (window);
345 buf = XBUFFER (w->buffer);
346 SET_TEXT_POS_FROM_MARKER (top, w->start);
347
348 if (!NILP (pos))
349 {
350 CHECK_NUMBER_COERCE_MARKER (pos);
351 posint = XINT (pos);
352 }
353 else if (w == XWINDOW (selected_window))
354 posint = PT;
355 else
356 posint = XMARKER (w->pointm)->charpos;
357
358 /* If position is above window start, it's not visible. */
359 if (posint < CHARPOS (top))
360 in_window = Qnil;
361 else if (XFASTINT (w->last_modified) >= BUF_MODIFF (buf)
362 && XFASTINT (w->last_overlay_modified) >= BUF_OVERLAY_MODIFF (buf)
363 && posint < BUF_Z (buf) - XFASTINT (w->window_end_pos))
364 {
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))
370 {
371 pos_visible_p (w, posint, &fully_p, NILP (partially));
372 in_window = fully_p ? Qt : Qnil;
373 }
374 else
375 in_window = Qt;
376 }
377 else if (posint > BUF_ZV (buf))
378 in_window = Qnil;
379 else if (CHARPOS (top) < BUF_BEGV (buf) || CHARPOS (top) > BUF_ZV (buf))
380 /* If window start is out of range, do something reasonable. */
381 in_window = Qnil;
382 else
383 {
384 if (pos_visible_p (w, posint, &fully_p, NILP (partially)))
385 in_window = !NILP (partially) || fully_p ? Qt : Qnil;
386 else
387 in_window = Qnil;
388 }
389
390 return in_window;
391 }
392
393 \f
394 static struct window *
395 decode_window (window)
396 register Lisp_Object window;
397 {
398 if (NILP (window))
399 return XWINDOW (selected_window);
400
401 CHECK_LIVE_WINDOW (window);
402 return XWINDOW (window);
403 }
404
405 DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
406 doc: /* Return the buffer that WINDOW is displaying. */)
407 (window)
408 Lisp_Object window;
409 {
410 return decode_window (window)->buffer;
411 }
412
413 DEFUN ("window-height", Fwindow_height, Swindow_height, 0, 1, 0,
414 doc: /* Return the number of lines in WINDOW (including its mode line). */)
415 (window)
416 Lisp_Object window;
417 {
418 return decode_window (window)->height;
419 }
420
421 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
422 doc: /* Return the number of display columns in WINDOW.
423 This is the width that is usable columns available for text in WINDOW.
424 If you want to find out how many columns WINDOW takes up,
425 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))). */)
426 (window)
427 Lisp_Object window;
428 {
429 return make_number (window_internal_width (decode_window (window)));
430 }
431
432 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
433 doc: /* Return the number of columns by which WINDOW is scrolled from left margin. */)
434 (window)
435 Lisp_Object window;
436 {
437 return decode_window (window)->hscroll;
438 }
439
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.
443
444 Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
445 window so that the location of point becomes invisible. */)
446 (window, ncol)
447 Lisp_Object window, ncol;
448 {
449 struct window *w = decode_window (window);
450 int hscroll;
451
452 CHECK_NUMBER (ncol);
453 hscroll = max (0, XINT (ncol));
454
455 /* Prevent redisplay shortcuts when changing the hscroll. */
456 if (XINT (w->hscroll) != hscroll)
457 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
458
459 w->hscroll = make_number (hscroll);
460 return ncol;
461 }
462
463 DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger,
464 Swindow_redisplay_end_trigger, 0, 1, 0,
465 doc: /* Return WINDOW's redisplay end trigger value.
466 See `set-window-redisplay-end-trigger' for more information. */)
467 (window)
468 Lisp_Object window;
469 {
470 return decode_window (window)->redisplay_end_trigger;
471 }
472
473 DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger,
474 Sset_window_redisplay_end_trigger, 2, 2, 0,
475 doc: /* Set WINDOW's redisplay end trigger value to VALUE.
476 VALUE should be a buffer position (typically a marker) or nil.
477 If it is a buffer position, then if redisplay in WINDOW reaches a position
478 beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
479 with two arguments: WINDOW, and the end trigger value.
480 Afterwards the end-trigger value is reset to nil. */)
481 (window, value)
482 register Lisp_Object window, value;
483 {
484 register struct window *w;
485
486 w = decode_window (window);
487 w->redisplay_end_trigger = value;
488 return value;
489 }
490
491 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
492 doc: /* Return a list of the edge coordinates of WINDOW.
493 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
494 RIGHT is one more than the rightmost column used by WINDOW,
495 and BOTTOM is one more than the bottommost row used by WINDOW
496 and its mode-line. */)
497 (window)
498 Lisp_Object window;
499 {
500 register struct window *w = decode_window (window);
501
502 return Fcons (w->left, Fcons (w->top,
503 Fcons (make_number (WINDOW_RIGHT_EDGE (w)),
504 Fcons (make_number (XFASTINT (w->top)
505 + XFASTINT (w->height)),
506 Qnil))));
507 }
508
509 /* Test if the character at column *X, row *Y is within window W.
510 If it is not, return 0;
511 if it is in the window's text area,
512 set *x and *y to its location relative to the upper left corner
513 of the window, and
514 return 1;
515 if it is on the window's modeline, return 2;
516 if it is on the border between the window and its right sibling,
517 return 3.
518 if it is on the window's top line, return 4;
519 if it is in left or right fringe of the window,
520 return 5 or 6, and convert *X and *Y to window-relative coordinates;
521 if it is in the marginal area to the left/right of the window,
522 return 7 or 8, and convert *X and *Y to window-relative coordinates.
523
524 X and Y are frame relative pixel coordinates. */
525
526 static enum window_part
527 coordinates_in_window (w, x, y)
528 register struct window *w;
529 register int *x, *y;
530 {
531 /* Let's make this a global enum later, instead of using numbers
532 everywhere. */
533 struct frame *f = XFRAME (WINDOW_FRAME (w));
534 int left_x, right_x, top_y, bottom_y;
535 enum window_part part;
536 int ux = CANON_X_UNIT (f);
537 int x0 = XFASTINT (w->left) * ux;
538 int x1 = x0 + XFASTINT (w->width) * ux;
539 /* The width of the area where the vertical line can be dragged.
540 (Between mode lines for instance. */
541 int grabbable_width = ux;
542 int lmargin_width = 0, rmargin_width = 0;
543
544 if (*x < x0 || *x >= x1)
545 return ON_NOTHING;
546
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)
550 {
551 left_x = 0;
552 right_x = XFASTINT (w->width) * CANON_X_UNIT (f) - 1;
553 top_y = WINDOW_DISPLAY_TOP_EDGE_PIXEL_Y (w);
554 bottom_y = WINDOW_DISPLAY_BOTTOM_EDGE_PIXEL_Y (w);
555 }
556 else
557 {
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);
564 }
565
566 /* On the mode line or header line? If it's near the start of
567 the mode or header line of window that's has a horizontal
568 sibling, say it's on the vertical line. That's to be able
569 to resize windows horizontally in case we're using toolkit
570 scroll bars. */
571
572 if (WINDOW_WANTS_MODELINE_P (w)
573 && *y >= bottom_y - CURRENT_MODE_LINE_HEIGHT (w)
574 && *y < bottom_y)
575 {
576 /* We're somewhere on the mode line. We consider the place
577 between mode lines of horizontally adjacent mode lines
578 as the vertical border. If scroll bars on the left,
579 return the right window. */
580 part = ON_MODE_LINE;
581
582 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
583 {
584 if (abs (*x - x0) < grabbable_width)
585 part = ON_VERTICAL_BORDER;
586 }
587 else if (!WINDOW_RIGHTMOST_P (w) && abs (*x - x1) < grabbable_width)
588 part = ON_VERTICAL_BORDER;
589 }
590 else if (WINDOW_WANTS_HEADER_LINE_P (w)
591 && *y < top_y + CURRENT_HEADER_LINE_HEIGHT (w)
592 && *y >= top_y)
593 {
594 part = ON_HEADER_LINE;
595
596 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f))
597 {
598 if (abs (*x - x0) < grabbable_width)
599 part = ON_VERTICAL_BORDER;
600 }
601 else if (!WINDOW_RIGHTMOST_P (w) && abs (*x - x1) < grabbable_width)
602 part = ON_VERTICAL_BORDER;
603 }
604 /* Outside anything interesting? */
605 else if (*y < top_y
606 || *y >= bottom_y
607 || *x < (left_x
608 - FRAME_LEFT_FRINGE_WIDTH (f)
609 - FRAME_LEFT_SCROLL_BAR_WIDTH (f) * ux)
610 || *x > (right_x
611 + FRAME_RIGHT_FRINGE_WIDTH (f)
612 + FRAME_RIGHT_SCROLL_BAR_WIDTH (f) * ux))
613 {
614 part = ON_NOTHING;
615 }
616 else if (FRAME_WINDOW_P (f))
617 {
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))
622 {
623 part = ON_VERTICAL_BORDER;
624 }
625 else if (*x < left_x || *x > right_x)
626 {
627 /* Other lines than the mode line don't include fringes and
628 scroll bars on the left. */
629
630 /* Convert X and Y to window-relative pixel coordinates. */
631 *x -= left_x;
632 *y -= top_y;
633 part = *x < left_x ? ON_LEFT_FRINGE : ON_RIGHT_FRINGE;
634 }
635 else
636 {
637 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
638 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
639 /* You can never be on a margin area if its width is zero. */
640 if (lmargin_width
641 && *x <= window_box_right (w, LEFT_MARGIN_AREA))
642 part = ON_LEFT_MARGIN;
643 else if (rmargin_width
644 && *x >= window_box_left (w, RIGHT_MARGIN_AREA))
645 part = ON_RIGHT_MARGIN;
646 else
647 {
648 part = ON_TEXT;
649 *x -= left_x;
650 *y -= top_y;
651 }
652 }
653 }
654 else
655 {
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)
659 {
660 /* Other lines than the mode line don't include fringes and
661 scroll bars on the left. */
662
663 /* Convert X and Y to window-relative pixel coordinates. */
664 *x -= left_x;
665 *y -= top_y;
666 part = *x < left_x ? ON_LEFT_FRINGE : ON_RIGHT_FRINGE;
667 }
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)
672 {
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;
676 }
677 else
678 {
679 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
680 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
681 /* You can never be on a margin area if its width is zero.
682 This is especially important for character terminals. */
683 if (lmargin_width
684 && *x <= window_box_right (w, LEFT_MARGIN_AREA))
685 part = ON_LEFT_MARGIN;
686 else if (rmargin_width
687 && *x >= window_box_left (w, RIGHT_MARGIN_AREA))
688 part = ON_RIGHT_MARGIN;
689 else
690 {
691 part = ON_TEXT;
692 /* Convert X and Y to window-relative pixel coordinates. */
693 *x -= left_x;
694 *y -= top_y;
695 }
696 }
697 }
698
699 return part;
700 }
701
702
703 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
704 Scoordinates_in_window_p, 2, 2, 0,
705 doc: /* Return non-nil if COORDINATES are in WINDOW.
706 COORDINATES is a cons of the form (X . Y), X and Y being distances
707 measured in characters from the upper-left corner of the frame.
708 \(0 . 0) denotes the character in the upper left corner of the
709 frame.
710 If COORDINATES are in the text portion of WINDOW,
711 the coordinates relative to the window are returned.
712 If they are in the mode line of WINDOW, `mode-line' is returned.
713 If they are in the top mode line of WINDOW, `header-line' is returned.
714 If they are in the left fringe of WINDOW, `left-fringe' is returned.
715 If they are in the right fringe of WINDOW, `right-fringe' is returned.
716 If they are on the border between WINDOW and its right sibling,
717 `vertical-line' is returned.
718 If they are in the windows's left or right marginal areas, `left-margin'\n\
719 or `right-margin' is returned. */)
720 (coordinates, window)
721 register Lisp_Object coordinates, window;
722 {
723 struct window *w;
724 struct frame *f;
725 int x, y;
726 Lisp_Object lx, ly;
727
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);
738
739 switch (coordinates_in_window (w, &x, &y))
740 {
741 case ON_NOTHING:
742 return Qnil;
743
744 case ON_TEXT:
745 /* X and Y are now window relative pixel coordinates. Convert
746 them to canonical char units before returning them. */
747 return Fcons (CANON_X_FROM_PIXEL_X (f, x),
748 CANON_Y_FROM_PIXEL_Y (f, y));
749
750 case ON_MODE_LINE:
751 return Qmode_line;
752
753 case ON_VERTICAL_BORDER:
754 return Qvertical_line;
755
756 case ON_HEADER_LINE:
757 return Qheader_line;
758
759 case ON_LEFT_FRINGE:
760 return Qleft_fringe;
761
762 case ON_RIGHT_FRINGE:
763 return Qright_fringe;
764
765 case ON_LEFT_MARGIN:
766 return Qleft_margin;
767
768 case ON_RIGHT_MARGIN:
769 return Qright_margin;
770
771 default:
772 abort ();
773 }
774 }
775
776
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.
780
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. */
785
786 struct check_window_data
787 {
788 Lisp_Object *window;
789 int *x, *y, *part;
790 };
791
792 static int
793 check_window_containing (w, user_data)
794 struct window *w;
795 void *user_data;
796 {
797 struct check_window_data *cw = (struct check_window_data *) user_data;
798 enum window_part found;
799 int continue_p = 1;
800
801 found = coordinates_in_window (w, cw->x, cw->y);
802 if (found != ON_NOTHING)
803 {
804 *cw->part = found - 1;
805 XSETWINDOW (*cw->window, w);
806 continue_p = 0;
807 }
808
809 return continue_p;
810 }
811
812
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.
819
820 This function was previously implemented with a loop cycling over
821 windows with Fnext_window, and starting with the frame's selected
822 window. It turned out that this doesn't work with an
823 implementation of next_window using Vwindow_list, because
824 FRAME_SELECTED_WINDOW (F) is not always contained in the window
825 tree of F when this function is called asynchronously from
826 note_mouse_highlight. The original loop didn't terminate in this
827 case. */
828
829 Lisp_Object
830 window_from_coordinates (f, x, y, part, tool_bar_p)
831 struct frame *f;
832 int x, y;
833 int *part;
834 int tool_bar_p;
835 {
836 Lisp_Object window;
837 struct check_window_data cw;
838
839 window = Qnil;
840 cw.window = &window, cw.x = &x, cw.y = &y; cw.part = part;
841 foreach_window (f, check_window_containing, &cw);
842
843 /* If not found above, see if it's in the tool bar window, if a tool
844 bar exists. */
845 if (NILP (window)
846 && tool_bar_p
847 && WINDOWP (f->tool_bar_window)
848 && XINT (XWINDOW (f->tool_bar_window)->height) > 0
849 && (coordinates_in_window (XWINDOW (f->tool_bar_window), &x, &y)
850 != ON_NOTHING))
851 {
852 *part = 0;
853 window = f->tool_bar_window;
854 }
855
856 return window;
857 }
858
859 DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
860 doc: /* Return window containing coordinates X and Y on FRAME.
861 If omitted, FRAME defaults to the currently selected frame.
862 The top left corner of the frame is considered to be row 0,
863 column 0. */)
864 (x, y, frame)
865 Lisp_Object x, y, frame;
866 {
867 int part;
868 struct frame *f;
869
870 if (NILP (frame))
871 frame = selected_frame;
872 CHECK_LIVE_FRAME (frame);
873 f = XFRAME (frame);
874
875 /* Check that arguments are integers or floats. */
876 CHECK_NUMBER_OR_FLOAT (x);
877 CHECK_NUMBER_OR_FLOAT (y);
878
879 return window_from_coordinates (f,
880 PIXEL_X_FROM_CANON_X (f, x),
881 PIXEL_Y_FROM_CANON_Y (f, y),
882 &part, 0);
883 }
884
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.
889
890 Note that, when WINDOW is the selected window and its buffer
891 is also currently selected, the value returned is the same as (point).
892 It would be more strictly correct to return the `top-level' value
893 of point, outside of any save-excursion forms.
894 But that is hard to define. */)
895 (window)
896 Lisp_Object window;
897 {
898 register struct window *w = decode_window (window);
899
900 if (w == XWINDOW (selected_window)
901 && current_buffer == XBUFFER (w->buffer))
902 return Fpoint ();
903 return Fmarker_position (w->pointm);
904 }
905
906 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
907 doc: /* Return position at which display currently starts in WINDOW.
908 This is updated by redisplay or by calling `set-window-start'. */)
909 (window)
910 Lisp_Object window;
911 {
912 return Fmarker_position (decode_window (window)->start);
913 }
914
915 /* This is text temporarily removed from the doc string below.
916
917 This function returns nil if the position is not currently known.
918 That happens when redisplay is preempted and doesn't finish.
919 If in that case you want to compute where the end of the window would
920 have been if redisplay had finished, do this:
921 (save-excursion
922 (goto-char (window-start window))
923 (vertical-motion (1- (window-height window)) window)
924 (point))") */
925
926 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 2, 0,
927 doc: /* Return position at which display currently ends in WINDOW.
928 This is updated by redisplay, when it runs to completion.
929 Simply changing the buffer text or setting `window-start'
930 does not update this value.
931 If UPDATE is non-nil, compute the up-to-date position
932 if it isn't already recorded. */)
933 (window, update)
934 Lisp_Object window, update;
935 {
936 Lisp_Object value;
937 struct window *w = decode_window (window);
938 Lisp_Object buf;
939
940 buf = w->buffer;
941 CHECK_BUFFER (buf);
942
943 #if 0 /* This change broke some things. We should make it later. */
944 /* If we don't know the end position, return nil.
945 The user can compute it with vertical-motion if he wants to.
946 It would be nicer to do it automatically,
947 but that's so slow that it would probably bother people. */
948 if (NILP (w->window_end_valid))
949 return Qnil;
950 #endif
951
952 if (! NILP (update)
953 && ! (! NILP (w->window_end_valid)
954 && XFASTINT (w->last_modified) >= MODIFF))
955 {
956 struct text_pos startp;
957 struct it it;
958 struct buffer *old_buffer = NULL, *b = XBUFFER (buf);
959
960 /* In case W->start is out of the range, use something
961 reasonable. This situation occurred when loading a file with
962 `-l' containing a call to `rmail' with subsequent other
963 commands. At the end, W->start happened to be BEG, while
964 rmail had already narrowed the buffer. */
965 if (XMARKER (w->start)->charpos < BEGV)
966 SET_TEXT_POS (startp, BEGV, BEGV_BYTE);
967 else if (XMARKER (w->start)->charpos > ZV)
968 SET_TEXT_POS (startp, ZV, ZV_BYTE);
969 else
970 SET_TEXT_POS_FROM_MARKER (startp, w->start);
971
972 /* Cannot use Fvertical_motion because that function doesn't
973 cope with variable-height lines. */
974 if (b != current_buffer)
975 {
976 old_buffer = current_buffer;
977 set_buffer_internal (b);
978 }
979
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));
985
986 if (old_buffer)
987 set_buffer_internal (old_buffer);
988 }
989 else
990 XSETINT (value, BUF_Z (XBUFFER (buf)) - XFASTINT (w->window_end_pos));
991
992 return value;
993 }
994
995 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
996 doc: /* Make point value in WINDOW be at position POS in WINDOW's buffer. */)
997 (window, pos)
998 Lisp_Object window, pos;
999 {
1000 register struct window *w = decode_window (window);
1001
1002 CHECK_NUMBER_COERCE_MARKER (pos);
1003 if (w == XWINDOW (selected_window)
1004 && XBUFFER (w->buffer) == current_buffer)
1005 Fgoto_char (pos);
1006 else
1007 set_marker_restricted (w->pointm, pos, w->buffer);
1008
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;
1013
1014 return pos;
1015 }
1016
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;
1023 {
1024 register struct window *w = decode_window (window);
1025
1026 CHECK_NUMBER_COERCE_MARKER (pos);
1027 set_marker_restricted (w->start, pos, w->buffer);
1028 /* this is not right, but much easier than doing what is right. */
1029 w->start_at_line_beg = Qnil;
1030 if (NILP (noforce))
1031 w->force_start = Qt;
1032 w->update_mode_line = Qt;
1033 XSETFASTINT (w->last_modified, 0);
1034 XSETFASTINT (w->last_overlay_modified, 0);
1035 if (!EQ (window, selected_window))
1036 windows_or_buffers_changed++;
1037
1038 return pos;
1039 }
1040
1041 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
1042 1, 1, 0,
1043 doc: /* Return WINDOW's dedicated object, usually t or nil.
1044 See also `set-window-dedicated-p'. */)
1045 (window)
1046 Lisp_Object window;
1047 {
1048 return decode_window (window)->dedicated;
1049 }
1050
1051 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
1052 Sset_window_dedicated_p, 2, 2, 0,
1053 doc: /* Control whether WINDOW is dedicated to the buffer it displays.
1054 If it is dedicated, Emacs will not automatically change
1055 which buffer appears in it.
1056 The second argument is the new value for the dedication flag;
1057 non-nil means yes. */)
1058 (window, arg)
1059 Lisp_Object window, arg;
1060 {
1061 register struct window *w = decode_window (window);
1062
1063 if (NILP (arg))
1064 w->dedicated = Qnil;
1065 else
1066 w->dedicated = Qt;
1067
1068 return w->dedicated;
1069 }
1070
1071 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
1072 0, 1, 0,
1073 doc: /* Return the display-table that WINDOW is using. */)
1074 (window)
1075 Lisp_Object window;
1076 {
1077 return decode_window (window)->display_table;
1078 }
1079
1080 /* Get the display table for use on window W. This is either W's
1081 display table or W's buffer's display table. Ignore the specified
1082 tables if they are not valid; if no valid table is specified,
1083 return 0. */
1084
1085 struct Lisp_Char_Table *
1086 window_display_table (w)
1087 struct window *w;
1088 {
1089 struct Lisp_Char_Table *dp = NULL;
1090
1091 if (DISP_TABLE_P (w->display_table))
1092 dp = XCHAR_TABLE (w->display_table);
1093 else if (BUFFERP (w->buffer))
1094 {
1095 struct buffer *b = XBUFFER (w->buffer);
1096
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);
1101 }
1102
1103 return dp;
1104 }
1105
1106 DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
1107 doc: /* Set WINDOW's display-table to TABLE. */)
1108 (window, table)
1109 register Lisp_Object window, table;
1110 {
1111 register struct window *w;
1112
1113 w = decode_window (window);
1114 w->display_table = table;
1115 return table;
1116 }
1117 \f
1118 /* Record info on buffer window w is displaying
1119 when it is about to cease to display that buffer. */
1120 static void
1121 unshow_buffer (w)
1122 register struct window *w;
1123 {
1124 Lisp_Object buf;
1125 struct buffer *b;
1126
1127 buf = w->buffer;
1128 b = XBUFFER (buf);
1129 if (b != XMARKER (w->pointm)->buffer)
1130 abort ();
1131
1132 #if 0
1133 if (w == XWINDOW (selected_window)
1134 || ! EQ (buf, XWINDOW (selected_window)->buffer))
1135 /* Do this except when the selected window's buffer
1136 is being removed from some other window. */
1137 #endif
1138 /* last_window_start records the start position that this buffer
1139 had in the last window to be disconnected from it.
1140 Now that this statement is unconditional,
1141 it is possible for the buffer to be displayed in the
1142 selected window, while last_window_start reflects another
1143 window which was recently showing the same buffer.
1144 Some people might say that might be a good thing. Let's see. */
1145 b->last_window_start = marker_position (w->start);
1146
1147 /* Point in the selected window's buffer
1148 is actually stored in that buffer, and the window's pointm isn't used.
1149 So don't clobber point in that buffer. */
1150 if (! EQ (buf, XWINDOW (selected_window)->buffer)
1151 /* This line helps to fix Horsley's testbug.el bug. */
1152 && !(WINDOWP (b->last_selected_window)
1153 && w != XWINDOW (b->last_selected_window)
1154 && EQ (buf, XWINDOW (b->last_selected_window)->buffer)))
1155 temp_set_point_both (b,
1156 clip_to_bounds (BUF_BEGV (b),
1157 XMARKER (w->pointm)->charpos,
1158 BUF_ZV (b)),
1159 clip_to_bounds (BUF_BEGV_BYTE (b),
1160 marker_byte_position (w->pointm),
1161 BUF_ZV_BYTE (b)));
1162
1163 if (WINDOWP (b->last_selected_window)
1164 && w == XWINDOW (b->last_selected_window))
1165 b->last_selected_window = Qnil;
1166 }
1167
1168 /* Put replacement into the window structure in place of old. */
1169 static void
1170 replace_window (old, replacement)
1171 Lisp_Object old, replacement;
1172 {
1173 register Lisp_Object tem;
1174 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
1175
1176 /* If OLD is its frame's root_window, then replacement is the new
1177 root_window for that frame. */
1178
1179 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
1180 FRAME_ROOT_WINDOW (XFRAME (o->frame)) = replacement;
1181
1182 p->left = o->left;
1183 p->top = o->top;
1184 p->width = o->width;
1185 p->height = o->height;
1186 p->desired_matrix = p->current_matrix = 0;
1187 p->vscroll = 0;
1188 bzero (&p->cursor, sizeof (p->cursor));
1189 bzero (&p->last_cursor, sizeof (p->last_cursor));
1190 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
1191 p->phys_cursor_type = -1;
1192 p->phys_cursor_width = -1;
1193 p->must_be_updated_p = 0;
1194 p->pseudo_window_p = 0;
1195 XSETFASTINT (p->window_end_vpos, 0);
1196 XSETFASTINT (p->window_end_pos, 0);
1197 p->window_end_valid = Qnil;
1198 p->frozen_window_start_p = 0;
1199 p->orig_top = p->orig_height = Qnil;
1200
1201 p->next = tem = o->next;
1202 if (!NILP (tem))
1203 XWINDOW (tem)->prev = replacement;
1204
1205 p->prev = tem = o->prev;
1206 if (!NILP (tem))
1207 XWINDOW (tem)->next = replacement;
1208
1209 p->parent = tem = o->parent;
1210 if (!NILP (tem))
1211 {
1212 if (EQ (XWINDOW (tem)->vchild, old))
1213 XWINDOW (tem)->vchild = replacement;
1214 if (EQ (XWINDOW (tem)->hchild, old))
1215 XWINDOW (tem)->hchild = replacement;
1216 }
1217
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. ***/
1221 }
1222
1223 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
1224 doc: /* Remove WINDOW from the display. Default is selected window. */)
1225 (window)
1226 register Lisp_Object window;
1227 {
1228 delete_window (window);
1229
1230 if (! NILP (Vwindow_configuration_change_hook)
1231 && ! NILP (Vrun_hooks))
1232 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
1233
1234 return Qnil;
1235 }
1236
1237 void
1238 delete_window (window)
1239 register Lisp_Object window;
1240 {
1241 register Lisp_Object tem, parent, sib;
1242 register struct window *p;
1243 register struct window *par;
1244 struct frame *f;
1245
1246 /* Because this function is called by other C code on non-leaf
1247 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
1248 so we can't decode_window here. */
1249 if (NILP (window))
1250 window = selected_window;
1251 else
1252 CHECK_WINDOW (window);
1253 p = XWINDOW (window);
1254
1255 /* It's okay to delete an already-deleted window. */
1256 if (NILP (p->buffer)
1257 && NILP (p->hchild)
1258 && NILP (p->vchild))
1259 return;
1260
1261 parent = p->parent;
1262 if (NILP (parent))
1263 error ("Attempt to delete minibuffer or sole ordinary window");
1264 par = XWINDOW (parent);
1265
1266 windows_or_buffers_changed++;
1267 Vwindow_list = Qnil;
1268 f = XFRAME (WINDOW_FRAME (p));
1269 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
1270
1271 /* Are we trying to delete any frame's selected window? */
1272 {
1273 Lisp_Object swindow, pwindow;
1274
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);
1279
1280 while (1)
1281 {
1282 pwindow = swindow;
1283 while (!NILP (pwindow))
1284 {
1285 if (EQ (window, pwindow))
1286 break;
1287 pwindow = XWINDOW (pwindow)->parent;
1288 }
1289
1290 /* If the window being deleted is not a parent of SWINDOW,
1291 then SWINDOW is ok as the new selected window. */
1292 if (!EQ (window, pwindow))
1293 break;
1294 /* Otherwise, try another window for SWINDOW. */
1295 swindow = Fnext_window (swindow, Qlambda, Qnil);;
1296
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");
1302 }
1303
1304 /* If we need to change SWINDOW, do it. */
1305 if (! EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1306 {
1307 /* If we're about to delete the selected window on the
1308 selected frame, then we should use Fselect_window to select
1309 the new window. On the other hand, if we're about to
1310 delete the selected window on any other frame, we shouldn't do
1311 anything but set the frame's selected_window slot. */
1312 if (EQ (FRAME_SELECTED_WINDOW (f), selected_window))
1313 Fselect_window (swindow);
1314 else
1315 FRAME_SELECTED_WINDOW (f) = swindow;
1316 }
1317 }
1318
1319 tem = p->buffer;
1320 /* tem is null for dummy parent windows
1321 (which have inferiors but not any contents themselves) */
1322 if (!NILP (tem))
1323 {
1324 unshow_buffer (p);
1325 unchain_marker (p->pointm);
1326 unchain_marker (p->start);
1327 }
1328
1329 /* Free window glyph matrices. It is sure that they are allocated
1330 again when ADJUST_GLYPHS is called. Block input so that expose
1331 events and other events that access glyph matrices are not
1332 processed while we are changing them. */
1333 BLOCK_INPUT;
1334 free_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f)));
1335
1336 tem = p->next;
1337 if (!NILP (tem))
1338 XWINDOW (tem)->prev = p->prev;
1339
1340 tem = p->prev;
1341 if (!NILP (tem))
1342 XWINDOW (tem)->next = p->next;
1343
1344 if (EQ (window, par->hchild))
1345 par->hchild = p->next;
1346 if (EQ (window, par->vchild))
1347 par->vchild = p->next;
1348
1349 /* Find one of our siblings to give our space to. */
1350 sib = p->prev;
1351 if (NILP (sib))
1352 {
1353 /* If p gives its space to its next sibling, that sibling needs
1354 to have its top/left side pulled back to where p's is.
1355 set_window_{height,width} will re-position the sibling's
1356 children. */
1357 sib = p->next;
1358 XWINDOW (sib)->top = p->top;
1359 XWINDOW (sib)->left = p->left;
1360 }
1361
1362 /* Stretch that sibling. */
1363 if (!NILP (par->vchild))
1364 set_window_height (sib,
1365 XFASTINT (XWINDOW (sib)->height) + XFASTINT (p->height),
1366 1);
1367 if (!NILP (par->hchild))
1368 set_window_width (sib,
1369 XFASTINT (XWINDOW (sib)->width) + XFASTINT (p->width),
1370 1);
1371
1372 /* If parent now has only one child,
1373 put the child into the parent's place. */
1374 tem = par->hchild;
1375 if (NILP (tem))
1376 tem = par->vchild;
1377 if (NILP (XWINDOW (tem)->next))
1378 replace_window (parent, tem);
1379
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));
1386
1387 /* Mark this window as deleted. */
1388 p->buffer = p->hchild = p->vchild = Qnil;
1389
1390 /* Adjust glyph matrices. */
1391 adjust_glyphs (f);
1392 UNBLOCK_INPUT;
1393 }
1394
1395
1396 \f
1397 /***********************************************************************
1398 Window List
1399 ***********************************************************************/
1400
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. */
1404
1405 static int
1406 add_window_to_list (w, user_data)
1407 struct window *w;
1408 void *user_data;
1409 {
1410 Lisp_Object *list = (Lisp_Object *) user_data;
1411 Lisp_Object window;
1412 XSETWINDOW (window, w);
1413 *list = Fcons (window, *list);
1414 return 1;
1415 }
1416
1417
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. */
1421
1422 static Lisp_Object
1423 window_list ()
1424 {
1425 if (!CONSP (Vwindow_list))
1426 {
1427 Lisp_Object tail;
1428
1429 Vwindow_list = Qnil;
1430 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1431 {
1432 Lisp_Object args[2];
1433
1434 /* We are visiting windows in canonical order, and add
1435 new windows at the front of args[1], which means we
1436 have to reverse this list at the end. */
1437 args[1] = Qnil;
1438 foreach_window (XFRAME (XCAR (tail)), add_window_to_list, &args[1]);
1439 args[0] = Vwindow_list;
1440 args[1] = Fnreverse (args[1]);
1441 Vwindow_list = Fnconc (2, args);
1442 }
1443 }
1444
1445 return Vwindow_list;
1446 }
1447
1448
1449 /* Value is non-zero if WINDOW satisfies the constraints given by
1450 OWINDOW, MINIBUF and ALL_FRAMES.
1451
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
1455
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. */
1462
1463 static int
1464 candidate_window_p (window, owindow, minibuf, all_frames)
1465 Lisp_Object window, owindow, minibuf, all_frames;
1466 {
1467 struct window *w = XWINDOW (window);
1468 struct frame *f = XFRAME (w->frame);
1469 int candidate_p = 1;
1470
1471 if (!BUFFERP (w->buffer))
1472 candidate_p = 0;
1473 else if (MINI_WINDOW_P (w)
1474 && (EQ (minibuf, Qlambda)
1475 || (WINDOWP (minibuf) && !EQ (minibuf, window))))
1476 {
1477 /* If MINIBUF is `lambda' don't consider any mini-windows.
1478 If it is a window, consider only that one. */
1479 candidate_p = 0;
1480 }
1481 else if (EQ (all_frames, Qt))
1482 candidate_p = 1;
1483 else if (NILP (all_frames))
1484 {
1485 xassert (WINDOWP (owindow));
1486 candidate_p = EQ (w->frame, XWINDOW (owindow)->frame);
1487 }
1488 else if (EQ (all_frames, Qvisible))
1489 {
1490 FRAME_SAMPLE_VISIBILITY (f);
1491 candidate_p = FRAME_VISIBLE_P (f);
1492 }
1493 else if (INTEGERP (all_frames) && XINT (all_frames) == 0)
1494 {
1495 FRAME_SAMPLE_VISIBILITY (f);
1496 candidate_p = FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f);
1497 }
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);
1504
1505 return candidate_p;
1506 }
1507
1508
1509 /* Decode arguments as allowed by Fnext_window, Fprevious_window, and
1510 Fwindow_list. See there for the meaning of WINDOW, MINIBUF, and
1511 ALL_FRAMES. */
1512
1513 static void
1514 decode_next_window_args (window, minibuf, all_frames)
1515 Lisp_Object *window, *minibuf, *all_frames;
1516 {
1517 if (NILP (*window))
1518 *window = selected_window;
1519 else
1520 CHECK_LIVE_WINDOW (*window);
1521
1522 /* MINIBUF nil may or may not include minibuffers. Decide if it
1523 does. */
1524 if (NILP (*minibuf))
1525 *minibuf = minibuf_level ? minibuf_window : Qlambda;
1526 else if (!EQ (*minibuf, Qt))
1527 *minibuf = Qlambda;
1528
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. */
1532
1533 /* ALL_FRAMES nil doesn't specify which frames to include. */
1534 if (NILP (*all_frames))
1535 *all_frames = (!EQ (*minibuf, Qlambda)
1536 ? FRAME_MINIBUF_WINDOW (XFRAME (XWINDOW (*window)->frame))
1537 : Qnil);
1538 else if (EQ (*all_frames, Qvisible))
1539 ;
1540 else if (XFASTINT (*all_frames) == 0)
1541 ;
1542 else if (FRAMEP (*all_frames))
1543 ;
1544 else if (!EQ (*all_frames, Qt))
1545 *all_frames = Qnil;
1546
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. */
1552 }
1553
1554
1555 /* Return the next or previous window of WINDOW in canonical ordering
1556 of windows. NEXT_P non-zero means return the next window. See the
1557 documentation string of next-window for the meaning of MINIBUF and
1558 ALL_FRAMES. */
1559
1560 static Lisp_Object
1561 next_window (window, minibuf, all_frames, next_p)
1562 Lisp_Object window, minibuf, all_frames;
1563 int next_p;
1564 {
1565 decode_next_window_args (&window, &minibuf, &all_frames);
1566
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);
1572
1573 if (next_p)
1574 {
1575 Lisp_Object list;
1576
1577 /* Find WINDOW in the list of all windows. */
1578 list = Fmemq (window, window_list ());
1579
1580 /* Scan forward from WINDOW to the end of the window list. */
1581 if (CONSP (list))
1582 for (list = XCDR (list); CONSP (list); list = XCDR (list))
1583 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1584 break;
1585
1586 /* Scan from the start of the window list up to WINDOW. */
1587 if (!CONSP (list))
1588 for (list = Vwindow_list;
1589 CONSP (list) && !EQ (XCAR (list), window);
1590 list = XCDR (list))
1591 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1592 break;
1593
1594 if (CONSP (list))
1595 window = XCAR (list);
1596 }
1597 else
1598 {
1599 Lisp_Object candidate, list;
1600
1601 /* Scan through the list of windows for candidates. If there are
1602 candidate windows in front of WINDOW, the last one of these
1603 is the one we want. If there are candidates following WINDOW
1604 in the list, again the last one of these is the one we want. */
1605 candidate = Qnil;
1606 for (list = window_list (); CONSP (list); list = XCDR (list))
1607 {
1608 if (EQ (XCAR (list), window))
1609 {
1610 if (WINDOWP (candidate))
1611 break;
1612 }
1613 else if (candidate_window_p (XCAR (list), window, minibuf,
1614 all_frames))
1615 candidate = XCAR (list);
1616 }
1617
1618 if (WINDOWP (candidate))
1619 window = candidate;
1620 }
1621
1622 return window;
1623 }
1624
1625
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.
1629
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.
1634
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.
1640
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.
1647
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;
1654 {
1655 return next_window (window, minibuf, all_frames, 1);
1656 }
1657
1658
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.
1662
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.
1667
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
1673
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.
1680
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;
1687 {
1688 return next_window (window, minibuf, all_frames, 0);
1689 }
1690
1691
1692 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
1693 doc: /* Select the ARG'th different window on this frame.
1694 All windows on current frame are arranged in a cyclic order.
1695 This command selects the window ARG steps away in that order.
1696 A negative ARG moves in the opposite order. If the optional second
1697 argument ALL_FRAMES is non-nil, cycle through all frames. */)
1698 (arg, all_frames)
1699 Lisp_Object arg, all_frames;
1700 {
1701 Lisp_Object window;
1702 int i;
1703
1704 CHECK_NUMBER (arg);
1705 window = selected_window;
1706
1707 for (i = XINT (arg); i > 0; --i)
1708 window = Fnext_window (window, Qnil, all_frames);
1709 for (; i < 0; ++i)
1710 window = Fprevious_window (window, Qnil, all_frames);
1711
1712 Fselect_window (window);
1713 return Qnil;
1714 }
1715
1716
1717 DEFUN ("window-list", Fwindow_list, Swindow_list, 0, 3, 0,
1718 doc: /* Return a list of windows on FRAME, starting with WINDOW.
1719 FRAME nil or omitted means use the selected frame.
1720 WINDOW nil or omitted means use the selected window.
1721 MINIBUF t means include the minibuffer window, even if it isn't active.
1722 MINIBUF nil or omitted means include the minibuffer window only
1723 if it's active.
1724 MINIBUF neither nil nor t means never include the minibuffer window. */)
1725 (frame, minibuf, window)
1726 Lisp_Object frame, minibuf, window;
1727 {
1728 if (NILP (window))
1729 window = selected_window;
1730 if (NILP (frame))
1731 frame = selected_frame;
1732
1733 if (!EQ (frame, XWINDOW (window)->frame))
1734 error ("Window is on a different frame");
1735
1736 return window_list_1 (window, minibuf, frame);
1737 }
1738
1739
1740 /* Return a list of windows in canonical ordering. Arguments are like
1741 for `next-window'. */
1742
1743 static Lisp_Object
1744 window_list_1 (window, minibuf, all_frames)
1745 Lisp_Object window, minibuf, all_frames;
1746 {
1747 Lisp_Object tail, list;
1748
1749 decode_next_window_args (&window, &minibuf, &all_frames);
1750 list = Qnil;
1751
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);
1755
1756 return Fnreverse (list);
1757 }
1758
1759
1760 \f
1761 /* Look at all windows, performing an operation specified by TYPE
1762 with argument OBJ.
1763 If FRAMES is Qt, look at all frames;
1764 Qnil, look at just the selected frame;
1765 Qvisible, look at visible frames;
1766 a frame, just look at windows on that frame.
1767 If MINI is non-zero, perform the operation on minibuffer windows too. */
1768
1769 enum window_loop
1770 {
1771 WINDOW_LOOP_UNUSED,
1772 GET_BUFFER_WINDOW, /* Arg is buffer */
1773 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
1774 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
1775 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
1776 GET_LARGEST_WINDOW,
1777 UNSHOW_BUFFER, /* Arg is buffer */
1778 CHECK_ALL_WINDOWS
1779 };
1780
1781 static Lisp_Object
1782 window_loop (type, obj, mini, frames)
1783 enum window_loop type;
1784 Lisp_Object obj, frames;
1785 int mini;
1786 {
1787 Lisp_Object window, windows, best_window, frame_arg;
1788 struct frame *f;
1789 struct gcpro gcpro1;
1790
1791 /* If we're only looping through windows on a particular frame,
1792 frame points to that frame. If we're looping through windows
1793 on all frames, frame is 0. */
1794 if (FRAMEP (frames))
1795 f = XFRAME (frames);
1796 else if (NILP (frames))
1797 f = SELECTED_FRAME ();
1798 else
1799 f = NULL;
1800
1801 if (f)
1802 frame_arg = Qlambda;
1803 else if (XFASTINT (frames) == 0)
1804 frame_arg = frames;
1805 else if (EQ (frames, Qvisible))
1806 frame_arg = frames;
1807 else
1808 frame_arg = Qt;
1809
1810 /* frame_arg is Qlambda to stick to one frame,
1811 Qvisible to consider all visible frames,
1812 or Qt otherwise. */
1813
1814 /* Pick a window to start with. */
1815 if (WINDOWP (obj))
1816 window = obj;
1817 else if (f)
1818 window = FRAME_SELECTED_WINDOW (f);
1819 else
1820 window = FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
1821
1822 windows = window_list_1 (window, mini ? Qt : Qnil, frame_arg);
1823 GCPRO1 (windows);
1824 best_window = Qnil;
1825
1826 for (; CONSP (windows); windows = CDR (windows))
1827 {
1828 struct window *w;
1829
1830 window = XCAR (windows);
1831 w = XWINDOW (window);
1832
1833 /* Note that we do not pay attention here to whether the frame
1834 is visible, since Fwindow_list skips non-visible frames if
1835 that is desired, under the control of frame_arg. */
1836 if (!MINI_WINDOW_P (w)
1837 /* For UNSHOW_BUFFER, we must always consider all windows. */
1838 || type == UNSHOW_BUFFER
1839 || (mini && minibuf_level > 0))
1840 switch (type)
1841 {
1842 case GET_BUFFER_WINDOW:
1843 if (EQ (w->buffer, obj)
1844 /* Don't find any minibuffer window
1845 except the one that is currently in use. */
1846 && (MINI_WINDOW_P (w)
1847 ? EQ (window, minibuf_window)
1848 : 1))
1849 {
1850 if (NILP (best_window))
1851 best_window = window;
1852 else if (EQ (window, selected_window))
1853 /* For compatibility with 20.x, prefer to return
1854 selected-window. */
1855 best_window = window;
1856 }
1857 break;
1858
1859 case GET_LRU_WINDOW:
1860 /* t as arg means consider only full-width windows */
1861 if (!NILP (obj) && !WINDOW_FULL_WIDTH_P (w))
1862 break;
1863 /* Ignore dedicated windows and minibuffers. */
1864 if (MINI_WINDOW_P (w) || !NILP (w->dedicated))
1865 break;
1866 if (NILP (best_window)
1867 || (XFASTINT (XWINDOW (best_window)->use_time)
1868 > XFASTINT (w->use_time)))
1869 best_window = window;
1870 break;
1871
1872 case DELETE_OTHER_WINDOWS:
1873 if (!EQ (window, obj))
1874 Fdelete_window (window);
1875 break;
1876
1877 case DELETE_BUFFER_WINDOWS:
1878 if (EQ (w->buffer, obj))
1879 {
1880 struct frame *f = XFRAME (WINDOW_FRAME (w));
1881
1882 /* If this window is dedicated, and in a frame of its own,
1883 kill the frame. */
1884 if (EQ (window, FRAME_ROOT_WINDOW (f))
1885 && !NILP (w->dedicated)
1886 && other_visible_frames (f))
1887 {
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);
1894
1895 /* Now we can safely delete the frame. */
1896 Fdelete_frame (w->frame, Qnil);
1897 }
1898 else if (NILP (w->parent))
1899 {
1900 /* If we're deleting the buffer displayed in the
1901 only window on the frame, find a new buffer to
1902 display there. */
1903 Lisp_Object buffer;
1904 buffer = Fother_buffer (obj, Qnil, w->frame);
1905 Fset_window_buffer (window, buffer);
1906 if (EQ (window, selected_window))
1907 Fset_buffer (w->buffer);
1908 }
1909 else
1910 Fdelete_window (window);
1911 }
1912 break;
1913
1914 case GET_LARGEST_WINDOW:
1915 {
1916 /* Ignore dedicated windows and minibuffers. */
1917 if (MINI_WINDOW_P (w) || !NILP (w->dedicated))
1918 break;
1919
1920 if (NILP (best_window))
1921 best_window = window;
1922 else
1923 {
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;
1928 }
1929 }
1930 break;
1931
1932 case UNSHOW_BUFFER:
1933 if (EQ (w->buffer, obj))
1934 {
1935 Lisp_Object buffer;
1936 struct frame *f = XFRAME (w->frame);
1937
1938 /* Find another buffer to show in this window. */
1939 buffer = Fother_buffer (obj, Qnil, w->frame);
1940
1941 /* If this window is dedicated, and in a frame of its own,
1942 kill the frame. */
1943 if (EQ (window, FRAME_ROOT_WINDOW (f))
1944 && !NILP (w->dedicated)
1945 && other_visible_frames (f))
1946 {
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);
1953
1954 /* Now we can safely delete the frame. */
1955 Fdelete_frame (w->frame, Qnil);
1956 }
1957 else
1958 {
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);
1964 }
1965 }
1966 break;
1967
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))
1972 abort ();
1973 break;
1974
1975 case WINDOW_LOOP_UNUSED:
1976 break;
1977 }
1978 }
1979
1980 UNGCPRO;
1981 return best_window;
1982 }
1983
1984 /* Used for debugging. Abort if any window has a dead buffer. */
1985
1986 void
1987 check_all_windows ()
1988 {
1989 window_loop (CHECK_ALL_WINDOWS, Qnil, 1, Qt);
1990 }
1991
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. */)
1999 (frame)
2000 Lisp_Object frame;
2001 {
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))
2006 return w;
2007 /* If none of them, try the rest */
2008 return window_loop (GET_LRU_WINDOW, Qnil, 0, frame);
2009 }
2010
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. */)
2018 (frame)
2019 Lisp_Object frame;
2020 {
2021 return window_loop (GET_LARGEST_WINDOW, Qnil, 0,
2022 frame);
2023 }
2024
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. */)
2032 (buffer, frame)
2033 Lisp_Object buffer, frame;
2034 {
2035 buffer = Fget_buffer (buffer);
2036 if (BUFFERP (buffer))
2037 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
2038 else
2039 return Qnil;
2040 }
2041
2042 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
2043 0, 1, "",
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. */)
2052 (window)
2053 Lisp_Object window;
2054 {
2055 struct window *w;
2056 int startpos;
2057 int top, new_top;
2058
2059 if (NILP (window))
2060 window = selected_window;
2061 else
2062 CHECK_LIVE_WINDOW (window);
2063 w = XWINDOW (window);
2064
2065 startpos = marker_position (w->start);
2066 top = XFASTINT (w->top) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2067
2068 if (MINI_WINDOW_P (w) && top > 0)
2069 error ("Can't expand minibuffer to full frame");
2070
2071 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
2072
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)));
2079 if (new_top != top
2080 && startpos >= BUF_BEGV (XBUFFER (w->buffer))
2081 && startpos <= BUF_ZV (XBUFFER (w->buffer)))
2082 {
2083 struct position pos;
2084 struct buffer *obuf = current_buffer;
2085
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);
2090
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
2095 : Qnil);
2096 /* We need to do this, so that the window-scroll-functions
2097 get called. */
2098 w->optional_new_start = Qt;
2099
2100 set_buffer_internal (obuf);
2101 }
2102
2103 return Qnil;
2104 }
2105
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. */)
2115 (buffer, frame)
2116 Lisp_Object buffer, frame;
2117 {
2118 /* FRAME uses t and nil to mean the opposite of what window_loop
2119 expects. */
2120 if (NILP (frame))
2121 frame = Qt;
2122 else if (EQ (frame, Qt))
2123 frame = Qnil;
2124
2125 if (!NILP (buffer))
2126 {
2127 buffer = Fget_buffer (buffer);
2128 CHECK_BUFFER (buffer);
2129 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
2130 }
2131
2132 return Qnil;
2133 }
2134
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. */)
2139 (buffer)
2140 Lisp_Object buffer;
2141 {
2142 if (!NILP (buffer))
2143 {
2144 buffer = Fget_buffer (buffer);
2145 CHECK_BUFFER (buffer);
2146 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
2147 }
2148 return Qnil;
2149 }
2150
2151 /* Replace BUFFER with some other buffer in all windows
2152 of all frames, even those on other keyboards. */
2153
2154 void
2155 replace_buffer_in_all_windows (buffer)
2156 Lisp_Object buffer;
2157 {
2158 #ifdef MULTI_KBOARD
2159 Lisp_Object tail, frame;
2160
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);
2166 #else
2167 window_loop (UNSHOW_BUFFER, buffer, 1, Qt);
2168 #endif
2169 }
2170 \f
2171 /* Set the height of WINDOW and all its inferiors. */
2172
2173 /* The smallest acceptable dimensions for a window. Anything smaller
2174 might crash Emacs. */
2175
2176 #define MIN_SAFE_WINDOW_WIDTH (2)
2177 #define MIN_SAFE_WINDOW_HEIGHT (1)
2178
2179 /* Make sure that window_min_height and window_min_width are
2180 not too small; if they are, set them to safe minima. */
2181
2182 static void
2183 check_min_window_sizes ()
2184 {
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;
2190 }
2191
2192 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
2193 minimum allowable size. */
2194
2195 void
2196 check_frame_size (frame, rows, cols)
2197 FRAME_PTR frame;
2198 int *rows, *cols;
2199 {
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. */
2203 int min_height
2204 = ((FRAME_MINIBUF_ONLY_P (frame) || ! FRAME_HAS_MINIBUF_P (frame))
2205 ? MIN_SAFE_WINDOW_HEIGHT
2206 : 2 * MIN_SAFE_WINDOW_HEIGHT);
2207
2208 if (FRAME_TOP_MARGIN (frame) > 0)
2209 min_height += FRAME_TOP_MARGIN (frame);
2210
2211 if (*rows < min_height)
2212 *rows = min_height;
2213 if (*cols < MIN_SAFE_WINDOW_WIDTH)
2214 *cols = MIN_SAFE_WINDOW_WIDTH;
2215 }
2216
2217
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
2222 either. */
2223
2224 static int
2225 window_fixed_size_p (w, width_p, check_siblings_p)
2226 struct window *w;
2227 int width_p, check_siblings_p;
2228 {
2229 int fixed_p;
2230 struct window *c;
2231
2232 if (!NILP (w->hchild))
2233 {
2234 c = XWINDOW (w->hchild);
2235
2236 if (width_p)
2237 {
2238 /* A horiz. combination is fixed-width if all of if its
2239 children are. */
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;
2243 }
2244 else
2245 {
2246 /* A horiz. combination is fixed-height if one of if its
2247 children is. */
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;
2251 }
2252 }
2253 else if (!NILP (w->vchild))
2254 {
2255 c = XWINDOW (w->vchild);
2256
2257 if (width_p)
2258 {
2259 /* A vert. combination is fixed-width if one of if its
2260 children is. */
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;
2264 }
2265 else
2266 {
2267 /* A vert. combination is fixed-height if all of if its
2268 children are. */
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;
2272 }
2273 }
2274 else if (BUFFERP (w->buffer))
2275 {
2276 if (w->height_fixed_p && !width_p)
2277 fixed_p = 1;
2278 else
2279 {
2280 struct buffer *old = current_buffer;
2281 Lisp_Object val;
2282
2283 current_buffer = XBUFFER (w->buffer);
2284 val = find_symbol_value (Qwindow_size_fixed);
2285 current_buffer = old;
2286
2287 fixed_p = 0;
2288 if (!EQ (val, Qunbound))
2289 {
2290 fixed_p = !NILP (val);
2291
2292 if (fixed_p
2293 && ((EQ (val, Qheight) && width_p)
2294 || (EQ (val, Qwidth) && !width_p)))
2295 fixed_p = 0;
2296 }
2297 }
2298
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))
2302 {
2303 Lisp_Object child;
2304
2305 for (child = w->prev; !NILP (child); child = XWINDOW (child)->prev)
2306 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2307 break;
2308
2309 if (NILP (child))
2310 for (child = w->next; !NILP (child); child = XWINDOW (child)->next)
2311 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2312 break;
2313
2314 if (NILP (child))
2315 fixed_p = 1;
2316 }
2317 }
2318 else
2319 fixed_p = 1;
2320
2321 return fixed_p;
2322 }
2323
2324
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. */
2329
2330 static int
2331 window_min_size_1 (w, width_p)
2332 struct window *w;
2333 int width_p;
2334 {
2335 struct window *c;
2336 int size;
2337
2338 if (!NILP (w->hchild))
2339 {
2340 c = XWINDOW (w->hchild);
2341 size = 0;
2342
2343 if (width_p)
2344 {
2345 /* The min width of a horizontal combination is
2346 the sum of the min widths of its children. */
2347 while (c)
2348 {
2349 size += window_min_size_1 (c, width_p);
2350 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2351 }
2352 }
2353 else
2354 {
2355 /* The min height a horizontal combination equals
2356 the maximum of all min height of its children. */
2357 while (c)
2358 {
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;
2362 }
2363 }
2364 }
2365 else if (!NILP (w->vchild))
2366 {
2367 c = XWINDOW (w->vchild);
2368 size = 0;
2369
2370 if (width_p)
2371 {
2372 /* The min width of a vertical combination is
2373 the maximum of the min widths of its children. */
2374 while (c)
2375 {
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;
2379 }
2380 }
2381 else
2382 {
2383 /* The min height of a vertical combination equals
2384 the sum of the min height of its children. */
2385 while (c)
2386 {
2387 size += window_min_size_1 (c, width_p);
2388 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2389 }
2390 }
2391 }
2392 else
2393 {
2394 if (width_p)
2395 size = window_min_width;
2396 else
2397 {
2398 if (MINI_WINDOW_P (w)
2399 || (!WINDOW_WANTS_MODELINE_P (w)
2400 && !WINDOW_WANTS_HEADER_LINE_P (w)))
2401 size = 1;
2402 else
2403 size = window_min_height;
2404 }
2405 }
2406
2407 return size;
2408 }
2409
2410
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. */
2416
2417 static int
2418 window_min_size (w, width_p, ignore_fixed_p, fixed)
2419 struct window *w;
2420 int width_p, ignore_fixed_p, *fixed;
2421 {
2422 int size, fixed_p;
2423
2424 if (ignore_fixed_p)
2425 fixed_p = 0;
2426 else
2427 fixed_p = window_fixed_size_p (w, width_p, 1);
2428
2429 if (fixed)
2430 *fixed = fixed_p;
2431
2432 if (fixed_p)
2433 size = width_p ? XFASTINT (w->width) : XFASTINT (w->height);
2434 else
2435 size = window_min_size_1 (w, width_p);
2436
2437 return size;
2438 }
2439
2440
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.
2446
2447 If NODELETE_P is 2, that means we do delete windows that are
2448 too small, even if they were too small before! */
2449
2450 static void
2451 size_window (window, size, width_p, nodelete_p)
2452 Lisp_Object window;
2453 int size, width_p, nodelete_p;
2454 {
2455 struct window *w = XWINDOW (window);
2456 struct window *c;
2457 Lisp_Object child, *forward, *sideward;
2458 int old_size, min_size;
2459
2460 if (nodelete_p == 2)
2461 nodelete_p = 0;
2462
2463 check_min_window_sizes ();
2464 size = max (0, size);
2465
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. */
2469 if (width_p)
2470 {
2471 old_size = XINT (w->width);
2472 min_size = window_min_width;
2473 }
2474 else
2475 {
2476 old_size = XINT (w->height);
2477 min_size = window_min_height;
2478 }
2479
2480 if (old_size < min_size && nodelete_p != 2)
2481 w->too_small_ok = Qt;
2482
2483 /* Maybe delete WINDOW if it's too small. */
2484 if (nodelete_p != 1 && !NILP (w->parent))
2485 {
2486 if (!MINI_WINDOW_P (w) && !NILP (w->too_small_ok))
2487 min_size = width_p ? MIN_SAFE_WINDOW_WIDTH : MIN_SAFE_WINDOW_HEIGHT;
2488 else
2489 min_size = width_p ? window_min_width : window_min_height;
2490
2491 if (size < min_size)
2492 {
2493 delete_window (window);
2494 return;
2495 }
2496 }
2497
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;
2503
2504 if (width_p)
2505 {
2506 sideward = &w->vchild;
2507 forward = &w->hchild;
2508 w->width = make_number (size);
2509 }
2510 else
2511 {
2512 sideward = &w->hchild;
2513 forward = &w->vchild;
2514 w->height = make_number (size);
2515 w->orig_height = Qnil;
2516 }
2517
2518 if (!NILP (*sideward))
2519 {
2520 for (child = *sideward; !NILP (child); child = c->next)
2521 {
2522 c = XWINDOW (child);
2523 if (width_p)
2524 c->left = w->left;
2525 else
2526 c->top = w->top;
2527 size_window (child, size, width_p, nodelete_p);
2528 }
2529 }
2530 else if (!NILP (*forward))
2531 {
2532 int fixed_size, each, extra, n;
2533 int resize_fixed_p, nfixed;
2534 int last_pos, first_pos, nchildren, total;
2535
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)
2540 {
2541 int child_size;
2542
2543 c = XWINDOW (child);
2544 child_size = width_p ? XINT (c->width) : XINT (c->height);
2545 total += child_size;
2546
2547 if (window_fixed_size_p (c, width_p, 0))
2548 {
2549 fixed_size += child_size;
2550 ++nfixed;
2551 }
2552 }
2553
2554 /* If the new size is smaller than fixed_size, or if there
2555 aren't any resizable windows, allow resizing fixed-size
2556 windows. */
2557 resize_fixed_p = nfixed == nchildren || size < fixed_size;
2558
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;
2564
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)
2569 {
2570 int new_size, old_size;
2571
2572 c = XWINDOW (child);
2573 old_size = width_p ? XFASTINT (c->width) : XFASTINT (c->height);
2574 new_size = old_size;
2575
2576 /* The top or left edge position of this child equals the
2577 bottom or right edge of its predecessor. */
2578 if (width_p)
2579 c->left = make_number (last_pos);
2580 else
2581 c->top = make_number (last_pos);
2582
2583 /* If this child can be resized, do it. */
2584 if (resize_fixed_p || !window_fixed_size_p (c, width_p, 0))
2585 {
2586 new_size = old_size + each + extra;
2587 extra = 0;
2588 }
2589
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);
2594
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;
2598 }
2599
2600 /* We should have covered the parent exactly with child windows. */
2601 xassert (size == last_pos - first_pos);
2602
2603 /* Now delete any children that became too small. */
2604 if (!nodelete_p)
2605 for (child = *forward; !NILP (child); child = c->next)
2606 {
2607 int child_size;
2608 c = XWINDOW (child);
2609 child_size = width_p ? XINT (c->width) : XINT (c->height);
2610 size_window (child, child_size, width_p, 2);
2611 }
2612 }
2613 }
2614
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.) */
2619
2620 void
2621 set_window_height (window, height, nodelete)
2622 Lisp_Object window;
2623 int height;
2624 int nodelete;
2625 {
2626 size_window (window, height, 0, nodelete);
2627 }
2628
2629
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.) */
2634
2635 void
2636 set_window_width (window, width, nodelete)
2637 Lisp_Object window;
2638 int width;
2639 int nodelete;
2640 {
2641 size_window (window, width, 1, nodelete);
2642 }
2643
2644 \f
2645 int window_select_count;
2646
2647 Lisp_Object
2648 Fset_window_buffer_unwind (obuf)
2649 Lisp_Object obuf;
2650 {
2651 Fset_buffer (obuf);
2652 return Qnil;
2653 }
2654
2655
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. */
2659
2660 void
2661 set_window_buffer (window, buffer, run_hooks_p)
2662 Lisp_Object window, buffer;
2663 int run_hooks_p;
2664 {
2665 struct window *w = XWINDOW (window);
2666 struct buffer *b = XBUFFER (buffer);
2667 int count = SPECPDL_INDEX ();
2668
2669 w->buffer = buffer;
2670
2671 if (EQ (window, selected_window))
2672 b->last_selected_window = window;
2673
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 ();
2678
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);
2684 w->vscroll = 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),
2688 buffer);
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++;
2694
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)
2703 {
2704 record_unwind_protect (Fset_window_buffer_unwind, Fcurrent_buffer ());
2705 Fset_buffer (buffer);
2706 }
2707
2708 /* Set left and right marginal area width from buffer. */
2709 Fset_window_margins (window, b->left_margin_width, b->right_margin_width);
2710
2711 if (run_hooks_p)
2712 {
2713 if (! NILP (Vwindow_scroll_functions))
2714 run_hook_with_args_2 (Qwindow_scroll_functions, window,
2715 Fmarker_position (w->start));
2716
2717 if (! NILP (Vwindow_configuration_change_hook)
2718 && ! NILP (Vrun_hooks))
2719 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
2720 }
2721
2722 unbind_to (count, Qnil);
2723 }
2724
2725
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. */)
2729 (window, buffer)
2730 register Lisp_Object window, buffer;
2731 {
2732 register Lisp_Object tem;
2733 register struct window *w = decode_window (window);
2734
2735 XSETWINDOW (window, w);
2736 buffer = Fget_buffer (buffer);
2737 CHECK_BUFFER (buffer);
2738
2739 if (NILP (XBUFFER (buffer)->name))
2740 error ("Attempt to display deleted buffer");
2741
2742 tem = w->buffer;
2743 if (NILP (tem))
2744 error ("Window is deleted");
2745 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
2746 is first being set up. */
2747 {
2748 if (!NILP (w->dedicated) && !EQ (tem, buffer))
2749 error ("Window is dedicated to `%s'",
2750 SDATA (XBUFFER (tem)->name));
2751
2752 unshow_buffer (w);
2753 }
2754
2755 set_window_buffer (window, buffer, 1);
2756 return Qnil;
2757 }
2758
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. */)
2764 (window)
2765 register Lisp_Object window;
2766 {
2767 return select_window_1 (window, 1);
2768 }
2769 \f
2770 /* Note that selected_window can be nil
2771 when this is called from Fset_window_configuration. */
2772
2773 static Lisp_Object
2774 select_window_1 (window, recordflag)
2775 register Lisp_Object window;
2776 int recordflag;
2777 {
2778 register struct window *w;
2779 register struct window *ow;
2780 struct frame *sf;
2781
2782 CHECK_LIVE_WINDOW (window);
2783
2784 w = XWINDOW (window);
2785 w->frozen_window_start_p = 0;
2786
2787 XSETFASTINT (w->use_time, ++window_select_count);
2788 if (EQ (window, selected_window))
2789 return window;
2790
2791 if (!NILP (selected_window))
2792 {
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)));
2798 }
2799
2800 selected_window = window;
2801 sf = SELECTED_FRAME ();
2802 if (XFRAME (WINDOW_FRAME (w)) != sf)
2803 {
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
2808 frame is active. */
2809 Fselect_frame (WINDOW_FRAME (w), Qnil);
2810 }
2811 else
2812 sf->selected_window = window;
2813
2814 if (recordflag)
2815 record_buffer (w->buffer);
2816 Fset_buffer (w->buffer);
2817
2818 XBUFFER (w->buffer)->last_selected_window = window;
2819
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. */
2825 {
2826 register int new_point = marker_position (w->pointm);
2827 if (new_point < BEGV)
2828 SET_PT (BEGV);
2829 else if (new_point > ZV)
2830 SET_PT (ZV);
2831 else
2832 SET_PT (new_point);
2833 }
2834
2835 windows_or_buffers_changed++;
2836 return window;
2837 }
2838 \f
2839 /* Deiconify the frame containing the window WINDOW,
2840 unless it is the selected frame;
2841 then return WINDOW.
2842
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. */
2848
2849 static Lisp_Object
2850 display_buffer_1 (window)
2851 Lisp_Object window;
2852 {
2853 Lisp_Object frame = XWINDOW (window)->frame;
2854 FRAME_PTR f = XFRAME (frame);
2855
2856 FRAME_SAMPLE_VISIBILITY (f);
2857
2858 if (!EQ (frame, selected_frame))
2859 {
2860 if (FRAME_ICONIFIED_P (f))
2861 Fmake_frame_visible (frame);
2862 else if (FRAME_VISIBLE_P (f))
2863 Fraise_frame (frame);
2864 }
2865
2866 return window;
2867 }
2868
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'. */)
2874 (buffer_name)
2875 Lisp_Object buffer_name;
2876 {
2877 Lisp_Object tem;
2878
2879 CHECK_STRING (buffer_name);
2880
2881 tem = Fmember (buffer_name, Vspecial_display_buffer_names);
2882 if (!NILP (tem))
2883 return Qt;
2884
2885 tem = Fassoc (buffer_name, Vspecial_display_buffer_names);
2886 if (!NILP (tem))
2887 return XCDR (tem);
2888
2889 for (tem = Vspecial_display_regexps; CONSP (tem); tem = XCDR (tem))
2890 {
2891 Lisp_Object car = XCAR (tem);
2892 if (STRINGP (car)
2893 && fast_string_match (car, buffer_name) >= 0)
2894 return Qt;
2895 else if (CONSP (car)
2896 && STRINGP (XCAR (car))
2897 && fast_string_match (XCAR (car), buffer_name) >= 0)
2898 return XCDR (car);
2899 }
2900 return Qnil;
2901 }
2902
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'. */)
2906 (buffer_name)
2907 Lisp_Object buffer_name;
2908 {
2909 Lisp_Object tem;
2910
2911 CHECK_STRING (buffer_name);
2912
2913 tem = Fmember (buffer_name, Vsame_window_buffer_names);
2914 if (!NILP (tem))
2915 return Qt;
2916
2917 tem = Fassoc (buffer_name, Vsame_window_buffer_names);
2918 if (!NILP (tem))
2919 return Qt;
2920
2921 for (tem = Vsame_window_regexps; CONSP (tem); tem = XCDR (tem))
2922 {
2923 Lisp_Object car = XCAR (tem);
2924 if (STRINGP (car)
2925 && fast_string_match (car, buffer_name) >= 0)
2926 return Qt;
2927 else if (CONSP (car)
2928 && STRINGP (XCAR (car))
2929 && fast_string_match (XCAR (car), buffer_name) >= 0)
2930 return Qt;
2931 }
2932 return Qnil;
2933 }
2934
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.
2947
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.
2951
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.
2960
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
2963 displayed. */)
2964 (buffer, not_this_window, frame)
2965 register Lisp_Object buffer, not_this_window, frame;
2966 {
2967 register Lisp_Object window, tem, swp;
2968 struct frame *f;
2969
2970 swp = Qnil;
2971 buffer = Fget_buffer (buffer);
2972 CHECK_BUFFER (buffer);
2973
2974 if (!NILP (Vdisplay_buffer_function))
2975 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
2976
2977 if (NILP (not_this_window)
2978 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
2979 return display_buffer_1 (selected_window);
2980
2981 /* See if the user has specified this buffer should appear
2982 in the selected window. */
2983 if (NILP (not_this_window))
2984 {
2985 swp = Fsame_window_p (XBUFFER (buffer)->name);
2986 if (!NILP (swp) && !no_switch_window (selected_window))
2987 {
2988 Fswitch_to_buffer (buffer, Qnil);
2989 return display_buffer_1 (selected_window);
2990 }
2991 }
2992
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. */
2996 if (! NILP (frame))
2997 tem = frame;
2998 else if (pop_up_frames
2999 || display_buffer_reuse_frames
3000 || last_nonminibuf_frame == 0)
3001 XSETFASTINT (tem, 0);
3002 else
3003 XSETFRAME (tem, last_nonminibuf_frame);
3004
3005 window = Fget_buffer_window (buffer, tem);
3006 if (!NILP (window)
3007 && (NILP (not_this_window) || !EQ (window, selected_window)))
3008 return display_buffer_1 (window);
3009
3010 /* Certain buffer names get special handling. */
3011 if (!NILP (Vspecial_display_function) && NILP (swp))
3012 {
3013 tem = Fspecial_display_p (XBUFFER (buffer)->name);
3014 if (EQ (tem, Qt))
3015 return call1 (Vspecial_display_function, buffer);
3016 if (CONSP (tem))
3017 return call2 (Vspecial_display_function, buffer, tem);
3018 }
3019
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)
3023 {
3024 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3025 Fset_window_buffer (window, buffer);
3026 return display_buffer_1 (window);
3027 }
3028
3029 f = SELECTED_FRAME ();
3030 if (pop_up_windows
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))
3035 {
3036 Lisp_Object frames;
3037
3038 frames = Qnil;
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;
3044
3045 /* Note that both Fget_largest_window and Fget_lru_window
3046 ignore minibuffers and dedicated windows.
3047 This means they can return nil. */
3048
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))
3052 {
3053 /* Try visible frames first. */
3054 window = Fget_largest_window (Qvisible);
3055 /* If that didn't work, try iconified frames. */
3056 if (NILP (window))
3057 window = Fget_largest_window (make_number (0));
3058 if (NILP (window))
3059 window = Fget_largest_window (Qt);
3060 }
3061 else
3062 window = Fget_largest_window (frames);
3063
3064 /* If we got a tall enough full-width window that can be split,
3065 split it. */
3066 if (!NILP (window)
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);
3071 else
3072 {
3073 Lisp_Object upper, lower, other;
3074
3075 window = Fget_lru_window (frames);
3076 /* If the LRU window is selected, and big enough,
3077 and can be split, split it. */
3078 if (!NILP (window)
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. */
3085
3086 /* Try visible frames first. */
3087 if (NILP (window))
3088 window = Fget_buffer_window (buffer, Qvisible);
3089 if (NILP (window))
3090 window = Fget_largest_window (Qvisible);
3091 /* If that didn't work, try iconified frames. */
3092 if (NILP (window))
3093 window = Fget_buffer_window (buffer, make_number (0));
3094 if (NILP (window))
3095 window = Fget_largest_window (make_number (0));
3096 /* Try invisible frames. */
3097 if (NILP (window))
3098 window = Fget_buffer_window (buffer, Qt);
3099 if (NILP (window))
3100 window = Fget_largest_window (Qt);
3101 /* As a last resort, make a new frame. */
3102 if (NILP (window))
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;
3111 if (!NILP (other)
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)))
3117 {
3118 int total = (XFASTINT (XWINDOW (other)->height)
3119 + XFASTINT (XWINDOW (window)->height));
3120 enlarge_window (upper,
3121 total / 2 - XFASTINT (XWINDOW (upper)->height),
3122 0, 0);
3123 }
3124 }
3125 }
3126 else
3127 window = Fget_lru_window (Qnil);
3128
3129 Fset_window_buffer (window, buffer);
3130 return display_buffer_1 (window);
3131 }
3132
3133 void
3134 temp_output_buffer_show (buf)
3135 register Lisp_Object buf;
3136 {
3137 register struct buffer *old = current_buffer;
3138 register Lisp_Object window;
3139 register struct window *w;
3140
3141 XBUFFER (buf)->directory = current_buffer->directory;
3142
3143 Fset_buffer (buf);
3144 BUF_SAVE_MODIFF (XBUFFER (buf)) = MODIFF;
3145 BEGV = BEG;
3146 ZV = Z;
3147 SET_PT (BEG);
3148 #if 0 /* rms: there should be no reason for this. */
3149 XBUFFER (buf)->prevent_redisplay_optimizations_p = 1;
3150 #endif
3151 set_buffer_internal (old);
3152
3153 if (!EQ (Vtemp_buffer_show_function, Qnil))
3154 call1 (Vtemp_buffer_show_function, buf);
3155 else
3156 {
3157 window = Fdisplay_buffer (buf, Qnil, Qnil);
3158
3159 if (!EQ (XWINDOW (window)->frame, selected_frame))
3160 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
3161 Vminibuf_scroll_window = window;
3162 w = XWINDOW (window);
3163 XSETFASTINT (w->hscroll, 0);
3164 XSETFASTINT (w->min_hscroll, 0);
3165 set_marker_restricted_both (w->start, buf, 1, 1);
3166 set_marker_restricted_both (w->pointm, buf, 1, 1);
3167
3168 /* Run temp-buffer-show-hook, with the chosen window selected
3169 and it sbuffer current. */
3170 if (!NILP (Vrun_hooks))
3171 {
3172 Lisp_Object tem;
3173 tem = Fboundp (Qtemp_buffer_show_hook);
3174 if (!NILP (tem))
3175 {
3176 tem = Fsymbol_value (Qtemp_buffer_show_hook);
3177 if (!NILP (tem))
3178 {
3179 int count = SPECPDL_INDEX ();
3180 Lisp_Object prev_window;
3181 prev_window = selected_window;
3182
3183 /* Select the window that was chosen, for running the hook. */
3184 record_unwind_protect (Fselect_window, prev_window);
3185 select_window_1 (window, 0);
3186 Fset_buffer (w->buffer);
3187 call1 (Vrun_hooks, Qtemp_buffer_show_hook);
3188 select_window_1 (prev_window, 0);
3189 unbind_to (count, Qnil);
3190 }
3191 }
3192 }
3193 }
3194 }
3195 \f
3196 static void
3197 make_dummy_parent (window)
3198 Lisp_Object window;
3199 {
3200 Lisp_Object new;
3201 register struct window *o, *p;
3202 int i;
3203
3204 o = XWINDOW (window);
3205 p = allocate_window ();
3206 for (i = 0; i < VECSIZE (struct window); ++i)
3207 ((struct Lisp_Vector *) p)->contents[i]
3208 = ((struct Lisp_Vector *)o)->contents[i];
3209 XSETWINDOW (new, p);
3210
3211 XSETFASTINT (p->sequence_number, ++sequence_number);
3212
3213 /* Put new into window structure in place of window */
3214 replace_window (window, new);
3215
3216 o->next = Qnil;
3217 o->prev = Qnil;
3218 o->vchild = Qnil;
3219 o->hchild = Qnil;
3220 o->parent = new;
3221
3222 p->start = Qnil;
3223 p->pointm = Qnil;
3224 p->buffer = Qnil;
3225 }
3226
3227 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
3228 doc: /* Split WINDOW, putting SIZE lines in the first of the pair.
3229 WINDOW defaults to selected one and SIZE to half its size.
3230 If optional third arg HORFLAG is non-nil, split side by side
3231 and put SIZE columns in the first of the pair. In that case,
3232 SIZE includes that window's scroll bar, or the divider column to its right. */)
3233 (window, size, horflag)
3234 Lisp_Object window, size, horflag;
3235 {
3236 register Lisp_Object new;
3237 register struct window *o, *p;
3238 FRAME_PTR fo;
3239 register int size_int;
3240
3241 if (NILP (window))
3242 window = selected_window;
3243 else
3244 CHECK_LIVE_WINDOW (window);
3245
3246 o = XWINDOW (window);
3247 fo = XFRAME (WINDOW_FRAME (o));
3248
3249 if (NILP (size))
3250 {
3251 if (!NILP (horflag))
3252 /* Calculate the size of the left-hand window, by dividing
3253 the usable space in columns by two.
3254 We round up, since the left-hand window may include
3255 a dividing line, while the right-hand may not. */
3256 size_int = (XFASTINT (o->width) + 1) >> 1;
3257 else
3258 size_int = XFASTINT (o->height) >> 1;
3259 }
3260 else
3261 {
3262 CHECK_NUMBER (size);
3263 size_int = XINT (size);
3264 }
3265
3266 if (MINI_WINDOW_P (o))
3267 error ("Attempt to split minibuffer window");
3268 else if (window_fixed_size_p (o, !NILP (horflag), 0))
3269 error ("Attempt to split fixed-size window");
3270
3271 check_min_window_sizes ();
3272
3273 if (NILP (horflag))
3274 {
3275 if (size_int < window_min_height)
3276 error ("Window height %d too small (after splitting)", size_int);
3277 if (size_int + window_min_height > XFASTINT (o->height))
3278 error ("Window height %d too small (after splitting)",
3279 XFASTINT (o->height) - size_int);
3280 if (NILP (o->parent)
3281 || NILP (XWINDOW (o->parent)->vchild))
3282 {
3283 make_dummy_parent (window);
3284 new = o->parent;
3285 XWINDOW (new)->vchild = window;
3286 }
3287 }
3288 else
3289 {
3290 if (size_int < window_min_width)
3291 error ("Window width %d too small (after splitting)", size_int);
3292
3293 if (size_int + window_min_width > XFASTINT (o->width))
3294 error ("Window width %d too small (after splitting)",
3295 XFASTINT (o->width) - size_int);
3296 if (NILP (o->parent)
3297 || NILP (XWINDOW (o->parent)->hchild))
3298 {
3299 make_dummy_parent (window);
3300 new = o->parent;
3301 XWINDOW (new)->hchild = window;
3302 }
3303 }
3304
3305 /* Now we know that window's parent is a vertical combination
3306 if we are dividing vertically, or a horizontal combination
3307 if we are making side-by-side windows */
3308
3309 windows_or_buffers_changed++;
3310 FRAME_WINDOW_SIZES_CHANGED (fo) = 1;
3311 new = make_window ();
3312 p = XWINDOW (new);
3313
3314 p->frame = o->frame;
3315 p->next = o->next;
3316 if (!NILP (p->next))
3317 XWINDOW (p->next)->prev = new;
3318 p->prev = window;
3319 o->next = new;
3320 p->parent = o->parent;
3321 p->buffer = Qt;
3322 p->window_end_valid = Qnil;
3323 bzero (&p->last_cursor, sizeof p->last_cursor);
3324
3325 /* Apportion the available frame space among the two new windows */
3326
3327 if (!NILP (horflag))
3328 {
3329 p->height = o->height;
3330 p->top = o->top;
3331 XSETFASTINT (p->width, XFASTINT (o->width) - size_int);
3332 XSETFASTINT (o->width, size_int);
3333 XSETFASTINT (p->left, XFASTINT (o->left) + size_int);
3334 }
3335 else
3336 {
3337 p->left = o->left;
3338 p->width = o->width;
3339 XSETFASTINT (p->height, XFASTINT (o->height) - size_int);
3340 XSETFASTINT (o->height, size_int);
3341 XSETFASTINT (p->top, XFASTINT (o->top) + size_int);
3342 }
3343
3344 /* Adjust glyph matrices. */
3345 adjust_glyphs (fo);
3346 Fset_window_buffer (new, o->buffer);
3347 return new;
3348 }
3349 \f
3350 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 3, "p",
3351 doc: /* Make current window ARG lines bigger.
3352 From program, optional second arg non-nil means grow sideways ARG columns.
3353 Interactively, if an argument is not given, make the window one line bigger.
3354
3355 Optional third arg PRESERVE-BEFORE, if non-nil, means do not change the size
3356 of the siblings above or to the left of the selected window. Only
3357 siblings to the right or below are changed. */)
3358 (arg, side, preserve_before)
3359 register Lisp_Object arg, side, preserve_before;
3360 {
3361 CHECK_NUMBER (arg);
3362 enlarge_window (selected_window, XINT (arg), !NILP (side),
3363 !NILP (preserve_before));
3364
3365 if (! NILP (Vwindow_configuration_change_hook))
3366 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3367
3368 return Qnil;
3369 }
3370
3371 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
3372 doc: /* Make current window ARG lines smaller.
3373 From program, optional second arg non-nil means shrink sideways arg columns.
3374 Interactively, if an argument is not given, make the window one line smaller. */)
3375 (arg, side)
3376 register Lisp_Object arg, side;
3377 {
3378 CHECK_NUMBER (arg);
3379 enlarge_window (selected_window, -XINT (arg), !NILP (side), 0);
3380
3381 if (! NILP (Vwindow_configuration_change_hook))
3382 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3383
3384 return Qnil;
3385 }
3386
3387 int
3388 window_height (window)
3389 Lisp_Object window;
3390 {
3391 register struct window *p = XWINDOW (window);
3392 return XFASTINT (p->height);
3393 }
3394
3395 int
3396 window_width (window)
3397 Lisp_Object window;
3398 {
3399 register struct window *p = XWINDOW (window);
3400 return XFASTINT (p->width);
3401 }
3402
3403
3404 #define CURBEG(w) \
3405 *(widthflag ? &(XWINDOW (w)->left) : &(XWINDOW (w)->top))
3406
3407 #define CURSIZE(w) \
3408 *(widthflag ? &(XWINDOW (w)->width) : &(XWINDOW (w)->height))
3409
3410
3411 /* Enlarge WINDOW by DELTA. WIDTHFLAG non-zero means
3412 increase its width. Siblings of the selected window are resized to
3413 fulfill the size request. If they become too small in the process,
3414 they will be deleted.
3415
3416 If PRESERVE_BEFORE is nonzero, that means don't alter
3417 the siblings to the left or above WINDOW. */
3418
3419 static void
3420 enlarge_window (window, delta, widthflag, preserve_before)
3421 Lisp_Object window;
3422 int delta, widthflag, preserve_before;
3423 {
3424 Lisp_Object parent, next, prev;
3425 struct window *p;
3426 Lisp_Object *sizep;
3427 int maximum;
3428 int (*sizefun) P_ ((Lisp_Object))
3429 = widthflag ? window_width : window_height;
3430 void (*setsizefun) P_ ((Lisp_Object, int, int))
3431 = (widthflag ? set_window_width : set_window_height);
3432
3433 /* Check values of window_min_width and window_min_height for
3434 validity. */
3435 check_min_window_sizes ();
3436
3437 /* Give up if this window cannot be resized. */
3438 if (window_fixed_size_p (XWINDOW (window), widthflag, 1))
3439 error ("Window is not resizable");
3440
3441 /* Find the parent of the selected window. */
3442 while (1)
3443 {
3444 p = XWINDOW (window);
3445 parent = p->parent;
3446
3447 if (NILP (parent))
3448 {
3449 if (widthflag)
3450 error ("No other window to side of this one");
3451 break;
3452 }
3453
3454 if (widthflag
3455 ? !NILP (XWINDOW (parent)->hchild)
3456 : !NILP (XWINDOW (parent)->vchild))
3457 break;
3458
3459 window = parent;
3460 }
3461
3462 sizep = &CURSIZE (window);
3463
3464 {
3465 register int maxdelta;
3466
3467 /* Compute the maximum size increment this window can have. */
3468
3469 if (preserve_before)
3470 {
3471 if (!NILP (parent))
3472 {
3473 maxdelta = (*sizefun) (parent) - XINT (*sizep);
3474 /* Subtract size of siblings before, since we can't take that. */
3475 maxdelta -= XINT (CURBEG (window)) - XINT (CURBEG (parent));
3476 }
3477 else
3478 maxdelta = (!NILP (p->next) ? ((*sizefun) (p->next)
3479 - window_min_size (XWINDOW (p->next),
3480 widthflag, 0, 0))
3481 : (delta = 0));
3482 }
3483 else
3484 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - XINT (*sizep)
3485 /* This is a main window followed by a minibuffer. */
3486 : !NILP (p->next) ? ((*sizefun) (p->next)
3487 - window_min_size (XWINDOW (p->next),
3488 widthflag, 0, 0))
3489 /* This is a minibuffer following a main window. */
3490 : !NILP (p->prev) ? ((*sizefun) (p->prev)
3491 - window_min_size (XWINDOW (p->prev),
3492 widthflag, 0, 0))
3493 /* This is a frame with only one window, a minibuffer-only
3494 or a minibufferless frame. */
3495 : (delta = 0));
3496
3497 if (delta > maxdelta)
3498 /* This case traps trying to make the minibuffer
3499 the full frame, or make the only window aside from the
3500 minibuffer the full frame. */
3501 delta = maxdelta;
3502 }
3503
3504 if (XINT (*sizep) + delta < window_min_size (XWINDOW (window), widthflag, 0, 0))
3505 {
3506 delete_window (window);
3507 return;
3508 }
3509
3510 if (delta == 0)
3511 return;
3512
3513 /* Find the total we can get from other siblings without deleting them. */
3514 maximum = 0;
3515 for (next = p->next; ! NILP (next); next = XWINDOW (next)->next)
3516 maximum += (*sizefun) (next) - window_min_size (XWINDOW (next),
3517 widthflag, 0, 0);
3518 if (! preserve_before)
3519 for (prev = p->prev; ! NILP (prev); prev = XWINDOW (prev)->prev)
3520 maximum += (*sizefun) (prev) - window_min_size (XWINDOW (prev),
3521 widthflag, 0, 0);
3522
3523 /* If we can get it all from them without deleting them, do so. */
3524 if (delta <= maximum)
3525 {
3526 Lisp_Object first_unaffected;
3527 Lisp_Object first_affected;
3528 int fixed_p;
3529
3530 next = p->next;
3531 prev = p->prev;
3532 first_affected = window;
3533 /* Look at one sibling at a time,
3534 moving away from this window in both directions alternately,
3535 and take as much as we can get without deleting that sibling. */
3536 while (delta != 0
3537 && (!NILP (next) || (!preserve_before && !NILP (prev))))
3538 {
3539 if (! NILP (next))
3540 {
3541 int this_one = ((*sizefun) (next)
3542 - window_min_size (XWINDOW (next),
3543 widthflag, 0, &fixed_p));
3544 if (!fixed_p)
3545 {
3546 if (this_one > delta)
3547 this_one = delta;
3548
3549 (*setsizefun) (next, (*sizefun) (next) - this_one, 0);
3550 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
3551
3552 delta -= this_one;
3553 }
3554
3555 next = XWINDOW (next)->next;
3556 }
3557
3558 if (delta == 0)
3559 break;
3560
3561 if (!preserve_before && ! NILP (prev))
3562 {
3563 int this_one = ((*sizefun) (prev)
3564 - window_min_size (XWINDOW (prev),
3565 widthflag, 0, &fixed_p));
3566 if (!fixed_p)
3567 {
3568 if (this_one > delta)
3569 this_one = delta;
3570
3571 first_affected = prev;
3572
3573 (*setsizefun) (prev, (*sizefun) (prev) - this_one, 0);
3574 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
3575
3576 delta -= this_one;
3577 }
3578
3579 prev = XWINDOW (prev)->prev;
3580 }
3581 }
3582
3583 xassert (delta == 0);
3584
3585 /* Now recalculate the edge positions of all the windows affected,
3586 based on the new sizes. */
3587 first_unaffected = next;
3588 prev = first_affected;
3589 for (next = XWINDOW (prev)->next; ! EQ (next, first_unaffected);
3590 prev = next, next = XWINDOW (next)->next)
3591 {
3592 XSETINT (CURBEG (next), XINT (CURBEG (prev)) + (*sizefun) (prev));
3593 /* This does not change size of NEXT,
3594 but it propagates the new top edge to its children */
3595 (*setsizefun) (next, (*sizefun) (next), 0);
3596 }
3597 }
3598 else
3599 {
3600 register int delta1;
3601 register int opht = (*sizefun) (parent);
3602
3603 if (opht <= XINT (*sizep) + delta)
3604 {
3605 /* If trying to grow this window to or beyond size of the parent,
3606 just delete all the sibling windows. */
3607 Lisp_Object start, tem, next;
3608
3609 start = XWINDOW (parent)->vchild;
3610 if (NILP (start))
3611 start = XWINDOW (parent)->hchild;
3612
3613 /* Delete any siblings that come after WINDOW. */
3614 tem = XWINDOW (window)->next;
3615 while (! NILP (tem))
3616 {
3617 next = XWINDOW (tem)->next;
3618 delete_window (tem);
3619 tem = next;
3620 }
3621
3622 /* Delete any siblings that come after WINDOW.
3623 Note that if START is not WINDOW, then WINDOW still
3624 Fhas siblings, so WINDOW has not yet replaced its parent. */
3625 tem = start;
3626 while (! EQ (tem, window))
3627 {
3628 next = XWINDOW (tem)->next;
3629 delete_window (tem);
3630 tem = next;
3631 }
3632 }
3633 else
3634 {
3635 /* Otherwise, make delta1 just right so that if we add
3636 delta1 lines to this window and to the parent, and then
3637 shrink the parent back to its original size, the new
3638 proportional size of this window will increase by delta.
3639
3640 The function size_window will compute the new height h'
3641 of the window from delta1 as:
3642
3643 e = delta1/n
3644 x = delta1 - delta1/n * n for the 1st resizable child
3645 h' = h + e + x
3646
3647 where n is the number of children that can be resized.
3648 We can ignore x by choosing a delta1 that is a multiple of
3649 n. We want the height of this window to come out as
3650
3651 h' = h + delta
3652
3653 So, delta1 must be
3654
3655 h + e = h + delta
3656 delta1/n = delta
3657 delta1 = n * delta.
3658
3659 The number of children n rquals the number of resizable
3660 children of this window + 1 because we know window itself
3661 is resizable (otherwise we would have signalled an error. */
3662
3663 struct window *w = XWINDOW (window);
3664 Lisp_Object s;
3665 int n = 1;
3666
3667 for (s = w->next; !NILP (s); s = XWINDOW (s)->next)
3668 if (!window_fixed_size_p (XWINDOW (s), widthflag, 0))
3669 ++n;
3670 for (s = w->prev; !NILP (s); s = XWINDOW (s)->prev)
3671 if (!window_fixed_size_p (XWINDOW (s), widthflag, 0))
3672 ++n;
3673
3674 delta1 = n * delta;
3675
3676 /* Add delta1 lines or columns to this window, and to the parent,
3677 keeping things consistent while not affecting siblings. */
3678 XSETINT (CURSIZE (parent), opht + delta1);
3679 (*setsizefun) (window, XINT (*sizep) + delta1, 0);
3680
3681 /* Squeeze out delta1 lines or columns from our parent,
3682 shriking this window and siblings proportionately.
3683 This brings parent back to correct size.
3684 Delta1 was calculated so this makes this window the desired size,
3685 taking it all out of the siblings. */
3686 (*setsizefun) (parent, opht, 0);
3687
3688 }
3689 }
3690
3691 XSETFASTINT (p->last_modified, 0);
3692 XSETFASTINT (p->last_overlay_modified, 0);
3693
3694 /* Adjust glyph matrices. */
3695 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
3696 }
3697
3698 #undef CURBEG
3699 #undef CURSIZE
3700
3701
3702 \f
3703 /***********************************************************************
3704 Resizing Mini-Windows
3705 ***********************************************************************/
3706
3707 static void shrink_window_lowest_first P_ ((struct window *, int));
3708
3709 enum save_restore_action
3710 {
3711 CHECK_ORIG_SIZES,
3712 SAVE_ORIG_SIZES,
3713 RESTORE_ORIG_SIZES
3714 };
3715
3716 static int save_restore_orig_size P_ ((struct window *,
3717 enum save_restore_action));
3718
3719 /* Shrink windows rooted in window W to HEIGHT. Take the space needed
3720 from lowest windows first. */
3721
3722 static void
3723 shrink_window_lowest_first (w, height)
3724 struct window *w;
3725 int height;
3726 {
3727 struct window *c;
3728 Lisp_Object child;
3729 int old_height;
3730
3731 xassert (!MINI_WINDOW_P (w));
3732
3733 /* Set redisplay hints. */
3734 XSETFASTINT (w->last_modified, 0);
3735 XSETFASTINT (w->last_overlay_modified, 0);
3736 windows_or_buffers_changed++;
3737 FRAME_WINDOW_SIZES_CHANGED (XFRAME (WINDOW_FRAME (w))) = 1;
3738
3739 old_height = XFASTINT (w->height);
3740 XSETFASTINT (w->height, height);
3741
3742 if (!NILP (w->hchild))
3743 {
3744 for (child = w->hchild; !NILP (child); child = c->next)
3745 {
3746 c = XWINDOW (child);
3747 c->top = w->top;
3748 shrink_window_lowest_first (c, height);
3749 }
3750 }
3751 else if (!NILP (w->vchild))
3752 {
3753 Lisp_Object last_child;
3754 int delta = old_height - height;
3755 int last_top;
3756
3757 last_child = Qnil;
3758
3759 /* Find the last child. We are taking space from lowest windows
3760 first, so we iterate over children from the last child
3761 backwards. */
3762 for (child = w->vchild; !NILP (child); child = XWINDOW (child)->next)
3763 last_child = child;
3764
3765 /* Assign new heights. We leave only MIN_SAFE_WINDOW_HEIGHT. */
3766 for (child = last_child; delta && !NILP (child); child = c->prev)
3767 {
3768 int this_one;
3769
3770 c = XWINDOW (child);
3771 this_one = XFASTINT (c->height) - MIN_SAFE_WINDOW_HEIGHT;
3772
3773 if (this_one > delta)
3774 this_one = delta;
3775
3776 shrink_window_lowest_first (c, XFASTINT (c->height) - this_one);
3777 delta -= this_one;
3778 }
3779
3780 /* Compute new positions. */
3781 last_top = XINT (w->top);
3782 for (child = w->vchild; !NILP (child); child = c->next)
3783 {
3784 c = XWINDOW (child);
3785 c->top = make_number (last_top);
3786 shrink_window_lowest_first (c, XFASTINT (c->height));
3787 last_top += XFASTINT (c->height);
3788 }
3789 }
3790 }
3791
3792
3793 /* Save, restore, or check positions and sizes in the window tree
3794 rooted at W. ACTION says what to do.
3795
3796 If ACTION is CHECK_ORIG_SIZES, check if orig_top and orig_height
3797 members are valid for all windows in the window tree. Value is
3798 non-zero if they are valid.
3799
3800 If ACTION is SAVE_ORIG_SIZES, save members top and height in
3801 orig_top and orig_height for all windows in the tree.
3802
3803 If ACTION is RESTORE_ORIG_SIZES, restore top and height from
3804 values stored in orig_top and orig_height for all windows. */
3805
3806 static int
3807 save_restore_orig_size (w, action)
3808 struct window *w;
3809 enum save_restore_action action;
3810 {
3811 int success_p = 1;
3812
3813 while (w)
3814 {
3815 if (!NILP (w->hchild))
3816 {
3817 if (!save_restore_orig_size (XWINDOW (w->hchild), action))
3818 success_p = 0;
3819 }
3820 else if (!NILP (w->vchild))
3821 {
3822 if (!save_restore_orig_size (XWINDOW (w->vchild), action))
3823 success_p = 0;
3824 }
3825
3826 switch (action)
3827 {
3828 case CHECK_ORIG_SIZES:
3829 if (!INTEGERP (w->orig_top) || !INTEGERP (w->orig_height))
3830 return 0;
3831 break;
3832
3833 case SAVE_ORIG_SIZES:
3834 w->orig_top = w->top;
3835 w->orig_height = w->height;
3836 XSETFASTINT (w->last_modified, 0);
3837 XSETFASTINT (w->last_overlay_modified, 0);
3838 break;
3839
3840 case RESTORE_ORIG_SIZES:
3841 xassert (INTEGERP (w->orig_top) && INTEGERP (w->orig_height));
3842 w->top = w->orig_top;
3843 w->height = w->orig_height;
3844 w->orig_height = w->orig_top = Qnil;
3845 XSETFASTINT (w->last_modified, 0);
3846 XSETFASTINT (w->last_overlay_modified, 0);
3847 break;
3848
3849 default:
3850 abort ();
3851 }
3852
3853 w = NILP (w->next) ? NULL : XWINDOW (w->next);
3854 }
3855
3856 return success_p;
3857 }
3858
3859
3860 /* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we can
3861 without deleting other windows. */
3862
3863 void
3864 grow_mini_window (w, delta)
3865 struct window *w;
3866 int delta;
3867 {
3868 struct frame *f = XFRAME (w->frame);
3869 struct window *root;
3870
3871 xassert (MINI_WINDOW_P (w));
3872 xassert (delta >= 0);
3873
3874 /* Check values of window_min_width and window_min_height for
3875 validity. */
3876 check_min_window_sizes ();
3877
3878 /* Compute how much we can enlarge the mini-window without deleting
3879 other windows. */
3880 root = XWINDOW (FRAME_ROOT_WINDOW (f));
3881 if (delta)
3882 {
3883 int min_height = window_min_size (root, 0, 0, 0);
3884 if (XFASTINT (root->height) - delta < min_height)
3885 /* Note that the root window may already be smaller than
3886 min_height. */
3887 delta = max (0, XFASTINT (root->height) - min_height);
3888 }
3889
3890 if (delta)
3891 {
3892 /* Save original window sizes and positions, if not already done. */
3893 if (!save_restore_orig_size (root, CHECK_ORIG_SIZES))
3894 save_restore_orig_size (root, SAVE_ORIG_SIZES);
3895
3896 /* Shrink other windows. */
3897 shrink_window_lowest_first (root, XFASTINT (root->height) - delta);
3898
3899 /* Grow the mini-window. */
3900 w->top = make_number (XFASTINT (root->top) + XFASTINT (root->height));
3901 w->height = make_number (XFASTINT (w->height) + delta);
3902 XSETFASTINT (w->last_modified, 0);
3903 XSETFASTINT (w->last_overlay_modified, 0);
3904
3905 adjust_glyphs (f);
3906 }
3907 }
3908
3909
3910 /* Shrink mini-window W. If there is recorded info about window sizes
3911 before a call to grow_mini_window, restore recorded window sizes.
3912 Otherwise, if the mini-window is higher than 1 line, resize it to 1
3913 line. */
3914
3915 void
3916 shrink_mini_window (w)
3917 struct window *w;
3918 {
3919 struct frame *f = XFRAME (w->frame);
3920 struct window *root = XWINDOW (FRAME_ROOT_WINDOW (f));
3921
3922 if (save_restore_orig_size (root, CHECK_ORIG_SIZES))
3923 {
3924 save_restore_orig_size (root, RESTORE_ORIG_SIZES);
3925 adjust_glyphs (f);
3926 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
3927 windows_or_buffers_changed = 1;
3928 }
3929 else if (XFASTINT (w->height) > 1)
3930 {
3931 /* Distribute the additional lines of the mini-window
3932 among the other windows. */
3933 Lisp_Object window;
3934 XSETWINDOW (window, w);
3935 enlarge_window (window, 1 - XFASTINT (w->height), 0, 0);
3936 }
3937 }
3938
3939
3940 \f
3941 /* Mark window cursors off for all windows in the window tree rooted
3942 at W by setting their phys_cursor_on_p flag to zero. Called from
3943 xterm.c, e.g. when a frame is cleared and thereby all cursors on
3944 the frame are cleared. */
3945
3946 void
3947 mark_window_cursors_off (w)
3948 struct window *w;
3949 {
3950 while (w)
3951 {
3952 if (!NILP (w->hchild))
3953 mark_window_cursors_off (XWINDOW (w->hchild));
3954 else if (!NILP (w->vchild))
3955 mark_window_cursors_off (XWINDOW (w->vchild));
3956 else
3957 w->phys_cursor_on_p = 0;
3958
3959 w = NILP (w->next) ? 0 : XWINDOW (w->next);
3960 }
3961 }
3962
3963
3964 /* Return number of lines of text (not counting mode lines) in W. */
3965
3966 int
3967 window_internal_height (w)
3968 struct window *w;
3969 {
3970 int ht = XFASTINT (w->height);
3971
3972 if (!MINI_WINDOW_P (w))
3973 {
3974 if (!NILP (w->parent)
3975 || !NILP (w->vchild)
3976 || !NILP (w->hchild)
3977 || !NILP (w->next)
3978 || !NILP (w->prev)
3979 || WINDOW_WANTS_MODELINE_P (w))
3980 --ht;
3981
3982 if (WINDOW_WANTS_HEADER_LINE_P (w))
3983 --ht;
3984 }
3985
3986 return ht;
3987 }
3988
3989
3990 /* Return the number of columns in W.
3991 Don't count columns occupied by scroll bars or the vertical bar
3992 separating W from the sibling to its right. */
3993
3994 int
3995 window_internal_width (w)
3996 struct window *w;
3997 {
3998 struct frame *f = XFRAME (WINDOW_FRAME (w));
3999 int width = XINT (w->width);
4000
4001 if (FRAME_HAS_VERTICAL_SCROLL_BARS (f))
4002 /* Scroll bars occupy a few columns. */
4003 width -= FRAME_SCROLL_BAR_COLS (f);
4004 else if (!WINDOW_RIGHTMOST_P (w) && !WINDOW_FULL_WIDTH_P (w))
4005 /* The column of `|' characters separating side-by-side windows
4006 occupies one column only. */
4007 width -= 1;
4008
4009 /* On window-systems, areas to the left and right of the window
4010 are used as fringes. */
4011 if (FRAME_WINDOW_P (f))
4012 width -= FRAME_FRINGE_COLS (f);
4013
4014 return width;
4015 }
4016
4017 \f
4018 /************************************************************************
4019 Window Scrolling
4020 ***********************************************************************/
4021
4022 /* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
4023 N screen-fulls, which is defined as the height of the window minus
4024 next_screen_context_lines. If WHOLE is zero, scroll up N lines
4025 instead. Negative values of N mean scroll down. NOERROR non-zero
4026 means don't signal an error if we try to move over BEGV or ZV,
4027 respectively. */
4028
4029 static void
4030 window_scroll (window, n, whole, noerror)
4031 Lisp_Object window;
4032 int n;
4033 int whole;
4034 int noerror;
4035 {
4036 /* If we must, use the pixel-based version which is much slower than
4037 the line-based one but can handle varying line heights. */
4038 if (FRAME_WINDOW_P (XFRAME (XWINDOW (window)->frame)))
4039 window_scroll_pixel_based (window, n, whole, noerror);
4040 else
4041 window_scroll_line_based (window, n, whole, noerror);
4042 }
4043
4044
4045 /* Implementation of window_scroll that works based on pixel line
4046 heights. See the comment of window_scroll for parameter
4047 descriptions. */
4048
4049 static void
4050 window_scroll_pixel_based (window, n, whole, noerror)
4051 Lisp_Object window;
4052 int n;
4053 int whole;
4054 int noerror;
4055 {
4056 struct it it;
4057 struct window *w = XWINDOW (window);
4058 struct text_pos start;
4059 Lisp_Object tem;
4060 int this_scroll_margin;
4061 int preserve_y;
4062 /* True if we fiddled the window vscroll field without really scrolling. */
4063 int vscrolled = 0;
4064
4065 SET_TEXT_POS_FROM_MARKER (start, w->start);
4066
4067 /* If PT is not visible in WINDOW, move back one half of
4068 the screen. Allow PT to be partially visible, otherwise
4069 something like (scroll-down 1) with PT in the line before
4070 the partially visible one would recenter. */
4071 tem = Fpos_visible_in_window_p (make_number (PT), window, Qt);
4072 if (NILP (tem))
4073 {
4074 /* Move backward half the height of the window. Performance note:
4075 vmotion used here is about 10% faster, but would give wrong
4076 results for variable height lines. */
4077 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
4078 it.current_y = it.last_visible_y;
4079 move_it_vertically (&it, - window_box_height (w) / 2);
4080
4081 /* The function move_iterator_vertically may move over more than
4082 the specified y-distance. If it->w is small, e.g. a
4083 mini-buffer window, we may end up in front of the window's
4084 display area. This is the case when Start displaying at the
4085 start of the line containing PT in this case. */
4086 if (it.current_y <= 0)
4087 {
4088 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
4089 move_it_vertically (&it, 0);
4090 it.current_y = 0;
4091 }
4092
4093 start = it.current.pos;
4094 }
4095
4096 /* If scroll_preserve_screen_position is non-zero, we try to set
4097 point in the same window line as it is now, so get that line. */
4098 if (!NILP (Vscroll_preserve_screen_position))
4099 {
4100 start_display (&it, w, start);
4101 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
4102 preserve_y = it.current_y;
4103 }
4104 else
4105 preserve_y = -1;
4106
4107 /* Move iterator it from start the specified distance forward or
4108 backward. The result is the new window start. */
4109 start_display (&it, w, start);
4110 if (whole)
4111 {
4112 int screen_full = (window_box_height (w)
4113 - next_screen_context_lines * CANON_Y_UNIT (it.f));
4114 int dy = n * screen_full;
4115
4116 /* Note that move_it_vertically always moves the iterator to the
4117 start of a line. So, if the last line doesn't have a newline,
4118 we would end up at the start of the line ending at ZV. */
4119 if (dy <= 0)
4120 move_it_vertically_backward (&it, -dy);
4121 else if (dy > 0)
4122 move_it_to (&it, ZV, -1, it.current_y + dy, -1,
4123 MOVE_TO_POS | MOVE_TO_Y);
4124 }
4125 else
4126 move_it_by_lines (&it, n, 1);
4127
4128 /* End if we end up at ZV or BEGV. */
4129 if ((n > 0 && IT_CHARPOS (it) == ZV)
4130 || (n < 0 && IT_CHARPOS (it) == CHARPOS (start)))
4131 {
4132 if (IT_CHARPOS (it) == ZV)
4133 {
4134 if (it.current_y + it.max_ascent + it.max_descent
4135 > it.last_visible_y)
4136 {
4137 /* The last line was only partially visible, make it fully
4138 visible. */
4139 w->vscroll = (it.last_visible_y
4140 - it.current_y + it.max_ascent + it.max_descent);
4141 adjust_glyphs (it.f);
4142 }
4143 else if (noerror)
4144 return;
4145 else
4146 Fsignal (Qend_of_buffer, Qnil);
4147 }
4148 else
4149 {
4150 if (w->vscroll != 0)
4151 /* The first line was only partially visible, make it fully
4152 visible. */
4153 w->vscroll = 0;
4154 else if (noerror)
4155 return;
4156 else
4157 Fsignal (Qbeginning_of_buffer, Qnil);
4158 }
4159
4160 /* If control gets here, then we vscrolled. */
4161
4162 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
4163
4164 /* Don't try to change the window start below. */
4165 vscrolled = 1;
4166 }
4167
4168 if (! vscrolled)
4169 {
4170 int pos = IT_CHARPOS (it);
4171 int bytepos;
4172 /* Set the window start, and set up the window for redisplay. */
4173 set_marker_restricted (w->start, make_number (pos),
4174 w->buffer);
4175 bytepos = XMARKER (w->start)->bytepos;
4176 w->start_at_line_beg = ((pos == BEGV || FETCH_BYTE (bytepos - 1) == '\n')
4177 ? Qt : Qnil);
4178 w->update_mode_line = Qt;
4179 XSETFASTINT (w->last_modified, 0);
4180 XSETFASTINT (w->last_overlay_modified, 0);
4181 /* Set force_start so that redisplay_window will run the
4182 window-scroll-functions. */
4183 w->force_start = Qt;
4184 }
4185
4186 it.current_y = it.vpos = 0;
4187
4188 /* Preserve the screen position if we must. */
4189 if (preserve_y >= 0)
4190 {
4191 move_it_to (&it, -1, -1, preserve_y, -1, MOVE_TO_Y);
4192 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4193 }
4194 else
4195 {
4196 /* Move PT out of scroll margins. */
4197 this_scroll_margin = max (0, scroll_margin);
4198 this_scroll_margin = min (this_scroll_margin, XFASTINT (w->height) / 4);
4199 this_scroll_margin *= CANON_Y_UNIT (it.f);
4200
4201 if (n > 0)
4202 {
4203 /* We moved the window start towards ZV, so PT may be now
4204 in the scroll margin at the top. */
4205 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
4206 while (it.current_y < this_scroll_margin)
4207 {
4208 int prev = it.current_y;
4209 move_it_by_lines (&it, 1, 1);
4210 if (prev == it.current_y)
4211 break;
4212 }
4213 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4214 }
4215 else if (n < 0)
4216 {
4217 int charpos, bytepos;
4218
4219 /* We moved the window start towards BEGV, so PT may be now
4220 in the scroll margin at the bottom. */
4221 move_it_to (&it, PT, -1,
4222 it.last_visible_y - this_scroll_margin - 1, -1,
4223 MOVE_TO_POS | MOVE_TO_Y);
4224
4225 /* Save our position, in case it's correct. */
4226 charpos = IT_CHARPOS (it);
4227 bytepos = IT_BYTEPOS (it);
4228
4229 /* See if point is on a partially visible line at the end. */
4230 move_it_by_lines (&it, 1, 1);
4231 if (it.current_y > it.last_visible_y)
4232 /* The last line was only partially visible, so back up two
4233 lines to make sure we're on a fully visible line. */
4234 {
4235 move_it_by_lines (&it, -2, 0);
4236 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4237 }
4238 else
4239 /* No, the position we saved is OK, so use it. */
4240 SET_PT_BOTH (charpos, bytepos);
4241 }
4242 }
4243 }
4244
4245
4246 /* Implementation of window_scroll that works based on screen lines.
4247 See the comment of window_scroll for parameter descriptions. */
4248
4249 static void
4250 window_scroll_line_based (window, n, whole, noerror)
4251 Lisp_Object window;
4252 int n;
4253 int whole;
4254 int noerror;
4255 {
4256 register struct window *w = XWINDOW (window);
4257 register int opoint = PT, opoint_byte = PT_BYTE;
4258 register int pos, pos_byte;
4259 register int ht = window_internal_height (w);
4260 register Lisp_Object tem;
4261 int lose;
4262 Lisp_Object bolp;
4263 int startpos;
4264 struct position posit;
4265 int original_vpos;
4266
4267 /* If scrolling screen-fulls, compute the number of lines to
4268 scroll from the window's height. */
4269 if (whole)
4270 n *= max (1, ht - next_screen_context_lines);
4271
4272 startpos = marker_position (w->start);
4273
4274 posit = *compute_motion (startpos, 0, 0, 0,
4275 PT, ht, 0,
4276 window_internal_width (w), XINT (w->hscroll),
4277 0, w);
4278 original_vpos = posit.vpos;
4279
4280 XSETFASTINT (tem, PT);
4281 tem = Fpos_visible_in_window_p (tem, window, Qnil);
4282
4283 if (NILP (tem))
4284 {
4285 Fvertical_motion (make_number (- (ht / 2)), window);
4286 startpos = PT;
4287 }
4288
4289 SET_PT (startpos);
4290 lose = n < 0 && PT == BEGV;
4291 Fvertical_motion (make_number (n), window);
4292 pos = PT;
4293 pos_byte = PT_BYTE;
4294 bolp = Fbolp ();
4295 SET_PT_BOTH (opoint, opoint_byte);
4296
4297 if (lose)
4298 {
4299 if (noerror)
4300 return;
4301 else
4302 Fsignal (Qbeginning_of_buffer, Qnil);
4303 }
4304
4305 if (pos < ZV)
4306 {
4307 int this_scroll_margin = scroll_margin;
4308
4309 /* Don't use a scroll margin that is negative or too large. */
4310 if (this_scroll_margin < 0)
4311 this_scroll_margin = 0;
4312
4313 if (XINT (w->height) < 4 * scroll_margin)
4314 this_scroll_margin = XINT (w->height) / 4;
4315
4316 set_marker_restricted_both (w->start, w->buffer, pos, pos_byte);
4317 w->start_at_line_beg = bolp;
4318 w->update_mode_line = Qt;
4319 XSETFASTINT (w->last_modified, 0);
4320 XSETFASTINT (w->last_overlay_modified, 0);
4321 /* Set force_start so that redisplay_window will run
4322 the window-scroll-functions. */
4323 w->force_start = Qt;
4324
4325 if (whole && !NILP (Vscroll_preserve_screen_position))
4326 {
4327 SET_PT_BOTH (pos, pos_byte);
4328 Fvertical_motion (make_number (original_vpos), window);
4329 }
4330 /* If we scrolled forward, put point enough lines down
4331 that it is outside the scroll margin. */
4332 else if (n > 0)
4333 {
4334 int top_margin;
4335
4336 if (this_scroll_margin > 0)
4337 {
4338 SET_PT_BOTH (pos, pos_byte);
4339 Fvertical_motion (make_number (this_scroll_margin), window);
4340 top_margin = PT;
4341 }
4342 else
4343 top_margin = pos;
4344
4345 if (top_margin <= opoint)
4346 SET_PT_BOTH (opoint, opoint_byte);
4347 else if (!NILP (Vscroll_preserve_screen_position))
4348 {
4349 SET_PT_BOTH (pos, pos_byte);
4350 Fvertical_motion (make_number (original_vpos), window);
4351 }
4352 else
4353 SET_PT (top_margin);
4354 }
4355 else if (n < 0)
4356 {
4357 int bottom_margin;
4358
4359 /* If we scrolled backward, put point near the end of the window
4360 but not within the scroll margin. */
4361 SET_PT_BOTH (pos, pos_byte);
4362 tem = Fvertical_motion (make_number (ht - this_scroll_margin), window);
4363 if (XFASTINT (tem) == ht - this_scroll_margin)
4364 bottom_margin = PT;
4365 else
4366 bottom_margin = PT + 1;
4367
4368 if (bottom_margin > opoint)
4369 SET_PT_BOTH (opoint, opoint_byte);
4370 else
4371 {
4372 if (!NILP (Vscroll_preserve_screen_position))
4373 {
4374 SET_PT_BOTH (pos, pos_byte);
4375 Fvertical_motion (make_number (original_vpos), window);
4376 }
4377 else
4378 Fvertical_motion (make_number (-1), window);
4379 }
4380 }
4381 }
4382 else
4383 {
4384 if (noerror)
4385 return;
4386 else
4387 Fsignal (Qend_of_buffer, Qnil);
4388 }
4389 }
4390
4391
4392 /* Scroll selected_window up or down. If N is nil, scroll a
4393 screen-full which is defined as the height of the window minus
4394 next_screen_context_lines. If N is the symbol `-', scroll.
4395 DIRECTION may be 1 meaning to scroll down, or -1 meaning to scroll
4396 up. This is the guts of Fscroll_up and Fscroll_down. */
4397
4398 static void
4399 scroll_command (n, direction)
4400 Lisp_Object n;
4401 int direction;
4402 {
4403 int count = SPECPDL_INDEX ();
4404
4405 xassert (abs (direction) == 1);
4406
4407 /* If selected window's buffer isn't current, make it current for
4408 the moment. But don't screw up if window_scroll gets an error. */
4409 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
4410 {
4411 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4412 Fset_buffer (XWINDOW (selected_window)->buffer);
4413
4414 /* Make redisplay consider other windows than just selected_window. */
4415 ++windows_or_buffers_changed;
4416 }
4417
4418 if (NILP (n))
4419 window_scroll (selected_window, direction, 1, 0);
4420 else if (EQ (n, Qminus))
4421 window_scroll (selected_window, -direction, 1, 0);
4422 else
4423 {
4424 n = Fprefix_numeric_value (n);
4425 window_scroll (selected_window, XINT (n) * direction, 0, 0);
4426 }
4427
4428 unbind_to (count, Qnil);
4429 }
4430
4431 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
4432 doc: /* Scroll text of current window upward ARG lines; or near full screen if no ARG.
4433 A near full screen is `next-screen-context-lines' less than a full screen.
4434 Negative ARG means scroll downward.
4435 If ARG is the atom `-', scroll downward by nearly full screen.
4436 When calling from a program, supply as argument a number, nil, or `-'. */)
4437 (arg)
4438 Lisp_Object arg;
4439 {
4440 scroll_command (arg, 1);
4441 return Qnil;
4442 }
4443
4444 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
4445 doc: /* Scroll text of current window down ARG lines; or near full screen if no ARG.
4446 A near full screen is `next-screen-context-lines' less than a full screen.
4447 Negative ARG means scroll upward.
4448 If ARG is the atom `-', scroll upward by nearly full screen.
4449 When calling from a program, supply as argument a number, nil, or `-'. */)
4450 (arg)
4451 Lisp_Object arg;
4452 {
4453 scroll_command (arg, -1);
4454 return Qnil;
4455 }
4456 \f
4457 DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling, Sother_window_for_scrolling, 0, 0, 0,
4458 doc: /* Return the other window for \"other window scroll\" commands.
4459 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4460 specifies the window.
4461 If `other-window-scroll-buffer' is non-nil, a window
4462 showing that buffer is used. */)
4463 ()
4464 {
4465 Lisp_Object window;
4466
4467 if (MINI_WINDOW_P (XWINDOW (selected_window))
4468 && !NILP (Vminibuf_scroll_window))
4469 window = Vminibuf_scroll_window;
4470 /* If buffer is specified, scroll that buffer. */
4471 else if (!NILP (Vother_window_scroll_buffer))
4472 {
4473 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
4474 if (NILP (window))
4475 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt, Qnil);
4476 }
4477 else
4478 {
4479 /* Nothing specified; look for a neighboring window on the same
4480 frame. */
4481 window = Fnext_window (selected_window, Qnil, Qnil);
4482
4483 if (EQ (window, selected_window))
4484 /* That didn't get us anywhere; look for a window on another
4485 visible frame. */
4486 do
4487 window = Fnext_window (window, Qnil, Qt);
4488 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
4489 && ! EQ (window, selected_window));
4490 }
4491
4492 CHECK_LIVE_WINDOW (window);
4493
4494 if (EQ (window, selected_window))
4495 error ("There is no other window");
4496
4497 return window;
4498 }
4499
4500 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
4501 doc: /* Scroll next window upward ARG lines; or near full screen if no ARG.
4502 A near full screen is `next-screen-context-lines' less than a full screen.
4503 The next window is the one below the current one; or the one at the top
4504 if the current one is at the bottom. Negative ARG means scroll downward.
4505 If ARG is the atom `-', scroll downward by nearly full screen.
4506 When calling from a program, supply as argument a number, nil, or `-'.
4507
4508 If in the minibuffer, `minibuffer-scroll-window' if non-nil
4509 specifies the window to scroll.
4510 If `other-window-scroll-buffer' is non-nil, scroll the window
4511 showing that buffer, popping the buffer up if necessary. */)
4512 (arg)
4513 Lisp_Object arg;
4514 {
4515 Lisp_Object window;
4516 struct window *w;
4517 int count = SPECPDL_INDEX ();
4518
4519 window = Fother_window_for_scrolling ();
4520 w = XWINDOW (window);
4521
4522 /* Don't screw up if window_scroll gets an error. */
4523 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4524 ++windows_or_buffers_changed;
4525
4526 Fset_buffer (w->buffer);
4527 SET_PT (marker_position (w->pointm));
4528
4529 if (NILP (arg))
4530 window_scroll (window, 1, 1, 1);
4531 else if (EQ (arg, Qminus))
4532 window_scroll (window, -1, 1, 1);
4533 else
4534 {
4535 if (CONSP (arg))
4536 arg = Fcar (arg);
4537 CHECK_NUMBER (arg);
4538 window_scroll (window, XINT (arg), 0, 1);
4539 }
4540
4541 set_marker_both (w->pointm, Qnil, PT, PT_BYTE);
4542 unbind_to (count, Qnil);
4543
4544 return Qnil;
4545 }
4546 \f
4547 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 1, "P",
4548 doc: /* Scroll selected window display ARG columns left.
4549 Default for ARG is window width minus 2.
4550 Value is the total amount of leftward horizontal scrolling in
4551 effect after the change.
4552 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4553 a lower bound for automatic scrolling, i.e. automatic scrolling
4554 will not scroll a window to a column less than the value returned
4555 by this function. */)
4556 (arg)
4557 register Lisp_Object arg;
4558 {
4559 Lisp_Object result;
4560 int hscroll;
4561 struct window *w = XWINDOW (selected_window);
4562
4563 if (NILP (arg))
4564 XSETFASTINT (arg, window_internal_width (w) - 2);
4565 else
4566 arg = Fprefix_numeric_value (arg);
4567
4568 hscroll = XINT (w->hscroll) + XINT (arg);
4569 result = Fset_window_hscroll (selected_window, make_number (hscroll));
4570
4571 if (interactive_p (0))
4572 w->min_hscroll = w->hscroll;
4573
4574 return result;
4575 }
4576
4577 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 1, "P",
4578 doc: /* Scroll selected window display ARG columns right.
4579 Default for ARG is window width minus 2.
4580 Value is the total amount of leftward horizontal scrolling in
4581 effect after the change.
4582 If `automatic-hscrolling' is non-nil, the argument ARG modifies
4583 a lower bound for automatic scrolling, i.e. automatic scrolling
4584 will not scroll a window to a column less than the value returned
4585 by this function. */)
4586 (arg)
4587 register Lisp_Object arg;
4588 {
4589 Lisp_Object result;
4590 int hscroll;
4591 struct window *w = XWINDOW (selected_window);
4592
4593 if (NILP (arg))
4594 XSETFASTINT (arg, window_internal_width (w) - 2);
4595 else
4596 arg = Fprefix_numeric_value (arg);
4597
4598 hscroll = XINT (w->hscroll) - XINT (arg);
4599 result = Fset_window_hscroll (selected_window, make_number (hscroll));
4600
4601 if (interactive_p (0))
4602 w->min_hscroll = w->hscroll;
4603
4604 return result;
4605 }
4606
4607 DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window, Sminibuffer_selected_window, 0, 0, 0,
4608 doc: /* Return the window which was selected when entering the minibuffer.
4609 Returns nil, if current window is not a minibuffer window. */)
4610 ()
4611 {
4612 if (minibuf_level > 0
4613 && MINI_WINDOW_P (XWINDOW (selected_window))
4614 && !NILP (minibuf_selected_window)
4615 && WINDOW_LIVE_P (minibuf_selected_window))
4616 return minibuf_selected_window;
4617
4618 return Qnil;
4619 }
4620
4621 /* Value is the number of lines actually displayed in window W,
4622 as opposed to its height. */
4623
4624 static int
4625 displayed_window_lines (w)
4626 struct window *w;
4627 {
4628 struct it it;
4629 struct text_pos start;
4630 int height = window_box_height (w);
4631 struct buffer *old_buffer;
4632 int bottom_y;
4633
4634 if (XBUFFER (w->buffer) != current_buffer)
4635 {
4636 old_buffer = current_buffer;
4637 set_buffer_internal (XBUFFER (w->buffer));
4638 }
4639 else
4640 old_buffer = NULL;
4641
4642 /* In case W->start is out of the accessible range, do something
4643 reasonable. This happens in Info mode when Info-scroll-down
4644 calls (recenter -1) while W->start is 1. */
4645 if (XMARKER (w->start)->charpos < BEGV)
4646 SET_TEXT_POS (start, BEGV, BEGV_BYTE);
4647 else if (XMARKER (w->start)->charpos > ZV)
4648 SET_TEXT_POS (start, ZV, ZV_BYTE);
4649 else
4650 SET_TEXT_POS_FROM_MARKER (start, w->start);
4651
4652 start_display (&it, w, start);
4653 move_it_vertically (&it, height);
4654 bottom_y = line_bottom_y (&it);
4655
4656 /* Add in empty lines at the bottom of the window. */
4657 if (bottom_y < height)
4658 {
4659 int uy = CANON_Y_UNIT (it.f);
4660 it.vpos += (height - bottom_y + uy - 1) / uy;
4661 }
4662
4663 if (old_buffer)
4664 set_buffer_internal (old_buffer);
4665
4666 return it.vpos;
4667 }
4668
4669
4670 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
4671 doc: /* Center point in window and redisplay frame.
4672 With prefix argument ARG, recenter putting point on screen line ARG
4673 relative to the current window. If ARG is negative, it counts up from the
4674 bottom of the window. (ARG should be less than the height of the window.)
4675
4676 If ARG is omitted or nil, erase the entire frame and then
4677 redraw with point in the center of the current window.
4678 Just C-u as prefix means put point in the center of the window
4679 and redisplay normally--don't erase and redraw the frame. */)
4680 (arg)
4681 register Lisp_Object arg;
4682 {
4683 struct window *w = XWINDOW (selected_window);
4684 struct buffer *buf = XBUFFER (w->buffer);
4685 struct buffer *obuf = current_buffer;
4686 int center_p = 0;
4687 int charpos, bytepos;
4688
4689 /* If redisplay is suppressed due to an error, try again. */
4690 obuf->display_error_modiff = 0;
4691
4692 if (NILP (arg))
4693 {
4694 int i;
4695
4696 /* Invalidate pixel data calculated for all compositions. */
4697 for (i = 0; i < n_compositions; i++)
4698 composition_table[i]->font = NULL;
4699
4700 Fredraw_frame (w->frame);
4701 SET_FRAME_GARBAGED (XFRAME (WINDOW_FRAME (w)));
4702 center_p = 1;
4703 }
4704 else if (CONSP (arg)) /* Just C-u. */
4705 center_p = 1;
4706 else
4707 {
4708 arg = Fprefix_numeric_value (arg);
4709 CHECK_NUMBER (arg);
4710 }
4711
4712 set_buffer_internal (buf);
4713
4714 /* Handle centering on a graphical frame specially. Such frames can
4715 have variable-height lines and centering point on the basis of
4716 line counts would lead to strange effects. */
4717 if (FRAME_WINDOW_P (XFRAME (w->frame)))
4718 {
4719 if (center_p)
4720 {
4721 struct it it;
4722 struct text_pos pt;
4723
4724 SET_TEXT_POS (pt, PT, PT_BYTE);
4725 start_display (&it, w, pt);
4726 move_it_vertically (&it, - window_box_height (w) / 2);
4727 charpos = IT_CHARPOS (it);
4728 bytepos = IT_BYTEPOS (it);
4729 }
4730 else if (XINT (arg) < 0)
4731 {
4732 struct it it;
4733 struct text_pos pt;
4734 int y0, y1, h, nlines;
4735
4736 SET_TEXT_POS (pt, PT, PT_BYTE);
4737 start_display (&it, w, pt);
4738 y0 = it.current_y;
4739
4740 /* The amount of pixels we have to move back is the window
4741 height minus what's displayed in the line containing PT,
4742 and the lines below. */
4743 nlines = - XINT (arg) - 1;
4744 move_it_by_lines (&it, nlines, 1);
4745
4746 y1 = line_bottom_y (&it);
4747
4748 /* If we can't move down NLINES lines because we hit
4749 the end of the buffer, count in some empty lines. */
4750 if (it.vpos < nlines)
4751 y1 += (nlines - it.vpos) * CANON_Y_UNIT (it.f);
4752
4753 h = window_box_height (w) - (y1 - y0);
4754
4755 start_display (&it, w, pt);
4756 move_it_vertically (&it, - h);
4757 charpos = IT_CHARPOS (it);
4758 bytepos = IT_BYTEPOS (it);
4759 }
4760 else
4761 {
4762 struct position pos;
4763 pos = *vmotion (PT, - XINT (arg), w);
4764 charpos = pos.bufpos;
4765 bytepos = pos.bytepos;
4766 }
4767 }
4768 else
4769 {
4770 struct position pos;
4771 int ht = window_internal_height (w);
4772
4773 if (center_p)
4774 arg = make_number (ht / 2);
4775 else if (XINT (arg) < 0)
4776 arg = make_number (XINT (arg) + ht);
4777
4778 pos = *vmotion (PT, - XINT (arg), w);
4779 charpos = pos.bufpos;
4780 bytepos = pos.bytepos;
4781 }
4782
4783 /* Set the new window start. */
4784 set_marker_both (w->start, w->buffer, charpos, bytepos);
4785 w->window_end_valid = Qnil;
4786
4787 w->optional_new_start = Qt;
4788
4789 if (bytepos == BEGV_BYTE || FETCH_BYTE (bytepos - 1) == '\n')
4790 w->start_at_line_beg = Qt;
4791 else
4792 w->start_at_line_beg = Qnil;
4793
4794 set_buffer_internal (obuf);
4795 return Qnil;
4796 }
4797
4798
4799 DEFUN ("window-text-height", Fwindow_text_height, Swindow_text_height,
4800 0, 1, 0,
4801 doc: /* Return the height in lines of the text display area of WINDOW.
4802 This doesn't include the mode-line (or header-line if any) or any
4803 partial-height lines in the text display area. */)
4804 (window)
4805 Lisp_Object window;
4806 {
4807 struct window *w = decode_window (window);
4808 int pixel_height = window_box_height (w);
4809 int line_height = pixel_height / CANON_Y_UNIT (XFRAME (w->frame));
4810 return make_number (line_height);
4811 }
4812
4813
4814 \f
4815 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
4816 1, 1, "P",
4817 doc: /* Position point relative to window.
4818 With no argument, position point at center of window.
4819 An argument specifies vertical position within the window;
4820 zero means top of window, negative means relative to bottom of window. */)
4821 (arg)
4822 Lisp_Object arg;
4823 {
4824 struct window *w = XWINDOW (selected_window);
4825 int lines, start;
4826 Lisp_Object window;
4827
4828 window = selected_window;
4829 start = marker_position (w->start);
4830 if (start < BEGV || start > ZV)
4831 {
4832 int height = window_internal_height (w);
4833 Fvertical_motion (make_number (- (height / 2)), window);
4834 set_marker_both (w->start, w->buffer, PT, PT_BYTE);
4835 w->start_at_line_beg = Fbolp ();
4836 w->force_start = Qt;
4837 }
4838 else
4839 Fgoto_char (w->start);
4840
4841 lines = displayed_window_lines (w);
4842 if (NILP (arg))
4843 XSETFASTINT (arg, lines / 2);
4844 else
4845 {
4846 arg = Fprefix_numeric_value (arg);
4847 if (XINT (arg) < 0)
4848 XSETINT (arg, XINT (arg) + lines);
4849 }
4850
4851 /* Skip past a partially visible first line. */
4852 if (w->vscroll)
4853 XSETINT (arg, XINT (arg) + 1);
4854
4855 return Fvertical_motion (arg, window);
4856 }
4857
4858
4859 \f
4860 /***********************************************************************
4861 Window Configuration
4862 ***********************************************************************/
4863
4864 struct save_window_data
4865 {
4866 EMACS_INT size_from_Lisp_Vector_struct;
4867 struct Lisp_Vector *next_from_Lisp_Vector_struct;
4868 Lisp_Object frame_width, frame_height, frame_menu_bar_lines;
4869 Lisp_Object frame_tool_bar_lines;
4870 Lisp_Object selected_frame;
4871 Lisp_Object current_window;
4872 Lisp_Object current_buffer;
4873 Lisp_Object minibuf_scroll_window;
4874 Lisp_Object minibuf_selected_window;
4875 Lisp_Object root_window;
4876 Lisp_Object focus_frame;
4877 /* Record the values of window-min-width and window-min-height
4878 so that window sizes remain consistent with them. */
4879 Lisp_Object min_width, min_height;
4880 /* A vector, each of whose elements is a struct saved_window
4881 for one window. */
4882 Lisp_Object saved_windows;
4883 };
4884
4885 /* This is saved as a Lisp_Vector */
4886 struct saved_window
4887 {
4888 /* these first two must agree with struct Lisp_Vector in lisp.h */
4889 EMACS_INT size_from_Lisp_Vector_struct;
4890 struct Lisp_Vector *next_from_Lisp_Vector_struct;
4891
4892 Lisp_Object window;
4893 Lisp_Object buffer, start, pointm, mark;
4894 Lisp_Object left, top, width, height, hscroll, min_hscroll;
4895 Lisp_Object parent, prev;
4896 Lisp_Object start_at_line_beg;
4897 Lisp_Object display_table;
4898 Lisp_Object orig_top, orig_height;
4899 };
4900
4901 #define SAVED_WINDOW_VECTOR_SIZE 17 /* Arg to Fmake_vector */
4902
4903 #define SAVED_WINDOW_N(swv,n) \
4904 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
4905
4906 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
4907 doc: /* Return t if OBJECT is a window-configuration object. */)
4908 (object)
4909 Lisp_Object object;
4910 {
4911 if (WINDOW_CONFIGURATIONP (object))
4912 return Qt;
4913 return Qnil;
4914 }
4915
4916 DEFUN ("window-configuration-frame", Fwindow_configuration_frame, Swindow_configuration_frame, 1, 1, 0,
4917 doc: /* Return the frame that CONFIG, a window-configuration object, is about. */)
4918 (config)
4919 Lisp_Object config;
4920 {
4921 register struct save_window_data *data;
4922 struct Lisp_Vector *saved_windows;
4923
4924 if (! WINDOW_CONFIGURATIONP (config))
4925 wrong_type_argument (Qwindow_configuration_p, config);
4926
4927 data = (struct save_window_data *) XVECTOR (config);
4928 saved_windows = XVECTOR (data->saved_windows);
4929 return XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
4930 }
4931
4932 DEFUN ("set-window-configuration", Fset_window_configuration,
4933 Sset_window_configuration, 1, 1, 0,
4934 doc: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
4935 CONFIGURATION must be a value previously returned
4936 by `current-window-configuration' (which see).
4937 If CONFIGURATION was made from a frame that is now deleted,
4938 only frame-independent values can be restored. In this case,
4939 the return value is nil. Otherwise the value is t. */)
4940 (configuration)
4941 Lisp_Object configuration;
4942 {
4943 register struct save_window_data *data;
4944 struct Lisp_Vector *saved_windows;
4945 Lisp_Object new_current_buffer;
4946 Lisp_Object frame;
4947 FRAME_PTR f;
4948 int old_point = -1;
4949
4950 while (!WINDOW_CONFIGURATIONP (configuration))
4951 wrong_type_argument (Qwindow_configuration_p, configuration);
4952
4953 data = (struct save_window_data *) XVECTOR (configuration);
4954 saved_windows = XVECTOR (data->saved_windows);
4955
4956 new_current_buffer = data->current_buffer;
4957 if (NILP (XBUFFER (new_current_buffer)->name))
4958 new_current_buffer = Qnil;
4959 else
4960 old_point = BUF_PT (XBUFFER (new_current_buffer));
4961
4962 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
4963 f = XFRAME (frame);
4964
4965 /* If f is a dead frame, don't bother rebuilding its window tree.
4966 However, there is other stuff we should still try to do below. */
4967 if (FRAME_LIVE_P (f))
4968 {
4969 register struct window *w;
4970 register struct saved_window *p;
4971 struct window *root_window;
4972 struct window **leaf_windows;
4973 int n_leaf_windows;
4974 int k, i, n;
4975
4976 /* If the frame has been resized since this window configuration was
4977 made, we change the frame to the size specified in the
4978 configuration, restore the configuration, and then resize it
4979 back. We keep track of the prevailing height in these variables. */
4980 int previous_frame_height = FRAME_HEIGHT (f);
4981 int previous_frame_width = FRAME_WIDTH (f);
4982 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
4983 int previous_frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
4984
4985 /* The mouse highlighting code could get screwed up
4986 if it runs during this. */
4987 BLOCK_INPUT;
4988
4989 if (XFASTINT (data->frame_height) != previous_frame_height
4990 || XFASTINT (data->frame_width) != previous_frame_width)
4991 change_frame_size (f, XFASTINT (data->frame_height),
4992 XFASTINT (data->frame_width), 0, 0, 0);
4993 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
4994 if (XFASTINT (data->frame_menu_bar_lines)
4995 != previous_frame_menu_bar_lines)
4996 x_set_menu_bar_lines (f, data->frame_menu_bar_lines, make_number (0));
4997 #ifdef HAVE_WINDOW_SYSTEM
4998 if (XFASTINT (data->frame_tool_bar_lines)
4999 != previous_frame_tool_bar_lines)
5000 x_set_tool_bar_lines (f, data->frame_tool_bar_lines, make_number (0));
5001 #endif
5002 #endif
5003
5004 /* "Swap out" point from the selected window
5005 into its buffer. We do this now, before
5006 restoring the window contents, and prevent it from
5007 being done later on when we select a new window. */
5008 if (! NILP (XWINDOW (selected_window)->buffer))
5009 {
5010 w = XWINDOW (selected_window);
5011 set_marker_both (w->pointm,
5012 w->buffer,
5013 BUF_PT (XBUFFER (w->buffer)),
5014 BUF_PT_BYTE (XBUFFER (w->buffer)));
5015 }
5016
5017 windows_or_buffers_changed++;
5018 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
5019
5020 /* Problem: Freeing all matrices and later allocating them again
5021 is a serious redisplay flickering problem. What we would
5022 really like to do is to free only those matrices not reused
5023 below. */
5024 root_window = XWINDOW (FRAME_ROOT_WINDOW (f));
5025 leaf_windows
5026 = (struct window **) alloca (count_windows (root_window)
5027 * sizeof (struct window *));
5028 n_leaf_windows = get_leaf_windows (root_window, leaf_windows, 0);
5029
5030 /* Temporarily avoid any problems with windows that are smaller
5031 than they are supposed to be. */
5032 window_min_height = 1;
5033 window_min_width = 1;
5034
5035 /* Kludge Alert!
5036 Mark all windows now on frame as "deleted".
5037 Restoring the new configuration "undeletes" any that are in it.
5038
5039 Save their current buffers in their height fields, since we may
5040 need it later, if a buffer saved in the configuration is now
5041 dead. */
5042 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
5043
5044 for (k = 0; k < saved_windows->size; k++)
5045 {
5046 p = SAVED_WINDOW_N (saved_windows, k);
5047 w = XWINDOW (p->window);
5048 w->next = Qnil;
5049
5050 if (!NILP (p->parent))
5051 w->parent = SAVED_WINDOW_N (saved_windows,
5052 XFASTINT (p->parent))->window;
5053 else
5054 w->parent = Qnil;
5055
5056 if (!NILP (p->prev))
5057 {
5058 w->prev = SAVED_WINDOW_N (saved_windows,
5059 XFASTINT (p->prev))->window;
5060 XWINDOW (w->prev)->next = p->window;
5061 }
5062 else
5063 {
5064 w->prev = Qnil;
5065 if (!NILP (w->parent))
5066 {
5067 if (EQ (p->width, XWINDOW (w->parent)->width))
5068 {
5069 XWINDOW (w->parent)->vchild = p->window;
5070 XWINDOW (w->parent)->hchild = Qnil;
5071 }
5072 else
5073 {
5074 XWINDOW (w->parent)->hchild = p->window;
5075 XWINDOW (w->parent)->vchild = Qnil;
5076 }
5077 }
5078 }
5079
5080 /* If we squirreled away the buffer in the window's height,
5081 restore it now. */
5082 if (BUFFERP (w->height))
5083 w->buffer = w->height;
5084 w->left = p->left;
5085 w->top = p->top;
5086 w->width = p->width;
5087 w->height = p->height;
5088 w->hscroll = p->hscroll;
5089 w->min_hscroll = p->min_hscroll;
5090 w->display_table = p->display_table;
5091 w->orig_top = p->orig_top;
5092 w->orig_height = p->orig_height;
5093 XSETFASTINT (w->last_modified, 0);
5094 XSETFASTINT (w->last_overlay_modified, 0);
5095
5096 /* Reinstall the saved buffer and pointers into it. */
5097 if (NILP (p->buffer))
5098 w->buffer = p->buffer;
5099 else
5100 {
5101 if (!NILP (XBUFFER (p->buffer)->name))
5102 /* If saved buffer is alive, install it. */
5103 {
5104 w->buffer = p->buffer;
5105 w->start_at_line_beg = p->start_at_line_beg;
5106 set_marker_restricted (w->start, p->start, w->buffer);
5107 set_marker_restricted (w->pointm, p->pointm, w->buffer);
5108 Fset_marker (XBUFFER (w->buffer)->mark,
5109 p->mark, w->buffer);
5110
5111 /* As documented in Fcurrent_window_configuration, don't
5112 restore the location of point in the buffer which was
5113 current when the window configuration was recorded. */
5114 if (!EQ (p->buffer, new_current_buffer)
5115 && XBUFFER (p->buffer) == current_buffer)
5116 Fgoto_char (w->pointm);
5117 }
5118 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
5119 /* Else unless window has a live buffer, get one. */
5120 {
5121 w->buffer = Fcdr (Fcar (Vbuffer_alist));
5122 /* This will set the markers to beginning of visible
5123 range. */
5124 set_marker_restricted (w->start, make_number (0), w->buffer);
5125 set_marker_restricted (w->pointm, make_number (0),w->buffer);
5126 w->start_at_line_beg = Qt;
5127 }
5128 else
5129 /* Keeping window's old buffer; make sure the markers
5130 are real. */
5131 {
5132 /* Set window markers at start of visible range. */
5133 if (XMARKER (w->start)->buffer == 0)
5134 set_marker_restricted (w->start, make_number (0),
5135 w->buffer);
5136 if (XMARKER (w->pointm)->buffer == 0)
5137 set_marker_restricted_both (w->pointm, w->buffer,
5138 BUF_PT (XBUFFER (w->buffer)),
5139 BUF_PT_BYTE (XBUFFER (w->buffer)));
5140 w->start_at_line_beg = Qt;
5141 }
5142 }
5143 }
5144
5145 FRAME_ROOT_WINDOW (f) = data->root_window;
5146 /* Prevent "swapping out point" in the old selected window
5147 using the buffer that has been restored into it.
5148 Use the point value from the beginning of this function
5149 since unshow_buffer (called from delete_all_subwindows)
5150 could have altered it. */
5151 selected_window = Qnil;
5152 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer))
5153 set_marker_restricted (XWINDOW (data->current_window)->pointm,
5154 make_number (old_point),
5155 XWINDOW (data->current_window)->buffer);
5156
5157 Fselect_window (data->current_window);
5158 XBUFFER (XWINDOW (selected_window)->buffer)->last_selected_window
5159 = selected_window;
5160
5161 if (NILP (data->focus_frame)
5162 || (FRAMEP (data->focus_frame)
5163 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
5164 Fredirect_frame_focus (frame, data->focus_frame);
5165
5166 #if 0 /* I don't understand why this is needed, and it causes problems
5167 when the frame's old selected window has been deleted. */
5168 if (f != selected_frame && FRAME_WINDOW_P (f))
5169 do_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)),
5170 0, 0);
5171 #endif
5172
5173 /* Set the screen height to the value it had before this function. */
5174 if (previous_frame_height != FRAME_HEIGHT (f)
5175 || previous_frame_width != FRAME_WIDTH (f))
5176 change_frame_size (f, previous_frame_height, previous_frame_width,
5177 0, 0, 0);
5178 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
5179 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
5180 x_set_menu_bar_lines (f, make_number (previous_frame_menu_bar_lines),
5181 make_number (0));
5182 #ifdef HAVE_WINDOW_SYSTEM
5183 if (previous_frame_tool_bar_lines != FRAME_TOOL_BAR_LINES (f))
5184 x_set_tool_bar_lines (f, make_number (previous_frame_tool_bar_lines),
5185 make_number (0));
5186 #endif
5187 #endif
5188
5189 /* Now, free glyph matrices in windows that were not reused. */
5190 for (i = n = 0; i < n_leaf_windows; ++i)
5191 {
5192 if (NILP (leaf_windows[i]->buffer))
5193 {
5194 /* Assert it's not reused as a combination. */
5195 xassert (NILP (leaf_windows[i]->hchild)
5196 && NILP (leaf_windows[i]->vchild));
5197 free_window_matrices (leaf_windows[i]);
5198 }
5199 else if (EQ (leaf_windows[i]->buffer, new_current_buffer))
5200 ++n;
5201 }
5202
5203 adjust_glyphs (f);
5204
5205 UNBLOCK_INPUT;
5206
5207 /* Fselect_window will have made f the selected frame, so we
5208 reselect the proper frame here. Fhandle_switch_frame will change the
5209 selected window too, but that doesn't make the call to
5210 Fselect_window above totally superfluous; it still sets f's
5211 selected window. */
5212 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
5213 do_switch_frame (data->selected_frame, 0, 0);
5214
5215 if (! NILP (Vwindow_configuration_change_hook)
5216 && ! NILP (Vrun_hooks))
5217 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
5218 }
5219
5220 if (!NILP (new_current_buffer))
5221 Fset_buffer (new_current_buffer);
5222
5223 /* Restore the minimum heights recorded in the configuration. */
5224 window_min_height = XINT (data->min_height);
5225 window_min_width = XINT (data->min_width);
5226
5227 Vminibuf_scroll_window = data->minibuf_scroll_window;
5228 minibuf_selected_window = data->minibuf_selected_window;
5229
5230 return (FRAME_LIVE_P (f) ? Qt : Qnil);
5231 }
5232
5233 /* Mark all windows now on frame as deleted
5234 by setting their buffers to nil. */
5235
5236 void
5237 delete_all_subwindows (w)
5238 register struct window *w;
5239 {
5240 if (!NILP (w->next))
5241 delete_all_subwindows (XWINDOW (w->next));
5242 if (!NILP (w->vchild))
5243 delete_all_subwindows (XWINDOW (w->vchild));
5244 if (!NILP (w->hchild))
5245 delete_all_subwindows (XWINDOW (w->hchild));
5246
5247 w->height = w->buffer; /* See Fset_window_configuration for excuse. */
5248
5249 if (!NILP (w->buffer))
5250 unshow_buffer (w);
5251
5252 /* We set all three of these fields to nil, to make sure that we can
5253 distinguish this dead window from any live window. Live leaf
5254 windows will have buffer set, and combination windows will have
5255 vchild or hchild set. */
5256 w->buffer = Qnil;
5257 w->vchild = Qnil;
5258 w->hchild = Qnil;
5259
5260 Vwindow_list = Qnil;
5261 }
5262 \f
5263 static int
5264 count_windows (window)
5265 register struct window *window;
5266 {
5267 register int count = 1;
5268 if (!NILP (window->next))
5269 count += count_windows (XWINDOW (window->next));
5270 if (!NILP (window->vchild))
5271 count += count_windows (XWINDOW (window->vchild));
5272 if (!NILP (window->hchild))
5273 count += count_windows (XWINDOW (window->hchild));
5274 return count;
5275 }
5276
5277
5278 /* Fill vector FLAT with leaf windows under W, starting at index I.
5279 Value is last index + 1. */
5280
5281 static int
5282 get_leaf_windows (w, flat, i)
5283 struct window *w;
5284 struct window **flat;
5285 int i;
5286 {
5287 while (w)
5288 {
5289 if (!NILP (w->hchild))
5290 i = get_leaf_windows (XWINDOW (w->hchild), flat, i);
5291 else if (!NILP (w->vchild))
5292 i = get_leaf_windows (XWINDOW (w->vchild), flat, i);
5293 else
5294 flat[i++] = w;
5295
5296 w = NILP (w->next) ? 0 : XWINDOW (w->next);
5297 }
5298
5299 return i;
5300 }
5301
5302
5303 /* Return a pointer to the glyph W's physical cursor is on. Value is
5304 null if W's current matrix is invalid, so that no meaningfull glyph
5305 can be returned. */
5306
5307 struct glyph *
5308 get_phys_cursor_glyph (w)
5309 struct window *w;
5310 {
5311 struct glyph_row *row;
5312 struct glyph *glyph;
5313
5314 if (w->phys_cursor.vpos >= 0
5315 && w->phys_cursor.vpos < w->current_matrix->nrows
5316 && (row = MATRIX_ROW (w->current_matrix, w->phys_cursor.vpos),
5317 row->enabled_p)
5318 && row->used[TEXT_AREA] > w->phys_cursor.hpos)
5319 glyph = row->glyphs[TEXT_AREA] + w->phys_cursor.hpos;
5320 else
5321 glyph = NULL;
5322
5323 return glyph;
5324 }
5325
5326
5327 static int
5328 save_window_save (window, vector, i)
5329 Lisp_Object window;
5330 struct Lisp_Vector *vector;
5331 int i;
5332 {
5333 register struct saved_window *p;
5334 register struct window *w;
5335 register Lisp_Object tem;
5336
5337 for (;!NILP (window); window = w->next)
5338 {
5339 p = SAVED_WINDOW_N (vector, i);
5340 w = XWINDOW (window);
5341
5342 XSETFASTINT (w->temslot, i++);
5343 p->window = window;
5344 p->buffer = w->buffer;
5345 p->left = w->left;
5346 p->top = w->top;
5347 p->width = w->width;
5348 p->height = w->height;
5349 p->hscroll = w->hscroll;
5350 p->min_hscroll = w->min_hscroll;
5351 p->display_table = w->display_table;
5352 p->orig_top = w->orig_top;
5353 p->orig_height = w->orig_height;
5354 if (!NILP (w->buffer))
5355 {
5356 /* Save w's value of point in the window configuration.
5357 If w is the selected window, then get the value of point
5358 from the buffer; pointm is garbage in the selected window. */
5359 if (EQ (window, selected_window))
5360 {
5361 p->pointm = Fmake_marker ();
5362 set_marker_both (p->pointm, w->buffer,
5363 BUF_PT (XBUFFER (w->buffer)),
5364 BUF_PT_BYTE (XBUFFER (w->buffer)));
5365 }
5366 else
5367 p->pointm = Fcopy_marker (w->pointm, Qnil);
5368
5369 p->start = Fcopy_marker (w->start, Qnil);
5370 p->start_at_line_beg = w->start_at_line_beg;
5371
5372 tem = XBUFFER (w->buffer)->mark;
5373 p->mark = Fcopy_marker (tem, Qnil);
5374 }
5375 else
5376 {
5377 p->pointm = Qnil;
5378 p->start = Qnil;
5379 p->mark = Qnil;
5380 p->start_at_line_beg = Qnil;
5381 }
5382
5383 if (NILP (w->parent))
5384 p->parent = Qnil;
5385 else
5386 p->parent = XWINDOW (w->parent)->temslot;
5387
5388 if (NILP (w->prev))
5389 p->prev = Qnil;
5390 else
5391 p->prev = XWINDOW (w->prev)->temslot;
5392
5393 if (!NILP (w->vchild))
5394 i = save_window_save (w->vchild, vector, i);
5395 if (!NILP (w->hchild))
5396 i = save_window_save (w->hchild, vector, i);
5397 }
5398
5399 return i;
5400 }
5401
5402 DEFUN ("current-window-configuration", Fcurrent_window_configuration,
5403 Scurrent_window_configuration, 0, 1, 0,
5404 doc: /* Return an object representing the current window configuration of FRAME.
5405 If FRAME is nil or omitted, use the selected frame.
5406 This describes the number of windows, their sizes and current buffers,
5407 and for each displayed buffer, where display starts, and the positions of
5408 point and mark. An exception is made for point in the current buffer:
5409 its value is -not- saved.
5410 This also records the currently selected frame, and FRAME's focus
5411 redirection (see `redirect-frame-focus'). */)
5412 (frame)
5413 Lisp_Object frame;
5414 {
5415 register Lisp_Object tem;
5416 register int n_windows;
5417 register struct save_window_data *data;
5418 register struct Lisp_Vector *vec;
5419 register int i;
5420 FRAME_PTR f;
5421
5422 if (NILP (frame))
5423 frame = selected_frame;
5424 CHECK_LIVE_FRAME (frame);
5425 f = XFRAME (frame);
5426
5427 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
5428 vec = allocate_other_vector (VECSIZE (struct save_window_data));
5429 data = (struct save_window_data *)vec;
5430
5431 XSETFASTINT (data->frame_width, FRAME_WIDTH (f));
5432 XSETFASTINT (data->frame_height, FRAME_HEIGHT (f));
5433 XSETFASTINT (data->frame_menu_bar_lines, FRAME_MENU_BAR_LINES (f));
5434 XSETFASTINT (data->frame_tool_bar_lines, FRAME_TOOL_BAR_LINES (f));
5435 data->selected_frame = selected_frame;
5436 data->current_window = FRAME_SELECTED_WINDOW (f);
5437 XSETBUFFER (data->current_buffer, current_buffer);
5438 data->minibuf_scroll_window = minibuf_level > 0 ? Vminibuf_scroll_window : Qnil;
5439 data->minibuf_selected_window = minibuf_level > 0 ? minibuf_selected_window : Qnil;
5440 data->root_window = FRAME_ROOT_WINDOW (f);
5441 data->focus_frame = FRAME_FOCUS_FRAME (f);
5442 XSETINT (data->min_height, window_min_height);
5443 XSETINT (data->min_width, window_min_width);
5444 tem = Fmake_vector (make_number (n_windows), Qnil);
5445 data->saved_windows = tem;
5446 for (i = 0; i < n_windows; i++)
5447 XVECTOR (tem)->contents[i]
5448 = Fmake_vector (make_number (SAVED_WINDOW_VECTOR_SIZE), Qnil);
5449 save_window_save (FRAME_ROOT_WINDOW (f), XVECTOR (tem), 0);
5450 XSETWINDOW_CONFIGURATION (tem, data);
5451 return (tem);
5452 }
5453
5454 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
5455 0, UNEVALLED, 0,
5456 doc: /* Execute body, preserving window sizes and contents.
5457 Restore which buffer appears in which window, where display starts,
5458 and the value of point and mark for each window.
5459 Also restore the choice of selected window.
5460 Also restore which buffer is current.
5461 Does not restore the value of point in current buffer.
5462 usage: (save-window-excursion BODY ...) */)
5463 (args)
5464 Lisp_Object args;
5465 {
5466 register Lisp_Object val;
5467 register int count = SPECPDL_INDEX ();
5468
5469 record_unwind_protect (Fset_window_configuration,
5470 Fcurrent_window_configuration (Qnil));
5471 val = Fprogn (args);
5472 return unbind_to (count, val);
5473 }
5474
5475 \f
5476 /***********************************************************************
5477 Marginal Areas
5478 ***********************************************************************/
5479
5480 DEFUN ("set-window-margins", Fset_window_margins, Sset_window_margins,
5481 2, 3, 0,
5482 doc: /* Set width of marginal areas of window WINDOW.
5483 If window is nil, set margins of the currently selected window.
5484 First parameter LEFT-WIDTH specifies the number of character
5485 cells to reserve for the left marginal area. Second parameter
5486 RIGHT-WIDTH does the same for the right marginal area.
5487 A nil width parameter means no margin. */)
5488 (window, left, right)
5489 Lisp_Object window, left, right;
5490 {
5491 struct window *w = decode_window (window);
5492
5493 if (!NILP (left))
5494 CHECK_NUMBER_OR_FLOAT (left);
5495 if (!NILP (right))
5496 CHECK_NUMBER_OR_FLOAT (right);
5497
5498 /* Check widths < 0 and translate a zero width to nil.
5499 Margins that are too wide have to be checked elsewhere. */
5500 if ((INTEGERP (left) && XINT (left) < 0)
5501 || (FLOATP (left) && XFLOAT_DATA (left) <= 0))
5502 XSETFASTINT (left, 0);
5503 if (INTEGERP (left) && XFASTINT (left) == 0)
5504 left = Qnil;
5505
5506 if ((INTEGERP (right) && XINT (right) < 0)
5507 || (FLOATP (right) && XFLOAT_DATA (right) <= 0))
5508 XSETFASTINT (right, 0);
5509 if (INTEGERP (right) && XFASTINT (right) == 0)
5510 right = Qnil;
5511
5512 w->left_margin_width = left;
5513 w->right_margin_width = right;
5514
5515 ++windows_or_buffers_changed;
5516 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
5517 return Qnil;
5518 }
5519
5520
5521 DEFUN ("window-margins", Fwindow_margins, Swindow_margins,
5522 0, 1, 0,
5523 doc: /* Get width of marginal areas of window WINDOW.
5524 If WINDOW is omitted or nil, use the currently selected window.
5525 Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
5526 If a marginal area does not exist, its width will be returned
5527 as nil. */)
5528 (window)
5529 Lisp_Object window;
5530 {
5531 struct window *w = decode_window (window);
5532 return Fcons (w->left_margin_width, w->right_margin_width);
5533 }
5534
5535
5536 \f
5537 /***********************************************************************
5538 Smooth scrolling
5539 ***********************************************************************/
5540
5541 DEFUN ("window-vscroll", Fwindow_vscroll, Swindow_vscroll, 0, 1, 0,
5542 doc: /* Return the amount by which WINDOW is scrolled vertically.
5543 Use the selected window if WINDOW is nil or omitted.
5544 Value is a multiple of the canonical character height of WINDOW. */)
5545 (window)
5546 Lisp_Object window;
5547 {
5548 Lisp_Object result;
5549 struct frame *f;
5550 struct window *w;
5551
5552 if (NILP (window))
5553 window = selected_window;
5554 else
5555 CHECK_WINDOW (window);
5556 w = XWINDOW (window);
5557 f = XFRAME (w->frame);
5558
5559 if (FRAME_WINDOW_P (f))
5560 result = CANON_Y_FROM_PIXEL_Y (f, -w->vscroll);
5561 else
5562 result = make_number (0);
5563 return result;
5564 }
5565
5566
5567 DEFUN ("set-window-vscroll", Fset_window_vscroll, Sset_window_vscroll,
5568 2, 2, 0,
5569 doc: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
5570 WINDOW nil means use the selected window. VSCROLL is a non-negative
5571 multiple of the canonical character height of WINDOW. */)
5572 (window, vscroll)
5573 Lisp_Object window, vscroll;
5574 {
5575 struct window *w;
5576 struct frame *f;
5577
5578 if (NILP (window))
5579 window = selected_window;
5580 else
5581 CHECK_WINDOW (window);
5582 CHECK_NUMBER_OR_FLOAT (vscroll);
5583
5584 w = XWINDOW (window);
5585 f = XFRAME (w->frame);
5586
5587 if (FRAME_WINDOW_P (f))
5588 {
5589 int old_dy = w->vscroll;
5590
5591 w->vscroll = - CANON_Y_UNIT (f) * XFLOATINT (vscroll);
5592 w->vscroll = min (w->vscroll, 0);
5593
5594 /* Adjust glyph matrix of the frame if the virtual display
5595 area becomes larger than before. */
5596 if (w->vscroll < 0 && w->vscroll < old_dy)
5597 adjust_glyphs (f);
5598
5599 /* Prevent redisplay shortcuts. */
5600 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
5601 }
5602
5603 return Fwindow_vscroll (window);
5604 }
5605
5606 \f
5607 /* Call FN for all leaf windows on frame F. FN is called with the
5608 first argument being a pointer to the leaf window, and with
5609 additional argument USER_DATA. Stops when FN returns 0. */
5610
5611 void
5612 foreach_window (f, fn, user_data)
5613 struct frame *f;
5614 int (* fn) P_ ((struct window *, void *));
5615 void *user_data;
5616 {
5617 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f)), fn, user_data);
5618 }
5619
5620
5621 /* Helper function for foreach_window. Call FN for all leaf windows
5622 reachable from W. FN is called with the first argument being a
5623 pointer to the leaf window, and with additional argument USER_DATA.
5624 Stop when FN returns 0. Value is 0 if stopped by FN. */
5625
5626 static int
5627 foreach_window_1 (w, fn, user_data)
5628 struct window *w;
5629 int (* fn) P_ ((struct window *, void *));
5630 void *user_data;
5631 {
5632 int cont;
5633
5634 for (cont = 1; w && cont;)
5635 {
5636 if (!NILP (w->hchild))
5637 cont = foreach_window_1 (XWINDOW (w->hchild), fn, user_data);
5638 else if (!NILP (w->vchild))
5639 cont = foreach_window_1 (XWINDOW (w->vchild), fn, user_data);
5640 else
5641 cont = fn (w, user_data);
5642
5643 w = NILP (w->next) ? 0 : XWINDOW (w->next);
5644 }
5645
5646 return cont;
5647 }
5648
5649
5650 /* Freeze or unfreeze the window start of W unless it is a
5651 mini-window or the selected window. FREEZE_P non-null means freeze
5652 the window start. */
5653
5654 static int
5655 freeze_window_start (w, freeze_p)
5656 struct window *w;
5657 void *freeze_p;
5658 {
5659 if (w == XWINDOW (selected_window)
5660 || MINI_WINDOW_P (w)
5661 || (MINI_WINDOW_P (XWINDOW (selected_window))
5662 && ! NILP (Vminibuf_scroll_window)
5663 && w == XWINDOW (Vminibuf_scroll_window)))
5664 freeze_p = NULL;
5665
5666 w->frozen_window_start_p = freeze_p != NULL;
5667 return 1;
5668 }
5669
5670
5671 /* Freeze or unfreeze the window starts of all leaf windows on frame
5672 F, except the selected window and a mini-window. FREEZE_P non-zero
5673 means freeze the window start. */
5674
5675 void
5676 freeze_window_starts (f, freeze_p)
5677 struct frame *f;
5678 int freeze_p;
5679 {
5680 foreach_window (f, freeze_window_start, (void *) (freeze_p ? f : 0));
5681 }
5682
5683 \f
5684 /***********************************************************************
5685 Initialization
5686 ***********************************************************************/
5687
5688 /* Return 1 if window configurations C1 and C2
5689 describe the same state of affairs. This is used by Fequal. */
5690
5691 int
5692 compare_window_configurations (c1, c2, ignore_positions)
5693 Lisp_Object c1, c2;
5694 int ignore_positions;
5695 {
5696 register struct save_window_data *d1, *d2;
5697 struct Lisp_Vector *sw1, *sw2;
5698 int i;
5699
5700 if (!WINDOW_CONFIGURATIONP (c1))
5701 wrong_type_argument (Qwindow_configuration_p, c1);
5702 if (!WINDOW_CONFIGURATIONP (c2))
5703 wrong_type_argument (Qwindow_configuration_p, c2);
5704
5705 d1 = (struct save_window_data *) XVECTOR (c1);
5706 d2 = (struct save_window_data *) XVECTOR (c2);
5707 sw1 = XVECTOR (d1->saved_windows);
5708 sw2 = XVECTOR (d2->saved_windows);
5709
5710 if (! EQ (d1->frame_width, d2->frame_width))
5711 return 0;
5712 if (! EQ (d1->frame_height, d2->frame_height))
5713 return 0;
5714 if (! EQ (d1->frame_menu_bar_lines, d2->frame_menu_bar_lines))
5715 return 0;
5716 if (! EQ (d1->selected_frame, d2->selected_frame))
5717 return 0;
5718 /* Don't compare the current_window field directly.
5719 Instead see w1_is_current and w2_is_current, below. */
5720 if (! EQ (d1->current_buffer, d2->current_buffer))
5721 return 0;
5722 if (! ignore_positions)
5723 {
5724 if (! EQ (d1->minibuf_scroll_window, d2->minibuf_scroll_window))
5725 return 0;
5726 if (! EQ (d1->minibuf_selected_window, d2->minibuf_selected_window))
5727 return 0;
5728 }
5729 /* Don't compare the root_window field.
5730 We don't require the two configurations
5731 to use the same window object,
5732 and the two root windows must be equivalent
5733 if everything else compares equal. */
5734 if (! EQ (d1->focus_frame, d2->focus_frame))
5735 return 0;
5736 if (! EQ (d1->min_width, d2->min_width))
5737 return 0;
5738 if (! EQ (d1->min_height, d2->min_height))
5739 return 0;
5740
5741 /* Verify that the two confis have the same number of windows. */
5742 if (sw1->size != sw2->size)
5743 return 0;
5744
5745 for (i = 0; i < sw1->size; i++)
5746 {
5747 struct saved_window *p1, *p2;
5748 int w1_is_current, w2_is_current;
5749
5750 p1 = SAVED_WINDOW_N (sw1, i);
5751 p2 = SAVED_WINDOW_N (sw2, i);
5752
5753 /* Verify that the current windows in the two
5754 configurations correspond to each other. */
5755 w1_is_current = EQ (d1->current_window, p1->window);
5756 w2_is_current = EQ (d2->current_window, p2->window);
5757
5758 if (w1_is_current != w2_is_current)
5759 return 0;
5760
5761 /* Verify that the corresponding windows do match. */
5762 if (! EQ (p1->buffer, p2->buffer))
5763 return 0;
5764 if (! EQ (p1->left, p2->left))
5765 return 0;
5766 if (! EQ (p1->top, p2->top))
5767 return 0;
5768 if (! EQ (p1->width, p2->width))
5769 return 0;
5770 if (! EQ (p1->height, p2->height))
5771 return 0;
5772 if (! EQ (p1->display_table, p2->display_table))
5773 return 0;
5774 if (! EQ (p1->parent, p2->parent))
5775 return 0;
5776 if (! EQ (p1->prev, p2->prev))
5777 return 0;
5778 if (! ignore_positions)
5779 {
5780 if (! EQ (p1->hscroll, p2->hscroll))
5781 return 0;
5782 if (!EQ (p1->min_hscroll, p2->min_hscroll))
5783 return 0;
5784 if (! EQ (p1->start_at_line_beg, p2->start_at_line_beg))
5785 return 0;
5786 if (NILP (Fequal (p1->start, p2->start)))
5787 return 0;
5788 if (NILP (Fequal (p1->pointm, p2->pointm)))
5789 return 0;
5790 if (NILP (Fequal (p1->mark, p2->mark)))
5791 return 0;
5792 }
5793 }
5794
5795 return 1;
5796 }
5797
5798 DEFUN ("compare-window-configurations", Fcompare_window_configurations,
5799 Scompare_window_configurations, 2, 2, 0,
5800 doc: /* Compare two window configurations as regards the structure of windows.
5801 This function ignores details such as the values of point and mark
5802 and scrolling positions. */)
5803 (x, y)
5804 Lisp_Object x, y;
5805 {
5806 if (compare_window_configurations (x, y, 1))
5807 return Qt;
5808 return Qnil;
5809 }
5810 \f
5811 void
5812 init_window_once ()
5813 {
5814 struct frame *f = make_terminal_frame ();
5815 XSETFRAME (selected_frame, f);
5816 Vterminal_frame = selected_frame;
5817 minibuf_window = f->minibuffer_window;
5818 selected_window = f->selected_window;
5819 last_nonminibuf_frame = f;
5820
5821 window_initialized = 1;
5822 }
5823
5824 void
5825 init_window ()
5826 {
5827 Vwindow_list = Qnil;
5828 }
5829
5830 void
5831 syms_of_window ()
5832 {
5833 Qwindow_size_fixed = intern ("window-size-fixed");
5834 staticpro (&Qwindow_size_fixed);
5835
5836 staticpro (&Qwindow_configuration_change_hook);
5837 Qwindow_configuration_change_hook
5838 = intern ("window-configuration-change-hook");
5839
5840 Qwindowp = intern ("windowp");
5841 staticpro (&Qwindowp);
5842
5843 Qwindow_configuration_p = intern ("window-configuration-p");
5844 staticpro (&Qwindow_configuration_p);
5845
5846 Qwindow_live_p = intern ("window-live-p");
5847 staticpro (&Qwindow_live_p);
5848
5849 Qtemp_buffer_show_hook = intern ("temp-buffer-show-hook");
5850 staticpro (&Qtemp_buffer_show_hook);
5851
5852 staticpro (&Vwindow_list);
5853
5854 minibuf_selected_window = Qnil;
5855 staticpro (&minibuf_selected_window);
5856
5857 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
5858 doc: /* Non-nil means call as function to display a help buffer.
5859 The function is called with one argument, the buffer to be displayed.
5860 Used by `with-output-to-temp-buffer'.
5861 If this function is used, then it must do the entire job of showing
5862 the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
5863 Vtemp_buffer_show_function = Qnil;
5864
5865 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
5866 doc: /* If non-nil, function to call to handle `display-buffer'.
5867 It will receive two args, the buffer and a flag which if non-nil means
5868 that the currently selected window is not acceptable.
5869 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
5870 work using this function. */);
5871 Vdisplay_buffer_function = Qnil;
5872
5873 DEFVAR_LISP ("even-window-heights", &Veven_window_heights,
5874 doc: /* *If non-nil, `display-buffer' should even the window heights.
5875 If nil, `display-buffer' will leave the window configuration alone. */);
5876 Veven_window_heights = Qt;
5877
5878 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
5879 doc: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
5880 Vminibuf_scroll_window = Qnil;
5881
5882 DEFVAR_BOOL ("mode-line-in-non-selected-windows", &mode_line_in_non_selected_windows,
5883 doc: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
5884 If the minibuffer is active, the `minibuffer-scroll-window' mode line
5885 is displayed in the `mode-line' face. */);
5886 mode_line_in_non_selected_windows = 1;
5887
5888 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
5889 doc: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
5890 Vother_window_scroll_buffer = Qnil;
5891
5892 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
5893 doc: /* *Non-nil means `display-buffer' should make a separate frame. */);
5894 pop_up_frames = 0;
5895
5896 DEFVAR_BOOL ("display-buffer-reuse-frames", &display_buffer_reuse_frames,
5897 doc: /* *Non-nil means `display-buffer' should reuse frames.
5898 If the buffer in question is already displayed in a frame, raise that frame. */);
5899 display_buffer_reuse_frames = 0;
5900
5901 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
5902 doc: /* Function to call to handle automatic new frame creation.
5903 It is called with no arguments and should return a newly created frame.
5904
5905 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
5906 where `pop-up-frame-alist' would hold the default frame parameters. */);
5907 Vpop_up_frame_function = Qnil;
5908
5909 DEFVAR_LISP ("special-display-buffer-names", &Vspecial_display_buffer_names,
5910 doc: /* *List of buffer names that should have their own special frames.
5911 Displaying a buffer whose name is in this list makes a special frame for it
5912 using `special-display-function'. See also `special-display-regexps'.
5913
5914 An element of the list can be a list instead of just a string.
5915 There are two ways to use a list as an element:
5916 (BUFFER FRAME-PARAMETERS...) (BUFFER FUNCTION OTHER-ARGS...)
5917 In the first case, FRAME-PARAMETERS are used to create the frame.
5918 In the latter case, FUNCTION is called with BUFFER as the first argument,
5919 followed by OTHER-ARGS--it can display BUFFER in any way it likes.
5920 All this is done by the function found in `special-display-function'.
5921
5922 If this variable appears \"not to work\", because you add a name to it
5923 but that buffer still appears in the selected window, look at the
5924 values of `same-window-buffer-names' and `same-window-regexps'.
5925 Those variables take precedence over this one. */);
5926 Vspecial_display_buffer_names = Qnil;
5927
5928 DEFVAR_LISP ("special-display-regexps", &Vspecial_display_regexps,
5929 doc: /* *List of regexps saying which buffers should have their own special frames.
5930 If a buffer name matches one of these regexps, it gets its own frame.
5931 Displaying a buffer whose name is in this list makes a special frame for it
5932 using `special-display-function'.
5933
5934 An element of the list can be a list instead of just a string.
5935 There are two ways to use a list as an element:
5936 (REGEXP FRAME-PARAMETERS...) (REGEXP FUNCTION OTHER-ARGS...)
5937 In the first case, FRAME-PARAMETERS are used to create the frame.
5938 In the latter case, FUNCTION is called with the buffer as first argument,
5939 followed by OTHER-ARGS--it can display the buffer in any way it likes.
5940 All this is done by the function found in `special-display-function'.
5941
5942 If this variable appears \"not to work\", because you add a regexp to it
5943 but the matching buffers still appear in the selected window, look at the
5944 values of `same-window-buffer-names' and `same-window-regexps'.
5945 Those variables take precedence over this one. */);
5946 Vspecial_display_regexps = Qnil;
5947
5948 DEFVAR_LISP ("special-display-function", &Vspecial_display_function,
5949 doc: /* Function to call to make a new frame for a special buffer.
5950 It is called with two arguments, the buffer and optional buffer specific
5951 data, and should return a window displaying that buffer.
5952 The default value makes a separate frame for the buffer,
5953 using `special-display-frame-alist' to specify the frame parameters.
5954
5955 A buffer is special if its is listed in `special-display-buffer-names'
5956 or matches a regexp in `special-display-regexps'. */);
5957 Vspecial_display_function = Qnil;
5958
5959 DEFVAR_LISP ("same-window-buffer-names", &Vsame_window_buffer_names,
5960 doc: /* *List of buffer names that should appear in the selected window.
5961 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
5962 switches to it in the selected window, rather than making it appear
5963 in some other window.
5964
5965 An element of the list can be a cons cell instead of just a string.
5966 Then the car must be a string, which specifies the buffer name.
5967 This is for compatibility with `special-display-buffer-names';
5968 the cdr of the cons cell is ignored.
5969
5970 See also `same-window-regexps'. */);
5971 Vsame_window_buffer_names = Qnil;
5972
5973 DEFVAR_LISP ("same-window-regexps", &Vsame_window_regexps,
5974 doc: /* *List of regexps saying which buffers should appear in the selected window.
5975 If a buffer name matches one of these regexps, then displaying it
5976 using `display-buffer' or `pop-to-buffer' switches to it
5977 in the selected window, rather than making it appear in some other window.
5978
5979 An element of the list can be a cons cell instead of just a string.
5980 Then the car must be a string, which specifies the buffer name.
5981 This is for compatibility with `special-display-buffer-names';
5982 the cdr of the cons cell is ignored.
5983
5984 See also `same-window-buffer-names'. */);
5985 Vsame_window_regexps = Qnil;
5986
5987 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
5988 doc: /* *Non-nil means display-buffer should make new windows. */);
5989 pop_up_windows = 1;
5990
5991 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
5992 doc: /* *Number of lines of continuity when scrolling by screenfuls. */);
5993 next_screen_context_lines = 2;
5994
5995 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
5996 doc: /* *display-buffer would prefer to split the largest window if this large.
5997 If there is only one window, it is split regardless of this value. */);
5998 split_height_threshold = 500;
5999
6000 DEFVAR_INT ("window-min-height", &window_min_height,
6001 doc: /* *Delete any window less than this tall (including its mode line). */);
6002 window_min_height = 4;
6003
6004 DEFVAR_INT ("window-min-width", &window_min_width,
6005 doc: /* *Delete any window less than this wide. */);
6006 window_min_width = 10;
6007
6008 DEFVAR_LISP ("scroll-preserve-screen-position",
6009 &Vscroll_preserve_screen_position,
6010 doc: /* *Non-nil means scroll commands move point to keep its screen line unchanged. */);
6011 Vscroll_preserve_screen_position = Qnil;
6012
6013 DEFVAR_LISP ("window-configuration-change-hook",
6014 &Vwindow_configuration_change_hook,
6015 doc: /* Functions to call when window configuration changes.
6016 The selected frame is the one whose configuration has changed. */);
6017 Vwindow_configuration_change_hook = Qnil;
6018
6019 DEFVAR_BOOL ("window-size-fixed", &window_size_fixed,
6020 doc: /* Non-nil in a buffer means windows displaying the buffer are fixed-size.
6021 Emacs won't change the size of any window displaying that buffer,
6022 unless you explicitly change the size, or Emacs has no other choice.
6023 This variable automatically becomes buffer-local when set. */);
6024 Fmake_variable_buffer_local (Qwindow_size_fixed);
6025 window_size_fixed = 0;
6026
6027 defsubr (&Sselected_window);
6028 defsubr (&Sminibuffer_window);
6029 defsubr (&Swindow_minibuffer_p);
6030 defsubr (&Swindowp);
6031 defsubr (&Swindow_live_p);
6032 defsubr (&Spos_visible_in_window_p);
6033 defsubr (&Swindow_buffer);
6034 defsubr (&Swindow_height);
6035 defsubr (&Swindow_width);
6036 defsubr (&Swindow_hscroll);
6037 defsubr (&Sset_window_hscroll);
6038 defsubr (&Swindow_redisplay_end_trigger);
6039 defsubr (&Sset_window_redisplay_end_trigger);
6040 defsubr (&Swindow_edges);
6041 defsubr (&Scoordinates_in_window_p);
6042 defsubr (&Swindow_at);
6043 defsubr (&Swindow_point);
6044 defsubr (&Swindow_start);
6045 defsubr (&Swindow_end);
6046 defsubr (&Sset_window_point);
6047 defsubr (&Sset_window_start);
6048 defsubr (&Swindow_dedicated_p);
6049 defsubr (&Sset_window_dedicated_p);
6050 defsubr (&Swindow_display_table);
6051 defsubr (&Sset_window_display_table);
6052 defsubr (&Snext_window);
6053 defsubr (&Sprevious_window);
6054 defsubr (&Sother_window);
6055 defsubr (&Sget_lru_window);
6056 defsubr (&Sget_largest_window);
6057 defsubr (&Sget_buffer_window);
6058 defsubr (&Sdelete_other_windows);
6059 defsubr (&Sdelete_windows_on);
6060 defsubr (&Sreplace_buffer_in_windows);
6061 defsubr (&Sdelete_window);
6062 defsubr (&Sset_window_buffer);
6063 defsubr (&Sselect_window);
6064 defsubr (&Sspecial_display_p);
6065 defsubr (&Ssame_window_p);
6066 defsubr (&Sdisplay_buffer);
6067 defsubr (&Ssplit_window);
6068 defsubr (&Senlarge_window);
6069 defsubr (&Sshrink_window);
6070 defsubr (&Sscroll_up);
6071 defsubr (&Sscroll_down);
6072 defsubr (&Sscroll_left);
6073 defsubr (&Sscroll_right);
6074 defsubr (&Sother_window_for_scrolling);
6075 defsubr (&Sscroll_other_window);
6076 defsubr (&Sminibuffer_selected_window);
6077 defsubr (&Srecenter);
6078 defsubr (&Swindow_text_height);
6079 defsubr (&Smove_to_window_line);
6080 defsubr (&Swindow_configuration_p);
6081 defsubr (&Swindow_configuration_frame);
6082 defsubr (&Sset_window_configuration);
6083 defsubr (&Scurrent_window_configuration);
6084 defsubr (&Ssave_window_excursion);
6085 defsubr (&Sset_window_margins);
6086 defsubr (&Swindow_margins);
6087 defsubr (&Swindow_vscroll);
6088 defsubr (&Sset_window_vscroll);
6089 defsubr (&Scompare_window_configurations);
6090 defsubr (&Swindow_list);
6091 }
6092
6093 void
6094 keys_of_window ()
6095 {
6096 initial_define_key (control_x_map, '1', "delete-other-windows");
6097 initial_define_key (control_x_map, '2', "split-window");
6098 initial_define_key (control_x_map, '0', "delete-window");
6099 initial_define_key (control_x_map, 'o', "other-window");
6100 initial_define_key (control_x_map, '^', "enlarge-window");
6101 initial_define_key (control_x_map, '<', "scroll-left");
6102 initial_define_key (control_x_map, '>', "scroll-right");
6103
6104 initial_define_key (global_map, Ctl ('V'), "scroll-up");
6105 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
6106 initial_define_key (meta_map, 'v', "scroll-down");
6107
6108 initial_define_key (global_map, Ctl('L'), "recenter");
6109 initial_define_key (meta_map, 'r', "move-to-window-line");
6110 }