]> code.delx.au - gnu-emacs/blob - src/window.c
Merge from emacs--devo--0
[gnu-emacs] / src / window.c
1 /* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
3 Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1996, 1997, 1998, 2000,
4 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
5 Free Software Foundation, Inc.
6
7 This file is part of GNU Emacs.
8
9 GNU Emacs is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3, or (at your option)
12 any later version.
13
14 GNU Emacs is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
18
19 You should have received a copy of the GNU General Public License
20 along with GNU Emacs; see the file COPYING. If not, write to
21 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA. */
23
24 #include <config.h>
25 #include <stdio.h>
26
27 #include "lisp.h"
28 #include "buffer.h"
29 #include "keyboard.h"
30 #include "keymap.h"
31 #include "frame.h"
32 #include "window.h"
33 #include "commands.h"
34 #include "indent.h"
35 #include "termchar.h"
36 #include "disptab.h"
37 #include "dispextern.h"
38 #include "blockinput.h"
39 #include "intervals.h"
40 #include "termhooks.h" /* For FRAME_TERMINAL. */
41
42 #ifdef HAVE_X_WINDOWS
43 #include "xterm.h"
44 #endif /* HAVE_X_WINDOWS */
45 #ifdef WINDOWSNT
46 #include "w32term.h"
47 #endif
48 #ifdef MSDOS
49 #include "msdos.h"
50 #endif
51 #ifdef MAC_OS
52 #include "macterm.h"
53 #endif
54
55
56 Lisp_Object Qwindowp, Qwindow_live_p, Qwindow_configuration_p;
57 Lisp_Object Qscroll_up, Qscroll_down;
58 Lisp_Object Qwindow_size_fixed;
59 extern Lisp_Object Qleft_margin, Qright_margin;
60
61 static int displayed_window_lines P_ ((struct window *));
62 static struct window *decode_window P_ ((Lisp_Object));
63 static int count_windows P_ ((struct window *));
64 static int get_leaf_windows P_ ((struct window *, struct window **, int));
65 static void window_scroll P_ ((Lisp_Object, int, int, int));
66 static void window_scroll_pixel_based P_ ((Lisp_Object, int, int, int));
67 static void window_scroll_line_based P_ ((Lisp_Object, int, int, int));
68 static int window_min_size_1 P_ ((struct window *, int));
69 static int window_min_size_2 P_ ((struct window *, int));
70 static int window_min_size P_ ((struct window *, int, int, int *));
71 static void size_window P_ ((Lisp_Object, int, int, int, int, int));
72 static int freeze_window_start P_ ((struct window *, void *));
73 static int window_fixed_size_p P_ ((struct window *, int, int));
74 static void enlarge_window P_ ((Lisp_Object, int, int));
75 static Lisp_Object window_list P_ ((void));
76 static int add_window_to_list P_ ((struct window *, void *));
77 static int candidate_window_p P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
78 Lisp_Object));
79 static Lisp_Object next_window P_ ((Lisp_Object, Lisp_Object,
80 Lisp_Object, int));
81 static void decode_next_window_args P_ ((Lisp_Object *, Lisp_Object *,
82 Lisp_Object *));
83 static int foreach_window_1 P_ ((struct window *,
84 int (* fn) (struct window *, void *),
85 void *));
86 static Lisp_Object window_list_1 P_ ((Lisp_Object, Lisp_Object, Lisp_Object));
87
88 /* This is the window in which the terminal's cursor should
89 be left when nothing is being done with it. This must
90 always be a leaf window, and its buffer is selected by
91 the top level editing loop at the end of each command.
92
93 This value is always the same as
94 FRAME_SELECTED_WINDOW (selected_frame). */
95
96 Lisp_Object selected_window;
97
98 /* A list of all windows for use by next_window and Fwindow_list.
99 Functions creating or deleting windows should invalidate this cache
100 by setting it to nil. */
101
102 Lisp_Object Vwindow_list;
103
104 /* The mini-buffer window of the selected frame.
105 Note that you cannot test for mini-bufferness of an arbitrary window
106 by comparing against this; but you can test for mini-bufferness of
107 the selected window. */
108
109 Lisp_Object minibuf_window;
110
111 /* Non-nil means it is the window whose mode line should be
112 shown as the selected window when the minibuffer is selected. */
113
114 Lisp_Object minibuf_selected_window;
115
116 /* Non-nil means it is the window for C-M-v to scroll
117 when the mini-buffer is selected. */
118
119 Lisp_Object Vminibuf_scroll_window;
120
121 /* Non-nil means this is the buffer whose window C-M-v should scroll. */
122
123 Lisp_Object Vother_window_scroll_buffer;
124
125 /* Non-nil means it's function to call to display temp buffers. */
126
127 Lisp_Object Vtemp_buffer_show_function;
128
129 /* Non-zero means line and page scrolling on tall lines (with images)
130 does partial scrolling by modifying window-vscroll. */
131
132 int auto_window_vscroll_p;
133
134 /* Non-zero means to use mode-line-inactive face in all windows but the
135 selected-window and the minibuffer-scroll-window when the
136 minibuffer is active. */
137 int mode_line_in_non_selected_windows;
138
139 /* If a window gets smaller than either of these, it is removed. */
140
141 EMACS_INT window_min_height;
142 EMACS_INT window_min_width;
143
144 /* Nonzero implies Fdisplay_buffer should create windows. */
145
146 int pop_up_windows;
147
148 /* Nonzero implies make new frames for Fdisplay_buffer. */
149
150 int pop_up_frames;
151
152 /* Nonzero means reuse existing frames for displaying buffers. */
153
154 int display_buffer_reuse_frames;
155
156 /* Non-nil means use this function instead of default */
157
158 Lisp_Object Vpop_up_frame_function;
159
160 /* Function to call to handle Fdisplay_buffer. */
161
162 Lisp_Object Vdisplay_buffer_function;
163
164 /* Non-nil means that Fdisplay_buffer should even the heights of windows. */
165
166 Lisp_Object Veven_window_heights;
167
168 /* List of buffer *names* for buffers that should have their own frames. */
169
170 Lisp_Object Vspecial_display_buffer_names;
171
172 /* List of regexps for buffer names that should have their own frames. */
173
174 Lisp_Object Vspecial_display_regexps;
175
176 /* Function to pop up a special frame. */
177
178 Lisp_Object Vspecial_display_function;
179
180 /* List of buffer *names* for buffers to appear in selected window. */
181
182 Lisp_Object Vsame_window_buffer_names;
183
184 /* List of regexps for buffer names to appear in selected window. */
185
186 Lisp_Object Vsame_window_regexps;
187
188 /* Hook run at end of temp_output_buffer_show. */
189
190 Lisp_Object Qtemp_buffer_show_hook;
191
192 /* Fdisplay_buffer always splits the largest window
193 if that window is more than this high. */
194
195 EMACS_INT split_height_threshold;
196
197 /* How to split windows (horizontally/vertically/hybrid). */
198
199 Lisp_Object Vsplit_window_preferred_function;
200
201 /* Number of lines of continuity in scrolling by screenfuls. */
202
203 EMACS_INT next_screen_context_lines;
204
205 /* Incremented for each window created. */
206
207 static int sequence_number;
208
209 /* Nonzero after init_window_once has finished. */
210
211 static int window_initialized;
212
213 /* Hook to run when window config changes. */
214
215 Lisp_Object Qwindow_configuration_change_hook;
216 Lisp_Object Vwindow_configuration_change_hook;
217
218 /* Non-nil means scroll commands try to put point
219 at the same screen height as previously. */
220
221 Lisp_Object Vscroll_preserve_screen_position;
222
223 /* Incremented by 1 whenever a window is deleted. */
224
225 int window_deletion_count;
226
227 /* Used by the function window_scroll_pixel_based */
228
229 static int window_scroll_pixel_based_preserve_y;
230
231 #if 0 /* This isn't used anywhere. */
232 /* Nonzero means we can split a frame even if it is "unsplittable". */
233 static int inhibit_frame_unsplittable;
234 #endif /* 0 */
235
236 extern EMACS_INT scroll_margin;
237
238 extern Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
239 \f
240 DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
241 doc: /* Returns t if OBJECT is a window. */)
242 (object)
243 Lisp_Object object;
244 {
245 return WINDOWP (object) ? Qt : Qnil;
246 }
247
248 DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
249 doc: /* Returns t if OBJECT is a window which is currently visible. */)
250 (object)
251 Lisp_Object object;
252 {
253 return WINDOW_LIVE_P (object) ? Qt : Qnil;
254 }
255
256 Lisp_Object
257 make_window ()
258 {
259 Lisp_Object val;
260 register struct window *p;
261
262 p = allocate_window ();
263 ++sequence_number;
264 XSETFASTINT (p->sequence_number, sequence_number);
265 XSETFASTINT (p->left_col, 0);
266 XSETFASTINT (p->top_line, 0);
267 XSETFASTINT (p->total_lines, 0);
268 XSETFASTINT (p->total_cols, 0);
269 XSETFASTINT (p->hscroll, 0);
270 XSETFASTINT (p->min_hscroll, 0);
271 p->orig_top_line = p->orig_total_lines = Qnil;
272 p->start = Fmake_marker ();
273 p->pointm = Fmake_marker ();
274 XSETFASTINT (p->use_time, 0);
275 p->frame = Qnil;
276 p->display_table = Qnil;
277 p->dedicated = Qnil;
278 p->pseudo_window_p = 0;
279 bzero (&p->cursor, sizeof (p->cursor));
280 bzero (&p->last_cursor, sizeof (p->last_cursor));
281 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
282 p->desired_matrix = p->current_matrix = 0;
283 p->nrows_scale_factor = p->ncols_scale_factor = 1;
284 p->phys_cursor_type = -1;
285 p->phys_cursor_width = -1;
286 p->must_be_updated_p = 0;
287 XSETFASTINT (p->window_end_vpos, 0);
288 XSETFASTINT (p->window_end_pos, 0);
289 p->window_end_valid = Qnil;
290 p->vscroll = 0;
291 XSETWINDOW (val, p);
292 XSETFASTINT (p->last_point, 0);
293 p->frozen_window_start_p = 0;
294 p->last_cursor_off_p = p->cursor_off_p = 0;
295 p->left_margin_cols = Qnil;
296 p->right_margin_cols = Qnil;
297 p->left_fringe_width = Qnil;
298 p->right_fringe_width = Qnil;
299 p->fringes_outside_margins = Qnil;
300 p->scroll_bar_width = Qnil;
301 p->vertical_scroll_bar_type = Qt;
302
303 Vwindow_list = Qnil;
304 return val;
305 }
306
307 DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
308 doc: /* Return the window that the cursor now appears in and commands apply to. */)
309 ()
310 {
311 return selected_window;
312 }
313
314 DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
315 doc: /* Return the window used now for minibuffers.
316 If the optional argument FRAME is specified, return the minibuffer window
317 used by that frame. */)
318 (frame)
319 Lisp_Object frame;
320 {
321 if (NILP (frame))
322 frame = selected_frame;
323 CHECK_LIVE_FRAME (frame);
324 return FRAME_MINIBUF_WINDOW (XFRAME (frame));
325 }
326
327 DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p, Swindow_minibuffer_p, 0, 1, 0,
328 doc: /* Returns non-nil if WINDOW is a minibuffer window.
329 WINDOW defaults to the selected window. */)
330 (window)
331 Lisp_Object window;
332 {
333 struct window *w = decode_window (window);
334 return MINI_WINDOW_P (w) ? Qt : Qnil;
335 }
336
337
338 DEFUN ("pos-visible-in-window-p", Fpos_visible_in_window_p,
339 Spos_visible_in_window_p, 0, 3, 0,
340 doc: /* Return non-nil if position POS is currently on the frame in WINDOW.
341 Return nil if that position is scrolled vertically out of view.
342 If a character is only partially visible, nil is returned, unless the
343 optional argument PARTIALLY is non-nil.
344 If POS is only out of view because of horizontal scrolling, return non-nil.
345 If POS is t, it specifies the position of the last visible glyph in WINDOW.
346 POS defaults to point in WINDOW; WINDOW defaults to the selected window.
347
348 If POS is visible, return t if PARTIALLY is nil; if PARTIALLY is non-nil,
349 return value is a list of 2 or 6 elements (X Y [RTOP RBOT ROWH VPOS]),
350 where X and Y are the pixel coordinates relative to the top left corner
351 of the window. The remaining elements are omitted if the character after
352 POS is fully visible; otherwise, RTOP and RBOT are the number of pixels
353 off-window at the top and bottom of the row, ROWH is the height of the
354 display row, and VPOS is the row number (0-based) containing POS. */)
355 (pos, window, partially)
356 Lisp_Object pos, window, partially;
357 {
358 register struct window *w;
359 register int posint;
360 register struct buffer *buf;
361 struct text_pos top;
362 Lisp_Object in_window = Qnil;
363 int rtop, rbot, rowh, vpos, fully_p = 1;
364 int x, y;
365
366 w = decode_window (window);
367 buf = XBUFFER (w->buffer);
368 SET_TEXT_POS_FROM_MARKER (top, w->start);
369
370 if (EQ (pos, Qt))
371 posint = -1;
372 else if (!NILP (pos))
373 {
374 CHECK_NUMBER_COERCE_MARKER (pos);
375 posint = XINT (pos);
376 }
377 else if (w == XWINDOW (selected_window))
378 posint = PT;
379 else
380 posint = XMARKER (w->pointm)->charpos;
381
382 /* If position is above window start or outside buffer boundaries,
383 or if window start is out of range, position is not visible. */
384 if ((EQ (pos, Qt)
385 || (posint >= CHARPOS (top) && posint <= BUF_ZV (buf)))
386 && CHARPOS (top) >= BUF_BEGV (buf)
387 && CHARPOS (top) <= BUF_ZV (buf)
388 && pos_visible_p (w, posint, &x, &y, &rtop, &rbot, &rowh, &vpos)
389 && (fully_p = !rtop && !rbot, (!NILP (partially) || fully_p)))
390 in_window = Qt;
391
392 if (!NILP (in_window) && !NILP (partially))
393 {
394 Lisp_Object part = Qnil;
395 if (!fully_p)
396 part = list4 (make_number (rtop), make_number (rbot),
397 make_number (rowh), make_number (vpos));
398 in_window = Fcons (make_number (x),
399 Fcons (make_number (y), part));
400 }
401
402 return in_window;
403 }
404
405 DEFUN ("window-line-height", Fwindow_line_height,
406 Swindow_line_height, 0, 2, 0,
407 doc: /* Return height in pixels of text line LINE in window WINDOW.
408 If WINDOW is nil or omitted, use selected window.
409
410 Return height of current line if LINE is omitted or nil. Return height of
411 header or mode line if LINE is `header-line' and `mode-line'.
412 Otherwise, LINE is a text line number starting from 0. A negative number
413 counts from the end of the window.
414
415 Value is a list (HEIGHT VPOS YPOS OFFBOT), where HEIGHT is the height
416 in pixels of the visible part of the line, VPOS and YPOS are the
417 vertical position in lines and pixels of the line, relative to the top
418 of the first text line, and OFFBOT is the number of off-window pixels at
419 the bottom of the text line. If there are off-window pixels at the top
420 of the (first) text line, YPOS is negative.
421
422 Return nil if window display is not up-to-date. In that case, use
423 `pos-visible-in-window-p' to obtain the information. */)
424 (line, window)
425 Lisp_Object line, window;
426 {
427 register struct window *w;
428 register struct buffer *b;
429 struct glyph_row *row, *end_row;
430 int max_y, crop, i, n;
431
432 w = decode_window (window);
433
434 if (noninteractive
435 || w->pseudo_window_p)
436 return Qnil;
437
438 CHECK_BUFFER (w->buffer);
439 b = XBUFFER (w->buffer);
440
441 /* Fail if current matrix is not up-to-date. */
442 if (NILP (w->window_end_valid)
443 || current_buffer->clip_changed
444 || current_buffer->prevent_redisplay_optimizations_p
445 || XFASTINT (w->last_modified) < BUF_MODIFF (b)
446 || XFASTINT (w->last_overlay_modified) < BUF_OVERLAY_MODIFF (b))
447 return Qnil;
448
449 if (NILP (line))
450 {
451 i = w->cursor.vpos;
452 if (i < 0 || i >= w->current_matrix->nrows
453 || (row = MATRIX_ROW (w->current_matrix, i), !row->enabled_p))
454 return Qnil;
455 max_y = window_text_bottom_y (w);
456 goto found_row;
457 }
458
459 if (EQ (line, Qheader_line))
460 {
461 if (!WINDOW_WANTS_HEADER_LINE_P (w))
462 return Qnil;
463 row = MATRIX_HEADER_LINE_ROW (w->current_matrix);
464 if (!row->enabled_p)
465 return Qnil;
466 return list4 (make_number (row->height),
467 make_number (0), make_number (0),
468 make_number (0));
469 }
470
471 if (EQ (line, Qmode_line))
472 {
473 row = MATRIX_MODE_LINE_ROW (w->current_matrix);
474 if (!row->enabled_p)
475 return Qnil;
476 return list4 (make_number (row->height),
477 make_number (0), /* not accurate */
478 make_number (WINDOW_HEADER_LINE_HEIGHT (w)
479 + window_text_bottom_y (w)),
480 make_number (0));
481 }
482
483 CHECK_NUMBER (line);
484 n = XINT (line);
485
486 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
487 end_row = MATRIX_BOTTOM_TEXT_ROW (w->current_matrix, w);
488 max_y = window_text_bottom_y (w);
489 i = 0;
490
491 while ((n < 0 || i < n)
492 && row <= end_row && row->enabled_p
493 && row->y + row->height < max_y)
494 row++, i++;
495
496 if (row > end_row || !row->enabled_p)
497 return Qnil;
498
499 if (++n < 0)
500 {
501 if (-n > i)
502 return Qnil;
503 row += n;
504 i += n;
505 }
506
507 found_row:
508 crop = max (0, (row->y + row->height) - max_y);
509 return list4 (make_number (row->height + min (0, row->y) - crop),
510 make_number (i),
511 make_number (row->y),
512 make_number (crop));
513 }
514
515
516 \f
517 static struct window *
518 decode_window (window)
519 register Lisp_Object window;
520 {
521 if (NILP (window))
522 return XWINDOW (selected_window);
523
524 CHECK_LIVE_WINDOW (window);
525 return XWINDOW (window);
526 }
527
528 static struct window *
529 decode_any_window (window)
530 register Lisp_Object window;
531 {
532 if (NILP (window))
533 return XWINDOW (selected_window);
534
535 CHECK_WINDOW (window);
536 return XWINDOW (window);
537 }
538
539 DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
540 doc: /* Return the buffer that WINDOW is displaying.
541 WINDOW defaults to the selected window. */)
542 (window)
543 Lisp_Object window;
544 {
545 return decode_window (window)->buffer;
546 }
547
548 DEFUN ("window-height", Fwindow_height, Swindow_height, 0, 1, 0,
549 doc: /* Return the number of lines in WINDOW (including its mode line).
550 WINDOW defaults to the selected window. */)
551 (window)
552 Lisp_Object window;
553 {
554 return decode_any_window (window)->total_lines;
555 }
556
557 DEFUN ("window-width", Fwindow_width, Swindow_width, 0, 1, 0,
558 doc: /* Return the number of display columns in WINDOW.
559 This is the width that is usable columns available for text in WINDOW.
560 If you want to find out how many columns WINDOW takes up,
561 use (let ((edges (window-edges))) (- (nth 2 edges) (nth 0 edges))). */)
562 (window)
563 Lisp_Object window;
564 {
565 return make_number (window_box_text_cols (decode_any_window (window)));
566 }
567
568 DEFUN ("window-full-width-p", Fwindow_full_width_p, Swindow_full_width_p, 0, 1, 0,
569 doc: /* Return t if WINDOW is as wide as its frame.
570 WINDOW defaults to the selected window. */)
571 (window)
572 Lisp_Object window;
573 {
574 return WINDOW_FULL_WIDTH_P (decode_any_window (window)) ? Qt : Qnil;
575 }
576
577 DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
578 doc: /* Return the number of columns by which WINDOW is scrolled from left margin.
579 WINDOW defaults to the selected window. */)
580 (window)
581 Lisp_Object window;
582 {
583 return decode_window (window)->hscroll;
584 }
585
586 DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
587 doc: /* Set number of columns WINDOW is scrolled from left margin to NCOL.
588 Return NCOL. NCOL should be zero or positive.
589
590 Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
591 window so that the location of point moves off-window. */)
592 (window, ncol)
593 Lisp_Object window, ncol;
594 {
595 struct window *w = decode_window (window);
596 int hscroll;
597
598 CHECK_NUMBER (ncol);
599 hscroll = max (0, XINT (ncol));
600
601 /* Prevent redisplay shortcuts when changing the hscroll. */
602 if (XINT (w->hscroll) != hscroll)
603 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
604
605 w->hscroll = make_number (hscroll);
606 return ncol;
607 }
608
609 DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger,
610 Swindow_redisplay_end_trigger, 0, 1, 0,
611 doc: /* Return WINDOW's redisplay end trigger value.
612 WINDOW defaults to the selected window.
613 See `set-window-redisplay-end-trigger' for more information. */)
614 (window)
615 Lisp_Object window;
616 {
617 return decode_window (window)->redisplay_end_trigger;
618 }
619
620 DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger,
621 Sset_window_redisplay_end_trigger, 2, 2, 0,
622 doc: /* Set WINDOW's redisplay end trigger value to VALUE.
623 VALUE should be a buffer position (typically a marker) or nil.
624 If it is a buffer position, then if redisplay in WINDOW reaches a position
625 beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
626 with two arguments: WINDOW, and the end trigger value.
627 Afterwards the end-trigger value is reset to nil. */)
628 (window, value)
629 register Lisp_Object window, value;
630 {
631 register struct window *w;
632
633 w = decode_window (window);
634 w->redisplay_end_trigger = value;
635 return value;
636 }
637
638 DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
639 doc: /* Return a list of the edge coordinates of WINDOW.
640 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
641 RIGHT is one more than the rightmost column occupied by WINDOW,
642 and BOTTOM is one more than the bottommost row occupied by WINDOW.
643 The edges include the space used by the window's scroll bar,
644 display margins, fringes, header line, and mode line, if it has them.
645 To get the edges of the actual text area, use `window-inside-edges'. */)
646 (window)
647 Lisp_Object window;
648 {
649 register struct window *w = decode_any_window (window);
650
651 return Fcons (make_number (WINDOW_LEFT_EDGE_COL (w)),
652 Fcons (make_number (WINDOW_TOP_EDGE_LINE (w)),
653 Fcons (make_number (WINDOW_RIGHT_EDGE_COL (w)),
654 Fcons (make_number (WINDOW_BOTTOM_EDGE_LINE (w)),
655 Qnil))));
656 }
657
658 DEFUN ("window-pixel-edges", Fwindow_pixel_edges, Swindow_pixel_edges, 0, 1, 0,
659 doc: /* Return a list of the edge pixel coordinates of WINDOW.
660 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
661 RIGHT is one more than the rightmost x position occupied by WINDOW,
662 and BOTTOM is one more than the bottommost y position occupied by WINDOW.
663 The pixel edges include the space used by the window's scroll bar,
664 display margins, fringes, header line, and mode line, if it has them.
665 To get the edges of the actual text area, use `window-inside-pixel-edges'. */)
666 (window)
667 Lisp_Object window;
668 {
669 register struct window *w = decode_any_window (window);
670
671 return Fcons (make_number (WINDOW_LEFT_EDGE_X (w)),
672 Fcons (make_number (WINDOW_TOP_EDGE_Y (w)),
673 Fcons (make_number (WINDOW_RIGHT_EDGE_X (w)),
674 Fcons (make_number (WINDOW_BOTTOM_EDGE_Y (w)),
675 Qnil))));
676 }
677
678 DEFUN ("window-inside-edges", Fwindow_inside_edges, Swindow_inside_edges, 0, 1, 0,
679 doc: /* Return a list of the edge coordinates of WINDOW.
680 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
681 RIGHT is one more than the rightmost column used by text in WINDOW,
682 and BOTTOM is one more than the bottommost row used by text in WINDOW.
683 The inside edges do not include the space used by the window's scroll bar,
684 display margins, fringes, header line, and/or mode line. */)
685 (window)
686 Lisp_Object window;
687 {
688 register struct window *w = decode_any_window (window);
689
690 return list4 (make_number (WINDOW_BOX_LEFT_EDGE_COL (w)
691 + WINDOW_LEFT_MARGIN_COLS (w)
692 + WINDOW_LEFT_FRINGE_COLS (w)),
693 make_number (WINDOW_TOP_EDGE_LINE (w)
694 + WINDOW_HEADER_LINE_LINES (w)),
695 make_number (WINDOW_BOX_RIGHT_EDGE_COL (w)
696 - WINDOW_RIGHT_MARGIN_COLS (w)
697 - WINDOW_RIGHT_FRINGE_COLS (w)),
698 make_number (WINDOW_BOTTOM_EDGE_LINE (w)
699 - WINDOW_MODE_LINE_LINES (w)));
700 }
701
702 DEFUN ("window-inside-pixel-edges", Fwindow_inside_pixel_edges, Swindow_inside_pixel_edges, 0, 1, 0,
703 doc: /* Return a list of the edge pixel coordinates of WINDOW.
704 \(LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of frame.
705 RIGHT is one more than the rightmost x position used by text in WINDOW,
706 and BOTTOM is one more than the bottommost y position used by text in WINDOW.
707 The inside edges do not include the space used by the window's scroll bar,
708 display margins, fringes, header line, and/or mode line. */)
709 (window)
710 Lisp_Object window;
711 {
712 register struct window *w = decode_any_window (window);
713
714 return list4 (make_number (WINDOW_BOX_LEFT_EDGE_X (w)
715 + WINDOW_LEFT_MARGIN_WIDTH (w)
716 + WINDOW_LEFT_FRINGE_WIDTH (w)),
717 make_number (WINDOW_TOP_EDGE_Y (w)
718 + WINDOW_HEADER_LINE_HEIGHT (w)),
719 make_number (WINDOW_BOX_RIGHT_EDGE_X (w)
720 - WINDOW_RIGHT_MARGIN_WIDTH (w)
721 - WINDOW_RIGHT_FRINGE_WIDTH (w)),
722 make_number (WINDOW_BOTTOM_EDGE_Y (w)
723 - WINDOW_MODE_LINE_HEIGHT (w)));
724 }
725
726 /* Test if the character at column *X, row *Y is within window W.
727 If it is not, return ON_NOTHING;
728 if it is in the window's text area,
729 set *x and *y to its location relative to the upper left corner
730 of the window, and
731 return ON_TEXT;
732 if it is on the window's modeline, return ON_MODE_LINE;
733 if it is on the border between the window and its right sibling,
734 return ON_VERTICAL_BORDER.
735 if it is on a scroll bar,
736 return ON_SCROLL_BAR.
737 if it is on the window's top line, return ON_HEADER_LINE;
738 if it is in left or right fringe of the window,
739 return ON_LEFT_FRINGE or ON_RIGHT_FRINGE, and convert *X and *Y
740 to window-relative coordinates;
741 if it is in the marginal area to the left/right of the window,
742 return ON_LEFT_MARGIN or ON_RIGHT_MARGIN, and convert *X and *Y
743 to window-relative coordinates.
744
745 X and Y are frame relative pixel coordinates. */
746
747 static enum window_part
748 coordinates_in_window (w, x, y)
749 register struct window *w;
750 register int *x, *y;
751 {
752 struct frame *f = XFRAME (WINDOW_FRAME (w));
753 int left_x, right_x, top_y, bottom_y;
754 enum window_part part;
755 int ux = FRAME_COLUMN_WIDTH (f);
756 int x0 = WINDOW_LEFT_EDGE_X (w);
757 int x1 = WINDOW_RIGHT_EDGE_X (w);
758 /* The width of the area where the vertical line can be dragged.
759 (Between mode lines for instance. */
760 int grabbable_width = ux;
761 int lmargin_width, rmargin_width, text_left, text_right;
762
763 /* In what's below, we subtract 1 when computing right_x because we
764 want the rightmost pixel, which is given by left_pixel+width-1. */
765 if (w->pseudo_window_p)
766 {
767 left_x = 0;
768 right_x = WINDOW_TOTAL_WIDTH (w) - 1;
769 top_y = WINDOW_TOP_EDGE_Y (w);
770 bottom_y = WINDOW_BOTTOM_EDGE_Y (w);
771 }
772 else
773 {
774 left_x = WINDOW_BOX_LEFT_EDGE_X (w);
775 right_x = WINDOW_BOX_RIGHT_EDGE_X (w) - 1;
776 top_y = WINDOW_TOP_EDGE_Y (w);
777 bottom_y = WINDOW_BOTTOM_EDGE_Y (w);
778 }
779
780 /* Outside any interesting row? */
781 if (*y < top_y || *y >= bottom_y)
782 return ON_NOTHING;
783
784 /* On the mode line or header line? If it's near the start of
785 the mode or header line of window that's has a horizontal
786 sibling, say it's on the vertical line. That's to be able
787 to resize windows horizontally in case we're using toolkit
788 scroll bars. */
789
790 if (WINDOW_WANTS_MODELINE_P (w)
791 && *y >= bottom_y - CURRENT_MODE_LINE_HEIGHT (w))
792 {
793 part = ON_MODE_LINE;
794
795 header_vertical_border_check:
796 /* We're somewhere on the mode line. We consider the place
797 between mode lines of horizontally adjacent mode lines
798 as the vertical border. If scroll bars on the left,
799 return the right window. */
800 if (WINDOW_HAS_VERTICAL_SCROLL_BAR_ON_LEFT (w)
801 || WINDOW_RIGHTMOST_P (w))
802 {
803 if (!WINDOW_LEFTMOST_P (w) && eabs (*x - x0) < grabbable_width)
804 {
805 /* Convert X and Y to window relative coordinates.
806 Vertical border is at the left edge of window. */
807 *x = max (0, *x - x0);
808 *y -= top_y;
809 return ON_VERTICAL_BORDER;
810 }
811 }
812 else
813 {
814 if (eabs (*x - x1) < grabbable_width)
815 {
816 /* Convert X and Y to window relative coordinates.
817 Vertical border is at the right edge of window. */
818 *x = min (x1, *x) - x0;
819 *y -= top_y;
820 return ON_VERTICAL_BORDER;
821 }
822 }
823
824 if (*x < x0 || *x >= x1)
825 return ON_NOTHING;
826
827 /* Convert X and Y to window relative coordinates.
828 Mode line starts at left edge of window. */
829 *x -= x0;
830 *y -= top_y;
831 return part;
832 }
833
834 if (WINDOW_WANTS_HEADER_LINE_P (w)
835 && *y < top_y + CURRENT_HEADER_LINE_HEIGHT (w))
836 {
837 part = ON_HEADER_LINE;
838 goto header_vertical_border_check;
839 }
840
841 if (*x < x0 || *x >= x1)
842 return ON_NOTHING;
843
844 /* Outside any interesting column? */
845 if (*x < left_x || *x > right_x)
846 {
847 *y -= top_y;
848 return ON_SCROLL_BAR;
849 }
850
851 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
852 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
853
854 text_left = window_box_left (w, TEXT_AREA);
855 text_right = text_left + window_box_width (w, TEXT_AREA);
856
857 if (FRAME_WINDOW_P (f))
858 {
859 if (!w->pseudo_window_p
860 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
861 && !WINDOW_RIGHTMOST_P (w)
862 && (eabs (*x - right_x) < grabbable_width))
863 {
864 /* Convert X and Y to window relative coordinates.
865 Vertical border is at the right edge of window. */
866 *x = min (right_x, *x) - left_x;
867 *y -= top_y;
868 return ON_VERTICAL_BORDER;
869 }
870 }
871 else
872 {
873 /* Need to say "*x > right_x" rather than >=, since on character
874 terminals, the vertical line's x coordinate is right_x. */
875 if (!w->pseudo_window_p
876 && !WINDOW_RIGHTMOST_P (w)
877 && *x > right_x - ux)
878 {
879 /* On the border on the right side of the window? Assume that
880 this area begins at RIGHT_X minus a canonical char width. */
881 *x = min (right_x, *x) - left_x;
882 *y -= top_y;
883 return ON_VERTICAL_BORDER;
884 }
885 }
886
887 if (*x < text_left)
888 {
889 if (lmargin_width > 0
890 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
891 ? (*x >= left_x + WINDOW_LEFT_FRINGE_WIDTH (w))
892 : (*x < left_x + lmargin_width)))
893 {
894 *x -= left_x;
895 if (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w))
896 *x -= WINDOW_LEFT_FRINGE_WIDTH (w);
897 *y -= top_y;
898 return ON_LEFT_MARGIN;
899 }
900
901 /* Convert X and Y to window-relative pixel coordinates. */
902 *x -= left_x;
903 *y -= top_y;
904 return ON_LEFT_FRINGE;
905 }
906
907 if (*x >= text_right)
908 {
909 if (rmargin_width > 0
910 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
911 ? (*x < right_x - WINDOW_RIGHT_FRINGE_WIDTH (w))
912 : (*x >= right_x - rmargin_width)))
913 {
914 *x -= right_x - rmargin_width;
915 if (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w))
916 *x += WINDOW_RIGHT_FRINGE_WIDTH (w);
917 *y -= top_y;
918 return ON_RIGHT_MARGIN;
919 }
920
921 /* Convert X and Y to window-relative pixel coordinates. */
922 *x -= left_x + WINDOW_LEFT_FRINGE_WIDTH (w);
923 *y -= top_y;
924 return ON_RIGHT_FRINGE;
925 }
926
927 /* Everything special ruled out - must be on text area */
928 *x -= text_left;
929 *y -= top_y;
930 return ON_TEXT;
931 }
932
933
934 DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
935 Scoordinates_in_window_p, 2, 2, 0,
936 doc: /* Return non-nil if COORDINATES are in WINDOW.
937 COORDINATES is a cons of the form (X . Y), X and Y being distances
938 measured in characters from the upper-left corner of the frame.
939 \(0 . 0) denotes the character in the upper left corner of the
940 frame.
941 If COORDINATES are in the text portion of WINDOW,
942 the coordinates relative to the window are returned.
943 If they are in the mode line of WINDOW, `mode-line' is returned.
944 If they are in the top mode line of WINDOW, `header-line' is returned.
945 If they are in the left fringe of WINDOW, `left-fringe' is returned.
946 If they are in the right fringe of WINDOW, `right-fringe' is returned.
947 If they are on the border between WINDOW and its right sibling,
948 `vertical-line' is returned.
949 If they are in the windows's left or right marginal areas, `left-margin'\n\
950 or `right-margin' is returned. */)
951 (coordinates, window)
952 register Lisp_Object coordinates, window;
953 {
954 struct window *w;
955 struct frame *f;
956 int x, y;
957 Lisp_Object lx, ly;
958
959 CHECK_WINDOW (window);
960 w = XWINDOW (window);
961 f = XFRAME (w->frame);
962 CHECK_CONS (coordinates);
963 lx = Fcar (coordinates);
964 ly = Fcdr (coordinates);
965 CHECK_NUMBER_OR_FLOAT (lx);
966 CHECK_NUMBER_OR_FLOAT (ly);
967 x = FRAME_PIXEL_X_FROM_CANON_X (f, lx) + FRAME_INTERNAL_BORDER_WIDTH (f);
968 y = FRAME_PIXEL_Y_FROM_CANON_Y (f, ly) + FRAME_INTERNAL_BORDER_WIDTH (f);
969
970 switch (coordinates_in_window (w, &x, &y))
971 {
972 case ON_NOTHING:
973 return Qnil;
974
975 case ON_TEXT:
976 /* X and Y are now window relative pixel coordinates. Convert
977 them to canonical char units before returning them. */
978 return Fcons (FRAME_CANON_X_FROM_PIXEL_X (f, x),
979 FRAME_CANON_Y_FROM_PIXEL_Y (f, y));
980
981 case ON_MODE_LINE:
982 return Qmode_line;
983
984 case ON_VERTICAL_BORDER:
985 return Qvertical_line;
986
987 case ON_HEADER_LINE:
988 return Qheader_line;
989
990 case ON_LEFT_FRINGE:
991 return Qleft_fringe;
992
993 case ON_RIGHT_FRINGE:
994 return Qright_fringe;
995
996 case ON_LEFT_MARGIN:
997 return Qleft_margin;
998
999 case ON_RIGHT_MARGIN:
1000 return Qright_margin;
1001
1002 case ON_SCROLL_BAR:
1003 /* Historically we are supposed to return nil in this case. */
1004 return Qnil;
1005
1006 default:
1007 abort ();
1008 }
1009 }
1010
1011
1012 /* Callback for foreach_window, used in window_from_coordinates.
1013 Check if window W contains coordinates specified by USER_DATA which
1014 is actually a pointer to a struct check_window_data CW.
1015
1016 Check if window W contains coordinates *CW->x and *CW->y. If it
1017 does, return W in *CW->window, as Lisp_Object, and return in
1018 *CW->part the part of the window under coordinates *X,*Y. Return
1019 zero from this function to stop iterating over windows. */
1020
1021 struct check_window_data
1022 {
1023 Lisp_Object *window;
1024 int *x, *y;
1025 enum window_part *part;
1026 };
1027
1028 static int
1029 check_window_containing (w, user_data)
1030 struct window *w;
1031 void *user_data;
1032 {
1033 struct check_window_data *cw = (struct check_window_data *) user_data;
1034 enum window_part found;
1035 int continue_p = 1;
1036
1037 found = coordinates_in_window (w, cw->x, cw->y);
1038 if (found != ON_NOTHING)
1039 {
1040 *cw->part = found;
1041 XSETWINDOW (*cw->window, w);
1042 continue_p = 0;
1043 }
1044
1045 return continue_p;
1046 }
1047
1048
1049 /* Find the window containing frame-relative pixel position X/Y and
1050 return it as a Lisp_Object.
1051
1052 If X, Y is on one of the window's special `window_part' elements,
1053 set *PART to the id of that element, and return X and Y converted
1054 to window relative coordinates in WX and WY.
1055
1056 If there is no window under X, Y return nil and leave *PART
1057 unmodified. TOOL_BAR_P non-zero means detect tool-bar windows.
1058
1059 This function was previously implemented with a loop cycling over
1060 windows with Fnext_window, and starting with the frame's selected
1061 window. It turned out that this doesn't work with an
1062 implementation of next_window using Vwindow_list, because
1063 FRAME_SELECTED_WINDOW (F) is not always contained in the window
1064 tree of F when this function is called asynchronously from
1065 note_mouse_highlight. The original loop didn't terminate in this
1066 case. */
1067
1068 Lisp_Object
1069 window_from_coordinates (f, x, y, part, wx, wy, tool_bar_p)
1070 struct frame *f;
1071 int x, y;
1072 enum window_part *part;
1073 int *wx, *wy;
1074 int tool_bar_p;
1075 {
1076 Lisp_Object window;
1077 struct check_window_data cw;
1078 enum window_part dummy;
1079
1080 if (part == 0)
1081 part = &dummy;
1082
1083 window = Qnil;
1084 cw.window = &window, cw.x = &x, cw.y = &y; cw.part = part;
1085 foreach_window (f, check_window_containing, &cw);
1086
1087 /* If not found above, see if it's in the tool bar window, if a tool
1088 bar exists. */
1089 if (NILP (window)
1090 && tool_bar_p
1091 && WINDOWP (f->tool_bar_window)
1092 && WINDOW_TOTAL_LINES (XWINDOW (f->tool_bar_window)) > 0
1093 && (coordinates_in_window (XWINDOW (f->tool_bar_window), &x, &y)
1094 != ON_NOTHING))
1095 {
1096 *part = ON_TEXT;
1097 window = f->tool_bar_window;
1098 }
1099
1100 if (wx) *wx = x;
1101 if (wy) *wy = y;
1102
1103 return window;
1104 }
1105
1106 DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
1107 doc: /* Return window containing coordinates X and Y on FRAME.
1108 If omitted, FRAME defaults to the currently selected frame.
1109 The top left corner of the frame is considered to be row 0,
1110 column 0. */)
1111 (x, y, frame)
1112 Lisp_Object x, y, frame;
1113 {
1114 struct frame *f;
1115
1116 if (NILP (frame))
1117 frame = selected_frame;
1118 CHECK_LIVE_FRAME (frame);
1119 f = XFRAME (frame);
1120
1121 /* Check that arguments are integers or floats. */
1122 CHECK_NUMBER_OR_FLOAT (x);
1123 CHECK_NUMBER_OR_FLOAT (y);
1124
1125 return window_from_coordinates (f,
1126 (FRAME_PIXEL_X_FROM_CANON_X (f, x)
1127 + FRAME_INTERNAL_BORDER_WIDTH (f)),
1128 (FRAME_PIXEL_Y_FROM_CANON_Y (f, y)
1129 + FRAME_INTERNAL_BORDER_WIDTH (f)),
1130 0, 0, 0, 0);
1131 }
1132
1133 DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
1134 doc: /* Return current value of point in WINDOW.
1135 WINDOW defaults to the selected window.
1136
1137 For a nonselected window, this is the value point would have
1138 if that window were selected.
1139
1140 Note that, when WINDOW is the selected window and its buffer
1141 is also currently selected, the value returned is the same as (point).
1142 It would be more strictly correct to return the `top-level' value
1143 of point, outside of any save-excursion forms.
1144 But that is hard to define. */)
1145 (window)
1146 Lisp_Object window;
1147 {
1148 register struct window *w = decode_window (window);
1149
1150 if (w == XWINDOW (selected_window)
1151 && current_buffer == XBUFFER (w->buffer))
1152 return Fpoint ();
1153 return Fmarker_position (w->pointm);
1154 }
1155
1156 DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
1157 doc: /* Return position at which display currently starts in WINDOW.
1158 WINDOW defaults to the selected window.
1159 This is updated by redisplay or by calling `set-window-start'. */)
1160 (window)
1161 Lisp_Object window;
1162 {
1163 return Fmarker_position (decode_window (window)->start);
1164 }
1165
1166 /* This is text temporarily removed from the doc string below.
1167
1168 This function returns nil if the position is not currently known.
1169 That happens when redisplay is preempted and doesn't finish.
1170 If in that case you want to compute where the end of the window would
1171 have been if redisplay had finished, do this:
1172 (save-excursion
1173 (goto-char (window-start window))
1174 (vertical-motion (1- (window-height window)) window)
1175 (point))") */
1176
1177 DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 2, 0,
1178 doc: /* Return position at which display currently ends in WINDOW.
1179 WINDOW defaults to the selected window.
1180 This is updated by redisplay, when it runs to completion.
1181 Simply changing the buffer text or setting `window-start'
1182 does not update this value.
1183 Return nil if there is no recorded value. \(This can happen if the
1184 last redisplay of WINDOW was preempted, and did not finish.)
1185 If UPDATE is non-nil, compute the up-to-date position
1186 if it isn't already recorded. */)
1187 (window, update)
1188 Lisp_Object window, update;
1189 {
1190 Lisp_Object value;
1191 struct window *w = decode_window (window);
1192 Lisp_Object buf;
1193 struct buffer *b;
1194
1195 buf = w->buffer;
1196 CHECK_BUFFER (buf);
1197 b = XBUFFER (buf);
1198
1199 #if 0 /* This change broke some things. We should make it later. */
1200 /* If we don't know the end position, return nil.
1201 The user can compute it with vertical-motion if he wants to.
1202 It would be nicer to do it automatically,
1203 but that's so slow that it would probably bother people. */
1204 if (NILP (w->window_end_valid))
1205 return Qnil;
1206 #endif
1207
1208 if (! NILP (update)
1209 && ! (! NILP (w->window_end_valid)
1210 && XFASTINT (w->last_modified) >= BUF_MODIFF (b)
1211 && XFASTINT (w->last_overlay_modified) >= BUF_OVERLAY_MODIFF (b))
1212 && !noninteractive)
1213 {
1214 struct text_pos startp;
1215 struct it it;
1216 struct buffer *old_buffer = NULL;
1217
1218 /* Cannot use Fvertical_motion because that function doesn't
1219 cope with variable-height lines. */
1220 if (b != current_buffer)
1221 {
1222 old_buffer = current_buffer;
1223 set_buffer_internal (b);
1224 }
1225
1226 /* In case W->start is out of the range, use something
1227 reasonable. This situation occurred when loading a file with
1228 `-l' containing a call to `rmail' with subsequent other
1229 commands. At the end, W->start happened to be BEG, while
1230 rmail had already narrowed the buffer. */
1231 if (XMARKER (w->start)->charpos < BEGV)
1232 SET_TEXT_POS (startp, BEGV, BEGV_BYTE);
1233 else if (XMARKER (w->start)->charpos > ZV)
1234 SET_TEXT_POS (startp, ZV, ZV_BYTE);
1235 else
1236 SET_TEXT_POS_FROM_MARKER (startp, w->start);
1237
1238 start_display (&it, w, startp);
1239 move_it_vertically (&it, window_box_height (w));
1240 if (it.current_y < it.last_visible_y)
1241 move_it_past_eol (&it);
1242 value = make_number (IT_CHARPOS (it));
1243
1244 if (old_buffer)
1245 set_buffer_internal (old_buffer);
1246 }
1247 else
1248 XSETINT (value, BUF_Z (b) - XFASTINT (w->window_end_pos));
1249
1250 return value;
1251 }
1252
1253 DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
1254 doc: /* Make point value in WINDOW be at position POS in WINDOW's buffer.
1255 Return POS. */)
1256 (window, pos)
1257 Lisp_Object window, pos;
1258 {
1259 register struct window *w = decode_window (window);
1260
1261 CHECK_NUMBER_COERCE_MARKER (pos);
1262 if (w == XWINDOW (selected_window)
1263 && XBUFFER (w->buffer) == current_buffer)
1264 Fgoto_char (pos);
1265 else
1266 set_marker_restricted (w->pointm, pos, w->buffer);
1267
1268 /* We have to make sure that redisplay updates the window to show
1269 the new value of point. */
1270 if (!EQ (window, selected_window))
1271 ++windows_or_buffers_changed;
1272
1273 return pos;
1274 }
1275
1276 DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
1277 doc: /* Make display in WINDOW start at position POS in WINDOW's buffer.
1278 Return POS.
1279 Optional third arg NOFORCE non-nil inhibits next redisplay
1280 from overriding motion of point in order to display at this exact start. */)
1281 (window, pos, noforce)
1282 Lisp_Object window, pos, noforce;
1283 {
1284 register struct window *w = decode_window (window);
1285
1286 CHECK_NUMBER_COERCE_MARKER (pos);
1287 set_marker_restricted (w->start, pos, w->buffer);
1288 /* this is not right, but much easier than doing what is right. */
1289 w->start_at_line_beg = Qnil;
1290 if (NILP (noforce))
1291 w->force_start = Qt;
1292 w->update_mode_line = Qt;
1293 XSETFASTINT (w->last_modified, 0);
1294 XSETFASTINT (w->last_overlay_modified, 0);
1295 if (!EQ (window, selected_window))
1296 windows_or_buffers_changed++;
1297
1298 return pos;
1299 }
1300
1301 DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
1302 1, 1, 0,
1303 doc: /* Return WINDOW's dedicated object, usually t or nil.
1304 See also `set-window-dedicated-p'. */)
1305 (window)
1306 Lisp_Object window;
1307 {
1308 return decode_window (window)->dedicated;
1309 }
1310
1311 DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
1312 Sset_window_dedicated_p, 2, 2, 0,
1313 doc: /* Control whether WINDOW is dedicated to the buffer it displays.
1314 If it is dedicated, Emacs will not automatically change
1315 which buffer appears in it.
1316 The second argument is the new value for the dedication flag;
1317 non-nil means yes. */)
1318 (window, arg)
1319 Lisp_Object window, arg;
1320 {
1321 register struct window *w = decode_window (window);
1322
1323 w->dedicated = arg;
1324
1325 return w->dedicated;
1326 }
1327
1328 DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
1329 0, 1, 0,
1330 doc: /* Return the display-table that WINDOW is using.
1331 WINDOW defaults to the selected window. */)
1332 (window)
1333 Lisp_Object window;
1334 {
1335 return decode_window (window)->display_table;
1336 }
1337
1338 /* Get the display table for use on window W. This is either W's
1339 display table or W's buffer's display table. Ignore the specified
1340 tables if they are not valid; if no valid table is specified,
1341 return 0. */
1342
1343 struct Lisp_Char_Table *
1344 window_display_table (w)
1345 struct window *w;
1346 {
1347 struct Lisp_Char_Table *dp = NULL;
1348
1349 if (DISP_TABLE_P (w->display_table))
1350 dp = XCHAR_TABLE (w->display_table);
1351 else if (BUFFERP (w->buffer))
1352 {
1353 struct buffer *b = XBUFFER (w->buffer);
1354
1355 if (DISP_TABLE_P (b->display_table))
1356 dp = XCHAR_TABLE (b->display_table);
1357 else if (DISP_TABLE_P (Vstandard_display_table))
1358 dp = XCHAR_TABLE (Vstandard_display_table);
1359 }
1360
1361 return dp;
1362 }
1363
1364 DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
1365 doc: /* Set WINDOW's display-table to TABLE. */)
1366 (window, table)
1367 register Lisp_Object window, table;
1368 {
1369 register struct window *w;
1370
1371 w = decode_window (window);
1372 w->display_table = table;
1373 return table;
1374 }
1375 \f
1376 /* Record info on buffer window w is displaying
1377 when it is about to cease to display that buffer. */
1378 static void
1379 unshow_buffer (w)
1380 register struct window *w;
1381 {
1382 Lisp_Object buf;
1383 struct buffer *b;
1384
1385 buf = w->buffer;
1386 b = XBUFFER (buf);
1387 if (b != XMARKER (w->pointm)->buffer)
1388 abort ();
1389
1390 #if 0
1391 if (w == XWINDOW (selected_window)
1392 || ! EQ (buf, XWINDOW (selected_window)->buffer))
1393 /* Do this except when the selected window's buffer
1394 is being removed from some other window. */
1395 #endif
1396 /* last_window_start records the start position that this buffer
1397 had in the last window to be disconnected from it.
1398 Now that this statement is unconditional,
1399 it is possible for the buffer to be displayed in the
1400 selected window, while last_window_start reflects another
1401 window which was recently showing the same buffer.
1402 Some people might say that might be a good thing. Let's see. */
1403 b->last_window_start = marker_position (w->start);
1404
1405 /* Point in the selected window's buffer
1406 is actually stored in that buffer, and the window's pointm isn't used.
1407 So don't clobber point in that buffer. */
1408 if (! EQ (buf, XWINDOW (selected_window)->buffer)
1409 /* This line helps to fix Horsley's testbug.el bug. */
1410 && !(WINDOWP (b->last_selected_window)
1411 && w != XWINDOW (b->last_selected_window)
1412 && EQ (buf, XWINDOW (b->last_selected_window)->buffer)))
1413 temp_set_point_both (b,
1414 clip_to_bounds (BUF_BEGV (b),
1415 XMARKER (w->pointm)->charpos,
1416 BUF_ZV (b)),
1417 clip_to_bounds (BUF_BEGV_BYTE (b),
1418 marker_byte_position (w->pointm),
1419 BUF_ZV_BYTE (b)));
1420
1421 if (WINDOWP (b->last_selected_window)
1422 && w == XWINDOW (b->last_selected_window))
1423 b->last_selected_window = Qnil;
1424 }
1425
1426 /* Put replacement into the window structure in place of old. */
1427 static void
1428 replace_window (old, replacement)
1429 Lisp_Object old, replacement;
1430 {
1431 register Lisp_Object tem;
1432 register struct window *o = XWINDOW (old), *p = XWINDOW (replacement);
1433
1434 /* If OLD is its frame's root_window, then replacement is the new
1435 root_window for that frame. */
1436
1437 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
1438 FRAME_ROOT_WINDOW (XFRAME (o->frame)) = replacement;
1439
1440 p->left_col = o->left_col;
1441 p->top_line = o->top_line;
1442 p->total_cols = o->total_cols;
1443 p->total_lines = o->total_lines;
1444 p->desired_matrix = p->current_matrix = 0;
1445 p->vscroll = 0;
1446 bzero (&p->cursor, sizeof (p->cursor));
1447 bzero (&p->last_cursor, sizeof (p->last_cursor));
1448 bzero (&p->phys_cursor, sizeof (p->phys_cursor));
1449 p->phys_cursor_type = -1;
1450 p->phys_cursor_width = -1;
1451 p->must_be_updated_p = 0;
1452 p->pseudo_window_p = 0;
1453 XSETFASTINT (p->window_end_vpos, 0);
1454 XSETFASTINT (p->window_end_pos, 0);
1455 p->window_end_valid = Qnil;
1456 p->frozen_window_start_p = 0;
1457 p->orig_top_line = p->orig_total_lines = Qnil;
1458
1459 p->next = tem = o->next;
1460 if (!NILP (tem))
1461 XWINDOW (tem)->prev = replacement;
1462
1463 p->prev = tem = o->prev;
1464 if (!NILP (tem))
1465 XWINDOW (tem)->next = replacement;
1466
1467 p->parent = tem = o->parent;
1468 if (!NILP (tem))
1469 {
1470 if (EQ (XWINDOW (tem)->vchild, old))
1471 XWINDOW (tem)->vchild = replacement;
1472 if (EQ (XWINDOW (tem)->hchild, old))
1473 XWINDOW (tem)->hchild = replacement;
1474 }
1475
1476 /*** Here, if replacement is a vertical combination
1477 and so is its new parent, we should make replacement's
1478 children be children of that parent instead. ***/
1479 }
1480
1481 DEFUN ("delete-window", Fdelete_window, Sdelete_window, 0, 1, "",
1482 doc: /* Remove WINDOW from the display. Default is selected window. */)
1483 (window)
1484 register Lisp_Object window;
1485 {
1486 delete_window (window);
1487
1488 if (! NILP (Vwindow_configuration_change_hook)
1489 && ! NILP (Vrun_hooks))
1490 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
1491
1492 return Qnil;
1493 }
1494
1495 void
1496 delete_window (window)
1497 register Lisp_Object window;
1498 {
1499 register Lisp_Object tem, parent, sib;
1500 register struct window *p;
1501 register struct window *par;
1502 struct frame *f;
1503
1504 /* Because this function is called by other C code on non-leaf
1505 windows, the CHECK_LIVE_WINDOW macro would choke inappropriately,
1506 so we can't decode_window here. */
1507 if (NILP (window))
1508 window = selected_window;
1509 else
1510 CHECK_WINDOW (window);
1511 p = XWINDOW (window);
1512
1513 /* It's a no-op to delete an already-deleted window. */
1514 if (NILP (p->buffer)
1515 && NILP (p->hchild)
1516 && NILP (p->vchild))
1517 return;
1518
1519 parent = p->parent;
1520 if (NILP (parent))
1521 error ("Attempt to delete minibuffer or sole ordinary window");
1522 par = XWINDOW (parent);
1523
1524 windows_or_buffers_changed++;
1525 Vwindow_list = Qnil;
1526 f = XFRAME (WINDOW_FRAME (p));
1527 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
1528
1529 /* Are we trying to delete any frame's selected window? */
1530 {
1531 Lisp_Object swindow, pwindow;
1532
1533 /* See if the frame's selected window is either WINDOW
1534 or any subwindow of it, by finding all that window's parents
1535 and comparing each one with WINDOW. */
1536 swindow = FRAME_SELECTED_WINDOW (f);
1537
1538 while (1)
1539 {
1540 pwindow = swindow;
1541 while (!NILP (pwindow))
1542 {
1543 if (EQ (window, pwindow))
1544 break;
1545 pwindow = XWINDOW (pwindow)->parent;
1546 }
1547
1548 /* If the window being deleted is not a parent of SWINDOW,
1549 then SWINDOW is ok as the new selected window. */
1550 if (!EQ (window, pwindow))
1551 break;
1552 /* Otherwise, try another window for SWINDOW. */
1553 swindow = Fnext_window (swindow, Qlambda, Qnil);
1554
1555 /* If we get back to the frame's selected window,
1556 it means there was no acceptable alternative,
1557 so we cannot delete. */
1558 if (EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1559 error ("Cannot delete window");
1560 }
1561
1562 /* If we need to change SWINDOW, do it. */
1563 if (! EQ (swindow, FRAME_SELECTED_WINDOW (f)))
1564 {
1565 /* If we're about to delete the selected window on the
1566 selected frame, then we should use Fselect_window to select
1567 the new window. On the other hand, if we're about to
1568 delete the selected window on any other frame, we shouldn't do
1569 anything but set the frame's selected_window slot. */
1570 if (EQ (FRAME_SELECTED_WINDOW (f), selected_window))
1571 Fselect_window (swindow, Qnil);
1572 else
1573 FRAME_SELECTED_WINDOW (f) = swindow;
1574 }
1575 }
1576
1577 /* Now we know we can delete this one. */
1578 window_deletion_count++;
1579
1580 tem = p->buffer;
1581 /* tem is null for dummy parent windows
1582 (which have inferiors but not any contents themselves) */
1583 if (!NILP (tem))
1584 {
1585 unshow_buffer (p);
1586 unchain_marker (XMARKER (p->pointm));
1587 unchain_marker (XMARKER (p->start));
1588 }
1589
1590 /* Free window glyph matrices. It is sure that they are allocated
1591 again when ADJUST_GLYPHS is called. Block input so that expose
1592 events and other events that access glyph matrices are not
1593 processed while we are changing them. */
1594 BLOCK_INPUT;
1595 free_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f)));
1596
1597 tem = p->next;
1598 if (!NILP (tem))
1599 XWINDOW (tem)->prev = p->prev;
1600
1601 tem = p->prev;
1602 if (!NILP (tem))
1603 XWINDOW (tem)->next = p->next;
1604
1605 if (EQ (window, par->hchild))
1606 par->hchild = p->next;
1607 if (EQ (window, par->vchild))
1608 par->vchild = p->next;
1609
1610 /* Find one of our siblings to give our space to. */
1611 sib = p->prev;
1612 if (NILP (sib))
1613 {
1614 /* If p gives its space to its next sibling, that sibling needs
1615 to have its top/left side pulled back to where p's is.
1616 set_window_{height,width} will re-position the sibling's
1617 children. */
1618 sib = p->next;
1619 XWINDOW (sib)->top_line = p->top_line;
1620 XWINDOW (sib)->left_col = p->left_col;
1621 }
1622
1623 /* Stretch that sibling. */
1624 if (!NILP (par->vchild))
1625 set_window_height (sib,
1626 XFASTINT (XWINDOW (sib)->total_lines) + XFASTINT (p->total_lines),
1627 1);
1628 if (!NILP (par->hchild))
1629 set_window_width (sib,
1630 XFASTINT (XWINDOW (sib)->total_cols) + XFASTINT (p->total_cols),
1631 1);
1632
1633 /* If parent now has only one child,
1634 put the child into the parent's place. */
1635 tem = par->hchild;
1636 if (NILP (tem))
1637 tem = par->vchild;
1638 if (NILP (XWINDOW (tem)->next)) {
1639 replace_window (parent, tem);
1640 par = XWINDOW (tem);
1641 }
1642
1643 /* Since we may be deleting combination windows, we must make sure that
1644 not only p but all its children have been marked as deleted. */
1645 if (! NILP (p->hchild))
1646 delete_all_subwindows (XWINDOW (p->hchild));
1647 else if (! NILP (p->vchild))
1648 delete_all_subwindows (XWINDOW (p->vchild));
1649
1650 /* Mark this window as deleted. */
1651 p->buffer = p->hchild = p->vchild = Qnil;
1652
1653 if (! NILP (par->parent))
1654 par = XWINDOW (par->parent);
1655
1656 /* Check if we have a v/hchild with a v/hchild. In that case remove
1657 one of them. */
1658
1659 if (! NILP (par->vchild) && ! NILP (XWINDOW (par->vchild)->vchild))
1660 {
1661 p = XWINDOW (par->vchild);
1662 par->vchild = p->vchild;
1663 tem = p->vchild;
1664 }
1665 else if (! NILP (par->hchild) && ! NILP (XWINDOW (par->hchild)->hchild))
1666 {
1667 p = XWINDOW (par->hchild);
1668 par->hchild = p->hchild;
1669 tem = p->hchild;
1670 }
1671 else
1672 p = 0;
1673
1674 if (p)
1675 {
1676 while (! NILP (tem)) {
1677 XWINDOW (tem)->parent = p->parent;
1678 if (NILP (XWINDOW (tem)->next))
1679 break;
1680 tem = XWINDOW (tem)->next;
1681 }
1682 if (! NILP (tem)) {
1683 /* The next of the v/hchild we are removing is now the next of the
1684 last child for the v/hchild:
1685 Before v/hchild -> v/hchild -> next1 -> next2
1686 |
1687 -> next3
1688 After: v/hchild -> next1 -> next2 -> next3
1689 */
1690 XWINDOW (tem)->next = p->next;
1691 if (! NILP (p->next))
1692 XWINDOW (p->next)->prev = tem;
1693 }
1694 p->next = p->prev = p->vchild = p->hchild = p->buffer = Qnil;
1695 }
1696
1697
1698 /* Adjust glyph matrices. */
1699 adjust_glyphs (f);
1700 UNBLOCK_INPUT;
1701 }
1702
1703
1704 \f
1705 /***********************************************************************
1706 Window List
1707 ***********************************************************************/
1708
1709 /* Add window W to *USER_DATA. USER_DATA is actually a Lisp_Object
1710 pointer. This is a callback function for foreach_window, used in
1711 function window_list. */
1712
1713 static int
1714 add_window_to_list (w, user_data)
1715 struct window *w;
1716 void *user_data;
1717 {
1718 Lisp_Object *list = (Lisp_Object *) user_data;
1719 Lisp_Object window;
1720 XSETWINDOW (window, w);
1721 *list = Fcons (window, *list);
1722 return 1;
1723 }
1724
1725
1726 /* Return a list of all windows, for use by next_window. If
1727 Vwindow_list is a list, return that list. Otherwise, build a new
1728 list, cache it in Vwindow_list, and return that. */
1729
1730 static Lisp_Object
1731 window_list ()
1732 {
1733 if (!CONSP (Vwindow_list))
1734 {
1735 Lisp_Object tail;
1736
1737 Vwindow_list = Qnil;
1738 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
1739 {
1740 Lisp_Object args[2];
1741
1742 /* We are visiting windows in canonical order, and add
1743 new windows at the front of args[1], which means we
1744 have to reverse this list at the end. */
1745 args[1] = Qnil;
1746 foreach_window (XFRAME (XCAR (tail)), add_window_to_list, &args[1]);
1747 args[0] = Vwindow_list;
1748 args[1] = Fnreverse (args[1]);
1749 Vwindow_list = Fnconc (2, args);
1750 }
1751 }
1752
1753 return Vwindow_list;
1754 }
1755
1756
1757 /* Value is non-zero if WINDOW satisfies the constraints given by
1758 OWINDOW, MINIBUF and ALL_FRAMES.
1759
1760 MINIBUF t means WINDOW may be minibuffer windows.
1761 `lambda' means WINDOW may not be a minibuffer window.
1762 a window means a specific minibuffer window
1763
1764 ALL_FRAMES t means search all frames,
1765 nil means search just current frame,
1766 `visible' means search just visible frames,
1767 0 means search visible and iconified frames,
1768 a window means search the frame that window belongs to,
1769 a frame means consider windows on that frame, only. */
1770
1771 static int
1772 candidate_window_p (window, owindow, minibuf, all_frames)
1773 Lisp_Object window, owindow, minibuf, all_frames;
1774 {
1775 struct window *w = XWINDOW (window);
1776 struct frame *f = XFRAME (w->frame);
1777 int candidate_p = 1;
1778
1779 if (!BUFFERP (w->buffer))
1780 candidate_p = 0;
1781 else if (MINI_WINDOW_P (w)
1782 && (EQ (minibuf, Qlambda)
1783 || (WINDOWP (minibuf) && !EQ (minibuf, window))))
1784 {
1785 /* If MINIBUF is `lambda' don't consider any mini-windows.
1786 If it is a window, consider only that one. */
1787 candidate_p = 0;
1788 }
1789 else if (EQ (all_frames, Qt))
1790 candidate_p = 1;
1791 else if (NILP (all_frames))
1792 {
1793 xassert (WINDOWP (owindow));
1794 candidate_p = EQ (w->frame, XWINDOW (owindow)->frame);
1795 }
1796 else if (EQ (all_frames, Qvisible))
1797 {
1798 FRAME_SAMPLE_VISIBILITY (f);
1799 candidate_p = FRAME_VISIBLE_P (f)
1800 && (FRAME_TERMINAL (XFRAME (w->frame))
1801 == FRAME_TERMINAL (XFRAME (selected_frame)));
1802
1803 }
1804 else if (INTEGERP (all_frames) && XINT (all_frames) == 0)
1805 {
1806 FRAME_SAMPLE_VISIBILITY (f);
1807 candidate_p = (FRAME_VISIBLE_P (f) || FRAME_ICONIFIED_P (f)
1808 #ifdef HAVE_X_WINDOWS
1809 /* Yuck!! If we've just created the frame and the
1810 window-manager requested the user to place it
1811 manually, the window may still not be considered
1812 `visible'. I'd argue it should be at least
1813 something like `iconified', but don't know how to do
1814 that yet. --Stef */
1815 || (FRAME_X_P (f) && f->output_data.x->asked_for_visible
1816 && !f->output_data.x->has_been_visible)
1817 #endif
1818 )
1819 && (FRAME_TERMINAL (XFRAME (w->frame))
1820 == FRAME_TERMINAL (XFRAME (selected_frame)));
1821 }
1822 else if (WINDOWP (all_frames))
1823 candidate_p = (EQ (FRAME_MINIBUF_WINDOW (f), all_frames)
1824 || EQ (XWINDOW (all_frames)->frame, w->frame)
1825 || EQ (XWINDOW (all_frames)->frame, FRAME_FOCUS_FRAME (f)));
1826 else if (FRAMEP (all_frames))
1827 candidate_p = EQ (all_frames, w->frame);
1828
1829 return candidate_p;
1830 }
1831
1832
1833 /* Decode arguments as allowed by Fnext_window, Fprevious_window, and
1834 Fwindow_list. See there for the meaning of WINDOW, MINIBUF, and
1835 ALL_FRAMES. */
1836
1837 static void
1838 decode_next_window_args (window, minibuf, all_frames)
1839 Lisp_Object *window, *minibuf, *all_frames;
1840 {
1841 if (NILP (*window))
1842 *window = selected_window;
1843 else
1844 CHECK_LIVE_WINDOW (*window);
1845
1846 /* MINIBUF nil may or may not include minibuffers. Decide if it
1847 does. */
1848 if (NILP (*minibuf))
1849 *minibuf = minibuf_level ? minibuf_window : Qlambda;
1850 else if (!EQ (*minibuf, Qt))
1851 *minibuf = Qlambda;
1852
1853 /* Now *MINIBUF can be t => count all minibuffer windows, `lambda'
1854 => count none of them, or a specific minibuffer window (the
1855 active one) to count. */
1856
1857 /* ALL_FRAMES nil doesn't specify which frames to include. */
1858 if (NILP (*all_frames))
1859 *all_frames = (!EQ (*minibuf, Qlambda)
1860 ? FRAME_MINIBUF_WINDOW (XFRAME (XWINDOW (*window)->frame))
1861 : Qnil);
1862 else if (EQ (*all_frames, Qvisible))
1863 ;
1864 else if (EQ (*all_frames, make_number (0)))
1865 ;
1866 else if (FRAMEP (*all_frames))
1867 ;
1868 else if (!EQ (*all_frames, Qt))
1869 *all_frames = Qnil;
1870
1871 /* Now *ALL_FRAMES is t meaning search all frames, nil meaning
1872 search just current frame, `visible' meaning search just visible
1873 frames, 0 meaning search visible and iconified frames, or a
1874 window, meaning search the frame that window belongs to, or a
1875 frame, meaning consider windows on that frame, only. */
1876 }
1877
1878
1879 /* Return the next or previous window of WINDOW in canonical ordering
1880 of windows. NEXT_P non-zero means return the next window. See the
1881 documentation string of next-window for the meaning of MINIBUF and
1882 ALL_FRAMES. */
1883
1884 static Lisp_Object
1885 next_window (window, minibuf, all_frames, next_p)
1886 Lisp_Object window, minibuf, all_frames;
1887 int next_p;
1888 {
1889 decode_next_window_args (&window, &minibuf, &all_frames);
1890
1891 /* If ALL_FRAMES is a frame, and WINDOW isn't on that frame, just
1892 return the first window on the frame. */
1893 if (FRAMEP (all_frames)
1894 && !EQ (all_frames, XWINDOW (window)->frame))
1895 return Fframe_first_window (all_frames);
1896
1897 if (next_p)
1898 {
1899 Lisp_Object list;
1900
1901 /* Find WINDOW in the list of all windows. */
1902 list = Fmemq (window, window_list ());
1903
1904 /* Scan forward from WINDOW to the end of the window list. */
1905 if (CONSP (list))
1906 for (list = XCDR (list); CONSP (list); list = XCDR (list))
1907 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1908 break;
1909
1910 /* Scan from the start of the window list up to WINDOW. */
1911 if (!CONSP (list))
1912 for (list = Vwindow_list;
1913 CONSP (list) && !EQ (XCAR (list), window);
1914 list = XCDR (list))
1915 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
1916 break;
1917
1918 if (CONSP (list))
1919 window = XCAR (list);
1920 }
1921 else
1922 {
1923 Lisp_Object candidate, list;
1924
1925 /* Scan through the list of windows for candidates. If there are
1926 candidate windows in front of WINDOW, the last one of these
1927 is the one we want. If there are candidates following WINDOW
1928 in the list, again the last one of these is the one we want. */
1929 candidate = Qnil;
1930 for (list = window_list (); CONSP (list); list = XCDR (list))
1931 {
1932 if (EQ (XCAR (list), window))
1933 {
1934 if (WINDOWP (candidate))
1935 break;
1936 }
1937 else if (candidate_window_p (XCAR (list), window, minibuf,
1938 all_frames))
1939 candidate = XCAR (list);
1940 }
1941
1942 if (WINDOWP (candidate))
1943 window = candidate;
1944 }
1945
1946 return window;
1947 }
1948
1949
1950 DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
1951 doc: /* Return next window after WINDOW in canonical ordering of windows.
1952 If omitted, WINDOW defaults to the selected window.
1953
1954 Optional second arg MINIBUF t means count the minibuffer window even
1955 if not active. MINIBUF nil or omitted means count the minibuffer iff
1956 it is active. MINIBUF neither t nor nil means not to count the
1957 minibuffer even if it is active.
1958
1959 Several frames may share a single minibuffer; if the minibuffer
1960 counts, all windows on all frames that share that minibuffer count
1961 too. Therefore, `next-window' can be used to iterate through the
1962 set of windows even when the minibuffer is on another frame. If the
1963 minibuffer does not count, only windows from WINDOW's frame count.
1964
1965 Optional third arg ALL-FRAMES t means include windows on all frames.
1966 ALL-FRAMES nil or omitted means cycle within the frames as specified
1967 above. ALL-FRAMES = `visible' means include windows on all visible frames.
1968 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
1969 If ALL-FRAMES is a frame, restrict search to windows on that frame.
1970 Anything else means restrict to WINDOW's frame.
1971
1972 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
1973 `next-window' to iterate through the entire cycle of acceptable
1974 windows, eventually ending up back at the window you started with.
1975 `previous-window' traverses the same cycle, in the reverse order. */)
1976 (window, minibuf, all_frames)
1977 Lisp_Object window, minibuf, all_frames;
1978 {
1979 return next_window (window, minibuf, all_frames, 1);
1980 }
1981
1982
1983 DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
1984 doc: /* Return the window preceding WINDOW in canonical ordering of windows.
1985 If omitted, WINDOW defaults to the selected window.
1986
1987 Optional second arg MINIBUF t means count the minibuffer window even
1988 if not active. MINIBUF nil or omitted means count the minibuffer iff
1989 it is active. MINIBUF neither t nor nil means not to count the
1990 minibuffer even if it is active.
1991
1992 Several frames may share a single minibuffer; if the minibuffer
1993 counts, all windows on all frames that share that minibuffer count
1994 too. Therefore, `previous-window' can be used to iterate through
1995 the set of windows even when the minibuffer is on another frame. If
1996 the minibuffer does not count, only windows from WINDOW's frame count
1997
1998 Optional third arg ALL-FRAMES t means include windows on all frames.
1999 ALL-FRAMES nil or omitted means cycle within the frames as specified
2000 above. ALL-FRAMES = `visible' means include windows on all visible frames.
2001 ALL-FRAMES = 0 means include windows on all visible and iconified frames.
2002 If ALL-FRAMES is a frame, restrict search to windows on that frame.
2003 Anything else means restrict to WINDOW's frame.
2004
2005 If you use consistent values for MINIBUF and ALL-FRAMES, you can use
2006 `previous-window' to iterate through the entire cycle of acceptable
2007 windows, eventually ending up back at the window you started with.
2008 `next-window' traverses the same cycle, in the reverse order. */)
2009 (window, minibuf, all_frames)
2010 Lisp_Object window, minibuf, all_frames;
2011 {
2012 return next_window (window, minibuf, all_frames, 0);
2013 }
2014
2015
2016 DEFUN ("other-window", Fother_window, Sother_window, 1, 2, "p",
2017 doc: /* Select the ARG'th different window on this frame.
2018 All windows on current frame are arranged in a cyclic order.
2019 This command selects the window ARG steps away in that order.
2020 A negative ARG moves in the opposite order. The optional second
2021 argument ALL-FRAMES has the same meaning as in `next-window', which see. */)
2022 (arg, all_frames)
2023 Lisp_Object arg, all_frames;
2024 {
2025 Lisp_Object window;
2026 int i;
2027
2028 CHECK_NUMBER (arg);
2029 window = selected_window;
2030
2031 for (i = XINT (arg); i > 0; --i)
2032 window = Fnext_window (window, Qnil, all_frames);
2033 for (; i < 0; ++i)
2034 window = Fprevious_window (window, Qnil, all_frames);
2035
2036 Fselect_window (window, Qnil);
2037 return Qnil;
2038 }
2039
2040
2041 DEFUN ("window-list", Fwindow_list, Swindow_list, 0, 3, 0,
2042 doc: /* Return a list of windows on FRAME, starting with WINDOW.
2043 FRAME nil or omitted means use the selected frame.
2044 WINDOW nil or omitted means use the selected window.
2045 MINIBUF t means include the minibuffer window, even if it isn't active.
2046 MINIBUF nil or omitted means include the minibuffer window only
2047 if it's active.
2048 MINIBUF neither nil nor t means never include the minibuffer window. */)
2049 (frame, minibuf, window)
2050 Lisp_Object frame, minibuf, window;
2051 {
2052 if (NILP (window))
2053 window = FRAMEP (frame) ? XFRAME (frame)->selected_window : selected_window;
2054 CHECK_WINDOW (window);
2055 if (NILP (frame))
2056 frame = selected_frame;
2057
2058 if (!EQ (frame, XWINDOW (window)->frame))
2059 error ("Window is on a different frame");
2060
2061 return window_list_1 (window, minibuf, frame);
2062 }
2063
2064
2065 /* Return a list of windows in canonical ordering. Arguments are like
2066 for `next-window'. */
2067
2068 static Lisp_Object
2069 window_list_1 (window, minibuf, all_frames)
2070 Lisp_Object window, minibuf, all_frames;
2071 {
2072 Lisp_Object tail, list, rest;
2073
2074 decode_next_window_args (&window, &minibuf, &all_frames);
2075 list = Qnil;
2076
2077 for (tail = window_list (); CONSP (tail); tail = XCDR (tail))
2078 if (candidate_window_p (XCAR (tail), window, minibuf, all_frames))
2079 list = Fcons (XCAR (tail), list);
2080
2081 /* Rotate the list to start with WINDOW. */
2082 list = Fnreverse (list);
2083 rest = Fmemq (window, list);
2084 if (!NILP (rest) && !EQ (rest, list))
2085 {
2086 for (tail = list; !EQ (XCDR (tail), rest); tail = XCDR (tail))
2087 ;
2088 XSETCDR (tail, Qnil);
2089 list = nconc2 (rest, list);
2090 }
2091 return list;
2092 }
2093
2094
2095 \f
2096 /* Look at all windows, performing an operation specified by TYPE
2097 with argument OBJ.
2098 If FRAMES is Qt, look at all frames;
2099 Qnil, look at just the selected frame;
2100 Qvisible, look at visible frames;
2101 a frame, just look at windows on that frame.
2102 If MINI is non-zero, perform the operation on minibuffer windows too. */
2103
2104 enum window_loop
2105 {
2106 WINDOW_LOOP_UNUSED,
2107 GET_BUFFER_WINDOW, /* Arg is buffer */
2108 GET_LRU_WINDOW, /* Arg is t for full-width windows only */
2109 DELETE_OTHER_WINDOWS, /* Arg is window not to delete */
2110 DELETE_BUFFER_WINDOWS, /* Arg is buffer */
2111 GET_LARGEST_WINDOW,
2112 UNSHOW_BUFFER, /* Arg is buffer */
2113 REDISPLAY_BUFFER_WINDOWS, /* Arg is buffer */
2114 CHECK_ALL_WINDOWS
2115 };
2116
2117 static Lisp_Object
2118 window_loop (type, obj, mini, frames)
2119 enum window_loop type;
2120 Lisp_Object obj, frames;
2121 int mini;
2122 {
2123 Lisp_Object window, windows, best_window, frame_arg;
2124 struct frame *f;
2125 struct gcpro gcpro1;
2126
2127 /* If we're only looping through windows on a particular frame,
2128 frame points to that frame. If we're looping through windows
2129 on all frames, frame is 0. */
2130 if (FRAMEP (frames))
2131 f = XFRAME (frames);
2132 else if (NILP (frames))
2133 f = SELECTED_FRAME ();
2134 else
2135 f = NULL;
2136
2137 if (f)
2138 frame_arg = Qlambda;
2139 else if (EQ (frames, make_number (0)))
2140 frame_arg = frames;
2141 else if (EQ (frames, Qvisible))
2142 frame_arg = frames;
2143 else
2144 frame_arg = Qt;
2145
2146 /* frame_arg is Qlambda to stick to one frame,
2147 Qvisible to consider all visible frames,
2148 or Qt otherwise. */
2149
2150 /* Pick a window to start with. */
2151 if (WINDOWP (obj))
2152 window = obj;
2153 else if (f)
2154 window = FRAME_SELECTED_WINDOW (f);
2155 else
2156 window = FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
2157
2158 windows = window_list_1 (window, mini ? Qt : Qnil, frame_arg);
2159 GCPRO1 (windows);
2160 best_window = Qnil;
2161
2162 for (; CONSP (windows); windows = XCDR (windows))
2163 {
2164 struct window *w;
2165
2166 window = XCAR (windows);
2167 w = XWINDOW (window);
2168
2169 /* Note that we do not pay attention here to whether the frame
2170 is visible, since Fwindow_list skips non-visible frames if
2171 that is desired, under the control of frame_arg. */
2172 if (!MINI_WINDOW_P (w)
2173 /* For UNSHOW_BUFFER, we must always consider all windows. */
2174 || type == UNSHOW_BUFFER
2175 || (mini && minibuf_level > 0))
2176 switch (type)
2177 {
2178 case GET_BUFFER_WINDOW:
2179 if (EQ (w->buffer, obj)
2180 /* Don't find any minibuffer window
2181 except the one that is currently in use. */
2182 && (MINI_WINDOW_P (w)
2183 ? EQ (window, minibuf_window)
2184 : 1))
2185 {
2186 if (NILP (best_window))
2187 best_window = window;
2188 else if (EQ (window, selected_window))
2189 /* Prefer to return selected-window. */
2190 RETURN_UNGCPRO (window);
2191 else if (EQ (Fwindow_frame (window), selected_frame))
2192 /* Prefer windows on the current frame. */
2193 best_window = window;
2194 }
2195 break;
2196
2197 case GET_LRU_WINDOW:
2198 /* `obj' is an integer encoding a bitvector.
2199 `obj & 1' means consider only full-width windows.
2200 `obj & 2' means consider also dedicated windows. */
2201 if (((XINT (obj) & 1) && !WINDOW_FULL_WIDTH_P (w))
2202 || (!(XINT (obj) & 2) && !NILP (w->dedicated))
2203 /* Minibuffer windows are always ignored. */
2204 || MINI_WINDOW_P (w))
2205 break;
2206 if (NILP (best_window)
2207 || (XFASTINT (XWINDOW (best_window)->use_time)
2208 > XFASTINT (w->use_time)))
2209 best_window = window;
2210 break;
2211
2212 case DELETE_OTHER_WINDOWS:
2213 if (!EQ (window, obj))
2214 Fdelete_window (window);
2215 break;
2216
2217 case DELETE_BUFFER_WINDOWS:
2218 if (EQ (w->buffer, obj))
2219 {
2220 struct frame *f = XFRAME (WINDOW_FRAME (w));
2221
2222 /* If this window is dedicated, and in a frame of its own,
2223 kill the frame. */
2224 if (EQ (window, FRAME_ROOT_WINDOW (f))
2225 && !NILP (w->dedicated)
2226 && other_visible_frames (f))
2227 {
2228 /* Skip the other windows on this frame.
2229 There might be one, the minibuffer! */
2230 while (CONSP (XCDR (windows))
2231 && EQ (XWINDOW (XCAR (windows))->frame,
2232 XWINDOW (XCAR (XCDR (windows)))->frame))
2233 windows = XCDR (windows);
2234
2235 /* Now we can safely delete the frame. */
2236 Fdelete_frame (w->frame, Qnil);
2237 }
2238 else if (NILP (w->parent))
2239 {
2240 /* If we're deleting the buffer displayed in the
2241 only window on the frame, find a new buffer to
2242 display there. */
2243 Lisp_Object buffer;
2244 buffer = Fother_buffer (obj, Qnil, w->frame);
2245 Fset_window_buffer (window, buffer, Qnil);
2246 if (EQ (window, selected_window))
2247 Fset_buffer (w->buffer);
2248 }
2249 else
2250 Fdelete_window (window);
2251 }
2252 break;
2253
2254 case GET_LARGEST_WINDOW:
2255 { /* nil `obj' means to ignore dedicated windows. */
2256 /* Ignore dedicated windows and minibuffers. */
2257 if (MINI_WINDOW_P (w) || (NILP (obj) && !NILP (w->dedicated)))
2258 break;
2259
2260 if (NILP (best_window))
2261 best_window = window;
2262 else
2263 {
2264 struct window *b = XWINDOW (best_window);
2265 if (XFASTINT (w->total_lines) * XFASTINT (w->total_cols)
2266 > XFASTINT (b->total_lines) * XFASTINT (b->total_cols))
2267 best_window = window;
2268 }
2269 }
2270 break;
2271
2272 case UNSHOW_BUFFER:
2273 if (EQ (w->buffer, obj))
2274 {
2275 Lisp_Object buffer;
2276 struct frame *f = XFRAME (w->frame);
2277
2278 /* Find another buffer to show in this window. */
2279 buffer = Fother_buffer (obj, Qnil, w->frame);
2280
2281 /* If this window is dedicated, and in a frame of its own,
2282 kill the frame. */
2283 if (EQ (window, FRAME_ROOT_WINDOW (f))
2284 && !NILP (w->dedicated)
2285 && other_visible_frames (f))
2286 {
2287 /* Skip the other windows on this frame.
2288 There might be one, the minibuffer! */
2289 while (CONSP (XCDR (windows))
2290 && EQ (XWINDOW (XCAR (windows))->frame,
2291 XWINDOW (XCAR (XCDR (windows)))->frame))
2292 windows = XCDR (windows);
2293
2294 /* Now we can safely delete the frame. */
2295 Fdelete_frame (w->frame, Qnil);
2296 }
2297 else if (!NILP (w->dedicated) && !NILP (w->parent))
2298 {
2299 Lisp_Object window;
2300 XSETWINDOW (window, w);
2301 /* If this window is dedicated and not the only window
2302 in its frame, then kill it. */
2303 Fdelete_window (window);
2304 }
2305 else
2306 {
2307 /* Otherwise show a different buffer in the window. */
2308 w->dedicated = Qnil;
2309 Fset_window_buffer (window, buffer, Qnil);
2310 if (EQ (window, selected_window))
2311 Fset_buffer (w->buffer);
2312 }
2313 }
2314 break;
2315
2316 case REDISPLAY_BUFFER_WINDOWS:
2317 if (EQ (w->buffer, obj))
2318 {
2319 mark_window_display_accurate (window, 0);
2320 w->update_mode_line = Qt;
2321 XBUFFER (obj)->prevent_redisplay_optimizations_p = 1;
2322 ++update_mode_lines;
2323 best_window = window;
2324 }
2325 break;
2326
2327 /* Check for a window that has a killed buffer. */
2328 case CHECK_ALL_WINDOWS:
2329 if (! NILP (w->buffer)
2330 && NILP (XBUFFER (w->buffer)->name))
2331 abort ();
2332 break;
2333
2334 case WINDOW_LOOP_UNUSED:
2335 break;
2336 }
2337 }
2338
2339 UNGCPRO;
2340 return best_window;
2341 }
2342
2343 /* Used for debugging. Abort if any window has a dead buffer. */
2344
2345 void
2346 check_all_windows ()
2347 {
2348 window_loop (CHECK_ALL_WINDOWS, Qnil, 1, Qt);
2349 }
2350
2351 DEFUN ("get-lru-window", Fget_lru_window, Sget_lru_window, 0, 2, 0,
2352 doc: /* Return the window least recently selected or used for display.
2353 \(LRU means Least Recently Used.)
2354
2355 Return a full-width window if possible.
2356 A minibuffer window is never a candidate.
2357 A dedicated window is never a candidate, unless DEDICATED is non-nil,
2358 so if all windows are dedicated, the value is nil.
2359 If optional argument FRAME is `visible', search all visible frames.
2360 If FRAME is 0, search all visible and iconified frames.
2361 If FRAME is t, search all frames.
2362 If FRAME is nil, search only the selected frame.
2363 If FRAME is a frame, search only that frame. */)
2364 (frame, dedicated)
2365 Lisp_Object frame, dedicated;
2366 {
2367 register Lisp_Object w;
2368 /* First try for a window that is full-width */
2369 w = window_loop (GET_LRU_WINDOW,
2370 NILP (dedicated) ? make_number (1) : make_number (3),
2371 0, frame);
2372 if (!NILP (w) && !EQ (w, selected_window))
2373 return w;
2374 /* If none of them, try the rest */
2375 return window_loop (GET_LRU_WINDOW,
2376 NILP (dedicated) ? make_number (0) : make_number (2),
2377 0, frame);
2378 }
2379
2380 DEFUN ("get-largest-window", Fget_largest_window, Sget_largest_window, 0, 2, 0,
2381 doc: /* Return the largest window in area.
2382 A minibuffer window is never a candidate.
2383 A dedicated window is never a candidate unless DEDICATED is non-nil,
2384 so if all windows are dedicated, the value is nil.
2385 If optional argument FRAME is `visible', search all visible frames.
2386 If FRAME is 0, search all visible and iconified frames.
2387 If FRAME is t, search all frames.
2388 If FRAME is nil, search only the selected frame.
2389 If FRAME is a frame, search only that frame. */)
2390 (frame, dedicated)
2391 Lisp_Object frame, dedicated;
2392 {
2393 return window_loop (GET_LARGEST_WINDOW, dedicated, 0,
2394 frame);
2395 }
2396
2397 DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 1, 2, 0,
2398 doc: /* Return a window currently displaying BUFFER, or nil if none.
2399 BUFFER can be a buffer or a buffer name.
2400 If optional argument FRAME is `visible', search all visible frames.
2401 If optional argument FRAME is 0, search all visible and iconified frames.
2402 If FRAME is t, search all frames.
2403 If FRAME is nil, search only the selected frame.
2404 If FRAME is a frame, search only that frame. */)
2405 (buffer, frame)
2406 Lisp_Object buffer, frame;
2407 {
2408 buffer = Fget_buffer (buffer);
2409 if (BUFFERP (buffer))
2410 return window_loop (GET_BUFFER_WINDOW, buffer, 1, frame);
2411 else
2412 return Qnil;
2413 }
2414
2415 DEFUN ("delete-other-windows", Fdelete_other_windows, Sdelete_other_windows,
2416 0, 1, "",
2417 doc: /* Make WINDOW (or the selected window) fill its frame.
2418 Only the frame WINDOW is on is affected.
2419 This function tries to reduce display jumps
2420 by keeping the text previously visible in WINDOW
2421 in the same place on the frame. Doing this depends on
2422 the value of (window-start WINDOW), so if calling this function
2423 in a program gives strange scrolling, make sure the window-start
2424 value is reasonable when this function is called. */)
2425 (window)
2426 Lisp_Object window;
2427 {
2428 struct window *w;
2429 int startpos;
2430 int top, new_top;
2431
2432 if (NILP (window))
2433 window = selected_window;
2434 else
2435 CHECK_LIVE_WINDOW (window);
2436 w = XWINDOW (window);
2437
2438 startpos = marker_position (w->start);
2439 top = WINDOW_TOP_EDGE_LINE (w) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2440
2441 if (MINI_WINDOW_P (w) && top > 0)
2442 error ("Can't expand minibuffer to full frame");
2443
2444 window_loop (DELETE_OTHER_WINDOWS, window, 0, WINDOW_FRAME (w));
2445
2446 /* Try to minimize scrolling, by setting the window start to the point
2447 will cause the text at the old window start to be at the same place
2448 on the frame. But don't try to do this if the window start is
2449 outside the visible portion (as might happen when the display is
2450 not current, due to typeahead). */
2451 new_top = WINDOW_TOP_EDGE_LINE (w) - FRAME_TOP_MARGIN (XFRAME (WINDOW_FRAME (w)));
2452 if (new_top != top
2453 && startpos >= BUF_BEGV (XBUFFER (w->buffer))
2454 && startpos <= BUF_ZV (XBUFFER (w->buffer)))
2455 {
2456 struct position pos;
2457 struct buffer *obuf = current_buffer;
2458
2459 Fset_buffer (w->buffer);
2460 /* This computation used to temporarily move point, but that can
2461 have unwanted side effects due to text properties. */
2462 pos = *vmotion (startpos, -top, w);
2463
2464 set_marker_both (w->start, w->buffer, pos.bufpos, pos.bytepos);
2465 w->window_end_valid = Qnil;
2466 w->start_at_line_beg = ((pos.bytepos == BEGV_BYTE
2467 || FETCH_BYTE (pos.bytepos - 1) == '\n') ? Qt
2468 : Qnil);
2469 /* We need to do this, so that the window-scroll-functions
2470 get called. */
2471 w->optional_new_start = Qt;
2472
2473 set_buffer_internal (obuf);
2474 }
2475
2476 return Qnil;
2477 }
2478
2479 DEFUN ("delete-windows-on", Fdelete_windows_on, Sdelete_windows_on,
2480 1, 2, "bDelete windows on (buffer): ",
2481 doc: /* Delete all windows showing BUFFER.
2482 BUFFER must be a buffer or the name of an existing buffer.
2483 Optional second argument FRAME controls which frames are affected.
2484 If optional argument FRAME is `visible', search all visible frames.
2485 If FRAME is 0, search all visible and iconified frames.
2486 If FRAME is nil, search all frames.
2487 If FRAME is t, search only the selected frame.
2488 If FRAME is a frame, search only that frame. */)
2489 (buffer, frame)
2490 Lisp_Object buffer, frame;
2491 {
2492 /* FRAME uses t and nil to mean the opposite of what window_loop
2493 expects. */
2494 if (NILP (frame))
2495 frame = Qt;
2496 else if (EQ (frame, Qt))
2497 frame = Qnil;
2498
2499 if (!NILP (buffer))
2500 {
2501 buffer = Fget_buffer (buffer);
2502 CHECK_BUFFER (buffer);
2503 window_loop (DELETE_BUFFER_WINDOWS, buffer, 0, frame);
2504 }
2505
2506 return Qnil;
2507 }
2508
2509 DEFUN ("replace-buffer-in-windows", Freplace_buffer_in_windows,
2510 Sreplace_buffer_in_windows,
2511 1, 1, "bReplace buffer in windows: ",
2512 doc: /* Replace BUFFER with some other buffer in all windows showing it.
2513 BUFFER may be a buffer or the name of an existing buffer. */)
2514 (buffer)
2515 Lisp_Object buffer;
2516 {
2517 if (!NILP (buffer))
2518 {
2519 buffer = Fget_buffer (buffer);
2520 CHECK_BUFFER (buffer);
2521 window_loop (UNSHOW_BUFFER, buffer, 0, Qt);
2522 }
2523 return Qnil;
2524 }
2525
2526 /* Replace BUFFER with some other buffer in all windows
2527 of all frames, even those on other keyboards. */
2528
2529 void
2530 replace_buffer_in_all_windows (buffer)
2531 Lisp_Object buffer;
2532 {
2533 #ifdef MULTI_KBOARD
2534 Lisp_Object tail, frame;
2535
2536 /* A single call to window_loop won't do the job
2537 because it only considers frames on the current keyboard.
2538 So loop manually over frames, and handle each one. */
2539 FOR_EACH_FRAME (tail, frame)
2540 window_loop (UNSHOW_BUFFER, buffer, 1, frame);
2541 #else
2542 window_loop (UNSHOW_BUFFER, buffer, 1, Qt);
2543 #endif
2544 }
2545 \f
2546 /* Set the height of WINDOW and all its inferiors. */
2547
2548 /* The smallest acceptable dimensions for a window. Anything smaller
2549 might crash Emacs. */
2550
2551 #define MIN_SAFE_WINDOW_WIDTH (2)
2552 #define MIN_SAFE_WINDOW_HEIGHT (1)
2553
2554 /* Make sure that window_min_height and window_min_width are
2555 not too small; if they are, set them to safe minima. */
2556
2557 static void
2558 check_min_window_sizes ()
2559 {
2560 /* Smaller values might permit a crash. */
2561 if (window_min_width < MIN_SAFE_WINDOW_WIDTH)
2562 window_min_width = MIN_SAFE_WINDOW_WIDTH;
2563 if (window_min_height < MIN_SAFE_WINDOW_HEIGHT)
2564 window_min_height = MIN_SAFE_WINDOW_HEIGHT;
2565 }
2566
2567 /* If *ROWS or *COLS are too small a size for FRAME, set them to the
2568 minimum allowable size. */
2569
2570 void
2571 check_frame_size (frame, rows, cols)
2572 FRAME_PTR frame;
2573 int *rows, *cols;
2574 {
2575 /* For height, we have to see:
2576 how many windows the frame has at minimum (one or two),
2577 and whether it has a menu bar or other special stuff at the top. */
2578 int min_height
2579 = ((FRAME_MINIBUF_ONLY_P (frame) || ! FRAME_HAS_MINIBUF_P (frame))
2580 ? MIN_SAFE_WINDOW_HEIGHT
2581 : 2 * MIN_SAFE_WINDOW_HEIGHT);
2582
2583 if (FRAME_TOP_MARGIN (frame) > 0)
2584 min_height += FRAME_TOP_MARGIN (frame);
2585
2586 if (*rows < min_height)
2587 *rows = min_height;
2588 if (*cols < MIN_SAFE_WINDOW_WIDTH)
2589 *cols = MIN_SAFE_WINDOW_WIDTH;
2590 }
2591
2592 /* Value is non-zero if window W is fixed-size. WIDTH_P non-zero means
2593 check if W's width can be changed, otherwise check W's height.
2594 CHECK_SIBLINGS_P non-zero means check resizablity of WINDOW's
2595 siblings, too. If none of the siblings is resizable, WINDOW isn't
2596 either. */
2597
2598 static int
2599 window_fixed_size_p (w, width_p, check_siblings_p)
2600 struct window *w;
2601 int width_p, check_siblings_p;
2602 {
2603 int fixed_p;
2604 struct window *c;
2605
2606 if (!NILP (w->hchild))
2607 {
2608 c = XWINDOW (w->hchild);
2609
2610 if (width_p)
2611 {
2612 /* A horiz. combination is fixed-width if all of if its
2613 children are. */
2614 while (c && window_fixed_size_p (c, width_p, 0))
2615 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2616 fixed_p = c == NULL;
2617 }
2618 else
2619 {
2620 /* A horiz. combination is fixed-height if one of if its
2621 children is. */
2622 while (c && !window_fixed_size_p (c, width_p, 0))
2623 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2624 fixed_p = c != NULL;
2625 }
2626 }
2627 else if (!NILP (w->vchild))
2628 {
2629 c = XWINDOW (w->vchild);
2630
2631 if (width_p)
2632 {
2633 /* A vert. combination is fixed-width if one of if its
2634 children is. */
2635 while (c && !window_fixed_size_p (c, width_p, 0))
2636 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2637 fixed_p = c != NULL;
2638 }
2639 else
2640 {
2641 /* A vert. combination is fixed-height if all of if its
2642 children are. */
2643 while (c && window_fixed_size_p (c, width_p, 0))
2644 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2645 fixed_p = c == NULL;
2646 }
2647 }
2648 else if (BUFFERP (w->buffer))
2649 {
2650 struct buffer *old = current_buffer;
2651 Lisp_Object val;
2652
2653 current_buffer = XBUFFER (w->buffer);
2654 val = find_symbol_value (Qwindow_size_fixed);
2655 current_buffer = old;
2656
2657 fixed_p = 0;
2658 if (!EQ (val, Qunbound))
2659 {
2660 fixed_p = !NILP (val);
2661
2662 if (fixed_p
2663 && ((EQ (val, Qheight) && width_p)
2664 || (EQ (val, Qwidth) && !width_p)))
2665 fixed_p = 0;
2666 }
2667
2668 /* Can't tell if this one is resizable without looking at
2669 siblings. If all siblings are fixed-size this one is too. */
2670 if (!fixed_p && check_siblings_p && WINDOWP (w->parent))
2671 {
2672 Lisp_Object child;
2673
2674 for (child = w->prev; WINDOWP (child); child = XWINDOW (child)->prev)
2675 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2676 break;
2677
2678 if (NILP (child))
2679 for (child = w->next; WINDOWP (child); child = XWINDOW (child)->next)
2680 if (!window_fixed_size_p (XWINDOW (child), width_p, 0))
2681 break;
2682
2683 if (NILP (child))
2684 fixed_p = 1;
2685 }
2686 }
2687 else
2688 fixed_p = 1;
2689
2690 return fixed_p;
2691 }
2692
2693 /* Return the minimum size for leaf window W. WIDTH_P non-zero means
2694 take into account fringes and the scrollbar of W. WIDTH_P zero means
2695 take into account mode-line of W. Return 1 for the minibuffer. */
2696
2697 static int
2698 window_min_size_2 (w, width_p)
2699 struct window *w;
2700 int width_p;
2701 {
2702 int size;
2703
2704 if (width_p)
2705 size = max (window_min_width,
2706 (MIN_SAFE_WINDOW_WIDTH
2707 + WINDOW_FRINGE_COLS (w)
2708 + WINDOW_SCROLL_BAR_COLS (w)));
2709 else if (MINI_WINDOW_P (w))
2710 size = 1;
2711 else
2712 size = max (window_min_height,
2713 (MIN_SAFE_WINDOW_HEIGHT
2714 /* Don't count the header-line here. It would break
2715 splitting a window with a header-line when the new
2716 window shall have a height of two (calculator does
2717 that). */
2718 + (WINDOW_WANTS_MODELINE_P (w) ? 1 : 0)));
2719
2720 return size;
2721 }
2722
2723 /* Return the minimum size of window W, not taking fixed-width windows
2724 into account. WIDTH_P non-zero means return the minimum width,
2725 otherwise return the minimum height. If W is a combination window,
2726 compute the minimum size from the minimum sizes of W's children. */
2727
2728 static int
2729 window_min_size_1 (w, width_p)
2730 struct window *w;
2731 int width_p;
2732 {
2733 struct window *c;
2734 int size;
2735
2736 if (!NILP (w->hchild))
2737 {
2738 c = XWINDOW (w->hchild);
2739 size = 0;
2740
2741 if (width_p)
2742 {
2743 /* The min width of a horizontal combination is
2744 the sum of the min widths of its children. */
2745 while (c)
2746 {
2747 size += window_min_size_1 (c, width_p);
2748 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2749 }
2750 }
2751 else
2752 {
2753 /* The min height a horizontal combination equals
2754 the maximum of all min height of its children. */
2755 while (c)
2756 {
2757 int min_size = window_min_size_1 (c, width_p);
2758 size = max (min_size, size);
2759 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2760 }
2761 }
2762 }
2763 else if (!NILP (w->vchild))
2764 {
2765 c = XWINDOW (w->vchild);
2766 size = 0;
2767
2768 if (width_p)
2769 {
2770 /* The min width of a vertical combination is
2771 the maximum of the min widths of its children. */
2772 while (c)
2773 {
2774 int min_size = window_min_size_1 (c, width_p);
2775 size = max (min_size, size);
2776 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2777 }
2778 }
2779 else
2780 {
2781 /* The min height of a vertical combination equals
2782 the sum of the min height of its children. */
2783 while (c)
2784 {
2785 size += window_min_size_1 (c, width_p);
2786 c = WINDOWP (c->next) ? XWINDOW (c->next) : NULL;
2787 }
2788 }
2789 }
2790 else
2791 size = window_min_size_2 (w, width_p);
2792
2793 return size;
2794 }
2795
2796
2797 /* Return the minimum size of window W, taking fixed-size windows into
2798 account. WIDTH_P non-zero means return the minimum width,
2799 otherwise return the minimum height. IGNORE_FIXED_P non-zero means
2800 ignore if W is fixed-size. Set *FIXED to 1 if W is fixed-size
2801 unless FIXED is null. */
2802
2803 static int
2804 window_min_size (w, width_p, ignore_fixed_p, fixed)
2805 struct window *w;
2806 int width_p, ignore_fixed_p, *fixed;
2807 {
2808 int size, fixed_p;
2809
2810 if (ignore_fixed_p)
2811 fixed_p = 0;
2812 else
2813 fixed_p = window_fixed_size_p (w, width_p, 1);
2814
2815 if (fixed)
2816 *fixed = fixed_p;
2817
2818 if (fixed_p)
2819 size = width_p ? XFASTINT (w->total_cols) : XFASTINT (w->total_lines);
2820 else
2821 size = window_min_size_1 (w, width_p);
2822
2823 return size;
2824 }
2825
2826
2827 /* Adjust the margins of window W if text area is too small.
2828 Return 1 if window width is ok after adjustment; 0 if window
2829 is still too narrow. */
2830
2831 static int
2832 adjust_window_margins (w)
2833 struct window *w;
2834 {
2835 int box_cols = (WINDOW_TOTAL_COLS (w)
2836 - WINDOW_FRINGE_COLS (w)
2837 - WINDOW_SCROLL_BAR_COLS (w));
2838 int margin_cols = (WINDOW_LEFT_MARGIN_COLS (w)
2839 + WINDOW_RIGHT_MARGIN_COLS (w));
2840
2841 if (box_cols - margin_cols >= MIN_SAFE_WINDOW_WIDTH)
2842 return 1;
2843
2844 if (margin_cols < 0 || box_cols < MIN_SAFE_WINDOW_WIDTH)
2845 return 0;
2846
2847 /* Window's text area is too narrow, but reducing the window
2848 margins will fix that. */
2849 margin_cols = box_cols - MIN_SAFE_WINDOW_WIDTH;
2850 if (WINDOW_RIGHT_MARGIN_COLS (w) > 0)
2851 {
2852 if (WINDOW_LEFT_MARGIN_COLS (w) > 0)
2853 w->left_margin_cols = w->right_margin_cols
2854 = make_number (margin_cols/2);
2855 else
2856 w->right_margin_cols = make_number (margin_cols);
2857 }
2858 else
2859 w->left_margin_cols = make_number (margin_cols);
2860 return 1;
2861 }
2862
2863 /* Calculate new sizes for windows in the list FORWARD when the window size
2864 goes from TOTAL to SIZE. TOTAL must be greater than SIZE.
2865 The number of windows in FORWARD is NCHILDREN, and the number that
2866 can shrink is SHRINKABLE.
2867 The minimum size a window can have is MIN_SIZE.
2868 If we are shrinking fixed windows, RESIZE_FIXED_P is non-zero.
2869 If we are shrinking columns, WIDTH_P is non-zero, otherwise we are
2870 shrinking rows.
2871
2872 This function returns an allocated array of new sizes that the caller
2873 must free. The size -1 means the window is fixed and RESIZE_FIXED_P
2874 is zero. Array index 0 refers to the first window in FORWARD, 1 to
2875 the second, and so on.
2876
2877 This function tries to keep windows at least at the minimum size
2878 and resize other windows before it resizes any window to zero (i.e.
2879 delete that window).
2880
2881 Windows are resized proportional to their size, so bigger windows
2882 shrink more than smaller windows. */
2883 static int *
2884 shrink_windows (total, size, nchildren, shrinkable,
2885 min_size, resize_fixed_p, forward, width_p)
2886 int total, size, nchildren, shrinkable, min_size;
2887 int resize_fixed_p, width_p;
2888 Lisp_Object forward;
2889 {
2890 int available_resize = 0;
2891 int *new_sizes;
2892 struct window *c;
2893 Lisp_Object child;
2894 int smallest = total;
2895 int total_removed = 0;
2896 int total_shrink = total - size;
2897 int i;
2898
2899 new_sizes = xmalloc (sizeof (*new_sizes) * nchildren);
2900
2901 for (i = 0, child = forward; !NILP (child); child = c->next, ++i)
2902 {
2903 int child_size;
2904
2905 c = XWINDOW (child);
2906 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
2907
2908 if (! resize_fixed_p && window_fixed_size_p (c, width_p, 0))
2909 new_sizes[i] = -1;
2910 else
2911 {
2912 new_sizes[i] = child_size;
2913 if (child_size > min_size)
2914 available_resize += child_size - min_size;
2915 }
2916 }
2917 /* We might need to shrink some windows to zero. Find the smallest
2918 windows and set them to 0 until we can fulfil the new size. */
2919
2920 while (shrinkable > 1 && size + available_resize < total)
2921 {
2922 for (i = 0; i < nchildren; ++i)
2923 if (new_sizes[i] > 0 && smallest > new_sizes[i])
2924 smallest = new_sizes[i];
2925
2926 for (i = 0; i < nchildren; ++i)
2927 if (new_sizes[i] == smallest)
2928 {
2929 /* Resize this window down to zero. */
2930 new_sizes[i] = 0;
2931 if (smallest > min_size)
2932 available_resize -= smallest - min_size;
2933 available_resize += smallest;
2934 --shrinkable;
2935 total_removed += smallest;
2936
2937 /* We don't know what the smallest is now. */
2938 smallest = total;
2939
2940 /* Out of for, just remove one window at the time and
2941 check again if we have enough space. */
2942 break;
2943 }
2944 }
2945
2946 /* Now, calculate the new sizes. Try to shrink each window
2947 proportional to its size. */
2948 for (i = 0; i < nchildren; ++i)
2949 {
2950 if (new_sizes[i] > min_size)
2951 {
2952 int to_shrink = total_shrink*new_sizes[i]/total;
2953 if (new_sizes[i] - to_shrink < min_size)
2954 to_shrink = new_sizes[i] - min_size;
2955 new_sizes[i] -= to_shrink;
2956 total_removed += to_shrink;
2957 }
2958 }
2959
2960 /* Any reminder due to rounding, we just subtract from windows
2961 that are left and still can be shrunk. */
2962 while (total_shrink > total_removed)
2963 {
2964 int nonzero_sizes = 0;
2965 int nonzero_idx = -1;
2966
2967 for (i = 0; i < nchildren; ++i)
2968 if (new_sizes[i] > 0)
2969 {
2970 ++nonzero_sizes;
2971 nonzero_idx = i;
2972 }
2973
2974 for (i = 0; i < nchildren; ++i)
2975 if (new_sizes[i] > min_size)
2976 {
2977 --new_sizes[i];
2978 ++total_removed;
2979
2980 /* Out of for, just shrink one window at the time and
2981 check again if we have enough space. */
2982 break;
2983 }
2984
2985
2986 /* Special case, only one window left. */
2987 if (nonzero_sizes == 1)
2988 break;
2989 }
2990
2991 /* Any surplus due to rounding, we add to windows that are left. */
2992 while (total_shrink < total_removed)
2993 {
2994 for (i = 0; i < nchildren; ++i)
2995 {
2996 if (new_sizes[i] != 0 && total_shrink < total_removed)
2997 {
2998 ++new_sizes[i];
2999 --total_removed;
3000 break;
3001 }
3002 }
3003 }
3004
3005 return new_sizes;
3006 }
3007
3008 /* Set WINDOW's height or width to SIZE. WIDTH_P non-zero means set
3009 WINDOW's width. Resize WINDOW's children, if any, so that they
3010 keep their proportionate size relative to WINDOW.
3011
3012 If FIRST_ONLY is 1, change only the first of WINDOW's children when
3013 they are in series. If LAST_ONLY is 1, change only the last of
3014 WINDOW's children when they are in series.
3015
3016 Propagate WINDOW's top or left edge position to children. Delete
3017 windows that become too small unless NODELETE_P is non-zero.
3018
3019 If NODELETE_P is 2, that means we do delete windows that are
3020 too small, even if they were too small before! */
3021
3022 static void
3023 size_window (window, size, width_p, nodelete_p, first_only, last_only)
3024 Lisp_Object window;
3025 int size, width_p, nodelete_p;
3026 int first_only, last_only;
3027 {
3028 struct window *w = XWINDOW (window);
3029 struct window *c;
3030 Lisp_Object child, *forward, *sideward;
3031 int old_size, min_size, safe_min_size;
3032
3033 check_min_window_sizes ();
3034 size = max (0, size);
3035
3036 /* If the window has been "too small" at one point,
3037 don't delete it for being "too small" in the future.
3038 Preserve it as long as that is at all possible. */
3039 if (width_p)
3040 {
3041 old_size = WINDOW_TOTAL_COLS (w);
3042 min_size = window_min_width;
3043 safe_min_size = window_min_size_2 (w, 1);
3044 }
3045 else
3046 {
3047 old_size = XINT (w->total_lines);
3048 min_size = window_min_height;
3049 safe_min_size = window_min_size_2 (w, 0);
3050 }
3051
3052 if (old_size < min_size && nodelete_p != 2)
3053 w->too_small_ok = Qt;
3054
3055 /* Move the following test here since otherwise the
3056 preceding test doesn't make sense. martin. */
3057 if (nodelete_p == 2)
3058 nodelete_p = 0;
3059
3060 /* Maybe delete WINDOW if it's too small. */
3061 if (nodelete_p != 1 && !NILP (w->parent))
3062 {
3063 if (!MINI_WINDOW_P (w) && !NILP (w->too_small_ok))
3064 min_size = width_p ? MIN_SAFE_WINDOW_WIDTH : MIN_SAFE_WINDOW_HEIGHT;
3065 if (min_size < safe_min_size)
3066 min_size = safe_min_size;
3067 if (size < min_size)
3068 {
3069 delete_window (window);
3070 return;
3071 }
3072 }
3073
3074 /* Set redisplay hints. */
3075 w->last_modified = make_number (0);
3076 w->last_overlay_modified = make_number (0);
3077 windows_or_buffers_changed++;
3078 FRAME_WINDOW_SIZES_CHANGED (XFRAME (w->frame)) = 1;
3079
3080 if (width_p)
3081 {
3082 sideward = &w->vchild;
3083 forward = &w->hchild;
3084 w->total_cols = make_number (size);
3085 adjust_window_margins (w);
3086 }
3087 else
3088 {
3089 sideward = &w->hchild;
3090 forward = &w->vchild;
3091 w->total_lines = make_number (size);
3092 w->orig_total_lines = Qnil;
3093 }
3094
3095 if (!NILP (*sideward))
3096 {
3097 /* We have a chain of parallel siblings whose size should all change. */
3098 for (child = *sideward; !NILP (child); child = c->next)
3099 {
3100 c = XWINDOW (child);
3101 if (width_p)
3102 c->left_col = w->left_col;
3103 else
3104 c->top_line = w->top_line;
3105 size_window (child, size, width_p, nodelete_p,
3106 first_only, last_only);
3107 }
3108 }
3109 else if (!NILP (*forward) && last_only)
3110 {
3111 /* Change the last in a series of siblings. */
3112 Lisp_Object last_child;
3113 int child_size;
3114
3115 for (child = *forward; !NILP (child); child = c->next)
3116 {
3117 c = XWINDOW (child);
3118 last_child = child;
3119 }
3120
3121 child_size = XINT (width_p ? c->total_cols : c->total_lines);
3122 size_window (last_child,
3123 size - old_size + child_size,
3124 width_p, nodelete_p, first_only, last_only);
3125 }
3126 else if (!NILP (*forward) && first_only)
3127 {
3128 /* Change the first in a series of siblings. */
3129 int child_size;
3130
3131 child = *forward;
3132 c = XWINDOW (child);
3133
3134 if (width_p)
3135 c->left_col = w->left_col;
3136 else
3137 c->top_line = w->top_line;
3138
3139 child_size = XINT (width_p ? c->total_cols : c->total_lines);
3140 size_window (child,
3141 size - old_size + child_size,
3142 width_p, nodelete_p, first_only, last_only);
3143 }
3144 else if (!NILP (*forward))
3145 {
3146 int fixed_size, each, extra, n;
3147 int resize_fixed_p, nfixed;
3148 int last_pos, first_pos, nchildren, total;
3149 int *new_sizes = NULL;
3150
3151 /* Determine the fixed-size portion of this window, and the
3152 number of child windows. */
3153 fixed_size = nchildren = nfixed = total = 0;
3154 for (child = *forward; !NILP (child); child = c->next, ++nchildren)
3155 {
3156 int child_size;
3157
3158 c = XWINDOW (child);
3159 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
3160 total += child_size;
3161
3162 if (window_fixed_size_p (c, width_p, 0))
3163 {
3164 fixed_size += child_size;
3165 ++nfixed;
3166 }
3167 }
3168
3169 /* If the new size is smaller than fixed_size, or if there
3170 aren't any resizable windows, allow resizing fixed-size
3171 windows. */
3172 resize_fixed_p = nfixed == nchildren || size < fixed_size;
3173
3174 /* Compute how many lines/columns to add/remove to each child. The
3175 value of extra takes care of rounding errors. */
3176 n = resize_fixed_p ? nchildren : nchildren - nfixed;
3177 if (size < total && n > 1)
3178 new_sizes = shrink_windows (total, size, nchildren, n, min_size,
3179 resize_fixed_p, *forward, width_p);
3180 else
3181 {
3182 each = (size - total) / n;
3183 extra = (size - total) - n * each;
3184 }
3185
3186 /* Compute new children heights and edge positions. */
3187 first_pos = width_p ? XINT (w->left_col) : XINT (w->top_line);
3188 last_pos = first_pos;
3189 for (n = 0, child = *forward; !NILP (child); child = c->next, ++n)
3190 {
3191 int new_size, old_size;
3192
3193 c = XWINDOW (child);
3194 old_size = width_p ? XFASTINT (c->total_cols) : XFASTINT (c->total_lines);
3195 new_size = old_size;
3196
3197 /* The top or left edge position of this child equals the
3198 bottom or right edge of its predecessor. */
3199 if (width_p)
3200 c->left_col = make_number (last_pos);
3201 else
3202 c->top_line = make_number (last_pos);
3203
3204 /* If this child can be resized, do it. */
3205 if (resize_fixed_p || !window_fixed_size_p (c, width_p, 0))
3206 {
3207 new_size = new_sizes ? new_sizes[n] : old_size + each + extra;
3208 extra = 0;
3209 }
3210
3211 /* Set new height. Note that size_window also propagates
3212 edge positions to children, so it's not a no-op if we
3213 didn't change the child's size. */
3214 size_window (child, new_size, width_p, 1, first_only, last_only);
3215
3216 /* Remember the bottom/right edge position of this child; it
3217 will be used to set the top/left edge of the next child. */
3218 last_pos += new_size;
3219 }
3220
3221 if (new_sizes) xfree (new_sizes);
3222
3223 /* We should have covered the parent exactly with child windows. */
3224 xassert (size == last_pos - first_pos);
3225
3226 /* Now delete any children that became too small. */
3227 if (!nodelete_p)
3228 for (child = *forward; !NILP (child); child = c->next)
3229 {
3230 int child_size;
3231 c = XWINDOW (child);
3232 child_size = width_p ? XINT (c->total_cols) : XINT (c->total_lines);
3233 size_window (child, child_size, width_p, 2, first_only, last_only);
3234 }
3235 }
3236 }
3237
3238 /* Set WINDOW's height to HEIGHT, and recursively change the height of
3239 WINDOW's children. NODELETE non-zero means don't delete windows
3240 that become too small in the process. (The caller should check
3241 later and do so if appropriate.) */
3242
3243 void
3244 set_window_height (window, height, nodelete)
3245 Lisp_Object window;
3246 int height;
3247 int nodelete;
3248 {
3249 size_window (window, height, 0, nodelete, 0, 0);
3250 }
3251
3252
3253 /* Set WINDOW's width to WIDTH, and recursively change the width of
3254 WINDOW's children. NODELETE non-zero means don't delete windows
3255 that become too small in the process. (The caller should check
3256 later and do so if appropriate.) */
3257
3258 void
3259 set_window_width (window, width, nodelete)
3260 Lisp_Object window;
3261 int width;
3262 int nodelete;
3263 {
3264 size_window (window, width, 1, nodelete, 0, 0);
3265 }
3266
3267 /* Change window heights in windows rooted in WINDOW by N lines. */
3268
3269 void
3270 change_window_heights (window, n)
3271 Lisp_Object window;
3272 int n;
3273 {
3274 struct window *w = XWINDOW (window);
3275
3276 XSETFASTINT (w->top_line, XFASTINT (w->top_line) + n);
3277 XSETFASTINT (w->total_lines, XFASTINT (w->total_lines) - n);
3278
3279 if (INTEGERP (w->orig_top_line))
3280 XSETFASTINT (w->orig_top_line, XFASTINT (w->orig_top_line) + n);
3281 if (INTEGERP (w->orig_total_lines))
3282 XSETFASTINT (w->orig_total_lines, XFASTINT (w->orig_total_lines) - n);
3283
3284 /* Handle just the top child in a vertical split. */
3285 if (!NILP (w->vchild))
3286 change_window_heights (w->vchild, n);
3287
3288 /* Adjust all children in a horizontal split. */
3289 for (window = w->hchild; !NILP (window); window = w->next)
3290 {
3291 w = XWINDOW (window);
3292 change_window_heights (window, n);
3293 }
3294 }
3295
3296 \f
3297 int window_select_count;
3298
3299 Lisp_Object
3300 Fset_window_buffer_unwind (obuf)
3301 Lisp_Object obuf;
3302 {
3303 Fset_buffer (obuf);
3304 return Qnil;
3305 }
3306
3307 EXFUN (Fset_window_fringes, 4);
3308 EXFUN (Fset_window_scroll_bars, 4);
3309
3310 /* Make WINDOW display BUFFER as its contents. RUN_HOOKS_P non-zero
3311 means it's allowed to run hooks. See make_frame for a case where
3312 it's not allowed. KEEP_MARGINS_P non-zero means that the current
3313 margins, fringes, and scroll-bar settings of the window are not
3314 reset from the buffer's local settings. */
3315
3316 void
3317 set_window_buffer (window, buffer, run_hooks_p, keep_margins_p)
3318 Lisp_Object window, buffer;
3319 int run_hooks_p, keep_margins_p;
3320 {
3321 struct window *w = XWINDOW (window);
3322 struct buffer *b = XBUFFER (buffer);
3323 int count = SPECPDL_INDEX ();
3324
3325 w->buffer = buffer;
3326
3327 if (EQ (window, selected_window))
3328 b->last_selected_window = window;
3329
3330 /* Let redisplay errors through. */
3331 b->display_error_modiff = 0;
3332
3333 /* Update time stamps of buffer display. */
3334 if (INTEGERP (b->display_count))
3335 XSETINT (b->display_count, XINT (b->display_count) + 1);
3336 b->display_time = Fcurrent_time ();
3337
3338 XSETFASTINT (w->window_end_pos, 0);
3339 XSETFASTINT (w->window_end_vpos, 0);
3340 bzero (&w->last_cursor, sizeof w->last_cursor);
3341 w->window_end_valid = Qnil;
3342 w->hscroll = w->min_hscroll = make_number (0);
3343 w->vscroll = 0;
3344 set_marker_both (w->pointm, buffer, BUF_PT (b), BUF_PT_BYTE (b));
3345 set_marker_restricted (w->start,
3346 make_number (b->last_window_start),
3347 buffer);
3348 w->start_at_line_beg = Qnil;
3349 w->force_start = Qnil;
3350 XSETFASTINT (w->last_modified, 0);
3351 XSETFASTINT (w->last_overlay_modified, 0);
3352 windows_or_buffers_changed++;
3353
3354 /* We must select BUFFER for running the window-scroll-functions.
3355 If WINDOW is selected, switch permanently.
3356 Otherwise, switch but go back to the ambient buffer afterward. */
3357 if (EQ (window, selected_window))
3358 Fset_buffer (buffer);
3359 /* We can't check ! NILP (Vwindow_scroll_functions) here
3360 because that might itself be a local variable. */
3361 else if (window_initialized)
3362 {
3363 record_unwind_protect (Fset_window_buffer_unwind, Fcurrent_buffer ());
3364 Fset_buffer (buffer);
3365 }
3366
3367 if (!keep_margins_p)
3368 {
3369 /* Set left and right marginal area width etc. from buffer. */
3370
3371 /* This may call adjust_window_margins three times, so
3372 temporarily disable window margins. */
3373 Lisp_Object save_left = w->left_margin_cols;
3374 Lisp_Object save_right = w->right_margin_cols;
3375
3376 w->left_margin_cols = w->right_margin_cols = Qnil;
3377
3378 Fset_window_fringes (window,
3379 b->left_fringe_width, b->right_fringe_width,
3380 b->fringes_outside_margins);
3381
3382 Fset_window_scroll_bars (window,
3383 b->scroll_bar_width,
3384 b->vertical_scroll_bar_type, Qnil);
3385
3386 w->left_margin_cols = save_left;
3387 w->right_margin_cols = save_right;
3388
3389 Fset_window_margins (window,
3390 b->left_margin_cols, b->right_margin_cols);
3391 }
3392
3393 if (run_hooks_p)
3394 {
3395 if (! NILP (Vwindow_scroll_functions))
3396 run_hook_with_args_2 (Qwindow_scroll_functions, window,
3397 Fmarker_position (w->start));
3398
3399 if (! NILP (Vwindow_configuration_change_hook)
3400 && ! NILP (Vrun_hooks))
3401 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
3402 }
3403
3404 unbind_to (count, Qnil);
3405 }
3406
3407
3408 DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 3, 0,
3409 doc: /* Make WINDOW display BUFFER as its contents.
3410 BUFFER can be a buffer or the name of an existing buffer.
3411 Optional third arg KEEP-MARGINS non-nil means that WINDOW's current
3412 display margins, fringe widths, and scroll bar settings are maintained;
3413 the default is to reset these from BUFFER's local settings or the frame
3414 defaults.
3415
3416 This function runs the hook `window-scroll-functions'. */)
3417 (window, buffer, keep_margins)
3418 register Lisp_Object window, buffer, keep_margins;
3419 {
3420 register Lisp_Object tem;
3421 register struct window *w = decode_window (window);
3422
3423 XSETWINDOW (window, w);
3424 buffer = Fget_buffer (buffer);
3425 CHECK_BUFFER (buffer);
3426
3427 if (NILP (XBUFFER (buffer)->name))
3428 error ("Attempt to display deleted buffer");
3429
3430 tem = w->buffer;
3431 if (NILP (tem))
3432 error ("Window is deleted");
3433 else if (! EQ (tem, Qt)) /* w->buffer is t when the window
3434 is first being set up. */
3435 {
3436 if (!NILP (w->dedicated) && !EQ (tem, buffer))
3437 error ("Window is dedicated to `%s'",
3438 SDATA (XBUFFER (tem)->name));
3439
3440 unshow_buffer (w);
3441 }
3442
3443 set_window_buffer (window, buffer, 1, !NILP (keep_margins));
3444 return Qnil;
3445 }
3446
3447 /* Note that selected_window can be nil
3448 when this is called from Fset_window_configuration. */
3449
3450 DEFUN ("select-window", Fselect_window, Sselect_window, 1, 2, 0,
3451 doc: /* Select WINDOW. Most editing will apply to WINDOW's buffer.
3452 If WINDOW is not already selected, make WINDOW's buffer current
3453 and make WINDOW the frame's selected window. Return WINDOW.
3454 Optional second arg NORECORD non-nil means
3455 do not put this buffer at the front of the list of recently selected ones.
3456
3457 Note that the main editor command loop
3458 selects the buffer of the selected window before each command. */)
3459 (window, norecord)
3460 register Lisp_Object window, norecord;
3461 {
3462 register struct window *w;
3463 register struct window *ow;
3464 struct frame *sf;
3465
3466 CHECK_LIVE_WINDOW (window);
3467
3468 w = XWINDOW (window);
3469 w->frozen_window_start_p = 0;
3470
3471 ++window_select_count;
3472 XSETFASTINT (w->use_time, window_select_count);
3473 if (EQ (window, selected_window))
3474 return window;
3475
3476 sf = SELECTED_FRAME ();
3477 if (XFRAME (WINDOW_FRAME (w)) != sf)
3478 {
3479 XFRAME (WINDOW_FRAME (w))->selected_window = window;
3480 /* Use this rather than Fhandle_switch_frame
3481 so that FRAME_FOCUS_FRAME is moved appropriately as we
3482 move around in the state where a minibuffer in a separate
3483 frame is active. */
3484 Fselect_frame (WINDOW_FRAME (w));
3485 /* Fselect_frame called us back so we've done all the work already. */
3486 eassert (EQ (window, selected_window));
3487 return window;
3488 }
3489 else
3490 sf->selected_window = window;
3491
3492 /* Store the current buffer's actual point into the
3493 old selected window. It belongs to that window,
3494 and when the window is not selected, must be in the window. */
3495 if (!NILP (selected_window))
3496 {
3497 ow = XWINDOW (selected_window);
3498 if (! NILP (ow->buffer))
3499 set_marker_both (ow->pointm, ow->buffer,
3500 BUF_PT (XBUFFER (ow->buffer)),
3501 BUF_PT_BYTE (XBUFFER (ow->buffer)));
3502 }
3503
3504 selected_window = window;
3505
3506 if (NILP (norecord))
3507 record_buffer (w->buffer);
3508 Fset_buffer (w->buffer);
3509
3510 XBUFFER (w->buffer)->last_selected_window = window;
3511
3512 /* Go to the point recorded in the window.
3513 This is important when the buffer is in more
3514 than one window. It also matters when
3515 redisplay_window has altered point after scrolling,
3516 because it makes the change only in the window. */
3517 {
3518 register int new_point = marker_position (w->pointm);
3519 if (new_point < BEGV)
3520 SET_PT (BEGV);
3521 else if (new_point > ZV)
3522 SET_PT (ZV);
3523 else
3524 SET_PT (new_point);
3525 }
3526
3527 windows_or_buffers_changed++;
3528 return window;
3529 }
3530
3531 static Lisp_Object
3532 select_window_norecord (window)
3533 Lisp_Object window;
3534 {
3535 return Fselect_window (window, Qt);
3536 }
3537 \f
3538 /* Deiconify the frame containing the window WINDOW,
3539 unless it is the selected frame;
3540 then return WINDOW.
3541
3542 The reason for the exception for the selected frame
3543 is that it seems better not to change the selected frames visibility
3544 merely because of displaying a different buffer in it.
3545 The deiconification is useful when a buffer gets shown in
3546 another frame that you were not using lately. */
3547
3548 static Lisp_Object
3549 display_buffer_1 (window)
3550 Lisp_Object window;
3551 {
3552 Lisp_Object frame = XWINDOW (window)->frame;
3553 FRAME_PTR f = XFRAME (frame);
3554
3555 FRAME_SAMPLE_VISIBILITY (f);
3556
3557 if (EQ (frame, selected_frame))
3558 ; /* Assume the selected frame is already visible enough. */
3559 else if (minibuf_level > 0
3560 && MINI_WINDOW_P (XWINDOW (selected_window))
3561 && WINDOW_LIVE_P (minibuf_selected_window)
3562 && EQ (frame, WINDOW_FRAME (XWINDOW (minibuf_selected_window))))
3563 ; /* Assume the frame from which we invoked the minibuffer is visible. */
3564 else
3565 {
3566 if (FRAME_ICONIFIED_P (f))
3567 Fmake_frame_visible (frame);
3568 else if (FRAME_VISIBLE_P (f))
3569 Fraise_frame (frame);
3570 }
3571
3572 return window;
3573 }
3574
3575 DEFUN ("special-display-p", Fspecial_display_p, Sspecial_display_p, 1, 1, 0,
3576 doc: /* Returns non-nil if a buffer named BUFFER-NAME gets a special frame.
3577 If the value is t, `display-buffer' or `pop-to-buffer' would create a
3578 special frame for that buffer using the default frame parameters.
3579
3580 If the value is a list, it is a list of frame parameters that would be used
3581 to make a frame for that buffer.
3582 The variables `special-display-buffer-names'
3583 and `special-display-regexps' control this. */)
3584 (buffer_name)
3585 Lisp_Object buffer_name;
3586 {
3587 Lisp_Object tem;
3588
3589 CHECK_STRING (buffer_name);
3590
3591 tem = Fmember (buffer_name, Vspecial_display_buffer_names);
3592 if (!NILP (tem))
3593 return Qt;
3594
3595 tem = Fassoc (buffer_name, Vspecial_display_buffer_names);
3596 if (!NILP (tem))
3597 return XCDR (tem);
3598
3599 for (tem = Vspecial_display_regexps; CONSP (tem); tem = XCDR (tem))
3600 {
3601 Lisp_Object car = XCAR (tem);
3602 if (STRINGP (car)
3603 && fast_string_match (car, buffer_name) >= 0)
3604 return Qt;
3605 else if (CONSP (car)
3606 && STRINGP (XCAR (car))
3607 && fast_string_match (XCAR (car), buffer_name) >= 0)
3608 return XCDR (car);
3609 }
3610 return Qnil;
3611 }
3612
3613 DEFUN ("same-window-p", Fsame_window_p, Ssame_window_p, 1, 1, 0,
3614 doc: /* Returns non-nil if a buffer named BUFFER-NAME would use the same window.
3615 More precisely, if `display-buffer' or `pop-to-buffer' would display
3616 that buffer in the selected window rather than (as usual) in some other window.
3617 See `same-window-buffer-names' and `same-window-regexps'. */)
3618 (buffer_name)
3619 Lisp_Object buffer_name;
3620 {
3621 Lisp_Object tem;
3622
3623 CHECK_STRING (buffer_name);
3624
3625 tem = Fmember (buffer_name, Vsame_window_buffer_names);
3626 if (!NILP (tem))
3627 return Qt;
3628
3629 tem = Fassoc (buffer_name, Vsame_window_buffer_names);
3630 if (!NILP (tem))
3631 return Qt;
3632
3633 for (tem = Vsame_window_regexps; CONSP (tem); tem = XCDR (tem))
3634 {
3635 Lisp_Object car = XCAR (tem);
3636 if (STRINGP (car)
3637 && fast_string_match (car, buffer_name) >= 0)
3638 return Qt;
3639 else if (CONSP (car)
3640 && STRINGP (XCAR (car))
3641 && fast_string_match (XCAR (car), buffer_name) >= 0)
3642 return Qt;
3643 }
3644 return Qnil;
3645 }
3646
3647 /* Use B so the default is (other-buffer). */
3648 DEFUN ("display-buffer", Fdisplay_buffer, Sdisplay_buffer, 1, 3,
3649 "BDisplay buffer: \nP",
3650 doc: /* Make BUFFER appear in some window but don't select it.
3651 BUFFER must be the name of an existing buffer, or, when called from Lisp,
3652 a buffer.
3653 If BUFFER is shown already in some window, just use that one,
3654 unless the window is the selected window and the optional second
3655 argument NOT-THIS-WINDOW is non-nil (interactively, with prefix arg).
3656 If `pop-up-frames' is non-nil, make a new frame if no window shows BUFFER.
3657 Returns the window displaying BUFFER.
3658 If `display-buffer-reuse-frames' is non-nil, and another frame is currently
3659 displaying BUFFER, then simply raise that frame.
3660
3661 The variables `special-display-buffer-names',
3662 `special-display-regexps', `same-window-buffer-names', and
3663 `same-window-regexps' customize how certain buffer names are handled.
3664 The latter two take effect only if NOT-THIS-WINDOW is nil.
3665
3666 If optional argument FRAME is `visible', check all visible frames
3667 for a window to use.
3668 If FRAME is 0, check all visible and iconified frames.
3669 If FRAME is t, check all frames.
3670 If FRAME is a frame, check only that frame.
3671 If FRAME is nil, check only the selected frame
3672 (actually the last nonminibuffer frame),
3673 unless `pop-up-frames' or `display-buffer-reuse-frames' is non-nil,
3674 which means search visible and iconified frames.
3675
3676 If a full-width window on a splittable frame is available to display
3677 the buffer, it may be split, subject to the value of the variable
3678 `split-height-threshold'.
3679
3680 If `even-window-heights' is non-nil, window heights will be evened out
3681 if displaying the buffer causes two vertically adjacent windows to be
3682 displayed. */)
3683 (buffer, not_this_window, frame)
3684 Lisp_Object buffer, not_this_window, frame;
3685 {
3686 register Lisp_Object window, tem, swp;
3687 struct frame *f;
3688
3689 swp = Qnil;
3690 buffer = Fget_buffer (buffer);
3691 CHECK_BUFFER (buffer);
3692
3693 if (!NILP (Vdisplay_buffer_function))
3694 return call2 (Vdisplay_buffer_function, buffer, not_this_window);
3695
3696 if (NILP (not_this_window)
3697 && XBUFFER (XWINDOW (selected_window)->buffer) == XBUFFER (buffer))
3698 return display_buffer_1 (selected_window);
3699
3700 /* See if the user has specified this buffer should appear
3701 in the selected window. */
3702 if (NILP (not_this_window))
3703 {
3704 swp = Fsame_window_p (XBUFFER (buffer)->name);
3705 if (!NILP (swp) && !no_switch_window (selected_window))
3706 {
3707 Fswitch_to_buffer (buffer, Qnil);
3708 return display_buffer_1 (selected_window);
3709 }
3710 }
3711
3712 /* If the user wants pop-up-frames or display-buffer-reuse-frames,
3713 look for a window showing BUFFER on any visible or iconified frame.
3714 Otherwise search only the current frame. */
3715 if (! NILP (frame))
3716 tem = frame;
3717 else if (pop_up_frames
3718 || display_buffer_reuse_frames
3719 || last_nonminibuf_frame == 0)
3720 XSETFASTINT (tem, 0);
3721 else
3722 XSETFRAME (tem, last_nonminibuf_frame);
3723
3724 window = Fget_buffer_window (buffer, tem);
3725 if (!NILP (window)
3726 && (NILP (not_this_window) || !EQ (window, selected_window)))
3727 return display_buffer_1 (window);
3728
3729 /* Certain buffer names get special handling. */
3730 if (!NILP (Vspecial_display_function) && NILP (swp))
3731 {
3732 tem = Fspecial_display_p (XBUFFER (buffer)->name);
3733 if (EQ (tem, Qt))
3734 return call1 (Vspecial_display_function, buffer);
3735 if (CONSP (tem))
3736 return call2 (Vspecial_display_function, buffer, tem);
3737 }
3738
3739 /* If there are no frames open that have more than a minibuffer,
3740 we need to create a new frame. */
3741 if (pop_up_frames || last_nonminibuf_frame == 0)
3742 {
3743 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3744 Fset_window_buffer (window, buffer, Qnil);
3745 return display_buffer_1 (window);
3746 }
3747
3748 f = SELECTED_FRAME ();
3749 if (pop_up_windows
3750 || FRAME_MINIBUF_ONLY_P (f)
3751 /* If the current frame is a special display frame,
3752 don't try to reuse its windows. */
3753 || !NILP (XWINDOW (FRAME_ROOT_WINDOW (f))->dedicated))
3754 {
3755 Lisp_Object frames;
3756 struct gcpro gcpro1;
3757 GCPRO1 (buffer);
3758
3759 frames = Qnil;
3760 if (FRAME_MINIBUF_ONLY_P (f))
3761 XSETFRAME (frames, last_nonminibuf_frame);
3762
3763 /* Note that both Fget_largest_window and Fget_lru_window
3764 ignore minibuffers and dedicated windows.
3765 This means they can return nil. */
3766
3767 /* If the frame we would try to split cannot be split,
3768 try other frames. */
3769 if (FRAME_NO_SPLIT_P (NILP (frames) ? f : last_nonminibuf_frame))
3770 {
3771 /* Try visible frames first. */
3772 window = Fget_largest_window (Qvisible, Qt);
3773 /* If that didn't work, try iconified frames. */
3774 if (NILP (window))
3775 window = Fget_largest_window (make_number (0), Qt);
3776 #if 0 /* Don't try windows on other displays. */
3777 if (NILP (window))
3778 window = Fget_largest_window (Qt, Qt);
3779 #endif
3780 }
3781 else
3782 window = Fget_largest_window (frames, Qt);
3783
3784 /* If the largest window is tall enough, full-width, and either eligible
3785 for splitting or the only window, split it. */
3786 if (!NILP (window)
3787 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3788 && WINDOW_FULL_WIDTH_P (XWINDOW (window))
3789 && (window_height (window) >= split_height_threshold
3790 || (NILP (XWINDOW (window)->parent)))
3791 && (window_height (window)
3792 >= (2 * window_min_size_2 (XWINDOW (window), 0))))
3793 window = call1 (Vsplit_window_preferred_function, window);
3794 else
3795 {
3796 Lisp_Object upper, other;
3797
3798 window = Fget_lru_window (frames, Qt);
3799 /* If the LRU window is tall enough, and either eligible for
3800 splitting and selected or the only window, split it. */
3801 if (!NILP (window)
3802 && ! FRAME_NO_SPLIT_P (XFRAME (XWINDOW (window)->frame))
3803 && ((EQ (window, selected_window)
3804 && window_height (window) >= split_height_threshold)
3805 || (NILP (XWINDOW (window)->parent)))
3806 && (window_height (window)
3807 >= (2 * window_min_size_2 (XWINDOW (window), 0))))
3808 window = call1 (Vsplit_window_preferred_function, window);
3809 else
3810 window = Fget_lru_window (frames, Qnil);
3811 /* If Fget_lru_window returned nil, try other approaches. */
3812
3813 /* Try visible frames first. */
3814 if (NILP (window))
3815 window = Fget_buffer_window (buffer, Qvisible);
3816 if (NILP (window))
3817 window = Fget_largest_window (Qvisible, Qnil);
3818 /* If that didn't work, try iconified frames. */
3819 if (NILP (window))
3820 window = Fget_buffer_window (buffer, make_number (0));
3821 if (NILP (window))
3822 window = Fget_largest_window (make_number (0), Qnil);
3823
3824 #if 0 /* Don't try frames on other displays. */
3825 if (NILP (window))
3826 window = Fget_buffer_window (buffer, Qt);
3827 if (NILP (window))
3828 window = Fget_largest_window (Qt, Qnil);
3829 #endif
3830 /* As a last resort, make a new frame. */
3831 if (NILP (window))
3832 window = Fframe_selected_window (call0 (Vpop_up_frame_function));
3833 /* If window appears above or below another,
3834 even out their heights. */
3835 other = upper = Qnil;
3836 if (!NILP (XWINDOW (window)->prev))
3837 other = upper = XWINDOW (window)->prev;
3838 if (!NILP (XWINDOW (window)->next))
3839 other = XWINDOW (window)->next, upper = window;
3840 if (!NILP (other)
3841 && !NILP (Veven_window_heights)
3842 /* Check that OTHER and WINDOW are vertically arrayed. */
3843 && !EQ (XWINDOW (other)->top_line, XWINDOW (window)->top_line)
3844 && (XFASTINT (XWINDOW (other)->total_lines)
3845 > XFASTINT (XWINDOW (window)->total_lines)))
3846 {
3847 int total = (XFASTINT (XWINDOW (other)->total_lines)
3848 + XFASTINT (XWINDOW (window)->total_lines));
3849 enlarge_window (upper,
3850 total / 2 - XFASTINT (XWINDOW (upper)->total_lines),
3851 0);
3852 }
3853 }
3854 UNGCPRO;
3855 }
3856 else
3857 window = Fget_lru_window (Qnil, Qnil);
3858
3859 Fset_window_buffer (window, buffer, Qnil);
3860 return display_buffer_1 (window);
3861 }
3862
3863
3864 DEFUN ("force-window-update", Fforce_window_update, Sforce_window_update,
3865 0, 1, 0,
3866 doc: /* Force all windows to be updated on next redisplay.
3867 If optional arg OBJECT is a window, force redisplay of that window only.
3868 If OBJECT is a buffer or buffer name, force redisplay of all windows
3869 displaying that buffer. */)
3870 (object)
3871 Lisp_Object object;
3872 {
3873 if (NILP (object))
3874 {
3875 windows_or_buffers_changed++;
3876 update_mode_lines++;
3877 return Qt;
3878 }
3879
3880 if (WINDOWP (object))
3881 {
3882 struct window *w = XWINDOW (object);
3883 mark_window_display_accurate (object, 0);
3884 w->update_mode_line = Qt;
3885 if (BUFFERP (w->buffer))
3886 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
3887 ++update_mode_lines;
3888 return Qt;
3889 }
3890
3891 if (STRINGP (object))
3892 object = Fget_buffer (object);
3893 if (BUFFERP (object) && !NILP (XBUFFER (object)->name))
3894 {
3895 /* Walk all windows looking for buffer, and force update
3896 of each of those windows. */
3897
3898 object = window_loop (REDISPLAY_BUFFER_WINDOWS, object, 0, Qvisible);
3899 return NILP (object) ? Qnil : Qt;
3900 }
3901
3902 /* If nothing suitable was found, just return.
3903 We could signal an error, but this feature will typically be used
3904 asynchronously in timers or process sentinels, so we don't. */
3905 return Qnil;
3906 }
3907
3908
3909 void
3910 temp_output_buffer_show (buf)
3911 register Lisp_Object buf;
3912 {
3913 register struct buffer *old = current_buffer;
3914 register Lisp_Object window;
3915 register struct window *w;
3916
3917 XBUFFER (buf)->directory = current_buffer->directory;
3918
3919 Fset_buffer (buf);
3920 BUF_SAVE_MODIFF (XBUFFER (buf)) = MODIFF;
3921 BEGV = BEG;
3922 ZV = Z;
3923 SET_PT (BEG);
3924 #if 0 /* rms: there should be no reason for this. */
3925 XBUFFER (buf)->prevent_redisplay_optimizations_p = 1;
3926 #endif
3927 set_buffer_internal (old);
3928
3929 if (!NILP (Vtemp_buffer_show_function))
3930 call1 (Vtemp_buffer_show_function, buf);
3931 else
3932 {
3933 window = Fdisplay_buffer (buf, Qnil, Qnil);
3934
3935 if (!EQ (XWINDOW (window)->frame, selected_frame))
3936 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
3937 Vminibuf_scroll_window = window;
3938 w = XWINDOW (window);
3939 XSETFASTINT (w->hscroll, 0);
3940 XSETFASTINT (w->min_hscroll, 0);
3941 set_marker_restricted_both (w->start, buf, BEG, BEG);
3942 set_marker_restricted_both (w->pointm, buf, BEG, BEG);
3943
3944 /* Run temp-buffer-show-hook, with the chosen window selected
3945 and its buffer current. */
3946
3947 if (!NILP (Vrun_hooks)
3948 && !NILP (Fboundp (Qtemp_buffer_show_hook))
3949 && !NILP (Fsymbol_value (Qtemp_buffer_show_hook)))
3950 {
3951 int count = SPECPDL_INDEX ();
3952 Lisp_Object prev_window, prev_buffer;
3953 prev_window = selected_window;
3954 XSETBUFFER (prev_buffer, old);
3955
3956 /* Select the window that was chosen, for running the hook.
3957 Note: Both Fselect_window and select_window_norecord may
3958 set-buffer to the buffer displayed in the window,
3959 so we need to save the current buffer. --stef */
3960 record_unwind_protect (Fset_buffer, prev_buffer);
3961 record_unwind_protect (select_window_norecord, prev_window);
3962 Fselect_window (window, Qt);
3963 Fset_buffer (w->buffer);
3964 call1 (Vrun_hooks, Qtemp_buffer_show_hook);
3965 unbind_to (count, Qnil);
3966 }
3967 }
3968 }
3969 \f
3970 static void
3971 make_dummy_parent (window)
3972 Lisp_Object window;
3973 {
3974 Lisp_Object new;
3975 register struct window *o, *p;
3976 int i;
3977
3978 o = XWINDOW (window);
3979 p = allocate_window ();
3980 for (i = 0; i < VECSIZE (struct window); ++i)
3981 ((struct Lisp_Vector *) p)->contents[i]
3982 = ((struct Lisp_Vector *)o)->contents[i];
3983 XSETWINDOW (new, p);
3984
3985 ++sequence_number;
3986 XSETFASTINT (p->sequence_number, sequence_number);
3987
3988 /* Put new into window structure in place of window */
3989 replace_window (window, new);
3990
3991 o->next = Qnil;
3992 o->prev = Qnil;
3993 o->vchild = Qnil;
3994 o->hchild = Qnil;
3995 o->parent = new;
3996
3997 p->start = Qnil;
3998 p->pointm = Qnil;
3999 p->buffer = Qnil;
4000 }
4001
4002 DEFUN ("split-window", Fsplit_window, Ssplit_window, 0, 3, "",
4003 doc: /* Split WINDOW, putting SIZE lines in the first of the pair.
4004 WINDOW defaults to selected one and SIZE to half its size.
4005 If optional third arg HORFLAG is non-nil, split side by side
4006 and put SIZE columns in the first of the pair. In that case,
4007 SIZE includes that window's scroll bar, or the divider column to its right.
4008 Interactively, all arguments are nil.
4009
4010 Returns the newly created window (which is the lower or rightmost one).
4011 The upper or leftmost window is the original one, and remains selected
4012 if it was selected before.
4013
4014 See Info node `(elisp)Splitting Windows' for more details and examples.*/)
4015 (window, size, horflag)
4016 Lisp_Object window, size, horflag;
4017 {
4018 register Lisp_Object new;
4019 register struct window *o, *p;
4020 FRAME_PTR fo;
4021 register int size_int;
4022
4023 if (NILP (window))
4024 window = selected_window;
4025 else
4026 CHECK_LIVE_WINDOW (window);
4027
4028 o = XWINDOW (window);
4029 fo = XFRAME (WINDOW_FRAME (o));
4030
4031 if (NILP (size))
4032 {
4033 if (!NILP (horflag))
4034 /* Calculate the size of the left-hand window, by dividing
4035 the usable space in columns by two.
4036 We round up, since the left-hand window may include
4037 a dividing line, while the right-hand may not. */
4038 size_int = (XFASTINT (o->total_cols) + 1) >> 1;
4039 else
4040 size_int = XFASTINT (o->total_lines) >> 1;
4041 }
4042 else
4043 {
4044 CHECK_NUMBER (size);
4045 size_int = XINT (size);
4046 }
4047
4048 if (MINI_WINDOW_P (o))
4049 error ("Attempt to split minibuffer window");
4050 else if (window_fixed_size_p (o, !NILP (horflag), 0))
4051 error ("Attempt to split fixed-size window");
4052
4053 check_min_window_sizes ();
4054
4055 if (NILP (horflag))
4056 {
4057 int window_safe_height = window_min_size_2 (o, 0);
4058
4059 if (size_int < window_safe_height)
4060 error ("Window height %d too small (after splitting)", size_int);
4061 if (size_int + window_safe_height > XFASTINT (o->total_lines))
4062 error ("Window height %d too small (after splitting)",
4063 XFASTINT (o->total_lines) - size_int);
4064 if (NILP (o->parent)
4065 || NILP (XWINDOW (o->parent)->vchild))
4066 {
4067 make_dummy_parent (window);
4068 new = o->parent;
4069 XWINDOW (new)->vchild = window;
4070 }
4071 }
4072 else
4073 {
4074 int window_safe_width = window_min_size_2 (o, 1);
4075
4076 if (size_int < window_safe_width)
4077 error ("Window width %d too small (after splitting)", size_int);
4078 if (size_int + window_safe_width > XFASTINT (o->total_cols))
4079 error ("Window width %d too small (after splitting)",
4080 XFASTINT (o->total_cols) - size_int);
4081 if (NILP (o->parent)
4082 || NILP (XWINDOW (o->parent)->hchild))
4083 {
4084 make_dummy_parent (window);
4085 new = o->parent;
4086 XWINDOW (new)->hchild = window;
4087 }
4088 }
4089
4090 /* Now we know that window's parent is a vertical combination
4091 if we are dividing vertically, or a horizontal combination
4092 if we are making side-by-side windows */
4093
4094 windows_or_buffers_changed++;
4095 FRAME_WINDOW_SIZES_CHANGED (fo) = 1;
4096 new = make_window ();
4097 p = XWINDOW (new);
4098
4099 p->frame = o->frame;
4100 p->next = o->next;
4101 if (!NILP (p->next))
4102 XWINDOW (p->next)->prev = new;
4103 p->prev = window;
4104 o->next = new;
4105 p->parent = o->parent;
4106 p->buffer = Qt;
4107 p->window_end_valid = Qnil;
4108 bzero (&p->last_cursor, sizeof p->last_cursor);
4109
4110 /* Duplicate special geometry settings. */
4111
4112 p->left_margin_cols = o->left_margin_cols;
4113 p->right_margin_cols = o->right_margin_cols;
4114 p->left_fringe_width = o->left_fringe_width;
4115 p->right_fringe_width = o->right_fringe_width;
4116 p->fringes_outside_margins = o->fringes_outside_margins;
4117 p->scroll_bar_width = o->scroll_bar_width;
4118 p->vertical_scroll_bar_type = o->vertical_scroll_bar_type;
4119
4120 /* Apportion the available frame space among the two new windows */
4121
4122 if (!NILP (horflag))
4123 {
4124 p->total_lines = o->total_lines;
4125 p->top_line = o->top_line;
4126 XSETFASTINT (p->total_cols, XFASTINT (o->total_cols) - size_int);
4127 XSETFASTINT (o->total_cols, size_int);
4128 XSETFASTINT (p->left_col, XFASTINT (o->left_col) + size_int);
4129 adjust_window_margins (p);
4130 adjust_window_margins (o);
4131 }
4132 else
4133 {
4134 p->left_col = o->left_col;
4135 p->total_cols = o->total_cols;
4136 XSETFASTINT (p->total_lines, XFASTINT (o->total_lines) - size_int);
4137 XSETFASTINT (o->total_lines, size_int);
4138 XSETFASTINT (p->top_line, XFASTINT (o->top_line) + size_int);
4139 }
4140
4141 /* Adjust glyph matrices. */
4142 adjust_glyphs (fo);
4143
4144 Fset_window_buffer (new, o->buffer, Qt);
4145 return new;
4146 }
4147 \f
4148 DEFUN ("enlarge-window", Fenlarge_window, Senlarge_window, 1, 2, "p",
4149 doc: /* Make current window ARG lines bigger.
4150 From program, optional second arg non-nil means grow sideways ARG columns.
4151 Interactively, if an argument is not given, make the window one line bigger.
4152 If HORIZONTAL is non-nil, enlarge horizontally instead of vertically.
4153 This function can delete windows, even the second window, if they get
4154 too small. */)
4155 (arg, horizontal)
4156 Lisp_Object arg, horizontal;
4157 {
4158 CHECK_NUMBER (arg);
4159 enlarge_window (selected_window, XINT (arg), !NILP (horizontal));
4160
4161 if (! NILP (Vwindow_configuration_change_hook))
4162 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4163
4164 return Qnil;
4165 }
4166
4167 DEFUN ("shrink-window", Fshrink_window, Sshrink_window, 1, 2, "p",
4168 doc: /* Make current window ARG lines smaller.
4169 From program, optional second arg non-nil means shrink sideways arg columns.
4170 Interactively, if an argument is not given, make the window one line smaller.
4171 Only siblings to the right or below are changed. */)
4172 (arg, side)
4173 Lisp_Object arg, side;
4174 {
4175 CHECK_NUMBER (arg);
4176 enlarge_window (selected_window, -XINT (arg), !NILP (side));
4177
4178 if (! NILP (Vwindow_configuration_change_hook))
4179 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4180
4181 return Qnil;
4182 }
4183
4184 int
4185 window_height (window)
4186 Lisp_Object window;
4187 {
4188 register struct window *p = XWINDOW (window);
4189 return WINDOW_TOTAL_LINES (p);
4190 }
4191
4192 int
4193 window_width (window)
4194 Lisp_Object window;
4195 {
4196 register struct window *p = XWINDOW (window);
4197 return WINDOW_TOTAL_COLS (p);
4198 }
4199
4200
4201 #define CURBEG(w) \
4202 *(horiz_flag ? &(XWINDOW (w)->left_col) : &(XWINDOW (w)->top_line))
4203
4204 #define CURSIZE(w) \
4205 *(horiz_flag ? &(XWINDOW (w)->total_cols) : &(XWINDOW (w)->total_lines))
4206
4207
4208 /* Enlarge WINDOW by DELTA.
4209 HORIZ_FLAG nonzero means enlarge it horizontally;
4210 zero means do it vertically.
4211
4212 Siblings of the selected window are resized to fulfill the size
4213 request. If they become too small in the process, they will be
4214 deleted. */
4215
4216 static void
4217 enlarge_window (window, delta, horiz_flag)
4218 Lisp_Object window;
4219 int delta, horiz_flag;
4220 {
4221 Lisp_Object parent, next, prev;
4222 struct window *p;
4223 Lisp_Object *sizep;
4224 int maximum;
4225 int (*sizefun) P_ ((Lisp_Object))
4226 = horiz_flag ? window_width : window_height;
4227 void (*setsizefun) P_ ((Lisp_Object, int, int))
4228 = (horiz_flag ? set_window_width : set_window_height);
4229
4230 /* Check values of window_min_width and window_min_height for
4231 validity. */
4232 check_min_window_sizes ();
4233
4234 /* Give up if this window cannot be resized. */
4235 if (window_fixed_size_p (XWINDOW (window), horiz_flag, 1))
4236 error ("Window is not resizable");
4237
4238 /* Find the parent of the selected window. */
4239 while (1)
4240 {
4241 p = XWINDOW (window);
4242 parent = p->parent;
4243
4244 if (NILP (parent))
4245 {
4246 if (horiz_flag)
4247 error ("No other window to side of this one");
4248 break;
4249 }
4250
4251 if (horiz_flag
4252 ? !NILP (XWINDOW (parent)->hchild)
4253 : !NILP (XWINDOW (parent)->vchild))
4254 break;
4255
4256 window = parent;
4257 }
4258
4259 sizep = &CURSIZE (window);
4260
4261 {
4262 register int maxdelta;
4263
4264 /* Compute the maximum size increment this window can have. */
4265
4266 maxdelta = (!NILP (parent) ? (*sizefun) (parent) - XINT (*sizep)
4267 /* This is a main window followed by a minibuffer. */
4268 : !NILP (p->next) ? ((*sizefun) (p->next)
4269 - window_min_size (XWINDOW (p->next),
4270 horiz_flag, 0, 0))
4271 /* This is a minibuffer following a main window. */
4272 : !NILP (p->prev) ? ((*sizefun) (p->prev)
4273 - window_min_size (XWINDOW (p->prev),
4274 horiz_flag, 0, 0))
4275 /* This is a frame with only one window, a minibuffer-only
4276 or a minibufferless frame. */
4277 : (delta = 0));
4278
4279 if (delta > maxdelta)
4280 /* This case traps trying to make the minibuffer
4281 the full frame, or make the only window aside from the
4282 minibuffer the full frame. */
4283 delta = maxdelta;
4284 }
4285
4286 if (XINT (*sizep) + delta < window_min_size (XWINDOW (window), horiz_flag, 0, 0))
4287 {
4288 delete_window (window);
4289 return;
4290 }
4291
4292 if (delta == 0)
4293 return;
4294
4295 /* Find the total we can get from other siblings without deleting them. */
4296 maximum = 0;
4297 for (next = p->next; WINDOWP (next); next = XWINDOW (next)->next)
4298 maximum += (*sizefun) (next) - window_min_size (XWINDOW (next),
4299 horiz_flag, 0, 0);
4300 for (prev = p->prev; WINDOWP (prev); prev = XWINDOW (prev)->prev)
4301 maximum += (*sizefun) (prev) - window_min_size (XWINDOW (prev),
4302 horiz_flag, 0, 0);
4303
4304 /* If we can get it all from them without deleting them, do so. */
4305 if (delta <= maximum)
4306 {
4307 Lisp_Object first_unaffected;
4308 Lisp_Object first_affected;
4309 int fixed_p;
4310
4311 next = p->next;
4312 prev = p->prev;
4313 first_affected = window;
4314 /* Look at one sibling at a time,
4315 moving away from this window in both directions alternately,
4316 and take as much as we can get without deleting that sibling. */
4317 while (delta != 0
4318 && (!NILP (next) || !NILP (prev)))
4319 {
4320 if (! NILP (next))
4321 {
4322 int this_one = ((*sizefun) (next)
4323 - window_min_size (XWINDOW (next),
4324 horiz_flag, 0, &fixed_p));
4325 if (!fixed_p)
4326 {
4327 if (this_one > delta)
4328 this_one = delta;
4329
4330 (*setsizefun) (next, (*sizefun) (next) - this_one, 0);
4331 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
4332
4333 delta -= this_one;
4334 }
4335
4336 next = XWINDOW (next)->next;
4337 }
4338
4339 if (delta == 0)
4340 break;
4341
4342 if (! NILP (prev))
4343 {
4344 int this_one = ((*sizefun) (prev)
4345 - window_min_size (XWINDOW (prev),
4346 horiz_flag, 0, &fixed_p));
4347 if (!fixed_p)
4348 {
4349 if (this_one > delta)
4350 this_one = delta;
4351
4352 first_affected = prev;
4353
4354 (*setsizefun) (prev, (*sizefun) (prev) - this_one, 0);
4355 (*setsizefun) (window, XINT (*sizep) + this_one, 0);
4356
4357 delta -= this_one;
4358 }
4359
4360 prev = XWINDOW (prev)->prev;
4361 }
4362 }
4363
4364 xassert (delta == 0);
4365
4366 /* Now recalculate the edge positions of all the windows affected,
4367 based on the new sizes. */
4368 first_unaffected = next;
4369 prev = first_affected;
4370 for (next = XWINDOW (prev)->next; ! EQ (next, first_unaffected);
4371 prev = next, next = XWINDOW (next)->next)
4372 {
4373 XSETINT (CURBEG (next), XINT (CURBEG (prev)) + (*sizefun) (prev));
4374 /* This does not change size of NEXT,
4375 but it propagates the new top edge to its children */
4376 (*setsizefun) (next, (*sizefun) (next), 0);
4377 }
4378 }
4379 else
4380 {
4381 register int delta1;
4382 register int opht = (*sizefun) (parent);
4383
4384 if (opht <= XINT (*sizep) + delta)
4385 {
4386 /* If trying to grow this window to or beyond size of the parent,
4387 just delete all the sibling windows. */
4388 Lisp_Object start, tem, next;
4389
4390 start = XWINDOW (parent)->vchild;
4391 if (NILP (start))
4392 start = XWINDOW (parent)->hchild;
4393
4394 /* Delete any siblings that come after WINDOW. */
4395 tem = XWINDOW (window)->next;
4396 while (! NILP (tem))
4397 {
4398 next = XWINDOW (tem)->next;
4399 delete_window (tem);
4400 tem = next;
4401 }
4402
4403 /* Delete any siblings that come after WINDOW.
4404 Note that if START is not WINDOW, then WINDOW still
4405 Fhas siblings, so WINDOW has not yet replaced its parent. */
4406 tem = start;
4407 while (! EQ (tem, window))
4408 {
4409 next = XWINDOW (tem)->next;
4410 delete_window (tem);
4411 tem = next;
4412 }
4413 }
4414 else
4415 {
4416 /* Otherwise, make delta1 just right so that if we add
4417 delta1 lines to this window and to the parent, and then
4418 shrink the parent back to its original size, the new
4419 proportional size of this window will increase by delta.
4420
4421 The function size_window will compute the new height h'
4422 of the window from delta1 as:
4423
4424 e = delta1/n
4425 x = delta1 - delta1/n * n for the 1st resizable child
4426 h' = h + e + x
4427
4428 where n is the number of children that can be resized.
4429 We can ignore x by choosing a delta1 that is a multiple of
4430 n. We want the height of this window to come out as
4431
4432 h' = h + delta
4433
4434 So, delta1 must be
4435
4436 h + e = h + delta
4437 delta1/n = delta
4438 delta1 = n * delta.
4439
4440 The number of children n equals the number of resizable
4441 children of this window + 1 because we know window itself
4442 is resizable (otherwise we would have signalled an error). */
4443
4444 struct window *w = XWINDOW (window);
4445 Lisp_Object s;
4446 int n = 1;
4447
4448 for (s = w->next; WINDOWP (s); s = XWINDOW (s)->next)
4449 if (!window_fixed_size_p (XWINDOW (s), horiz_flag, 0))
4450 ++n;
4451 for (s = w->prev; WINDOWP (s); s = XWINDOW (s)->prev)
4452 if (!window_fixed_size_p (XWINDOW (s), horiz_flag, 0))
4453 ++n;
4454
4455 delta1 = n * delta;
4456
4457 /* Add delta1 lines or columns to this window, and to the parent,
4458 keeping things consistent while not affecting siblings. */
4459 XSETINT (CURSIZE (parent), opht + delta1);
4460 (*setsizefun) (window, XINT (*sizep) + delta1, 0);
4461
4462 /* Squeeze out delta1 lines or columns from our parent,
4463 shriking this window and siblings proportionately.
4464 This brings parent back to correct size.
4465 Delta1 was calculated so this makes this window the desired size,
4466 taking it all out of the siblings. */
4467 (*setsizefun) (parent, opht, 0);
4468
4469 }
4470 }
4471
4472 XSETFASTINT (p->last_modified, 0);
4473 XSETFASTINT (p->last_overlay_modified, 0);
4474
4475 /* Adjust glyph matrices. */
4476 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
4477 }
4478
4479
4480 /* Adjust the size of WINDOW by DELTA, moving only its trailing edge.
4481 HORIZ_FLAG nonzero means adjust the width, moving the right edge.
4482 zero means adjust the height, moving the bottom edge.
4483
4484 Following siblings of the selected window are resized to fulfill
4485 the size request. If they become too small in the process, they
4486 are not deleted; instead, we signal an error. */
4487
4488 static void
4489 adjust_window_trailing_edge (window, delta, horiz_flag)
4490 Lisp_Object window;
4491 int delta, horiz_flag;
4492 {
4493 Lisp_Object parent, child;
4494 struct window *p;
4495 Lisp_Object old_config = Fcurrent_window_configuration (Qnil);
4496 int delcount = window_deletion_count;
4497
4498 /* Check values of window_min_width and window_min_height for
4499 validity. */
4500 check_min_window_sizes ();
4501
4502 if (NILP (window))
4503 window = Fselected_window ();
4504
4505 CHECK_WINDOW (window);
4506
4507 /* Give up if this window cannot be resized. */
4508 if (window_fixed_size_p (XWINDOW (window), horiz_flag, 1))
4509 error ("Window is not resizable");
4510
4511 while (1)
4512 {
4513 Lisp_Object first_parallel = Qnil;
4514
4515 if (NILP (window))
4516 {
4517 /* This happens if WINDOW on the previous iteration was
4518 at top level of the window tree. */
4519 Fset_window_configuration (old_config);
4520 error ("Specified window edge is fixed");
4521 }
4522
4523 p = XWINDOW (window);
4524 parent = p->parent;
4525
4526 /* See if this level has windows in parallel in the specified
4527 direction. If so, set FIRST_PARALLEL to the first one. */
4528 if (horiz_flag)
4529 {
4530 if (! NILP (parent) && !NILP (XWINDOW (parent)->vchild))
4531 first_parallel = XWINDOW (parent)->vchild;
4532 else if (NILP (parent) && !NILP (p->next))
4533 {
4534 /* Handle the vertical chain of main window and minibuffer
4535 which has no parent. */
4536 first_parallel = window;
4537 while (! NILP (XWINDOW (first_parallel)->prev))
4538 first_parallel = XWINDOW (first_parallel)->prev;
4539 }
4540 }
4541 else
4542 {
4543 if (! NILP (parent) && !NILP (XWINDOW (parent)->hchild))
4544 first_parallel = XWINDOW (parent)->hchild;
4545 }
4546
4547 /* If this level's succession is in the desired dimension,
4548 and this window is the last one, and there is no higher level,
4549 its trailing edge is fixed. */
4550 if (NILP (XWINDOW (window)->next) && NILP (first_parallel)
4551 && NILP (parent))
4552 {
4553 Fset_window_configuration (old_config);
4554 error ("Specified window edge is fixed");
4555 }
4556
4557 /* Don't make this window too small. */
4558 if (XINT (CURSIZE (window)) + delta
4559 < window_min_size_2 (XWINDOW (window), horiz_flag))
4560 {
4561 Fset_window_configuration (old_config);
4562 error ("Cannot adjust window size as specified");
4563 }
4564
4565 /* Clear out some redisplay caches. */
4566 XSETFASTINT (p->last_modified, 0);
4567 XSETFASTINT (p->last_overlay_modified, 0);
4568
4569 /* Adjust this window's edge. */
4570 XSETINT (CURSIZE (window),
4571 XINT (CURSIZE (window)) + delta);
4572
4573 /* If this window has following siblings in the desired dimension,
4574 make them smaller, and exit the loop.
4575
4576 (If we reach the top of the tree and can never do this,
4577 we will fail and report an error, above.) */
4578 if (NILP (first_parallel))
4579 {
4580 if (!NILP (p->next))
4581 {
4582 /* This may happen for the minibuffer. In that case
4583 the window_deletion_count check below does not work. */
4584 if (XINT (CURSIZE (p->next)) - delta <= 0)
4585 {
4586 Fset_window_configuration (old_config);
4587 error ("Cannot adjust window size as specified");
4588 }
4589
4590 XSETINT (CURBEG (p->next),
4591 XINT (CURBEG (p->next)) + delta);
4592 size_window (p->next, XINT (CURSIZE (p->next)) - delta,
4593 horiz_flag, 0, 1, 0);
4594 break;
4595 }
4596 }
4597 else
4598 /* Here we have a chain of parallel siblings, in the other dimension.
4599 Change the size of the other siblings. */
4600 for (child = first_parallel;
4601 ! NILP (child);
4602 child = XWINDOW (child)->next)
4603 if (! EQ (child, window))
4604 size_window (child, XINT (CURSIZE (child)) + delta,
4605 horiz_flag, 0, 0, 1);
4606
4607 window = parent;
4608 }
4609
4610 /* If we made a window so small it got deleted,
4611 we failed. Report failure. */
4612 if (delcount != window_deletion_count)
4613 {
4614 Fset_window_configuration (old_config);
4615 error ("Cannot adjust window size as specified");
4616 }
4617
4618 /* Adjust glyph matrices. */
4619 adjust_glyphs (XFRAME (WINDOW_FRAME (XWINDOW (window))));
4620 }
4621
4622 #undef CURBEG
4623 #undef CURSIZE
4624
4625 DEFUN ("adjust-window-trailing-edge", Fadjust_window_trailing_edge,
4626 Sadjust_window_trailing_edge, 3, 3, 0,
4627 doc: /* Adjust the bottom or right edge of WINDOW by DELTA.
4628 If HORIZONTAL is non-nil, that means adjust the width, moving the right edge.
4629 Otherwise, adjust the height, moving the bottom edge.
4630
4631 Following siblings of the selected window are resized to fulfill
4632 the size request. If they become too small in the process, they
4633 are not deleted; instead, we signal an error. */)
4634 (window, delta, horizontal)
4635 Lisp_Object window, delta, horizontal;
4636 {
4637 CHECK_NUMBER (delta);
4638 adjust_window_trailing_edge (window, XINT (delta), !NILP (horizontal));
4639
4640 if (! NILP (Vwindow_configuration_change_hook))
4641 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
4642
4643 return Qnil;
4644 }
4645
4646
4647 \f
4648 /***********************************************************************
4649 Resizing Mini-Windows
4650 ***********************************************************************/
4651
4652 static void shrink_window_lowest_first P_ ((struct window *, int));
4653
4654 enum save_restore_action
4655 {
4656 CHECK_ORIG_SIZES,
4657 SAVE_ORIG_SIZES,
4658 RESTORE_ORIG_SIZES
4659 };
4660
4661 static int save_restore_orig_size P_ ((struct window *,
4662 enum save_restore_action));
4663
4664 /* Shrink windows rooted in window W to HEIGHT. Take the space needed
4665 from lowest windows first. */
4666
4667 static void
4668 shrink_window_lowest_first (w, height)
4669 struct window *w;
4670 int height;
4671 {
4672 struct window *c;
4673 Lisp_Object child;
4674 int old_height;
4675
4676 xassert (!MINI_WINDOW_P (w));
4677
4678 /* Set redisplay hints. */
4679 XSETFASTINT (w->last_modified, 0);
4680 XSETFASTINT (w->last_overlay_modified, 0);
4681 windows_or_buffers_changed++;
4682 FRAME_WINDOW_SIZES_CHANGED (XFRAME (WINDOW_FRAME (w))) = 1;
4683
4684 old_height = XFASTINT (w->total_lines);
4685 XSETFASTINT (w->total_lines, height);
4686
4687 if (!NILP (w->hchild))
4688 {
4689 for (child = w->hchild; !NILP (child); child = c->next)
4690 {
4691 c = XWINDOW (child);
4692 c->top_line = w->top_line;
4693 shrink_window_lowest_first (c, height);
4694 }
4695 }
4696 else if (!NILP (w->vchild))
4697 {
4698 Lisp_Object last_child;
4699 int delta = old_height - height;
4700 int last_top;
4701
4702 last_child = Qnil;
4703
4704 /* Find the last child. We are taking space from lowest windows
4705 first, so we iterate over children from the last child
4706 backwards. */
4707 for (child = w->vchild; WINDOWP (child); child = XWINDOW (child)->next)
4708 last_child = child;
4709
4710 /* Assign new heights. We leave only MIN_SAFE_WINDOW_HEIGHT. */
4711 for (child = last_child; delta && !NILP (child); child = c->prev)
4712 {
4713 int this_one;
4714
4715 c = XWINDOW (child);
4716 this_one = XFASTINT (c->total_lines) - MIN_SAFE_WINDOW_HEIGHT;
4717
4718 if (this_one > delta)
4719 this_one = delta;
4720
4721 shrink_window_lowest_first (c, XFASTINT (c->total_lines) - this_one);
4722 delta -= this_one;
4723 }
4724
4725 /* Compute new positions. */
4726 last_top = XINT (w->top_line);
4727 for (child = w->vchild; !NILP (child); child = c->next)
4728 {
4729 c = XWINDOW (child);
4730 c->top_line = make_number (last_top);
4731 shrink_window_lowest_first (c, XFASTINT (c->total_lines));
4732 last_top += XFASTINT (c->total_lines);
4733 }
4734 }
4735 }
4736
4737
4738 /* Save, restore, or check positions and sizes in the window tree
4739 rooted at W. ACTION says what to do.
4740
4741 If ACTION is CHECK_ORIG_SIZES, check if orig_top_line and
4742 orig_total_lines members are valid for all windows in the window
4743 tree. Value is non-zero if they are valid.
4744
4745 If ACTION is SAVE_ORIG_SIZES, save members top and height in
4746 orig_top_line and orig_total_lines for all windows in the tree.
4747
4748 If ACTION is RESTORE_ORIG_SIZES, restore top and height from values
4749 stored in orig_top_line and orig_total_lines for all windows. */
4750
4751 static int
4752 save_restore_orig_size (w, action)
4753 struct window *w;
4754 enum save_restore_action action;
4755 {
4756 int success_p = 1;
4757
4758 while (w)
4759 {
4760 if (!NILP (w->hchild))
4761 {
4762 if (!save_restore_orig_size (XWINDOW (w->hchild), action))
4763 success_p = 0;
4764 }
4765 else if (!NILP (w->vchild))
4766 {
4767 if (!save_restore_orig_size (XWINDOW (w->vchild), action))
4768 success_p = 0;
4769 }
4770
4771 switch (action)
4772 {
4773 case CHECK_ORIG_SIZES:
4774 if (!INTEGERP (w->orig_top_line) || !INTEGERP (w->orig_total_lines))
4775 return 0;
4776 break;
4777
4778 case SAVE_ORIG_SIZES:
4779 w->orig_top_line = w->top_line;
4780 w->orig_total_lines = w->total_lines;
4781 XSETFASTINT (w->last_modified, 0);
4782 XSETFASTINT (w->last_overlay_modified, 0);
4783 break;
4784
4785 case RESTORE_ORIG_SIZES:
4786 xassert (INTEGERP (w->orig_top_line) && INTEGERP (w->orig_total_lines));
4787 w->top_line = w->orig_top_line;
4788 w->total_lines = w->orig_total_lines;
4789 w->orig_total_lines = w->orig_top_line = Qnil;
4790 XSETFASTINT (w->last_modified, 0);
4791 XSETFASTINT (w->last_overlay_modified, 0);
4792 break;
4793
4794 default:
4795 abort ();
4796 }
4797
4798 w = NILP (w->next) ? NULL : XWINDOW (w->next);
4799 }
4800
4801 return success_p;
4802 }
4803
4804
4805 /* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we can
4806 without deleting other windows. */
4807
4808 void
4809 grow_mini_window (w, delta)
4810 struct window *w;
4811 int delta;
4812 {
4813 struct frame *f = XFRAME (w->frame);
4814 struct window *root;
4815
4816 xassert (MINI_WINDOW_P (w));
4817 xassert (delta >= 0);
4818
4819 /* Check values of window_min_width and window_min_height for
4820 validity. */
4821 check_min_window_sizes ();
4822
4823 /* Compute how much we can enlarge the mini-window without deleting
4824 other windows. */
4825 root = XWINDOW (FRAME_ROOT_WINDOW (f));
4826 if (delta)
4827 {
4828 int min_height = window_min_size (root, 0, 0, 0);
4829 if (XFASTINT (root->total_lines) - delta < min_height)
4830 /* Note that the root window may already be smaller than
4831 min_height. */
4832 delta = max (0, XFASTINT (root->total_lines) - min_height);
4833 }
4834
4835 if (delta)
4836 {
4837 /* Save original window sizes and positions, if not already done. */
4838 if (!save_restore_orig_size (root, CHECK_ORIG_SIZES))
4839 save_restore_orig_size (root, SAVE_ORIG_SIZES);
4840
4841 /* Shrink other windows. */
4842 shrink_window_lowest_first (root, XFASTINT (root->total_lines) - delta);
4843
4844 /* Grow the mini-window. */
4845 w->top_line = make_number (XFASTINT (root->top_line) + XFASTINT (root->total_lines));
4846 w->total_lines = make_number (XFASTINT (w->total_lines) + delta);
4847 XSETFASTINT (w->last_modified, 0);
4848 XSETFASTINT (w->last_overlay_modified, 0);
4849
4850 adjust_glyphs (f);
4851 }
4852 }
4853
4854
4855 /* Shrink mini-window W. If there is recorded info about window sizes
4856 before a call to grow_mini_window, restore recorded window sizes.
4857 Otherwise, if the mini-window is higher than 1 line, resize it to 1
4858 line. */
4859
4860 void
4861 shrink_mini_window (w)
4862 struct window *w;
4863 {
4864 struct frame *f = XFRAME (w->frame);
4865 struct window *root = XWINDOW (FRAME_ROOT_WINDOW (f));
4866
4867 if (save_restore_orig_size (root, CHECK_ORIG_SIZES))
4868 {
4869 save_restore_orig_size (root, RESTORE_ORIG_SIZES);
4870 adjust_glyphs (f);
4871 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
4872 windows_or_buffers_changed = 1;
4873 }
4874 else if (XFASTINT (w->total_lines) > 1)
4875 {
4876 /* Distribute the additional lines of the mini-window
4877 among the other windows. */
4878 Lisp_Object window;
4879 XSETWINDOW (window, w);
4880 enlarge_window (window, 1 - XFASTINT (w->total_lines), 0);
4881 }
4882 }
4883
4884
4885 \f
4886 /* Mark window cursors off for all windows in the window tree rooted
4887 at W by setting their phys_cursor_on_p flag to zero. Called from
4888 xterm.c, e.g. when a frame is cleared and thereby all cursors on
4889 the frame are cleared. */
4890
4891 void
4892 mark_window_cursors_off (w)
4893 struct window *w;
4894 {
4895 while (w)
4896 {
4897 if (!NILP (w->hchild))
4898 mark_window_cursors_off (XWINDOW (w->hchild));
4899 else if (!NILP (w->vchild))
4900 mark_window_cursors_off (XWINDOW (w->vchild));
4901 else
4902 w->phys_cursor_on_p = 0;
4903
4904 w = NILP (w->next) ? 0 : XWINDOW (w->next);
4905 }
4906 }
4907
4908
4909 /* Return number of lines of text (not counting mode lines) in W. */
4910
4911 int
4912 window_internal_height (w)
4913 struct window *w;
4914 {
4915 int ht = XFASTINT (w->total_lines);
4916
4917 if (!MINI_WINDOW_P (w))
4918 {
4919 if (!NILP (w->parent)
4920 || !NILP (w->vchild)
4921 || !NILP (w->hchild)
4922 || !NILP (w->next)
4923 || !NILP (w->prev)
4924 || WINDOW_WANTS_MODELINE_P (w))
4925 --ht;
4926
4927 if (WINDOW_WANTS_HEADER_LINE_P (w))
4928 --ht;
4929 }
4930
4931 return ht;
4932 }
4933
4934
4935 /* Return the number of columns in W.
4936 Don't count columns occupied by scroll bars or the vertical bar
4937 separating W from the sibling to its right. */
4938
4939 int
4940 window_box_text_cols (w)
4941 struct window *w;
4942 {
4943 struct frame *f = XFRAME (WINDOW_FRAME (w));
4944 int width = XINT (w->total_cols);
4945
4946 if (WINDOW_HAS_VERTICAL_SCROLL_BAR (w))
4947 /* Scroll bars occupy a few columns. */
4948 width -= WINDOW_CONFIG_SCROLL_BAR_COLS (w);
4949 else if (!FRAME_WINDOW_P (f)
4950 && !WINDOW_RIGHTMOST_P (w) && !WINDOW_FULL_WIDTH_P (w))
4951 /* The column of `|' characters separating side-by-side windows
4952 occupies one column only. */
4953 width -= 1;
4954
4955 if (FRAME_WINDOW_P (f))
4956 /* On window-systems, fringes and display margins cannot be
4957 used for normal text. */
4958 width -= (WINDOW_FRINGE_COLS (w)
4959 + WINDOW_LEFT_MARGIN_COLS (w)
4960 + WINDOW_RIGHT_MARGIN_COLS (w));
4961
4962 return width;
4963 }
4964
4965 \f
4966 /************************************************************************
4967 Window Scrolling
4968 ***********************************************************************/
4969
4970 /* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
4971 N screen-fulls, which is defined as the height of the window minus
4972 next_screen_context_lines. If WHOLE is zero, scroll up N lines
4973 instead. Negative values of N mean scroll down. NOERROR non-zero
4974 means don't signal an error if we try to move over BEGV or ZV,
4975 respectively. */
4976
4977 static void
4978 window_scroll (window, n, whole, noerror)
4979 Lisp_Object window;
4980 int n;
4981 int whole;
4982 int noerror;
4983 {
4984 immediate_quit = 1;
4985
4986 /* If we must, use the pixel-based version which is much slower than
4987 the line-based one but can handle varying line heights. */
4988 if (FRAME_WINDOW_P (XFRAME (XWINDOW (window)->frame)))
4989 window_scroll_pixel_based (window, n, whole, noerror);
4990 else
4991 window_scroll_line_based (window, n, whole, noerror);
4992
4993 immediate_quit = 0;
4994 }
4995
4996
4997 /* Implementation of window_scroll that works based on pixel line
4998 heights. See the comment of window_scroll for parameter
4999 descriptions. */
5000
5001 static void
5002 window_scroll_pixel_based (window, n, whole, noerror)
5003 Lisp_Object window;
5004 int n;
5005 int whole;
5006 int noerror;
5007 {
5008 struct it it;
5009 struct window *w = XWINDOW (window);
5010 struct text_pos start;
5011 int this_scroll_margin;
5012 /* True if we fiddled the window vscroll field without really scrolling. */
5013 int vscrolled = 0;
5014 int x, y, rtop, rbot, rowh, vpos;
5015
5016 SET_TEXT_POS_FROM_MARKER (start, w->start);
5017
5018 /* If PT is not visible in WINDOW, move back one half of
5019 the screen. Allow PT to be partially visible, otherwise
5020 something like (scroll-down 1) with PT in the line before
5021 the partially visible one would recenter. */
5022
5023 if (!pos_visible_p (w, PT, &x, &y, &rtop, &rbot, &rowh, &vpos))
5024 {
5025 /* Move backward half the height of the window. Performance note:
5026 vmotion used here is about 10% faster, but would give wrong
5027 results for variable height lines. */
5028 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
5029 it.current_y = it.last_visible_y;
5030 move_it_vertically_backward (&it, window_box_height (w) / 2);
5031
5032 /* The function move_iterator_vertically may move over more than
5033 the specified y-distance. If it->w is small, e.g. a
5034 mini-buffer window, we may end up in front of the window's
5035 display area. This is the case when Start displaying at the
5036 start of the line containing PT in this case. */
5037 if (it.current_y <= 0)
5038 {
5039 init_iterator (&it, w, PT, PT_BYTE, NULL, DEFAULT_FACE_ID);
5040 move_it_vertically_backward (&it, 0);
5041 it.current_y = 0;
5042 }
5043
5044 start = it.current.pos;
5045 }
5046 else if (auto_window_vscroll_p)
5047 {
5048 if (rtop || rbot) /* partially visible */
5049 {
5050 int px;
5051 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
5052 if (whole)
5053 dy = max ((window_box_height (w)
5054 - next_screen_context_lines * dy),
5055 dy);
5056 dy *= n;
5057
5058 if (n < 0)
5059 {
5060 /* Only vscroll backwards if already vscrolled forwards. */
5061 if (w->vscroll < 0 && rtop > 0)
5062 {
5063 px = max (0, -w->vscroll - min (rtop, -dy));
5064 Fset_window_vscroll (window, make_number (px), Qt);
5065 return;
5066 }
5067 }
5068 if (n > 0)
5069 {
5070 /* Do vscroll if already vscrolled or only display line. */
5071 if (rbot > 0 && (w->vscroll < 0 || vpos == 0))
5072 {
5073 px = max (0, -w->vscroll + min (rbot, dy));
5074 Fset_window_vscroll (window, make_number (px), Qt);
5075 return;
5076 }
5077
5078 /* Maybe modify window start instead of scrolling. */
5079 if (rbot > 0 || w->vscroll < 0)
5080 {
5081 int spos;
5082
5083 Fset_window_vscroll (window, make_number (0), Qt);
5084 /* If there are other text lines above the current row,
5085 move window start to current row. Else to next row. */
5086 if (rbot > 0)
5087 spos = XINT (Fline_beginning_position (Qnil));
5088 else
5089 spos = min (XINT (Fline_end_position (Qnil)) + 1, ZV);
5090 set_marker_restricted (w->start, make_number (spos),
5091 w->buffer);
5092 w->start_at_line_beg = Qt;
5093 w->update_mode_line = Qt;
5094 XSETFASTINT (w->last_modified, 0);
5095 XSETFASTINT (w->last_overlay_modified, 0);
5096 /* Set force_start so that redisplay_window will run the
5097 window-scroll-functions. */
5098 w->force_start = Qt;
5099 return;
5100 }
5101 }
5102 }
5103 /* Cancel previous vscroll. */
5104 Fset_window_vscroll (window, make_number (0), Qt);
5105 }
5106
5107 /* If scroll_preserve_screen_position is non-nil, we try to set
5108 point in the same window line as it is now, so get that line. */
5109 if (!NILP (Vscroll_preserve_screen_position))
5110 {
5111 /* We preserve the goal pixel coordinate across consecutive
5112 calls to scroll-up or scroll-down. This avoids the
5113 possibility of point becoming "stuck" on a tall line when
5114 scrolling by one line. */
5115 if (window_scroll_pixel_based_preserve_y < 0
5116 || (!EQ (current_kboard->Vlast_command, Qscroll_up)
5117 && !EQ (current_kboard->Vlast_command, Qscroll_down)))
5118 {
5119 start_display (&it, w, start);
5120 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
5121 window_scroll_pixel_based_preserve_y = it.current_y;
5122 }
5123 }
5124 else
5125 window_scroll_pixel_based_preserve_y = -1;
5126
5127 /* Move iterator it from start the specified distance forward or
5128 backward. The result is the new window start. */
5129 start_display (&it, w, start);
5130 if (whole)
5131 {
5132 int start_pos = IT_CHARPOS (it);
5133 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
5134 dy = max ((window_box_height (w)
5135 - next_screen_context_lines * dy),
5136 dy) * n;
5137
5138 /* Note that move_it_vertically always moves the iterator to the
5139 start of a line. So, if the last line doesn't have a newline,
5140 we would end up at the start of the line ending at ZV. */
5141 if (dy <= 0)
5142 {
5143 move_it_vertically_backward (&it, -dy);
5144 /* Ensure we actually do move, e.g. in case we are currently
5145 looking at an image that is taller that the window height. */
5146 while (start_pos == IT_CHARPOS (it)
5147 && start_pos > BEGV)
5148 move_it_by_lines (&it, -1, 1);
5149 }
5150 else if (dy > 0)
5151 {
5152 move_it_to (&it, ZV, -1, it.current_y + dy, -1,
5153 MOVE_TO_POS | MOVE_TO_Y);
5154 /* Ensure we actually do move, e.g. in case we are currently
5155 looking at an image that is taller that the window height. */
5156 while (start_pos == IT_CHARPOS (it)
5157 && start_pos < ZV)
5158 move_it_by_lines (&it, 1, 1);
5159 }
5160 }
5161 else
5162 move_it_by_lines (&it, n, 1);
5163
5164 /* We failed if we find ZV is already on the screen (scrolling up,
5165 means there's nothing past the end), or if we can't start any
5166 earlier (scrolling down, means there's nothing past the top). */
5167 if ((n > 0 && IT_CHARPOS (it) == ZV)
5168 || (n < 0 && IT_CHARPOS (it) == CHARPOS (start)))
5169 {
5170 if (IT_CHARPOS (it) == ZV)
5171 {
5172 if (it.current_y < it.last_visible_y
5173 && (it.current_y + it.max_ascent + it.max_descent
5174 > it.last_visible_y))
5175 {
5176 /* The last line was only partially visible, make it fully
5177 visible. */
5178 w->vscroll = (it.last_visible_y
5179 - it.current_y + it.max_ascent + it.max_descent);
5180 adjust_glyphs (it.f);
5181 }
5182 else if (noerror)
5183 return;
5184 else if (n < 0) /* could happen with empty buffers */
5185 xsignal0 (Qbeginning_of_buffer);
5186 else
5187 xsignal0 (Qend_of_buffer);
5188 }
5189 else
5190 {
5191 if (w->vscroll != 0)
5192 /* The first line was only partially visible, make it fully
5193 visible. */
5194 w->vscroll = 0;
5195 else if (noerror)
5196 return;
5197 else
5198 xsignal0 (Qbeginning_of_buffer);
5199 }
5200
5201 /* If control gets here, then we vscrolled. */
5202
5203 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
5204
5205 /* Don't try to change the window start below. */
5206 vscrolled = 1;
5207 }
5208
5209 if (! vscrolled)
5210 {
5211 int pos = IT_CHARPOS (it);
5212 int bytepos;
5213
5214 /* If in the middle of a multi-glyph character move forward to
5215 the next character. */
5216 if (in_display_vector_p (&it))
5217 {
5218 ++pos;
5219 move_it_to (&it, pos, -1, -1, -1, MOVE_TO_POS);
5220 }
5221
5222 /* Set the window start, and set up the window for redisplay. */
5223 set_marker_restricted (w->start, make_number (pos),
5224 w->buffer);
5225 bytepos = XMARKER (w->start)->bytepos;
5226 w->start_at_line_beg = ((pos == BEGV || FETCH_BYTE (bytepos - 1) == '\n')
5227 ? Qt : Qnil);
5228 w->update_mode_line = Qt;
5229 XSETFASTINT (w->last_modified, 0);
5230 XSETFASTINT (w->last_overlay_modified, 0);
5231 /* Set force_start so that redisplay_window will run the
5232 window-scroll-functions. */
5233 w->force_start = Qt;
5234 }
5235
5236 /* The rest of this function uses current_y in a nonstandard way,
5237 not including the height of the header line if any. */
5238 it.current_y = it.vpos = 0;
5239
5240 /* Move PT out of scroll margins.
5241 This code wants current_y to be zero at the window start position
5242 even if there is a header line. */
5243 this_scroll_margin = max (0, scroll_margin);
5244 this_scroll_margin = min (this_scroll_margin, XFASTINT (w->total_lines) / 4);
5245 this_scroll_margin *= FRAME_LINE_HEIGHT (it.f);
5246
5247 if (n > 0)
5248 {
5249 /* We moved the window start towards ZV, so PT may be now
5250 in the scroll margin at the top. */
5251 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
5252 if (IT_CHARPOS (it) == PT && it.current_y >= this_scroll_margin
5253 && (NILP (Vscroll_preserve_screen_position)
5254 || EQ (Vscroll_preserve_screen_position, Qt)))
5255 /* We found PT at a legitimate height. Leave it alone. */
5256 ;
5257 else if (window_scroll_pixel_based_preserve_y >= 0)
5258 {
5259 /* If we have a header line, take account of it.
5260 This is necessary because we set it.current_y to 0, above. */
5261 move_it_to (&it, -1, -1,
5262 window_scroll_pixel_based_preserve_y
5263 - (WINDOW_WANTS_HEADER_LINE_P (w) ? 1 : 0 ),
5264 -1, MOVE_TO_Y);
5265 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5266 }
5267 else
5268 {
5269 while (it.current_y < this_scroll_margin)
5270 {
5271 int prev = it.current_y;
5272 move_it_by_lines (&it, 1, 1);
5273 if (prev == it.current_y)
5274 break;
5275 }
5276 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5277 }
5278 }
5279 else if (n < 0)
5280 {
5281 int charpos, bytepos;
5282 int partial_p;
5283
5284 /* Save our position, for the
5285 window_scroll_pixel_based_preserve_y case. */
5286 charpos = IT_CHARPOS (it);
5287 bytepos = IT_BYTEPOS (it);
5288
5289 /* We moved the window start towards BEGV, so PT may be now
5290 in the scroll margin at the bottom. */
5291 move_it_to (&it, PT, -1,
5292 (it.last_visible_y - CURRENT_HEADER_LINE_HEIGHT (w)
5293 - this_scroll_margin - 1),
5294 -1,
5295 MOVE_TO_POS | MOVE_TO_Y);
5296
5297 /* Save our position, in case it's correct. */
5298 charpos = IT_CHARPOS (it);
5299 bytepos = IT_BYTEPOS (it);
5300
5301 /* See if point is on a partially visible line at the end. */
5302 if (it.what == IT_EOB)
5303 partial_p = it.current_y + it.ascent + it.descent > it.last_visible_y;
5304 else
5305 {
5306 move_it_by_lines (&it, 1, 1);
5307 partial_p = it.current_y > it.last_visible_y;
5308 }
5309
5310 if (charpos == PT && !partial_p
5311 && (NILP (Vscroll_preserve_screen_position)
5312 || EQ (Vscroll_preserve_screen_position, Qt)))
5313 /* We found PT before we found the display margin, so PT is ok. */
5314 ;
5315 else if (window_scroll_pixel_based_preserve_y >= 0)
5316 {
5317 SET_TEXT_POS_FROM_MARKER (start, w->start);
5318 start_display (&it, w, start);
5319 /* It would be wrong to subtract CURRENT_HEADER_LINE_HEIGHT
5320 here because we called start_display again and did not
5321 alter it.current_y this time. */
5322 move_it_to (&it, -1, -1, window_scroll_pixel_based_preserve_y, -1,
5323 MOVE_TO_Y);
5324 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5325 }
5326 else
5327 {
5328 if (partial_p)
5329 /* The last line was only partially visible, so back up two
5330 lines to make sure we're on a fully visible line. */
5331 {
5332 move_it_by_lines (&it, -2, 0);
5333 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
5334 }
5335 else
5336 /* No, the position we saved is OK, so use it. */
5337 SET_PT_BOTH (charpos, bytepos);
5338 }
5339 }
5340 }
5341
5342
5343 /* Implementation of window_scroll that works based on screen lines.
5344 See the comment of window_scroll for parameter descriptions. */
5345
5346 static void
5347 window_scroll_line_based (window, n, whole, noerror)
5348 Lisp_Object window;
5349 int n;
5350 int whole;
5351 int noerror;
5352 {
5353 register struct window *w = XWINDOW (window);
5354 register int opoint = PT, opoint_byte = PT_BYTE;
5355 register int pos, pos_byte;
5356 register int ht = window_internal_height (w);
5357 register Lisp_Object tem;
5358 int lose;
5359 Lisp_Object bolp;
5360 int startpos;
5361 struct position posit;
5362 int original_vpos;
5363
5364 /* If scrolling screen-fulls, compute the number of lines to
5365 scroll from the window's height. */
5366 if (whole)
5367 n *= max (1, ht - next_screen_context_lines);
5368
5369 startpos = marker_position (w->start);
5370
5371 posit = *compute_motion (startpos, 0, 0, 0,
5372 PT, ht, 0,
5373 -1, XINT (w->hscroll),
5374 0, w);
5375 original_vpos = posit.vpos;
5376
5377 XSETFASTINT (tem, PT);
5378 tem = Fpos_visible_in_window_p (tem, window, Qnil);
5379
5380 if (NILP (tem))
5381 {
5382 Fvertical_motion (make_number (- (ht / 2)), window);
5383 startpos = PT;
5384 }
5385
5386 SET_PT (startpos);
5387 lose = n < 0 && PT == BEGV;
5388 Fvertical_motion (make_number (n), window);
5389 pos = PT;
5390 pos_byte = PT_BYTE;
5391 bolp = Fbolp ();
5392 SET_PT_BOTH (opoint, opoint_byte);
5393
5394 if (lose)
5395 {
5396 if (noerror)
5397 return;
5398 else
5399 xsignal0 (Qbeginning_of_buffer);
5400 }
5401
5402 if (pos < ZV)
5403 {
5404 int this_scroll_margin = scroll_margin;
5405
5406 /* Don't use a scroll margin that is negative or too large. */
5407 if (this_scroll_margin < 0)
5408 this_scroll_margin = 0;
5409
5410 if (XINT (w->total_lines) < 4 * scroll_margin)
5411 this_scroll_margin = XINT (w->total_lines) / 4;
5412
5413 set_marker_restricted_both (w->start, w->buffer, pos, pos_byte);
5414 w->start_at_line_beg = bolp;
5415 w->update_mode_line = Qt;
5416 XSETFASTINT (w->last_modified, 0);
5417 XSETFASTINT (w->last_overlay_modified, 0);
5418 /* Set force_start so that redisplay_window will run
5419 the window-scroll-functions. */
5420 w->force_start = Qt;
5421
5422 if (!NILP (Vscroll_preserve_screen_position)
5423 && (whole || !EQ (Vscroll_preserve_screen_position, Qt)))
5424 {
5425 SET_PT_BOTH (pos, pos_byte);
5426 Fvertical_motion (make_number (original_vpos), window);
5427 }
5428 /* If we scrolled forward, put point enough lines down
5429 that it is outside the scroll margin. */
5430 else if (n > 0)
5431 {
5432 int top_margin;
5433
5434 if (this_scroll_margin > 0)
5435 {
5436 SET_PT_BOTH (pos, pos_byte);
5437 Fvertical_motion (make_number (this_scroll_margin), window);
5438 top_margin = PT;
5439 }
5440 else
5441 top_margin = pos;
5442
5443 if (top_margin <= opoint)
5444 SET_PT_BOTH (opoint, opoint_byte);
5445 else if (!NILP (Vscroll_preserve_screen_position))
5446 {
5447 SET_PT_BOTH (pos, pos_byte);
5448 Fvertical_motion (make_number (original_vpos), window);
5449 }
5450 else
5451 SET_PT (top_margin);
5452 }
5453 else if (n < 0)
5454 {
5455 int bottom_margin;
5456
5457 /* If we scrolled backward, put point near the end of the window
5458 but not within the scroll margin. */
5459 SET_PT_BOTH (pos, pos_byte);
5460 tem = Fvertical_motion (make_number (ht - this_scroll_margin), window);
5461 if (XFASTINT (tem) == ht - this_scroll_margin)
5462 bottom_margin = PT;
5463 else
5464 bottom_margin = PT + 1;
5465
5466 if (bottom_margin > opoint)
5467 SET_PT_BOTH (opoint, opoint_byte);
5468 else
5469 {
5470 if (!NILP (Vscroll_preserve_screen_position))
5471 {
5472 SET_PT_BOTH (pos, pos_byte);
5473 Fvertical_motion (make_number (original_vpos), window);
5474 }
5475 else
5476 Fvertical_motion (make_number (-1), window);
5477 }
5478 }
5479 }
5480 else
5481 {
5482 if (noerror)
5483 return;
5484 else
5485 xsignal0 (Qend_of_buffer);
5486 }
5487 }
5488
5489
5490 /* Scroll selected_window up or down. If N is nil, scroll a
5491 screen-full which is defined as the height of the window minus
5492 next_screen_context_lines. If N is the symbol `-', scroll.
5493 DIRECTION may be 1 meaning to scroll down, or -1 meaning to scroll
5494 up. This is the guts of Fscroll_up and Fscroll_down. */
5495
5496 static void
5497 scroll_command (n, direction)
5498 Lisp_Object n;
5499 int direction;
5500 {
5501 int count = SPECPDL_INDEX ();
5502
5503 xassert (eabs (direction) == 1);
5504
5505 /* If selected window's buffer isn't current, make it current for
5506 the moment. But don't screw up if window_scroll gets an error. */
5507 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
5508 {
5509 record_unwind_protect (save_excursion_restore, save_excursion_save ());
5510 Fset_buffer (XWINDOW (selected_window)->buffer);
5511
5512 /* Make redisplay consider other windows than just selected_window. */
5513 ++windows_or_buffers_changed;
5514 }
5515
5516 if (NILP (n))
5517 window_scroll (selected_window, direction, 1, 0);
5518 else if (EQ (n, Qminus))
5519 window_scroll (selected_window, -direction, 1, 0);
5520 else
5521 {
5522 n = Fprefix_numeric_value (n);
5523 window_scroll (selected_window, XINT (n) * direction, 0, 0);
5524 }
5525
5526 unbind_to (count, Qnil);
5527 }
5528
5529 DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "P",
5530 doc: /* Scroll text of current window upward ARG lines.
5531 If ARG is omitted or nil, scroll upward by a near full screen.
5532 A near full screen is `next-screen-context-lines' less than a full screen.
5533 Negative ARG means scroll downward.
5534 If ARG is the atom `-', scroll downward by nearly full screen.
5535 When calling from a program, supply as argument a number, nil, or `-'. */)
5536 (arg)
5537 Lisp_Object arg;
5538 {
5539 scroll_command (arg, 1);
5540 return Qnil;
5541 }
5542
5543 DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "P",
5544 doc: /* Scroll text of current window down ARG lines.
5545 If ARG is omitted or nil, scroll down by a near full screen.
5546 A near full screen is `next-screen-context-lines' less than a full screen.
5547 Negative ARG means scroll upward.
5548 If ARG is the atom `-', scroll upward by nearly full screen.
5549 When calling from a program, supply as argument a number, nil, or `-'. */)
5550 (arg)
5551 Lisp_Object arg;
5552 {
5553 scroll_command (arg, -1);
5554 return Qnil;
5555 }
5556 \f
5557 DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling, Sother_window_for_scrolling, 0, 0, 0,
5558 doc: /* Return the other window for \"other window scroll\" commands.
5559 If `other-window-scroll-buffer' is non-nil, a window
5560 showing that buffer is used.
5561 If in the minibuffer, `minibuffer-scroll-window' if non-nil
5562 specifies the window. This takes precedence over
5563 `other-window-scroll-buffer'. */)
5564 ()
5565 {
5566 Lisp_Object window;
5567
5568 if (MINI_WINDOW_P (XWINDOW (selected_window))
5569 && !NILP (Vminibuf_scroll_window))
5570 window = Vminibuf_scroll_window;
5571 /* If buffer is specified, scroll that buffer. */
5572 else if (!NILP (Vother_window_scroll_buffer))
5573 {
5574 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
5575 if (NILP (window))
5576 window = Fdisplay_buffer (Vother_window_scroll_buffer, Qt, Qnil);
5577 }
5578 else
5579 {
5580 /* Nothing specified; look for a neighboring window on the same
5581 frame. */
5582 window = Fnext_window (selected_window, Qnil, Qnil);
5583
5584 if (EQ (window, selected_window))
5585 /* That didn't get us anywhere; look for a window on another
5586 visible frame. */
5587 do
5588 window = Fnext_window (window, Qnil, Qt);
5589 while (! FRAME_VISIBLE_P (XFRAME (WINDOW_FRAME (XWINDOW (window))))
5590 && ! EQ (window, selected_window));
5591 }
5592
5593 CHECK_LIVE_WINDOW (window);
5594
5595 if (EQ (window, selected_window))
5596 error ("There is no other window");
5597
5598 return window;
5599 }
5600
5601 DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
5602 doc: /* Scroll next window upward ARG lines; or near full screen if no ARG.
5603 A near full screen is `next-screen-context-lines' less than a full screen.
5604 The next window is the one below the current one; or the one at the top
5605 if the current one is at the bottom. Negative ARG means scroll downward.
5606 If ARG is the atom `-', scroll downward by nearly full screen.
5607 When calling from a program, supply as argument a number, nil, or `-'.
5608
5609 If `other-window-scroll-buffer' is non-nil, scroll the window
5610 showing that buffer, popping the buffer up if necessary.
5611 If in the minibuffer, `minibuffer-scroll-window' if non-nil
5612 specifies the window to scroll. This takes precedence over
5613 `other-window-scroll-buffer'. */)
5614 (arg)
5615 Lisp_Object arg;
5616 {
5617 Lisp_Object window;
5618 struct window *w;
5619 int count = SPECPDL_INDEX ();
5620
5621 window = Fother_window_for_scrolling ();
5622 w = XWINDOW (window);
5623
5624 /* Don't screw up if window_scroll gets an error. */
5625 record_unwind_protect (save_excursion_restore, save_excursion_save ());
5626 ++windows_or_buffers_changed;
5627
5628 Fset_buffer (w->buffer);
5629 SET_PT (marker_position (w->pointm));
5630
5631 if (NILP (arg))
5632 window_scroll (window, 1, 1, 1);
5633 else if (EQ (arg, Qminus))
5634 window_scroll (window, -1, 1, 1);
5635 else
5636 {
5637 if (CONSP (arg))
5638 arg = Fcar (arg);
5639 CHECK_NUMBER (arg);
5640 window_scroll (window, XINT (arg), 0, 1);
5641 }
5642
5643 set_marker_both (w->pointm, Qnil, PT, PT_BYTE);
5644 unbind_to (count, Qnil);
5645
5646 return Qnil;
5647 }
5648 \f
5649 DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 2, "P\np",
5650 doc: /* Scroll selected window display ARG columns left.
5651 Default for ARG is window width minus 2.
5652 Value is the total amount of leftward horizontal scrolling in
5653 effect after the change.
5654 If SET_MINIMUM is non-nil, the new scroll amount becomes the
5655 lower bound for automatic scrolling, i.e. automatic scrolling
5656 will not scroll a window to a column less than the value returned
5657 by this function. This happens in an interactive call. */)
5658 (arg, set_minimum)
5659 register Lisp_Object arg, set_minimum;
5660 {
5661 Lisp_Object result;
5662 int hscroll;
5663 struct window *w = XWINDOW (selected_window);
5664
5665 if (NILP (arg))
5666 XSETFASTINT (arg, window_box_text_cols (w) - 2);
5667 else
5668 arg = Fprefix_numeric_value (arg);
5669
5670 hscroll = XINT (w->hscroll) + XINT (arg);
5671 result = Fset_window_hscroll (selected_window, make_number (hscroll));
5672
5673 if (!NILP (set_minimum))
5674 w->min_hscroll = w->hscroll;
5675
5676 return result;
5677 }
5678
5679 DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 2, "P\np",
5680 doc: /* Scroll selected window display ARG columns right.
5681 Default for ARG is window width minus 2.
5682 Value is the total amount of leftward horizontal scrolling in
5683 effect after the change.
5684 If SET_MINIMUM is non-nil, the new scroll amount becomes the
5685 lower bound for automatic scrolling, i.e. automatic scrolling
5686 will not scroll a window to a column less than the value returned
5687 by this function. This happens in an interactive call. */)
5688 (arg, set_minimum)
5689 register Lisp_Object arg, set_minimum;
5690 {
5691 Lisp_Object result;
5692 int hscroll;
5693 struct window *w = XWINDOW (selected_window);
5694
5695 if (NILP (arg))
5696 XSETFASTINT (arg, window_box_text_cols (w) - 2);
5697 else
5698 arg = Fprefix_numeric_value (arg);
5699
5700 hscroll = XINT (w->hscroll) - XINT (arg);
5701 result = Fset_window_hscroll (selected_window, make_number (hscroll));
5702
5703 if (!NILP (set_minimum))
5704 w->min_hscroll = w->hscroll;
5705
5706 return result;
5707 }
5708
5709 DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window, Sminibuffer_selected_window, 0, 0, 0,
5710 doc: /* Return the window which was selected when entering the minibuffer.
5711 Returns nil, if current window is not a minibuffer window. */)
5712 ()
5713 {
5714 if (minibuf_level > 0
5715 && MINI_WINDOW_P (XWINDOW (selected_window))
5716 && WINDOW_LIVE_P (minibuf_selected_window))
5717 return minibuf_selected_window;
5718
5719 return Qnil;
5720 }
5721
5722 /* Value is the number of lines actually displayed in window W,
5723 as opposed to its height. */
5724
5725 static int
5726 displayed_window_lines (w)
5727 struct window *w;
5728 {
5729 struct it it;
5730 struct text_pos start;
5731 int height = window_box_height (w);
5732 struct buffer *old_buffer;
5733 int bottom_y;
5734
5735 if (XBUFFER (w->buffer) != current_buffer)
5736 {
5737 old_buffer = current_buffer;
5738 set_buffer_internal (XBUFFER (w->buffer));
5739 }
5740 else
5741 old_buffer = NULL;
5742
5743 /* In case W->start is out of the accessible range, do something
5744 reasonable. This happens in Info mode when Info-scroll-down
5745 calls (recenter -1) while W->start is 1. */
5746 if (XMARKER (w->start)->charpos < BEGV)
5747 SET_TEXT_POS (start, BEGV, BEGV_BYTE);
5748 else if (XMARKER (w->start)->charpos > ZV)
5749 SET_TEXT_POS (start, ZV, ZV_BYTE);
5750 else
5751 SET_TEXT_POS_FROM_MARKER (start, w->start);
5752
5753 start_display (&it, w, start);
5754 move_it_vertically (&it, height);
5755 bottom_y = line_bottom_y (&it);
5756
5757 /* rms: On a non-window display,
5758 the value of it.vpos at the bottom of the screen
5759 seems to be 1 larger than window_box_height (w).
5760 This kludge fixes a bug whereby (move-to-window-line -1)
5761 when ZV is on the last screen line
5762 moves to the previous screen line instead of the last one. */
5763 if (! FRAME_WINDOW_P (XFRAME (w->frame)))
5764 height++;
5765
5766 /* Add in empty lines at the bottom of the window. */
5767 if (bottom_y < height)
5768 {
5769 int uy = FRAME_LINE_HEIGHT (it.f);
5770 it.vpos += (height - bottom_y + uy - 1) / uy;
5771 }
5772
5773 if (old_buffer)
5774 set_buffer_internal (old_buffer);
5775
5776 return it.vpos;
5777 }
5778
5779
5780 DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
5781 doc: /* Center point in window and redisplay frame.
5782 With prefix argument ARG, recenter putting point on screen line ARG
5783 relative to the current window. If ARG is negative, it counts up from the
5784 bottom of the window. (ARG should be less than the height of the window.)
5785
5786 If ARG is omitted or nil, erase the entire frame and then redraw with point
5787 in the center of the current window. If `auto-resize-tool-bars' is set to
5788 `grow-only', this resets the tool-bar's height to the minimum height needed.
5789
5790 Just C-u as prefix means put point in the center of the window
5791 and redisplay normally--don't erase and redraw the frame. */)
5792 (arg)
5793 register Lisp_Object arg;
5794 {
5795 struct window *w = XWINDOW (selected_window);
5796 struct buffer *buf = XBUFFER (w->buffer);
5797 struct buffer *obuf = current_buffer;
5798 int center_p = 0;
5799 int charpos, bytepos;
5800 int iarg;
5801 int this_scroll_margin;
5802
5803 /* If redisplay is suppressed due to an error, try again. */
5804 obuf->display_error_modiff = 0;
5805
5806 if (NILP (arg))
5807 {
5808 int i;
5809
5810 /* Invalidate pixel data calculated for all compositions. */
5811 for (i = 0; i < n_compositions; i++)
5812 composition_table[i]->font = NULL;
5813
5814 WINDOW_XFRAME (w)->minimize_tool_bar_window_p = 1;
5815
5816 Fredraw_frame (WINDOW_FRAME (w));
5817 SET_FRAME_GARBAGED (WINDOW_XFRAME (w));
5818 center_p = 1;
5819 }
5820 else if (CONSP (arg)) /* Just C-u. */
5821 center_p = 1;
5822 else
5823 {
5824 arg = Fprefix_numeric_value (arg);
5825 CHECK_NUMBER (arg);
5826 iarg = XINT (arg);
5827 }
5828
5829 set_buffer_internal (buf);
5830
5831 /* Do this after making BUF current
5832 in case scroll_margin is buffer-local. */
5833 this_scroll_margin = max (0, scroll_margin);
5834 this_scroll_margin = min (this_scroll_margin,
5835 XFASTINT (w->total_lines) / 4);
5836
5837 /* Handle centering on a graphical frame specially. Such frames can
5838 have variable-height lines and centering point on the basis of
5839 line counts would lead to strange effects. */
5840 if (FRAME_WINDOW_P (XFRAME (w->frame)))
5841 {
5842 if (center_p)
5843 {
5844 struct it it;
5845 struct text_pos pt;
5846
5847 SET_TEXT_POS (pt, PT, PT_BYTE);
5848 start_display (&it, w, pt);
5849 move_it_vertically_backward (&it, window_box_height (w) / 2);
5850 charpos = IT_CHARPOS (it);
5851 bytepos = IT_BYTEPOS (it);
5852 }
5853 else if (iarg < 0)
5854 {
5855 struct it it;
5856 struct text_pos pt;
5857 int nlines = -iarg;
5858 int extra_line_spacing;
5859 int h = window_box_height (w);
5860
5861 iarg = - max (-iarg, this_scroll_margin);
5862
5863 SET_TEXT_POS (pt, PT, PT_BYTE);
5864 start_display (&it, w, pt);
5865
5866 /* Be sure we have the exact height of the full line containing PT. */
5867 move_it_by_lines (&it, 0, 1);
5868
5869 /* The amount of pixels we have to move back is the window
5870 height minus what's displayed in the line containing PT,
5871 and the lines below. */
5872 it.current_y = 0;
5873 it.vpos = 0;
5874 move_it_by_lines (&it, nlines, 1);
5875
5876 if (it.vpos == nlines)
5877 h -= it.current_y;
5878 else
5879 {
5880 /* Last line has no newline */
5881 h -= line_bottom_y (&it);
5882 it.vpos++;
5883 }
5884
5885 /* Don't reserve space for extra line spacing of last line. */
5886 extra_line_spacing = it.max_extra_line_spacing;
5887
5888 /* If we can't move down NLINES lines because we hit
5889 the end of the buffer, count in some empty lines. */
5890 if (it.vpos < nlines)
5891 {
5892 nlines -= it.vpos;
5893 extra_line_spacing = it.extra_line_spacing;
5894 h -= nlines * (FRAME_LINE_HEIGHT (it.f) + extra_line_spacing);
5895 }
5896 if (h <= 0)
5897 return Qnil;
5898
5899 /* Now find the new top line (starting position) of the window. */
5900 start_display (&it, w, pt);
5901 it.current_y = 0;
5902 move_it_vertically_backward (&it, h);
5903
5904 /* If extra line spacing is present, we may move too far
5905 back. This causes the last line to be only partially
5906 visible (which triggers redisplay to recenter that line
5907 in the middle), so move forward.
5908 But ignore extra line spacing on last line, as it is not
5909 considered to be part of the visible height of the line.
5910 */
5911 h += extra_line_spacing;
5912 while (-it.current_y > h)
5913 move_it_by_lines (&it, 1, 1);
5914
5915 charpos = IT_CHARPOS (it);
5916 bytepos = IT_BYTEPOS (it);
5917 }
5918 else
5919 {
5920 struct position pos;
5921
5922 iarg = max (iarg, this_scroll_margin);
5923
5924 pos = *vmotion (PT, -iarg, w);
5925 charpos = pos.bufpos;
5926 bytepos = pos.bytepos;
5927 }
5928 }
5929 else
5930 {
5931 struct position pos;
5932 int ht = window_internal_height (w);
5933
5934 if (center_p)
5935 iarg = ht / 2;
5936 else if (iarg < 0)
5937 iarg += ht;
5938
5939 /* Don't let it get into the margin at either top or bottom. */
5940 iarg = max (iarg, this_scroll_margin);
5941 iarg = min (iarg, ht - this_scroll_margin - 1);
5942
5943 pos = *vmotion (PT, - iarg, w);
5944 charpos = pos.bufpos;
5945 bytepos = pos.bytepos;
5946 }
5947
5948 /* Set the new window start. */
5949 set_marker_both (w->start, w->buffer, charpos, bytepos);
5950 w->window_end_valid = Qnil;
5951
5952 w->optional_new_start = Qt;
5953
5954 if (bytepos == BEGV_BYTE || FETCH_BYTE (bytepos - 1) == '\n')
5955 w->start_at_line_beg = Qt;
5956 else
5957 w->start_at_line_beg = Qnil;
5958
5959 set_buffer_internal (obuf);
5960 return Qnil;
5961 }
5962
5963
5964 DEFUN ("window-text-height", Fwindow_text_height, Swindow_text_height,
5965 0, 1, 0,
5966 doc: /* Return the height in lines of the text display area of WINDOW.
5967 WINDOW defaults to the selected window.
5968 This doesn't include the mode-line (or header-line if any) or any
5969 partial-height lines in the text display area. */)
5970 (window)
5971 Lisp_Object window;
5972 {
5973 struct window *w = decode_window (window);
5974 int pixel_height = window_box_height (w);
5975 int line_height = pixel_height / FRAME_LINE_HEIGHT (XFRAME (w->frame));
5976 return make_number (line_height);
5977 }
5978
5979
5980 \f
5981 DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
5982 1, 1, "P",
5983 doc: /* Position point relative to window.
5984 With no argument, position point at center of window.
5985 An argument specifies vertical position within the window;
5986 zero means top of window, negative means relative to bottom of window. */)
5987 (arg)
5988 Lisp_Object arg;
5989 {
5990 struct window *w = XWINDOW (selected_window);
5991 int lines, start;
5992 Lisp_Object window;
5993 #if 0
5994 int this_scroll_margin;
5995 #endif
5996
5997 window = selected_window;
5998 start = marker_position (w->start);
5999 if (start < BEGV || start > ZV)
6000 {
6001 int height = window_internal_height (w);
6002 Fvertical_motion (make_number (- (height / 2)), window);
6003 set_marker_both (w->start, w->buffer, PT, PT_BYTE);
6004 w->start_at_line_beg = Fbolp ();
6005 w->force_start = Qt;
6006 }
6007 else
6008 Fgoto_char (w->start);
6009
6010 lines = displayed_window_lines (w);
6011
6012 #if 0
6013 this_scroll_margin = max (0, scroll_margin);
6014 this_scroll_margin = min (this_scroll_margin, lines / 4);
6015 #endif
6016
6017 if (NILP (arg))
6018 XSETFASTINT (arg, lines / 2);
6019 else
6020 {
6021 int iarg = XINT (Fprefix_numeric_value (arg));
6022
6023 if (iarg < 0)
6024 iarg = iarg + lines;
6025
6026 #if 0 /* This code would prevent move-to-window-line from moving point
6027 to a place inside the scroll margins (which would cause the
6028 next redisplay to scroll). I wrote this code, but then concluded
6029 it is probably better not to install it. However, it is here
6030 inside #if 0 so as not to lose it. -- rms. */
6031
6032 /* Don't let it get into the margin at either top or bottom. */
6033 iarg = max (iarg, this_scroll_margin);
6034 iarg = min (iarg, lines - this_scroll_margin - 1);
6035 #endif
6036
6037 arg = make_number (iarg);
6038 }
6039
6040 /* Skip past a partially visible first line. */
6041 if (w->vscroll)
6042 XSETINT (arg, XINT (arg) + 1);
6043
6044 return Fvertical_motion (arg, window);
6045 }
6046
6047
6048 \f
6049 /***********************************************************************
6050 Window Configuration
6051 ***********************************************************************/
6052
6053 struct save_window_data
6054 {
6055 EMACS_UINT size;
6056 struct Lisp_Vector *next_from_Lisp_Vector_struct;
6057 Lisp_Object selected_frame;
6058 Lisp_Object current_window;
6059 Lisp_Object current_buffer;
6060 Lisp_Object minibuf_scroll_window;
6061 Lisp_Object minibuf_selected_window;
6062 Lisp_Object root_window;
6063 Lisp_Object focus_frame;
6064 /* A vector, each of whose elements is a struct saved_window
6065 for one window. */
6066 Lisp_Object saved_windows;
6067
6068 /* All fields above are traced by the GC.
6069 From `fame-cols' down, the fields are ignored by the GC. */
6070
6071 int frame_cols, frame_lines, frame_menu_bar_lines;
6072 int frame_tool_bar_lines;
6073 /* Record the values of window-min-width and window-min-height
6074 so that window sizes remain consistent with them. */
6075 int min_width, min_height;
6076 };
6077
6078 /* This is saved as a Lisp_Vector */
6079 struct saved_window
6080 {
6081 /* these first two must agree with struct Lisp_Vector in lisp.h */
6082 EMACS_UINT size;
6083 struct Lisp_Vector *next_from_Lisp_Vector_struct;
6084
6085 Lisp_Object window;
6086 Lisp_Object buffer, start, pointm, mark;
6087 Lisp_Object left_col, top_line, total_cols, total_lines;
6088 Lisp_Object hscroll, min_hscroll;
6089 Lisp_Object parent, prev;
6090 Lisp_Object start_at_line_beg;
6091 Lisp_Object display_table;
6092 Lisp_Object orig_top_line, orig_total_lines;
6093 Lisp_Object left_margin_cols, right_margin_cols;
6094 Lisp_Object left_fringe_width, right_fringe_width, fringes_outside_margins;
6095 Lisp_Object scroll_bar_width, vertical_scroll_bar_type;
6096 Lisp_Object dedicated;
6097 };
6098
6099 #define SAVED_WINDOW_N(swv,n) \
6100 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
6101
6102 DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
6103 doc: /* Return t if OBJECT is a window-configuration object. */)
6104 (object)
6105 Lisp_Object object;
6106 {
6107 return WINDOW_CONFIGURATIONP (object) ? Qt : Qnil;
6108 }
6109
6110 DEFUN ("window-configuration-frame", Fwindow_configuration_frame, Swindow_configuration_frame, 1, 1, 0,
6111 doc: /* Return the frame that CONFIG, a window-configuration object, is about. */)
6112 (config)
6113 Lisp_Object config;
6114 {
6115 register struct save_window_data *data;
6116 struct Lisp_Vector *saved_windows;
6117
6118 CHECK_WINDOW_CONFIGURATION (config);
6119
6120 data = (struct save_window_data *) XVECTOR (config);
6121 saved_windows = XVECTOR (data->saved_windows);
6122 return XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
6123 }
6124
6125 DEFUN ("set-window-configuration", Fset_window_configuration,
6126 Sset_window_configuration, 1, 1, 0,
6127 doc: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
6128 CONFIGURATION must be a value previously returned
6129 by `current-window-configuration' (which see).
6130 If CONFIGURATION was made from a frame that is now deleted,
6131 only frame-independent values can be restored. In this case,
6132 the return value is nil. Otherwise the value is t. */)
6133 (configuration)
6134 Lisp_Object configuration;
6135 {
6136 register struct save_window_data *data;
6137 struct Lisp_Vector *saved_windows;
6138 Lisp_Object new_current_buffer;
6139 Lisp_Object frame;
6140 FRAME_PTR f;
6141 int old_point = -1;
6142
6143 CHECK_WINDOW_CONFIGURATION (configuration);
6144
6145 data = (struct save_window_data *) XVECTOR (configuration);
6146 saved_windows = XVECTOR (data->saved_windows);
6147
6148 new_current_buffer = data->current_buffer;
6149 if (NILP (XBUFFER (new_current_buffer)->name))
6150 new_current_buffer = Qnil;
6151 else
6152 {
6153 if (XBUFFER (new_current_buffer) == current_buffer)
6154 /* The code further down "preserves point" by saving here PT in
6155 old_point and then setting it later back into PT. When the
6156 current-selected-window and the final-selected-window both show
6157 the current buffer, this suffers from the problem that the
6158 current PT is the window-point of the current-selected-window,
6159 while the final PT is the point of the final-selected-window, so
6160 this copy from one PT to the other would end up moving the
6161 window-point of the final-selected-window to the window-point of
6162 the current-selected-window. So we have to be careful which
6163 point of the current-buffer we copy into old_point. */
6164 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer)
6165 && WINDOWP (selected_window)
6166 && EQ (XWINDOW (selected_window)->buffer, new_current_buffer)
6167 && !EQ (selected_window, data->current_window))
6168 old_point = XMARKER (XWINDOW (data->current_window)->pointm)->charpos;
6169 else
6170 old_point = PT;
6171 else
6172 /* BUF_PT (XBUFFER (new_current_buffer)) gives us the position of
6173 point in new_current_buffer as of the last time this buffer was
6174 used. This can be non-deterministic since it can be changed by
6175 things like jit-lock by mere temporary selection of some random
6176 window that happens to show this buffer.
6177 So if possible we want this arbitrary choice of "which point" to
6178 be the one from the to-be-selected-window so as to prevent this
6179 window's cursor from being copied from another window. */
6180 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer)
6181 /* If current_window = selected_window, its point is in BUF_PT. */
6182 && !EQ (selected_window, data->current_window))
6183 old_point = XMARKER (XWINDOW (data->current_window)->pointm)->charpos;
6184 else
6185 old_point = BUF_PT (XBUFFER (new_current_buffer));
6186 }
6187
6188 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
6189 f = XFRAME (frame);
6190
6191 /* If f is a dead frame, don't bother rebuilding its window tree.
6192 However, there is other stuff we should still try to do below. */
6193 if (FRAME_LIVE_P (f))
6194 {
6195 register struct window *w;
6196 register struct saved_window *p;
6197 struct window *root_window;
6198 struct window **leaf_windows;
6199 int n_leaf_windows;
6200 int k, i, n;
6201
6202 /* If the frame has been resized since this window configuration was
6203 made, we change the frame to the size specified in the
6204 configuration, restore the configuration, and then resize it
6205 back. We keep track of the prevailing height in these variables. */
6206 int previous_frame_lines = FRAME_LINES (f);
6207 int previous_frame_cols = FRAME_COLS (f);
6208 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
6209 int previous_frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
6210
6211 /* The mouse highlighting code could get screwed up
6212 if it runs during this. */
6213 BLOCK_INPUT;
6214
6215 if (data->frame_lines != previous_frame_lines
6216 || data->frame_cols != previous_frame_cols)
6217 change_frame_size (f, data->frame_lines,
6218 data->frame_cols, 0, 0, 0);
6219 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
6220 if (data->frame_menu_bar_lines
6221 != previous_frame_menu_bar_lines)
6222 x_set_menu_bar_lines (f, make_number (data->frame_menu_bar_lines),
6223 make_number (0));
6224 #ifdef HAVE_WINDOW_SYSTEM
6225 if (data->frame_tool_bar_lines
6226 != previous_frame_tool_bar_lines)
6227 x_set_tool_bar_lines (f, make_number (data->frame_tool_bar_lines),
6228 make_number (0));
6229 #endif
6230 #endif
6231
6232 /* "Swap out" point from the selected window's buffer
6233 into the window itself. (Normally the pointm of the selected
6234 window holds garbage.) We do this now, before
6235 restoring the window contents, and prevent it from
6236 being done later on when we select a new window. */
6237 if (! NILP (XWINDOW (selected_window)->buffer))
6238 {
6239 w = XWINDOW (selected_window);
6240 set_marker_both (w->pointm,
6241 w->buffer,
6242 BUF_PT (XBUFFER (w->buffer)),
6243 BUF_PT_BYTE (XBUFFER (w->buffer)));
6244 }
6245
6246 windows_or_buffers_changed++;
6247 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
6248
6249 /* Problem: Freeing all matrices and later allocating them again
6250 is a serious redisplay flickering problem. What we would
6251 really like to do is to free only those matrices not reused
6252 below. */
6253 root_window = XWINDOW (FRAME_ROOT_WINDOW (f));
6254 leaf_windows
6255 = (struct window **) alloca (count_windows (root_window)
6256 * sizeof (struct window *));
6257 n_leaf_windows = get_leaf_windows (root_window, leaf_windows, 0);
6258
6259 /* Temporarily avoid any problems with windows that are smaller
6260 than they are supposed to be. */
6261 window_min_height = 1;
6262 window_min_width = 1;
6263
6264 /* Kludge Alert!
6265 Mark all windows now on frame as "deleted".
6266 Restoring the new configuration "undeletes" any that are in it.
6267
6268 Save their current buffers in their height fields, since we may
6269 need it later, if a buffer saved in the configuration is now
6270 dead. */
6271 delete_all_subwindows (XWINDOW (FRAME_ROOT_WINDOW (f)));
6272
6273 for (k = 0; k < saved_windows->size; k++)
6274 {
6275 p = SAVED_WINDOW_N (saved_windows, k);
6276 w = XWINDOW (p->window);
6277 w->next = Qnil;
6278
6279 if (!NILP (p->parent))
6280 w->parent = SAVED_WINDOW_N (saved_windows,
6281 XFASTINT (p->parent))->window;
6282 else
6283 w->parent = Qnil;
6284
6285 if (!NILP (p->prev))
6286 {
6287 w->prev = SAVED_WINDOW_N (saved_windows,
6288 XFASTINT (p->prev))->window;
6289 XWINDOW (w->prev)->next = p->window;
6290 }
6291 else
6292 {
6293 w->prev = Qnil;
6294 if (!NILP (w->parent))
6295 {
6296 if (EQ (p->total_cols, XWINDOW (w->parent)->total_cols))
6297 {
6298 XWINDOW (w->parent)->vchild = p->window;
6299 XWINDOW (w->parent)->hchild = Qnil;
6300 }
6301 else
6302 {
6303 XWINDOW (w->parent)->hchild = p->window;
6304 XWINDOW (w->parent)->vchild = Qnil;
6305 }
6306 }
6307 }
6308
6309 /* If we squirreled away the buffer in the window's height,
6310 restore it now. */
6311 if (BUFFERP (w->total_lines))
6312 w->buffer = w->total_lines;
6313 w->left_col = p->left_col;
6314 w->top_line = p->top_line;
6315 w->total_cols = p->total_cols;
6316 w->total_lines = p->total_lines;
6317 w->hscroll = p->hscroll;
6318 w->min_hscroll = p->min_hscroll;
6319 w->display_table = p->display_table;
6320 w->orig_top_line = p->orig_top_line;
6321 w->orig_total_lines = p->orig_total_lines;
6322 w->left_margin_cols = p->left_margin_cols;
6323 w->right_margin_cols = p->right_margin_cols;
6324 w->left_fringe_width = p->left_fringe_width;
6325 w->right_fringe_width = p->right_fringe_width;
6326 w->fringes_outside_margins = p->fringes_outside_margins;
6327 w->scroll_bar_width = p->scroll_bar_width;
6328 w->vertical_scroll_bar_type = p->vertical_scroll_bar_type;
6329 w->dedicated = p->dedicated;
6330 XSETFASTINT (w->last_modified, 0);
6331 XSETFASTINT (w->last_overlay_modified, 0);
6332
6333 /* Reinstall the saved buffer and pointers into it. */
6334 if (NILP (p->buffer))
6335 w->buffer = p->buffer;
6336 else
6337 {
6338 if (!NILP (XBUFFER (p->buffer)->name))
6339 /* If saved buffer is alive, install it. */
6340 {
6341 w->buffer = p->buffer;
6342 w->start_at_line_beg = p->start_at_line_beg;
6343 set_marker_restricted (w->start, p->start, w->buffer);
6344 set_marker_restricted (w->pointm, p->pointm, w->buffer);
6345 Fset_marker (XBUFFER (w->buffer)->mark,
6346 p->mark, w->buffer);
6347
6348 /* As documented in Fcurrent_window_configuration, don't
6349 restore the location of point in the buffer which was
6350 current when the window configuration was recorded. */
6351 if (!EQ (p->buffer, new_current_buffer)
6352 && XBUFFER (p->buffer) == current_buffer)
6353 Fgoto_char (w->pointm);
6354 }
6355 else if (NILP (w->buffer) || NILP (XBUFFER (w->buffer)->name))
6356 /* Else unless window has a live buffer, get one. */
6357 {
6358 w->buffer = Fcdr (Fcar (Vbuffer_alist));
6359 /* This will set the markers to beginning of visible
6360 range. */
6361 set_marker_restricted (w->start, make_number (0), w->buffer);
6362 set_marker_restricted (w->pointm, make_number (0),w->buffer);
6363 w->start_at_line_beg = Qt;
6364 }
6365 else
6366 /* Keeping window's old buffer; make sure the markers
6367 are real. */
6368 {
6369 /* Set window markers at start of visible range. */
6370 if (XMARKER (w->start)->buffer == 0)
6371 set_marker_restricted (w->start, make_number (0),
6372 w->buffer);
6373 if (XMARKER (w->pointm)->buffer == 0)
6374 set_marker_restricted_both (w->pointm, w->buffer,
6375 BUF_PT (XBUFFER (w->buffer)),
6376 BUF_PT_BYTE (XBUFFER (w->buffer)));
6377 w->start_at_line_beg = Qt;
6378 }
6379 }
6380 }
6381
6382 FRAME_ROOT_WINDOW (f) = data->root_window;
6383 /* Prevent "swapping out point" in the old selected window
6384 using the buffer that has been restored into it.
6385 We already swapped out point that from that window's old buffer. */
6386 selected_window = Qnil;
6387
6388 /* Arrange *not* to restore point in the buffer that was
6389 current when the window configuration was saved. */
6390 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer))
6391 set_marker_restricted (XWINDOW (data->current_window)->pointm,
6392 make_number (old_point),
6393 XWINDOW (data->current_window)->buffer);
6394
6395 Fselect_window (data->current_window, Qnil);
6396 XBUFFER (XWINDOW (selected_window)->buffer)->last_selected_window
6397 = selected_window;
6398
6399 if (NILP (data->focus_frame)
6400 || (FRAMEP (data->focus_frame)
6401 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
6402 Fredirect_frame_focus (frame, data->focus_frame);
6403
6404 #if 0 /* I don't understand why this is needed, and it causes problems
6405 when the frame's old selected window has been deleted. */
6406 if (f != selected_frame && FRAME_WINDOW_P (f))
6407 do_switch_frame (WINDOW_FRAME (XWINDOW (data->root_window)),
6408 0, 0);
6409 #endif
6410
6411 /* Set the screen height to the value it had before this function. */
6412 if (previous_frame_lines != FRAME_LINES (f)
6413 || previous_frame_cols != FRAME_COLS (f))
6414 change_frame_size (f, previous_frame_lines, previous_frame_cols,
6415 0, 0, 0);
6416 #if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
6417 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
6418 x_set_menu_bar_lines (f, make_number (previous_frame_menu_bar_lines),
6419 make_number (0));
6420 #ifdef HAVE_WINDOW_SYSTEM
6421 if (previous_frame_tool_bar_lines != FRAME_TOOL_BAR_LINES (f))
6422 x_set_tool_bar_lines (f, make_number (previous_frame_tool_bar_lines),
6423 make_number (0));
6424 #endif
6425 #endif
6426
6427 /* Now, free glyph matrices in windows that were not reused. */
6428 for (i = n = 0; i < n_leaf_windows; ++i)
6429 {
6430 if (NILP (leaf_windows[i]->buffer))
6431 {
6432 /* Assert it's not reused as a combination. */
6433 xassert (NILP (leaf_windows[i]->hchild)
6434 && NILP (leaf_windows[i]->vchild));
6435 free_window_matrices (leaf_windows[i]);
6436 }
6437 else if (EQ (leaf_windows[i]->buffer, new_current_buffer))
6438 ++n;
6439 }
6440
6441 adjust_glyphs (f);
6442
6443 UNBLOCK_INPUT;
6444
6445 /* Fselect_window will have made f the selected frame, so we
6446 reselect the proper frame here. Fhandle_switch_frame will change the
6447 selected window too, but that doesn't make the call to
6448 Fselect_window above totally superfluous; it still sets f's
6449 selected window. */
6450 if (FRAME_LIVE_P (XFRAME (data->selected_frame)))
6451 do_switch_frame (data->selected_frame, 0, 0);
6452
6453 if (! NILP (Vwindow_configuration_change_hook)
6454 && ! NILP (Vrun_hooks))
6455 call1 (Vrun_hooks, Qwindow_configuration_change_hook);
6456 }
6457
6458 if (!NILP (new_current_buffer))
6459 Fset_buffer (new_current_buffer);
6460
6461 /* Restore the minimum heights recorded in the configuration. */
6462 window_min_height = data->min_height;
6463 window_min_width = data->min_width;
6464
6465 Vminibuf_scroll_window = data->minibuf_scroll_window;
6466 minibuf_selected_window = data->minibuf_selected_window;
6467
6468 return (FRAME_LIVE_P (f) ? Qt : Qnil);
6469 }
6470
6471 /* Mark all windows now on frame as deleted
6472 by setting their buffers to nil. */
6473
6474 void
6475 delete_all_subwindows (w)
6476 register struct window *w;
6477 {
6478 if (!NILP (w->next))
6479 delete_all_subwindows (XWINDOW (w->next));
6480 if (!NILP (w->vchild))
6481 delete_all_subwindows (XWINDOW (w->vchild));
6482 if (!NILP (w->hchild))
6483 delete_all_subwindows (XWINDOW (w->hchild));
6484
6485 w->total_lines = w->buffer; /* See Fset_window_configuration for excuse. */
6486
6487 if (!NILP (w->buffer))
6488 unshow_buffer (w);
6489
6490 /* We set all three of these fields to nil, to make sure that we can
6491 distinguish this dead window from any live window. Live leaf
6492 windows will have buffer set, and combination windows will have
6493 vchild or hchild set. */
6494 w->buffer = Qnil;
6495 w->vchild = Qnil;
6496 w->hchild = Qnil;
6497
6498 Vwindow_list = Qnil;
6499 }
6500 \f
6501 static int
6502 count_windows (window)
6503 register struct window *window;
6504 {
6505 register int count = 1;
6506 if (!NILP (window->next))
6507 count += count_windows (XWINDOW (window->next));
6508 if (!NILP (window->vchild))
6509 count += count_windows (XWINDOW (window->vchild));
6510 if (!NILP (window->hchild))
6511 count += count_windows (XWINDOW (window->hchild));
6512 return count;
6513 }
6514
6515
6516 /* Fill vector FLAT with leaf windows under W, starting at index I.
6517 Value is last index + 1. */
6518
6519 static int
6520 get_leaf_windows (w, flat, i)
6521 struct window *w;
6522 struct window **flat;
6523 int i;
6524 {
6525 while (w)
6526 {
6527 if (!NILP (w->hchild))
6528 i = get_leaf_windows (XWINDOW (w->hchild), flat, i);
6529 else if (!NILP (w->vchild))
6530 i = get_leaf_windows (XWINDOW (w->vchild), flat, i);
6531 else
6532 flat[i++] = w;
6533
6534 w = NILP (w->next) ? 0 : XWINDOW (w->next);
6535 }
6536
6537 return i;
6538 }
6539
6540
6541 /* Return a pointer to the glyph W's physical cursor is on. Value is
6542 null if W's current matrix is invalid, so that no meaningfull glyph
6543 can be returned. */
6544
6545 struct glyph *
6546 get_phys_cursor_glyph (w)
6547 struct window *w;
6548 {
6549 struct glyph_row *row;
6550 struct glyph *glyph;
6551
6552 if (w->phys_cursor.vpos >= 0
6553 && w->phys_cursor.vpos < w->current_matrix->nrows
6554 && (row = MATRIX_ROW (w->current_matrix, w->phys_cursor.vpos),
6555 row->enabled_p)
6556 && row->used[TEXT_AREA] > w->phys_cursor.hpos)
6557 glyph = row->glyphs[TEXT_AREA] + w->phys_cursor.hpos;
6558 else
6559 glyph = NULL;
6560
6561 return glyph;
6562 }
6563
6564
6565 static int
6566 save_window_save (window, vector, i)
6567 Lisp_Object window;
6568 struct Lisp_Vector *vector;
6569 int i;
6570 {
6571 register struct saved_window *p;
6572 register struct window *w;
6573 register Lisp_Object tem;
6574
6575 for (;!NILP (window); window = w->next)
6576 {
6577 p = SAVED_WINDOW_N (vector, i);
6578 w = XWINDOW (window);
6579
6580 XSETFASTINT (w->temslot, i); i++;
6581 p->window = window;
6582 p->buffer = w->buffer;
6583 p->left_col = w->left_col;
6584 p->top_line = w->top_line;
6585 p->total_cols = w->total_cols;
6586 p->total_lines = w->total_lines;
6587 p->hscroll = w->hscroll;
6588 p->min_hscroll = w->min_hscroll;
6589 p->display_table = w->display_table;
6590 p->orig_top_line = w->orig_top_line;
6591 p->orig_total_lines = w->orig_total_lines;
6592 p->left_margin_cols = w->left_margin_cols;
6593 p->right_margin_cols = w->right_margin_cols;
6594 p->left_fringe_width = w->left_fringe_width;
6595 p->right_fringe_width = w->right_fringe_width;
6596 p->fringes_outside_margins = w->fringes_outside_margins;
6597 p->scroll_bar_width = w->scroll_bar_width;
6598 p->vertical_scroll_bar_type = w->vertical_scroll_bar_type;
6599 p->dedicated = w->dedicated;
6600 if (!NILP (w->buffer))
6601 {
6602 /* Save w's value of point in the window configuration.
6603 If w is the selected window, then get the value of point
6604 from the buffer; pointm is garbage in the selected window. */
6605 if (EQ (window, selected_window))
6606 {
6607 p->pointm = Fmake_marker ();
6608 set_marker_both (p->pointm, w->buffer,
6609 BUF_PT (XBUFFER (w->buffer)),
6610 BUF_PT_BYTE (XBUFFER (w->buffer)));
6611 }
6612 else
6613 p->pointm = Fcopy_marker (w->pointm, Qnil);
6614
6615 p->start = Fcopy_marker (w->start, Qnil);
6616 p->start_at_line_beg = w->start_at_line_beg;
6617
6618 tem = XBUFFER (w->buffer)->mark;
6619 p->mark = Fcopy_marker (tem, Qnil);
6620 }
6621 else
6622 {
6623 p->pointm = Qnil;
6624 p->start = Qnil;
6625 p->mark = Qnil;
6626 p->start_at_line_beg = Qnil;
6627 }
6628
6629 if (NILP (w->parent))
6630 p->parent = Qnil;
6631 else
6632 p->parent = XWINDOW (w->parent)->temslot;
6633
6634 if (NILP (w->prev))
6635 p->prev = Qnil;
6636 else
6637 p->prev = XWINDOW (w->prev)->temslot;
6638
6639 if (!NILP (w->vchild))
6640 i = save_window_save (w->vchild, vector, i);
6641 if (!NILP (w->hchild))
6642 i = save_window_save (w->hchild, vector, i);
6643 }
6644
6645 return i;
6646 }
6647
6648 DEFUN ("current-window-configuration", Fcurrent_window_configuration,
6649 Scurrent_window_configuration, 0, 1, 0,
6650 doc: /* Return an object representing the current window configuration of FRAME.
6651 If FRAME is nil or omitted, use the selected frame.
6652 This describes the number of windows, their sizes and current buffers,
6653 and for each displayed buffer, where display starts, and the positions of
6654 point and mark. An exception is made for point in the current buffer:
6655 its value is -not- saved.
6656 This also records the currently selected frame, and FRAME's focus
6657 redirection (see `redirect-frame-focus'). */)
6658 (frame)
6659 Lisp_Object frame;
6660 {
6661 register Lisp_Object tem;
6662 register int n_windows;
6663 register struct save_window_data *data;
6664 register int i;
6665 FRAME_PTR f;
6666
6667 if (NILP (frame))
6668 frame = selected_frame;
6669 CHECK_LIVE_FRAME (frame);
6670 f = XFRAME (frame);
6671
6672 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
6673 data = ALLOCATE_PSEUDOVECTOR (struct save_window_data, frame_cols,
6674 PVEC_WINDOW_CONFIGURATION);
6675
6676 data->frame_cols = FRAME_COLS (f);
6677 data->frame_lines = FRAME_LINES (f);
6678 data->frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
6679 data->frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
6680 data->selected_frame = selected_frame;
6681 data->current_window = FRAME_SELECTED_WINDOW (f);
6682 XSETBUFFER (data->current_buffer, current_buffer);
6683 data->minibuf_scroll_window = minibuf_level > 0 ? Vminibuf_scroll_window : Qnil;
6684 data->minibuf_selected_window = minibuf_level > 0 ? minibuf_selected_window : Qnil;
6685 data->root_window = FRAME_ROOT_WINDOW (f);
6686 data->focus_frame = FRAME_FOCUS_FRAME (f);
6687 data->min_height = window_min_height;
6688 data->min_width = window_min_width;
6689 tem = Fmake_vector (make_number (n_windows), Qnil);
6690 data->saved_windows = tem;
6691 for (i = 0; i < n_windows; i++)
6692 XVECTOR (tem)->contents[i]
6693 = Fmake_vector (make_number (VECSIZE (struct saved_window)), Qnil);
6694 save_window_save (FRAME_ROOT_WINDOW (f), XVECTOR (tem), 0);
6695 XSETWINDOW_CONFIGURATION (tem, data);
6696 return (tem);
6697 }
6698
6699 DEFUN ("save-window-excursion", Fsave_window_excursion, Ssave_window_excursion,
6700 0, UNEVALLED, 0,
6701 doc: /* Execute BODY, preserving window sizes and contents.
6702 Return the value of the last form in BODY.
6703 Restore which buffer appears in which window, where display starts,
6704 and the value of point and mark for each window.
6705 Also restore the choice of selected window.
6706 Also restore which buffer is current.
6707 Does not restore the value of point in current buffer.
6708 usage: (save-window-excursion BODY...) */)
6709 (args)
6710 Lisp_Object args;
6711 {
6712 register Lisp_Object val;
6713 register int count = SPECPDL_INDEX ();
6714
6715 record_unwind_protect (Fset_window_configuration,
6716 Fcurrent_window_configuration (Qnil));
6717 val = Fprogn (args);
6718 return unbind_to (count, val);
6719 }
6720
6721
6722 \f
6723 /***********************************************************************
6724 Window Split Tree
6725 ***********************************************************************/
6726
6727 static Lisp_Object
6728 window_tree (w)
6729 struct window *w;
6730 {
6731 Lisp_Object tail = Qnil;
6732 Lisp_Object result = Qnil;
6733
6734 while (w)
6735 {
6736 Lisp_Object wn;
6737
6738 XSETWINDOW (wn, w);
6739 if (!NILP (w->hchild))
6740 wn = Fcons (Qnil, Fcons (Fwindow_edges (wn),
6741 window_tree (XWINDOW (w->hchild))));
6742 else if (!NILP (w->vchild))
6743 wn = Fcons (Qt, Fcons (Fwindow_edges (wn),
6744 window_tree (XWINDOW (w->vchild))));
6745
6746 if (NILP (result))
6747 {
6748 result = tail = Fcons (wn, Qnil);
6749 }
6750 else
6751 {
6752 XSETCDR (tail, Fcons (wn, Qnil));
6753 tail = XCDR (tail);
6754 }
6755
6756 w = NILP (w->next) ? 0 : XWINDOW (w->next);
6757 }
6758
6759 return result;
6760 }
6761
6762
6763
6764 DEFUN ("window-tree", Fwindow_tree, Swindow_tree,
6765 0, 1, 0,
6766 doc: /* Return the window tree for frame FRAME.
6767
6768 The return value is a list of the form (ROOT MINI), where ROOT
6769 represents the window tree of the frame's root window, and MINI
6770 is the frame's minibuffer window.
6771
6772 If the root window is not split, ROOT is the root window itself.
6773 Otherwise, ROOT is a list (DIR EDGES W1 W2 ...) where DIR is nil for a
6774 horizontal split, and t for a vertical split, EDGES gives the combined
6775 size and position of the subwindows in the split, and the rest of the
6776 elements are the subwindows in the split. Each of the subwindows may
6777 again be a window or a list representing a window split, and so on.
6778 EDGES is a list \(LEFT TOP RIGHT BOTTOM) as returned by `window-edges'.
6779
6780 If FRAME is nil or omitted, return information on the currently
6781 selected frame. */)
6782 (frame)
6783 Lisp_Object frame;
6784 {
6785 FRAME_PTR f;
6786
6787 if (NILP (frame))
6788 frame = selected_frame;
6789
6790 CHECK_FRAME (frame);
6791 f = XFRAME (frame);
6792
6793 if (!FRAME_LIVE_P (f))
6794 return Qnil;
6795
6796 return window_tree (XWINDOW (FRAME_ROOT_WINDOW (f)));
6797 }
6798
6799 \f
6800 /***********************************************************************
6801 Marginal Areas
6802 ***********************************************************************/
6803
6804 DEFUN ("set-window-margins", Fset_window_margins, Sset_window_margins,
6805 2, 3, 0,
6806 doc: /* Set width of marginal areas of window WINDOW.
6807 If WINDOW is nil, set margins of the currently selected window.
6808 Second arg LEFT-WIDTH specifies the number of character cells to
6809 reserve for the left marginal area. Optional third arg RIGHT-WIDTH
6810 does the same for the right marginal area. A nil width parameter
6811 means no margin. */)
6812 (window, left_width, right_width)
6813 Lisp_Object window, left_width, right_width;
6814 {
6815 struct window *w = decode_window (window);
6816
6817 /* Translate negative or zero widths to nil.
6818 Margins that are too wide have to be checked elsewhere. */
6819
6820 if (!NILP (left_width))
6821 {
6822 CHECK_NUMBER (left_width);
6823 if (XINT (left_width) <= 0)
6824 left_width = Qnil;
6825 }
6826
6827 if (!NILP (right_width))
6828 {
6829 CHECK_NUMBER (right_width);
6830 if (XINT (right_width) <= 0)
6831 right_width = Qnil;
6832 }
6833
6834 if (!EQ (w->left_margin_cols, left_width)
6835 || !EQ (w->right_margin_cols, right_width))
6836 {
6837 w->left_margin_cols = left_width;
6838 w->right_margin_cols = right_width;
6839
6840 adjust_window_margins (w);
6841
6842 ++windows_or_buffers_changed;
6843 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
6844 }
6845
6846 return Qnil;
6847 }
6848
6849
6850 DEFUN ("window-margins", Fwindow_margins, Swindow_margins,
6851 0, 1, 0,
6852 doc: /* Get width of marginal areas of window WINDOW.
6853 If WINDOW is omitted or nil, use the currently selected window.
6854 Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
6855 If a marginal area does not exist, its width will be returned
6856 as nil. */)
6857 (window)
6858 Lisp_Object window;
6859 {
6860 struct window *w = decode_window (window);
6861 return Fcons (w->left_margin_cols, w->right_margin_cols);
6862 }
6863
6864
6865 \f
6866 /***********************************************************************
6867 Fringes
6868 ***********************************************************************/
6869
6870 DEFUN ("set-window-fringes", Fset_window_fringes, Sset_window_fringes,
6871 2, 4, 0,
6872 doc: /* Set the fringe widths of window WINDOW.
6873 If WINDOW is nil, set the fringe widths of the currently selected
6874 window.
6875 Second arg LEFT-WIDTH specifies the number of pixels to reserve for
6876 the left fringe. Optional third arg RIGHT-WIDTH specifies the right
6877 fringe width. If a fringe width arg is nil, that means to use the
6878 frame's default fringe width. Default fringe widths can be set with
6879 the command `set-fringe-style'.
6880 If optional fourth arg OUTSIDE-MARGINS is non-nil, draw the fringes
6881 outside of the display margins. By default, fringes are drawn between
6882 display marginal areas and the text area. */)
6883 (window, left_width, right_width, outside_margins)
6884 Lisp_Object window, left_width, right_width, outside_margins;
6885 {
6886 struct window *w = decode_window (window);
6887
6888 if (!NILP (left_width))
6889 CHECK_NATNUM (left_width);
6890 if (!NILP (right_width))
6891 CHECK_NATNUM (right_width);
6892
6893 /* Do nothing on a tty. */
6894 if (FRAME_WINDOW_P (WINDOW_XFRAME (w))
6895 && (!EQ (w->left_fringe_width, left_width)
6896 || !EQ (w->right_fringe_width, right_width)
6897 || !EQ (w->fringes_outside_margins, outside_margins)))
6898 {
6899 w->left_fringe_width = left_width;
6900 w->right_fringe_width = right_width;
6901 w->fringes_outside_margins = outside_margins;
6902
6903 adjust_window_margins (w);
6904
6905 clear_glyph_matrix (w->current_matrix);
6906 w->window_end_valid = Qnil;
6907
6908 ++windows_or_buffers_changed;
6909 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
6910 }
6911
6912 return Qnil;
6913 }
6914
6915
6916 DEFUN ("window-fringes", Fwindow_fringes, Swindow_fringes,
6917 0, 1, 0,
6918 doc: /* Get width of fringes of window WINDOW.
6919 If WINDOW is omitted or nil, use the currently selected window.
6920 Value is a list of the form (LEFT-WIDTH RIGHT-WIDTH OUTSIDE-MARGINS). */)
6921 (window)
6922 Lisp_Object window;
6923 {
6924 struct window *w = decode_window (window);
6925
6926 return Fcons (make_number (WINDOW_LEFT_FRINGE_WIDTH (w)),
6927 Fcons (make_number (WINDOW_RIGHT_FRINGE_WIDTH (w)),
6928 Fcons ((WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
6929 ? Qt : Qnil), Qnil)));
6930 }
6931
6932
6933 \f
6934 /***********************************************************************
6935 Scroll bars
6936 ***********************************************************************/
6937
6938 DEFUN ("set-window-scroll-bars", Fset_window_scroll_bars, Sset_window_scroll_bars,
6939 2, 4, 0,
6940 doc: /* Set width and type of scroll bars of window WINDOW.
6941 If window is nil, set scroll bars of the currently selected window.
6942 Second parameter WIDTH specifies the pixel width for the scroll bar;
6943 this is automatically adjusted to a multiple of the frame column width.
6944 Third parameter VERTICAL-TYPE specifies the type of the vertical scroll
6945 bar: left, right, or nil.
6946 If WIDTH is nil, use the frame's scroll-bar width.
6947 If VERTICAL-TYPE is t, use the frame's scroll-bar type.
6948 Fourth parameter HORIZONTAL-TYPE is currently unused. */)
6949 (window, width, vertical_type, horizontal_type)
6950 Lisp_Object window, width, vertical_type, horizontal_type;
6951 {
6952 struct window *w = decode_window (window);
6953
6954 if (!NILP (width))
6955 {
6956 CHECK_NATNUM (width);
6957
6958 if (XINT (width) == 0)
6959 vertical_type = Qnil;
6960 }
6961
6962 if (!(NILP (vertical_type)
6963 || EQ (vertical_type, Qleft)
6964 || EQ (vertical_type, Qright)
6965 || EQ (vertical_type, Qt)))
6966 error ("Invalid type of vertical scroll bar");
6967
6968 if (!EQ (w->scroll_bar_width, width)
6969 || !EQ (w->vertical_scroll_bar_type, vertical_type))
6970 {
6971 w->scroll_bar_width = width;
6972 w->vertical_scroll_bar_type = vertical_type;
6973
6974 adjust_window_margins (w);
6975
6976 clear_glyph_matrix (w->current_matrix);
6977 w->window_end_valid = Qnil;
6978
6979 ++windows_or_buffers_changed;
6980 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
6981 }
6982
6983 return Qnil;
6984 }
6985
6986
6987 DEFUN ("window-scroll-bars", Fwindow_scroll_bars, Swindow_scroll_bars,
6988 0, 1, 0,
6989 doc: /* Get width and type of scroll bars of window WINDOW.
6990 If WINDOW is omitted or nil, use the currently selected window.
6991 Value is a list of the form (WIDTH COLS VERTICAL-TYPE HORIZONTAL-TYPE).
6992 If WIDTH is nil or TYPE is t, the window is using the frame's corresponding
6993 value. */)
6994 (window)
6995 Lisp_Object window;
6996 {
6997 struct window *w = decode_window (window);
6998 return Fcons (make_number ((WINDOW_CONFIG_SCROLL_BAR_WIDTH (w)
6999 ? WINDOW_CONFIG_SCROLL_BAR_WIDTH (w)
7000 : WINDOW_SCROLL_BAR_AREA_WIDTH (w))),
7001 Fcons (make_number (WINDOW_SCROLL_BAR_COLS (w)),
7002 Fcons (w->vertical_scroll_bar_type,
7003 Fcons (Qnil, Qnil))));
7004 }
7005
7006
7007 \f
7008 /***********************************************************************
7009 Smooth scrolling
7010 ***********************************************************************/
7011
7012 DEFUN ("window-vscroll", Fwindow_vscroll, Swindow_vscroll, 0, 2, 0,
7013 doc: /* Return the amount by which WINDOW is scrolled vertically.
7014 Use the selected window if WINDOW is nil or omitted.
7015 Normally, value is a multiple of the canonical character height of WINDOW;
7016 optional second arg PIXELS-P means value is measured in pixels. */)
7017 (window, pixels_p)
7018 Lisp_Object window, pixels_p;
7019 {
7020 Lisp_Object result;
7021 struct frame *f;
7022 struct window *w;
7023
7024 if (NILP (window))
7025 window = selected_window;
7026 else
7027 CHECK_WINDOW (window);
7028 w = XWINDOW (window);
7029 f = XFRAME (w->frame);
7030
7031 if (FRAME_WINDOW_P (f))
7032 result = (NILP (pixels_p)
7033 ? FRAME_CANON_Y_FROM_PIXEL_Y (f, -w->vscroll)
7034 : make_number (-w->vscroll));
7035 else
7036 result = make_number (0);
7037 return result;
7038 }
7039
7040
7041 DEFUN ("set-window-vscroll", Fset_window_vscroll, Sset_window_vscroll,
7042 2, 3, 0,
7043 doc: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
7044 WINDOW nil means use the selected window. Normally, VSCROLL is a
7045 non-negative multiple of the canonical character height of WINDOW;
7046 optional third arg PIXELS-P non-nil means that VSCROLL is in pixels.
7047 If PIXELS-P is nil, VSCROLL may have to be rounded so that it
7048 corresponds to an integral number of pixels. The return value is the
7049 result of this rounding.
7050 If PIXELS-P is non-nil, the return value is VSCROLL. */)
7051 (window, vscroll, pixels_p)
7052 Lisp_Object window, vscroll, pixels_p;
7053 {
7054 struct window *w;
7055 struct frame *f;
7056
7057 if (NILP (window))
7058 window = selected_window;
7059 else
7060 CHECK_WINDOW (window);
7061 CHECK_NUMBER_OR_FLOAT (vscroll);
7062
7063 w = XWINDOW (window);
7064 f = XFRAME (w->frame);
7065
7066 if (FRAME_WINDOW_P (f))
7067 {
7068 int old_dy = w->vscroll;
7069
7070 w->vscroll = - (NILP (pixels_p)
7071 ? FRAME_LINE_HEIGHT (f) * XFLOATINT (vscroll)
7072 : XFLOATINT (vscroll));
7073 w->vscroll = min (w->vscroll, 0);
7074
7075 if (w->vscroll != old_dy)
7076 {
7077 /* Adjust glyph matrix of the frame if the virtual display
7078 area becomes larger than before. */
7079 if (w->vscroll < 0 && w->vscroll < old_dy)
7080 adjust_glyphs (f);
7081
7082 /* Prevent redisplay shortcuts. */
7083 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
7084 }
7085 }
7086
7087 return Fwindow_vscroll (window, pixels_p);
7088 }
7089
7090 \f
7091 /* Call FN for all leaf windows on frame F. FN is called with the
7092 first argument being a pointer to the leaf window, and with
7093 additional argument USER_DATA. Stops when FN returns 0. */
7094
7095 void
7096 foreach_window (f, fn, user_data)
7097 struct frame *f;
7098 int (* fn) P_ ((struct window *, void *));
7099 void *user_data;
7100 {
7101 /* Fdelete_frame may set FRAME_ROOT_WINDOW (f) to Qnil. */
7102 if (WINDOWP (FRAME_ROOT_WINDOW (f)))
7103 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f)), fn, user_data);
7104 }
7105
7106
7107 /* Helper function for foreach_window. Call FN for all leaf windows
7108 reachable from W. FN is called with the first argument being a
7109 pointer to the leaf window, and with additional argument USER_DATA.
7110 Stop when FN returns 0. Value is 0 if stopped by FN. */
7111
7112 static int
7113 foreach_window_1 (w, fn, user_data)
7114 struct window *w;
7115 int (* fn) P_ ((struct window *, void *));
7116 void *user_data;
7117 {
7118 int cont;
7119
7120 for (cont = 1; w && cont;)
7121 {
7122 if (!NILP (w->hchild))
7123 cont = foreach_window_1 (XWINDOW (w->hchild), fn, user_data);
7124 else if (!NILP (w->vchild))
7125 cont = foreach_window_1 (XWINDOW (w->vchild), fn, user_data);
7126 else
7127 cont = fn (w, user_data);
7128
7129 w = NILP (w->next) ? 0 : XWINDOW (w->next);
7130 }
7131
7132 return cont;
7133 }
7134
7135
7136 /* Freeze or unfreeze the window start of W unless it is a
7137 mini-window or the selected window. FREEZE_P non-null means freeze
7138 the window start. */
7139
7140 static int
7141 freeze_window_start (w, freeze_p)
7142 struct window *w;
7143 void *freeze_p;
7144 {
7145 if (MINI_WINDOW_P (w)
7146 || (WINDOWP (selected_window) /* Can be nil in corner cases. */
7147 && (w == XWINDOW (selected_window)
7148 || (MINI_WINDOW_P (XWINDOW (selected_window))
7149 && ! NILP (Vminibuf_scroll_window)
7150 && w == XWINDOW (Vminibuf_scroll_window)))))
7151 freeze_p = NULL;
7152
7153 w->frozen_window_start_p = freeze_p != NULL;
7154 return 1;
7155 }
7156
7157
7158 /* Freeze or unfreeze the window starts of all leaf windows on frame
7159 F, except the selected window and a mini-window. FREEZE_P non-zero
7160 means freeze the window start. */
7161
7162 void
7163 freeze_window_starts (f, freeze_p)
7164 struct frame *f;
7165 int freeze_p;
7166 {
7167 foreach_window (f, freeze_window_start, (void *) (freeze_p ? f : 0));
7168 }
7169
7170 \f
7171 /***********************************************************************
7172 Initialization
7173 ***********************************************************************/
7174
7175 /* Return 1 if window configurations C1 and C2
7176 describe the same state of affairs. This is used by Fequal. */
7177
7178 int
7179 compare_window_configurations (c1, c2, ignore_positions)
7180 Lisp_Object c1, c2;
7181 int ignore_positions;
7182 {
7183 register struct save_window_data *d1, *d2;
7184 struct Lisp_Vector *sw1, *sw2;
7185 int i;
7186
7187 CHECK_WINDOW_CONFIGURATION (c1);
7188 CHECK_WINDOW_CONFIGURATION (c2);
7189
7190 d1 = (struct save_window_data *) XVECTOR (c1);
7191 d2 = (struct save_window_data *) XVECTOR (c2);
7192 sw1 = XVECTOR (d1->saved_windows);
7193 sw2 = XVECTOR (d2->saved_windows);
7194
7195 if (d1->frame_cols != d2->frame_cols)
7196 return 0;
7197 if (d1->frame_lines != d2->frame_lines)
7198 return 0;
7199 if (d1->frame_menu_bar_lines != d2->frame_menu_bar_lines)
7200 return 0;
7201 if (! EQ (d1->selected_frame, d2->selected_frame))
7202 return 0;
7203 /* Don't compare the current_window field directly.
7204 Instead see w1_is_current and w2_is_current, below. */
7205 if (! EQ (d1->current_buffer, d2->current_buffer))
7206 return 0;
7207 if (! ignore_positions)
7208 {
7209 if (! EQ (d1->minibuf_scroll_window, d2->minibuf_scroll_window))
7210 return 0;
7211 if (! EQ (d1->minibuf_selected_window, d2->minibuf_selected_window))
7212 return 0;
7213 }
7214 /* Don't compare the root_window field.
7215 We don't require the two configurations
7216 to use the same window object,
7217 and the two root windows must be equivalent
7218 if everything else compares equal. */
7219 if (! EQ (d1->focus_frame, d2->focus_frame))
7220 return 0;
7221 if (d1->min_width != d2->min_width)
7222 return 0;
7223 if (d1->min_height != d2->min_height)
7224 return 0;
7225
7226 /* Verify that the two confis have the same number of windows. */
7227 if (sw1->size != sw2->size)
7228 return 0;
7229
7230 for (i = 0; i < sw1->size; i++)
7231 {
7232 struct saved_window *p1, *p2;
7233 int w1_is_current, w2_is_current;
7234
7235 p1 = SAVED_WINDOW_N (sw1, i);
7236 p2 = SAVED_WINDOW_N (sw2, i);
7237
7238 /* Verify that the current windows in the two
7239 configurations correspond to each other. */
7240 w1_is_current = EQ (d1->current_window, p1->window);
7241 w2_is_current = EQ (d2->current_window, p2->window);
7242
7243 if (w1_is_current != w2_is_current)
7244 return 0;
7245
7246 /* Verify that the corresponding windows do match. */
7247 if (! EQ (p1->buffer, p2->buffer))
7248 return 0;
7249 if (! EQ (p1->left_col, p2->left_col))
7250 return 0;
7251 if (! EQ (p1->top_line, p2->top_line))
7252 return 0;
7253 if (! EQ (p1->total_cols, p2->total_cols))
7254 return 0;
7255 if (! EQ (p1->total_lines, p2->total_lines))
7256 return 0;
7257 if (! EQ (p1->display_table, p2->display_table))
7258 return 0;
7259 if (! EQ (p1->parent, p2->parent))
7260 return 0;
7261 if (! EQ (p1->prev, p2->prev))
7262 return 0;
7263 if (! ignore_positions)
7264 {
7265 if (! EQ (p1->hscroll, p2->hscroll))
7266 return 0;
7267 if (!EQ (p1->min_hscroll, p2->min_hscroll))
7268 return 0;
7269 if (! EQ (p1->start_at_line_beg, p2->start_at_line_beg))
7270 return 0;
7271 if (NILP (Fequal (p1->start, p2->start)))
7272 return 0;
7273 if (NILP (Fequal (p1->pointm, p2->pointm)))
7274 return 0;
7275 if (NILP (Fequal (p1->mark, p2->mark)))
7276 return 0;
7277 }
7278 if (! EQ (p1->left_margin_cols, p2->left_margin_cols))
7279 return 0;
7280 if (! EQ (p1->right_margin_cols, p2->right_margin_cols))
7281 return 0;
7282 if (! EQ (p1->left_fringe_width, p2->left_fringe_width))
7283 return 0;
7284 if (! EQ (p1->right_fringe_width, p2->right_fringe_width))
7285 return 0;
7286 if (! EQ (p1->fringes_outside_margins, p2->fringes_outside_margins))
7287 return 0;
7288 if (! EQ (p1->scroll_bar_width, p2->scroll_bar_width))
7289 return 0;
7290 if (! EQ (p1->vertical_scroll_bar_type, p2->vertical_scroll_bar_type))
7291 return 0;
7292 }
7293
7294 return 1;
7295 }
7296
7297 DEFUN ("compare-window-configurations", Fcompare_window_configurations,
7298 Scompare_window_configurations, 2, 2, 0,
7299 doc: /* Compare two window configurations as regards the structure of windows.
7300 This function ignores details such as the values of point and mark
7301 and scrolling positions. */)
7302 (x, y)
7303 Lisp_Object x, y;
7304 {
7305 if (compare_window_configurations (x, y, 1))
7306 return Qt;
7307 return Qnil;
7308 }
7309 \f
7310 void
7311 init_window_once ()
7312 {
7313 struct frame *f = make_initial_frame ();
7314 XSETFRAME (selected_frame, f);
7315 Vterminal_frame = selected_frame;
7316 minibuf_window = f->minibuffer_window;
7317 selected_window = f->selected_window;
7318 last_nonminibuf_frame = f;
7319
7320 window_initialized = 1;
7321 }
7322
7323 void
7324 init_window ()
7325 {
7326 Vwindow_list = Qnil;
7327 }
7328
7329 void
7330 syms_of_window ()
7331 {
7332 Qscroll_up = intern ("scroll-up");
7333 staticpro (&Qscroll_up);
7334
7335 Qscroll_down = intern ("scroll-down");
7336 staticpro (&Qscroll_down);
7337
7338 Qwindow_size_fixed = intern ("window-size-fixed");
7339 staticpro (&Qwindow_size_fixed);
7340 Fset (Qwindow_size_fixed, Qnil);
7341
7342 staticpro (&Qwindow_configuration_change_hook);
7343 Qwindow_configuration_change_hook
7344 = intern ("window-configuration-change-hook");
7345
7346 Qwindowp = intern ("windowp");
7347 staticpro (&Qwindowp);
7348
7349 Qwindow_configuration_p = intern ("window-configuration-p");
7350 staticpro (&Qwindow_configuration_p);
7351
7352 Qwindow_live_p = intern ("window-live-p");
7353 staticpro (&Qwindow_live_p);
7354
7355 Qtemp_buffer_show_hook = intern ("temp-buffer-show-hook");
7356 staticpro (&Qtemp_buffer_show_hook);
7357
7358 staticpro (&Vwindow_list);
7359
7360 minibuf_selected_window = Qnil;
7361 staticpro (&minibuf_selected_window);
7362
7363 window_scroll_pixel_based_preserve_y = -1;
7364
7365 DEFVAR_LISP ("temp-buffer-show-function", &Vtemp_buffer_show_function,
7366 doc: /* Non-nil means call as function to display a help buffer.
7367 The function is called with one argument, the buffer to be displayed.
7368 Used by `with-output-to-temp-buffer'.
7369 If this function is used, then it must do the entire job of showing
7370 the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
7371 Vtemp_buffer_show_function = Qnil;
7372
7373 DEFVAR_LISP ("display-buffer-function", &Vdisplay_buffer_function,
7374 doc: /* If non-nil, function to call to handle `display-buffer'.
7375 It will receive two args, the buffer and a flag which if non-nil means
7376 that the currently selected window is not acceptable.
7377 It should choose or create a window, display the specified buffer in it,
7378 and return the window.
7379 Commands such as `switch-to-buffer-other-window' and `find-file-other-window'
7380 work using this function. */);
7381 Vdisplay_buffer_function = Qnil;
7382
7383 DEFVAR_LISP ("even-window-heights", &Veven_window_heights,
7384 doc: /* *If non-nil, `display-buffer' should even the window heights.
7385 If nil, `display-buffer' will leave the window configuration alone. */);
7386 Veven_window_heights = Qt;
7387
7388 DEFVAR_LISP ("minibuffer-scroll-window", &Vminibuf_scroll_window,
7389 doc: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
7390 Vminibuf_scroll_window = Qnil;
7391
7392 DEFVAR_BOOL ("mode-line-in-non-selected-windows", &mode_line_in_non_selected_windows,
7393 doc: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
7394 If the minibuffer is active, the `minibuffer-scroll-window' mode line
7395 is displayed in the `mode-line' face. */);
7396 mode_line_in_non_selected_windows = 1;
7397
7398 DEFVAR_LISP ("other-window-scroll-buffer", &Vother_window_scroll_buffer,
7399 doc: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
7400 Vother_window_scroll_buffer = Qnil;
7401
7402 DEFVAR_BOOL ("pop-up-frames", &pop_up_frames,
7403 doc: /* *Non-nil means `display-buffer' should make a separate frame. */);
7404 pop_up_frames = 0;
7405
7406 DEFVAR_BOOL ("auto-window-vscroll", &auto_window_vscroll_p,
7407 doc: /* *Non-nil means to automatically adjust `window-vscroll' to view tall lines. */);
7408 auto_window_vscroll_p = 1;
7409
7410 DEFVAR_BOOL ("display-buffer-reuse-frames", &display_buffer_reuse_frames,
7411 doc: /* *Non-nil means `display-buffer' should reuse frames.
7412 If the buffer in question is already displayed in a frame, raise that frame. */);
7413 display_buffer_reuse_frames = 0;
7414
7415 DEFVAR_LISP ("pop-up-frame-function", &Vpop_up_frame_function,
7416 doc: /* Function to call to handle automatic new frame creation.
7417 It is called with no arguments and should return a newly created frame.
7418
7419 A typical value might be `(lambda () (new-frame pop-up-frame-alist))'
7420 where `pop-up-frame-alist' would hold the default frame parameters. */);
7421 Vpop_up_frame_function = Qnil;
7422
7423 DEFVAR_LISP ("special-display-buffer-names", &Vspecial_display_buffer_names,
7424 doc: /* *List of buffer names that should have their own special frames.
7425 Displaying a buffer with `display-buffer' or `pop-to-buffer',
7426 if its name is in this list, makes a special frame for it
7427 using `special-display-function'. See also `special-display-regexps'.
7428
7429 An element of the list can be a list instead of just a string.
7430 There are two ways to use a list as an element:
7431 (BUFFER FRAME-PARAMETERS...) (BUFFER FUNCTION OTHER-ARGS...)
7432 In the first case, the FRAME-PARAMETERS are pairs of the form
7433 \(PARAMETER . VALUE); these parameter values are used to create the frame.
7434 In the second case, FUNCTION is called with BUFFER as the first argument,
7435 followed by the OTHER-ARGS--it can display BUFFER in any way it likes.
7436 All this is done by the function found in `special-display-function'.
7437
7438 If the specified frame parameters include (same-buffer . t), the
7439 buffer is displayed in the currently selected window. Otherwise, if
7440 they include (same-frame . t), the buffer is displayed in a new window
7441 in the currently selected frame.
7442
7443 If this variable appears \"not to work\", because you add a name to it
7444 but that buffer still appears in the selected window, look at the
7445 values of `same-window-buffer-names' and `same-window-regexps'.
7446 Those variables take precedence over this one. */);
7447 Vspecial_display_buffer_names = Qnil;
7448
7449 DEFVAR_LISP ("special-display-regexps", &Vspecial_display_regexps,
7450 doc: /* *List of regexps saying which buffers should have their own special frames.
7451 When displaying a buffer with `display-buffer' or `pop-to-buffer',
7452 if any regexp in this list matches the buffer name, it makes a
7453 special frame for the buffer by calling `special-display-function'.
7454
7455 An element of the list can be a list instead of just a string.
7456 There are two ways to use a list as an element:
7457 (REGEXP FRAME-PARAMETERS...) (REGEXP FUNCTION OTHER-ARGS...)
7458 In the first case, the FRAME-PARAMETERS are pairs of the form
7459 \(PARAMETER . VALUE); these parameter values are used to create the frame.
7460 In the second case, FUNCTION is called with BUFFER as the first argument,
7461 followed by the OTHER-ARGS--it can display the buffer in any way it likes.
7462 All this is done by the function found in `special-display-function'.
7463
7464 If the specified frame parameters include (same-buffer . t), the
7465 buffer is displayed in the currently selected window. Otherwise, if
7466 they include (same-frame . t), the buffer is displayed in a new window
7467 in the currently selected frame.
7468
7469 If this variable appears \"not to work\", because you add a regexp to it
7470 but the matching buffers still appear in the selected window, look at the
7471 values of `same-window-buffer-names' and `same-window-regexps'.
7472 Those variables take precedence over this one. */);
7473 Vspecial_display_regexps = Qnil;
7474
7475 DEFVAR_LISP ("special-display-function", &Vspecial_display_function,
7476 doc: /* Function to call to make a new frame for a special buffer.
7477 It is called with two arguments, the buffer and optional buffer specific
7478 data, and should return a window displaying that buffer.
7479 The default value normally makes a separate frame for the buffer,
7480 using `special-display-frame-alist' to specify the frame parameters.
7481 But if the buffer specific data includes (same-buffer . t) then the
7482 buffer is displayed in the current selected window.
7483 Otherwise if it includes (same-frame . t) then the buffer is displayed in
7484 a new window in the currently selected frame.
7485
7486 A buffer is special if it is listed in `special-display-buffer-names'
7487 or matches a regexp in `special-display-regexps'. */);
7488 Vspecial_display_function = Qnil;
7489
7490 DEFVAR_LISP ("same-window-buffer-names", &Vsame_window_buffer_names,
7491 doc: /* *List of buffer names that should appear in the selected window.
7492 Displaying one of these buffers using `display-buffer' or `pop-to-buffer'
7493 switches to it in the selected window, rather than making it appear
7494 in some other window.
7495
7496 An element of the list can be a cons cell instead of just a string.
7497 Then the car must be a string, which specifies the buffer name.
7498 This is for compatibility with `special-display-buffer-names';
7499 the cdr of the cons cell is ignored.
7500
7501 See also `same-window-regexps'. */);
7502 Vsame_window_buffer_names = Qnil;
7503
7504 DEFVAR_LISP ("same-window-regexps", &Vsame_window_regexps,
7505 doc: /* *List of regexps saying which buffers should appear in the selected window.
7506 If a buffer name matches one of these regexps, then displaying it
7507 using `display-buffer' or `pop-to-buffer' switches to it
7508 in the selected window, rather than making it appear in some other window.
7509
7510 An element of the list can be a cons cell instead of just a string.
7511 Then the car must be a string, which specifies the buffer name.
7512 This is for compatibility with `special-display-buffer-names';
7513 the cdr of the cons cell is ignored.
7514
7515 See also `same-window-buffer-names'. */);
7516 Vsame_window_regexps = Qnil;
7517
7518 DEFVAR_BOOL ("pop-up-windows", &pop_up_windows,
7519 doc: /* *Non-nil means display-buffer should make new windows. */);
7520 pop_up_windows = 1;
7521
7522 DEFVAR_INT ("next-screen-context-lines", &next_screen_context_lines,
7523 doc: /* *Number of lines of continuity when scrolling by screenfuls. */);
7524 next_screen_context_lines = 2;
7525
7526 DEFVAR_INT ("split-height-threshold", &split_height_threshold,
7527 doc: /* *A window must be at least this tall to be eligible for splitting
7528 by `display-buffer'. The value is in line units.
7529 If there is only one window, it is split regardless of this value. */);
7530 split_height_threshold = 500;
7531
7532 DEFVAR_LISP ("split-window-preferred-function",
7533 &Vsplit_window_preferred_function,
7534 doc: /* Function to use to split a window.
7535 This is used by `display-buffer' to allow the user to choose whether
7536 to split windows horizontally or vertically or some mix of the two.
7537 It is called with a window as single argument and should split it in two
7538 and return the new window. */);
7539 Vsplit_window_preferred_function = intern ("split-window");
7540
7541 DEFVAR_INT ("window-min-height", &window_min_height,
7542 doc: /* *Delete any window less than this tall (including its mode line).
7543 The value is in line units. */);
7544 window_min_height = 4;
7545
7546 DEFVAR_INT ("window-min-width", &window_min_width,
7547 doc: /* *Delete any window less than this wide (measured in characters). */);
7548 window_min_width = 10;
7549
7550 DEFVAR_LISP ("scroll-preserve-screen-position",
7551 &Vscroll_preserve_screen_position,
7552 doc: /* *Controls if scroll commands move point to keep its screen line unchanged.
7553 A value of nil means point does not keep its screen position except
7554 at the scroll margin or window boundary respectively.
7555 A value of t means point keeps its screen position if the scroll
7556 command moved it vertically out of the window, e.g. when scrolling
7557 by full screens.
7558 Any other value means point always keeps its screen position. */);
7559 Vscroll_preserve_screen_position = Qnil;
7560
7561 DEFVAR_LISP ("window-configuration-change-hook",
7562 &Vwindow_configuration_change_hook,
7563 doc: /* Functions to call when window configuration changes.
7564 The selected frame is the one whose configuration has changed. */);
7565 Vwindow_configuration_change_hook = Qnil;
7566
7567 defsubr (&Sselected_window);
7568 defsubr (&Sminibuffer_window);
7569 defsubr (&Swindow_minibuffer_p);
7570 defsubr (&Swindowp);
7571 defsubr (&Swindow_live_p);
7572 defsubr (&Spos_visible_in_window_p);
7573 defsubr (&Swindow_line_height);
7574 defsubr (&Swindow_buffer);
7575 defsubr (&Swindow_height);
7576 defsubr (&Swindow_width);
7577 defsubr (&Swindow_full_width_p);
7578 defsubr (&Swindow_hscroll);
7579 defsubr (&Sset_window_hscroll);
7580 defsubr (&Swindow_redisplay_end_trigger);
7581 defsubr (&Sset_window_redisplay_end_trigger);
7582 defsubr (&Swindow_edges);
7583 defsubr (&Swindow_pixel_edges);
7584 defsubr (&Swindow_inside_edges);
7585 defsubr (&Swindow_inside_pixel_edges);
7586 defsubr (&Scoordinates_in_window_p);
7587 defsubr (&Swindow_at);
7588 defsubr (&Swindow_point);
7589 defsubr (&Swindow_start);
7590 defsubr (&Swindow_end);
7591 defsubr (&Sset_window_point);
7592 defsubr (&Sset_window_start);
7593 defsubr (&Swindow_dedicated_p);
7594 defsubr (&Sset_window_dedicated_p);
7595 defsubr (&Swindow_display_table);
7596 defsubr (&Sset_window_display_table);
7597 defsubr (&Snext_window);
7598 defsubr (&Sprevious_window);
7599 defsubr (&Sother_window);
7600 defsubr (&Sget_lru_window);
7601 defsubr (&Sget_largest_window);
7602 defsubr (&Sget_buffer_window);
7603 defsubr (&Sdelete_other_windows);
7604 defsubr (&Sdelete_windows_on);
7605 defsubr (&Sreplace_buffer_in_windows);
7606 defsubr (&Sdelete_window);
7607 defsubr (&Sset_window_buffer);
7608 defsubr (&Sselect_window);
7609 defsubr (&Sspecial_display_p);
7610 defsubr (&Ssame_window_p);
7611 defsubr (&Sdisplay_buffer);
7612 defsubr (&Sforce_window_update);
7613 defsubr (&Ssplit_window);
7614 defsubr (&Senlarge_window);
7615 defsubr (&Sshrink_window);
7616 defsubr (&Sadjust_window_trailing_edge);
7617 defsubr (&Sscroll_up);
7618 defsubr (&Sscroll_down);
7619 defsubr (&Sscroll_left);
7620 defsubr (&Sscroll_right);
7621 defsubr (&Sother_window_for_scrolling);
7622 defsubr (&Sscroll_other_window);
7623 defsubr (&Sminibuffer_selected_window);
7624 defsubr (&Srecenter);
7625 defsubr (&Swindow_text_height);
7626 defsubr (&Smove_to_window_line);
7627 defsubr (&Swindow_configuration_p);
7628 defsubr (&Swindow_configuration_frame);
7629 defsubr (&Sset_window_configuration);
7630 defsubr (&Scurrent_window_configuration);
7631 defsubr (&Ssave_window_excursion);
7632 defsubr (&Swindow_tree);
7633 defsubr (&Sset_window_margins);
7634 defsubr (&Swindow_margins);
7635 defsubr (&Sset_window_fringes);
7636 defsubr (&Swindow_fringes);
7637 defsubr (&Sset_window_scroll_bars);
7638 defsubr (&Swindow_scroll_bars);
7639 defsubr (&Swindow_vscroll);
7640 defsubr (&Sset_window_vscroll);
7641 defsubr (&Scompare_window_configurations);
7642 defsubr (&Swindow_list);
7643 }
7644
7645 void
7646 keys_of_window ()
7647 {
7648 initial_define_key (control_x_map, '1', "delete-other-windows");
7649 initial_define_key (control_x_map, '2', "split-window");
7650 initial_define_key (control_x_map, '0', "delete-window");
7651 initial_define_key (control_x_map, 'o', "other-window");
7652 initial_define_key (control_x_map, '^', "enlarge-window");
7653 initial_define_key (control_x_map, '<', "scroll-left");
7654 initial_define_key (control_x_map, '>', "scroll-right");
7655
7656 initial_define_key (global_map, Ctl ('V'), "scroll-up");
7657 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
7658 initial_define_key (meta_map, 'v', "scroll-down");
7659
7660 initial_define_key (global_map, Ctl('L'), "recenter");
7661 initial_define_key (meta_map, 'r', "move-to-window-line");
7662 }
7663
7664 /* arch-tag: 90a9c576-0590-48f1-a5f1-6c96a0452d9f
7665 (do not change this comment) */