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