* net/tramp-sh.el (tramp-remote-path): Set tramp-autoload cookie.
[bpt/emacs.git] / src / window.c
CommitLineData
7ab12479
JB
1/* Window creation, deletion and examination for GNU Emacs.
2 Does not include redisplay.
acaf905b 3 Copyright (C) 1985-1987, 1993-1998, 2000-2012
8cabe764 4 Free Software Foundation, Inc.
7ab12479
JB
5
6This file is part of GNU Emacs.
7
9ec0b715 8GNU Emacs is free software: you can redistribute it and/or modify
7ab12479 9it under the terms of the GNU General Public License as published by
9ec0b715
GM
10the Free Software Foundation, either version 3 of the License, or
11(at your option) any later version.
7ab12479
JB
12
13GNU Emacs is distributed in the hope that it will be useful,
14but WITHOUT ANY WARRANTY; without even the implied warranty of
15MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16GNU General Public License for more details.
17
18You should have received a copy of the GNU General Public License
9ec0b715 19along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
7ab12479 20
18160b98 21#include <config.h>
4d553a13 22#include <stdio.h>
d7306fe6 23#include <setjmp.h>
4d553a13 24
7ab12479
JB
25#include "lisp.h"
26#include "buffer.h"
3e4731a3 27#include "keyboard.h"
e35f6ff7 28#include "keymap.h"
44fa5b1e 29#include "frame.h"
7ab12479
JB
30#include "window.h"
31#include "commands.h"
32#include "indent.h"
33#include "termchar.h"
34#include "disptab.h"
dfcf069d 35#include "dispextern.h"
5500c422
GM
36#include "blockinput.h"
37#include "intervals.h"
de509a60 38#include "termhooks.h" /* For FRAME_TERMINAL. */
5500c422 39
6d55d620 40#ifdef HAVE_X_WINDOWS
dfcf069d 41#include "xterm.h"
5500c422 42#endif /* HAVE_X_WINDOWS */
8f23f280
AI
43#ifdef WINDOWSNT
44#include "w32term.h"
45#endif
1e3c8885
EZ
46#ifdef MSDOS
47#include "msdos.h"
48#endif
edfda783
AR
49#ifdef HAVE_NS
50#include "nsterm.h"
51#endif
5500c422 52
9397e56f 53Lisp_Object Qwindowp, Qwindow_live_p;
b9e809c2 54static Lisp_Object Qwindow_configuration_p, Qrecord_window_buffer;
9397e56f 55static Lisp_Object Qwindow_deletable_p, Qdelete_window, Qdisplay_buffer;
b9e809c2 56static Lisp_Object Qreplace_buffer_in_windows, Qget_mru_window;
5386012d 57static Lisp_Object Qwindow_resize_root_window, Qwindow_resize_root_window_vertically;
955cbe7b 58static Lisp_Object Qscroll_up, Qscroll_down, Qscroll_command;
b9e809c2
MR
59static Lisp_Object Qsafe, Qabove, Qbelow;
60static Lisp_Object Qauto_buffer_name;
61
f57e2426
J
62static int displayed_window_lines (struct window *);
63static struct window *decode_window (Lisp_Object);
64static int count_windows (struct window *);
65static int get_leaf_windows (struct window *, struct window **, int);
66static void window_scroll (Lisp_Object, int, int, int);
67static void window_scroll_pixel_based (Lisp_Object, int, int, int);
68static void window_scroll_line_based (Lisp_Object, int, int, int);
f57e2426 69static int freeze_window_start (struct window *, void *);
f57e2426
J
70static Lisp_Object window_list (void);
71static int add_window_to_list (struct window *, void *);
72static int candidate_window_p (Lisp_Object, Lisp_Object, Lisp_Object,
73 Lisp_Object);
74static Lisp_Object next_window (Lisp_Object, Lisp_Object,
75 Lisp_Object, int);
76static void decode_next_window_args (Lisp_Object *, Lisp_Object *,
77 Lisp_Object *);
2f7c71a1 78static void foreach_window (struct frame *,
f95464e4 79 int (* fn) (struct window *, void *),
2f7c71a1 80 void *);
f57e2426
J
81static int foreach_window_1 (struct window *,
82 int (* fn) (struct window *, void *),
83 void *);
84static Lisp_Object window_list_1 (Lisp_Object, Lisp_Object, Lisp_Object);
d615d6d2
MR
85static int window_resize_check (struct window *, int);
86static void window_resize_apply (struct window *, int);
7c82f3e2 87static Lisp_Object select_window (Lisp_Object, Lisp_Object, int);
b7354ddf 88
7ab12479
JB
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
44fa5b1e 95 FRAME_SELECTED_WINDOW (selected_frame). */
7ab12479
JB
96Lisp_Object selected_window;
97
67492200
GM
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. */
67492200
GM
101Lisp_Object Vwindow_list;
102
5500c422
GM
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
7ab12479
JB
106 the selected window. */
107Lisp_Object minibuf_window;
108
3f49fddc
KS
109/* Non-nil means it is the window whose mode line should be
110 shown as the selected window when the minibuffer is selected. */
3dbab091 111Lisp_Object minibuf_selected_window;
3f49fddc 112
a58ec57d 113/* Hook run at end of temp_output_buffer_show. */
955cbe7b 114static Lisp_Object Qtemp_buffer_show_hook;
a58ec57d 115
7ab12479
JB
116/* Incremented for each window created. */
117static int sequence_number;
118
5b03d3c0
RS
119/* Nonzero after init_window_once has finished. */
120static int window_initialized;
121
543f5fb1 122/* Hook to run when window config changes. */
eeca6f6f 123static Lisp_Object Qwindow_configuration_change_hook;
0d384044 124
66d43aea 125/* Used by the function window_scroll_pixel_based */
c876b227 126static int window_scroll_pixel_based_preserve_x;
66fe93d1 127static int window_scroll_pixel_based_preserve_y;
66d43aea 128
c876b227 129/* Same for window_scroll_line_based. */
c876b227
SM
130static int window_scroll_preserve_hpos;
131static int window_scroll_preserve_vpos;
f230ecc9
MR
132\f
133static struct window *
134decode_window (register Lisp_Object window)
135{
136 if (NILP (window))
137 return XWINDOW (selected_window);
c876b227 138
f230ecc9
MR
139 CHECK_LIVE_WINDOW (window);
140 return XWINDOW (window);
141}
142
143static struct window *
144decode_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}
666e158e 152
7ab12479 153DEFUN ("windowp", Fwindowp, Swindowp, 1, 1, 0,
f230ecc9 154 doc: /* Return t if OBJECT is a window and nil otherwise. */)
5842a27b 155 (Lisp_Object object)
7ab12479 156{
413430c5 157 return WINDOWP (object) ? Qt : Qnil;
7ab12479
JB
158}
159
806b4d9b 160DEFUN ("window-live-p", Fwindow_live_p, Swindow_live_p, 1, 1, 0,
f230ecc9 161 doc: /* Return t if OBJECT is a live window and nil otherwise.
49745b39
CY
162A live window is a window that displays a buffer.
163Internal windows and deleted windows are not live. */)
5842a27b 164 (Lisp_Object object)
605be8af 165{
9e571f49 166 return WINDOW_LIVE_P (object) ? Qt : Qnil;
605be8af 167}
727e958e
MR
168\f
169/* Frames and windows. */
170DEFUN ("window-frame", Fwindow_frame, Swindow_frame, 1, 1, 0,
171 doc: /* Return the frame that window WINDOW is on.
49745b39 172If WINDOW is omitted or nil, it defaults to the selected window. */)
727e958e
MR
173 (Lisp_Object window)
174{
175 return decode_any_window (window)->frame;
176}
177
178DEFUN ("frame-root-window", Fframe_root_window, Sframe_root_window, 0, 1, 0,
87e68db4
JB
179 doc: /* Return the root window of FRAME-OR-WINDOW.
180If omitted, FRAME-OR-WINDOW defaults to the currently selected frame.
49745b39
CY
181With a frame argument, return that frame's root window.
182With a window argument, return the root window of that window's frame. */)
727e958e
MR
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
200DEFUN ("minibuffer-window", Fminibuffer_window, Sminibuffer_window, 0, 1, 0,
49745b39
CY
201 doc: /* Return the minibuffer window for frame FRAME.
202If FRAME is omitted or nil, it defaults to the selected frame. */)
727e958e
MR
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
211DEFUN ("window-minibuffer-p", Fwindow_minibuffer_p,
212 Swindow_minibuffer_p, 0, 1, 0,
213 doc: /* Return non-nil if WINDOW is a minibuffer window.
49745b39 214If WINDOW is omitted or nil, it defaults to the selected window. */)
727e958e
MR
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. */
221DEFUN ("frame-first-window", Fframe_first_window, Sframe_first_window, 0, 1, 0,
87e68db4
JB
222 doc: /* Return the topmost, leftmost live window on FRAME-OR-WINDOW.
223If omitted, FRAME-OR-WINDOW defaults to the currently selected frame.
224Else if FRAME-OR-WINDOW denotes any window, return the first window of
225that window's frame. If FRAME-OR-WINDOW denotes a live frame, return
727e958e
MR
226the 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
254DEFUN ("frame-selected-window", Fframe_selected_window,
255 Sframe_selected_window, 0, 1, 0,
87e68db4
JB
256 doc: /* Return the selected window of FRAME-OR-WINDOW.
257If omitted, FRAME-OR-WINDOW defaults to the currently selected frame.
258Else if FRAME-OR-WINDOW denotes any window, return the selected window
259of that window's frame. If FRAME-OR-WINDOW denotes a live frame, return
727e958e
MR
260the 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
278DEFUN ("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.
281FRAME must be a live frame and defaults to the selected one. If FRAME
282is the selected frame, this makes WINDOW the selected window. Optional
283argument NORECORD non-nil means to neither change the order of recently
284selected windows nor the buffer list. WINDOW must denote a live window.
285Return 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
303DEFUN ("selected-window", Fselected_window, Sselected_window, 0, 0, 0,
304 doc: /* Return the selected window.
305The selected window is the window in which the standard cursor for
306selected windows appears and to which many commands apply. */)
307 (void)
308{
309 return selected_window;
310}
311
9397e56f
MR
312int window_select_count;
313
727e958e
MR
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. */
319static Lisp_Object
320select_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
394DEFUN ("select-window", Fselect_window, Sselect_window, 1, 2, 0,
395 doc: /* Select WINDOW. Most editing will apply to WINDOW's buffer.
396Also make WINDOW's buffer current and make WINDOW the frame's selected
397window. Return WINDOW.
398
399Optional second arg NORECORD non-nil means do not put this buffer at the
400front of the buffer list and do not make this window the most recently
401selected one.
605be8af 402
727e958e
MR
403Note that the main editor command loop sets the current buffer to the
404buffer 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
bf60a96b 410DEFUN ("window-buffer", Fwindow_buffer, Swindow_buffer, 0, 1, 0,
49745b39
CY
411 doc: /* Return the buffer displayed in window WINDOW.
412If WINDOW is omitted or nil, it defaults to the selected window.
413Return nil for an internal window or a deleted window. */)
bf60a96b
MR
414 (Lisp_Object window)
415{
416 return decode_any_window (window)->buffer;
417}
418
419DEFUN ("window-parent", Fwindow_parent, Swindow_parent, 0, 1, 0,
49745b39
CY
420 doc: /* Return the parent window of window WINDOW.
421If WINDOW is omitted or nil, it defaults to the selected window.
422Return nil for a window with no parent (e.g. a root window). */)
bf60a96b
MR
423 (Lisp_Object window)
424{
425 return decode_any_window (window)->parent;
426}
427
49745b39
CY
428DEFUN ("window-top-child", Fwindow_top_child, Swindow_top_child, 1, 1, 0,
429 doc: /* Return the topmost child window of window WINDOW.
430Return nil if WINDOW is a live window (live windows have no children).
431Return nil if WINDOW is an internal window whose children form a
432horizontal combination. */)
bf60a96b
MR
433 (Lisp_Object window)
434{
49745b39 435 CHECK_WINDOW (window);
bf60a96b
MR
436 return decode_any_window (window)->vchild;
437}
438
49745b39
CY
439DEFUN ("window-left-child", Fwindow_left_child, Swindow_left_child, 1, 1, 0,
440 doc: /* Return the leftmost child window of window WINDOW.
441Return nil if WINDOW is a live window (live windows have no children).
442Return nil if WINDOW is an internal window whose children form a
443vertical combination. */)
bf60a96b
MR
444 (Lisp_Object window)
445{
49745b39 446 CHECK_WINDOW (window);
bf60a96b
MR
447 return decode_any_window (window)->hchild;
448}
449
d68443dc 450DEFUN ("window-next-sibling", Fwindow_next_sibling, Swindow_next_sibling, 0, 1, 0,
49745b39
CY
451 doc: /* Return the next sibling window of window WINDOW.
452If WINDOW is omitted or nil, it defaults to the selected window.
d68443dc 453Return nil if WINDOW has no next sibling. */)
bf60a96b
MR
454 (Lisp_Object window)
455{
456 return decode_any_window (window)->next;
457}
458
d68443dc 459DEFUN ("window-prev-sibling", Fwindow_prev_sibling, Swindow_prev_sibling, 0, 1, 0,
49745b39
CY
460 doc: /* Return the previous sibling window of window WINDOW.
461If WINDOW is omitted or nil, it defaults to the selected window.
d68443dc 462Return nil if WINDOW has no previous sibling. */)
bf60a96b
MR
463 (Lisp_Object window)
464{
465 return decode_any_window (window)->prev;
466}
67492200 467
df05a53c 468DEFUN ("window-combination-limit", Fwindow_combination_limit, Swindow_combination_limit, 1, 1, 0,
b6f67890 469 doc: /* Return combination limit of window WINDOW.
be7f5545 470If the return value is nil, child windows of WINDOW can be recombined with
b6f67890 471WINDOW's siblings. A return value of t means that child windows of
496e208e
MR
472WINDOW are never \(re-)combined with WINDOW's siblings. */)
473 (Lisp_Object window)
474{
b6f67890 475 return decode_any_window (window)->combination_limit;
496e208e 476}
b3a10345 477
b6f67890 478DEFUN ("set-window-combination-limit", Fset_window_combination_limit, Sset_window_combination_limit, 2, 2, 0,
d2999b1a
MR
479 doc: /* Set combination limit of window WINDOW to LIMIT; return LIMIT.
480If LIMIT is nil, child windows of WINDOW can be recombined with
481WINDOW's siblings. LIMIT t means that child windows of WINDOW are
b6f67890
MR
482never \(re-)combined with WINDOW's siblings. Other values are reserved
483for future use. */)
d2999b1a 484 (Lisp_Object window, Lisp_Object limit)
496e208e
MR
485{
486 register struct window *w = decode_any_window (window);
536833ab 487
d2999b1a 488 w->combination_limit = limit;
b3a10345 489
b6f67890 490 return w->combination_limit;
496e208e 491}
b3a10345 492
496e208e 493DEFUN ("window-use-time", Fwindow_use_time, Swindow_use_time, 0, 1, 0,
49745b39
CY
494 doc: /* Return the use time of window WINDOW.
495If WINDOW is omitted or nil, it defaults to the selected window.
496The window with the highest use time is the most recently selected
497one. The window with the lowest use time is the least recently
498selected one. */)
496e208e
MR
499 (Lisp_Object window)
500{
501 return decode_window (window)->use_time;
b3a10345 502}
abde8f8c 503\f
105216ed
CY
504DEFUN ("window-total-height", Fwindow_total_height, Swindow_total_height, 0, 1, 0,
505 doc: /* Return the total height, in lines, of window WINDOW.
49745b39
CY
506If WINDOW is omitted or nil, it defaults to the selected window.
507
105216ed
CY
508The return value includes the mode line and header line, if any.
509If WINDOW is an internal window, the total height is the height
510of the screen areas spanned by its children.
511
512On a graphical display, this total height is reported as an
513integer multiple of the default character height. */)
514 (Lisp_Object window)
abde8f8c 515{
105216ed
CY
516 return decode_any_window (window)->total_lines;
517}
518
519DEFUN ("window-total-width", Fwindow_total_width, Swindow_total_width, 0, 1, 0,
520 doc: /* Return the total width, in columns, of window WINDOW.
521If WINDOW is omitted or nil, it defaults to the selected window.
522
523The return value includes any vertical dividers or scroll bars
524belonging to WINDOW. If WINDOW is an internal window, the total width
525is the width of the screen areas spanned by its children.
526
527On a graphical display, this total width is reported as an
528integer multiple of the default character width. */)
529 (Lisp_Object window)
530{
531 return decode_any_window (window)->total_cols;
abde8f8c 532}
b3a10345 533
496e208e 534DEFUN ("window-new-total", Fwindow_new_total, Swindow_new_total, 0, 1, 0,
49745b39
CY
535 doc: /* Return the new total size of window WINDOW.
536If WINDOW is omitted or nil, it defaults to the selected window. */)
496e208e
MR
537 (Lisp_Object window)
538{
539 return decode_any_window (window)->new_total;
540}
541
542DEFUN ("window-normal-size", Fwindow_normal_size, Swindow_normal_size, 0, 2, 0,
49745b39
CY
543 doc: /* Return the normal height of window WINDOW.
544If WINDOW is omitted or nil, it defaults to the selected window.
545If HORIZONTAL is non-nil, return the normal width of WINDOW. */)
496e208e
MR
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
554DEFUN ("window-new-normal", Fwindow_new_normal, Swindow_new_normal, 0, 1, 0,
49745b39
CY
555 doc: /* Return new normal size of window WINDOW.
556If WINDOW is omitted or nil, it defaults to the selected window. */)
496e208e
MR
557 (Lisp_Object window)
558{
559 return decode_any_window (window)->new_normal;
560}
561
abde8f8c 562DEFUN ("window-left-column", Fwindow_left_column, Swindow_left_column, 0, 1, 0,
49745b39 563 doc: /* Return left column of window WINDOW.
105216ed
CY
564This is the distance, in columns, between the left edge of WINDOW and
565the left edge of the frame's window area. For instance, the return
566value is 0 if there is no window to the left of WINDOW.
567
49745b39 568If WINDOW is omitted or nil, it defaults to the selected window. */)
abde8f8c
MR
569 (Lisp_Object window)
570{
571 return decode_any_window (window)->left_col;
572}
573
574DEFUN ("window-top-line", Fwindow_top_line, Swindow_top_line, 0, 1, 0,
49745b39 575 doc: /* Return top line of window WINDOW.
105216ed
CY
576This is the distance, in lines, between the top of WINDOW and the top
577of the frame's window area. For instance, the return value is 0 if
578there is no window above WINDOW.
579
49745b39 580If WINDOW is omitted or nil, it defaults to the selected window. */)
abde8f8c
MR
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
46a4ce9e 589static int
abde8f8c
MR
590window_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
610int
611window_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
105216ed
CY
635DEFUN ("window-body-height", Fwindow_body_height, Swindow_body_height, 0, 1, 0,
636 doc: /* Return the height, in lines, of WINDOW's text area.
637If WINDOW is omitted or nil, it defaults to the selected window.
638Signal an error if the window is not live.
89bd5ee1 639
105216ed
CY
640The returned height does not include the mode line or header line.
641On a graphical display, the height is expressed as an integer multiple
642of the default character height. If a line at the bottom of the text
643area is only partially visible, that counts as a whole line; to
644exclude partially-visible lines, use `window-text-height'. */)
645 (Lisp_Object window)
abde8f8c 646{
105216ed
CY
647 struct window *w = decode_window (window);
648 return make_number (window_body_lines (w));
649}
abde8f8c 650
105216ed
CY
651DEFUN ("window-body-width", Fwindow_body_width, Swindow_body_width, 0, 1, 0,
652 doc: /* Return the width, in columns, of WINDOW's text area.
653If WINDOW is omitted or nil, it defaults to the selected window.
654Signal an error if the window is not live.
655
656The return value does not include any vertical dividers, fringe or
657marginal areas, or scroll bars. On a graphical display, the width is
658expressed 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));
abde8f8c 663}
536833ab 664
7ab12479 665DEFUN ("window-hscroll", Fwindow_hscroll, Swindow_hscroll, 0, 1, 0,
c85322d0 666 doc: /* Return the number of columns by which WINDOW is scrolled from left margin.
496e208e 667WINDOW must be a live window and defaults to the selected one. */)
5842a27b 668 (Lisp_Object window)
7ab12479
JB
669{
670 return decode_window (window)->hscroll;
671}
672
673DEFUN ("set-window-hscroll", Fset_window_hscroll, Sset_window_hscroll, 2, 2, 0,
fdb82f93 674 doc: /* Set number of columns WINDOW is scrolled from left margin to NCOL.
0cf34688 675If WINDOW is nil, the selected window is used.
a0a37a6f 676Return NCOL. NCOL should be zero or positive.
ebadb1e4
EZ
677
678Note that if `automatic-hscrolling' is non-nil, you cannot scroll the
120b7781 679window so that the location of point moves off-window. */)
5842a27b 680 (Lisp_Object window, Lisp_Object ncol)
7ab12479 681{
ea68264b
GM
682 struct window *w = decode_window (window);
683 int hscroll;
7ab12479 684
b7826503 685 CHECK_NUMBER (ncol);
ea68264b 686 hscroll = max (0, XINT (ncol));
177c0ea7 687
ea68264b
GM
688 /* Prevent redisplay shortcuts when changing the hscroll. */
689 if (XINT (w->hscroll) != hscroll)
b1599b4c 690 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
177c0ea7 691
c67fa410 692 w->hscroll = make_number (hscroll);
7ab12479
JB
693 return ncol;
694}
695
190eb263
RS
696DEFUN ("window-redisplay-end-trigger", Fwindow_redisplay_end_trigger,
697 Swindow_redisplay_end_trigger, 0, 1, 0,
fdb82f93 698 doc: /* Return WINDOW's redisplay end trigger value.
c85322d0 699WINDOW defaults to the selected window.
fdb82f93 700See `set-window-redisplay-end-trigger' for more information. */)
5842a27b 701 (Lisp_Object window)
190eb263
RS
702{
703 return decode_window (window)->redisplay_end_trigger;
704}
705
706DEFUN ("set-window-redisplay-end-trigger", Fset_window_redisplay_end_trigger,
707 Sset_window_redisplay_end_trigger, 2, 2, 0,
fdb82f93
PJ
708 doc: /* Set WINDOW's redisplay end trigger value to VALUE.
709VALUE should be a buffer position (typically a marker) or nil.
710If it is a buffer position, then if redisplay in WINDOW reaches a position
711beyond VALUE, the functions in `redisplay-end-trigger-functions' are called
712with two arguments: WINDOW, and the end trigger value.
713Afterwards the end-trigger value is reset to nil. */)
5842a27b 714 (register Lisp_Object window, Lisp_Object value)
190eb263
RS
715{
716 register struct window *w;
717
718 w = decode_window (window);
719 w->redisplay_end_trigger = value;
720 return value;
721}
722
7ab12479 723DEFUN ("window-edges", Fwindow_edges, Swindow_edges, 0, 1, 0,
fdb82f93 724 doc: /* Return a list of the edge coordinates of WINDOW.
b35ac83e
CY
725The list has the form (LEFT TOP RIGHT BOTTOM).
726TOP and BOTTOM count by lines, and LEFT and RIGHT count by columns,
727all relative to 0, 0 at top left corner of frame.
728
729RIGHT is one more than the rightmost column occupied by WINDOW.
730BOTTOM is one more than the bottommost row occupied by WINDOW.
731The edges include the space used by WINDOW's scroll bar, display
732margins, fringes, header line, and/or mode line. For the edges of
733just the text area, use `window-inside-edges'. */)
5842a27b 734 (Lisp_Object window)
7ab12479 735{
6b61353c 736 register struct window *w = decode_any_window (window);
7ab12479 737
949cf20f
KS
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))));
7ab12479
JB
743}
744
c99a9eb3
RS
745DEFUN ("window-pixel-edges", Fwindow_pixel_edges, Swindow_pixel_edges, 0, 1, 0,
746 doc: /* Return a list of the edge pixel coordinates of WINDOW.
b35ac83e
CY
747The list has the form (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at
748the top left corner of the frame.
749
750RIGHT is one more than the rightmost x position occupied by WINDOW.
751BOTTOM is one more than the bottommost y position occupied by WINDOW.
752The pixel edges include the space used by WINDOW's scroll bar, display
753margins, fringes, header line, and/or mode line. For the pixel edges
754of just the text area, use `window-inside-pixel-edges'. */)
5842a27b 755 (Lisp_Object window)
c99a9eb3 756{
6b61353c 757 register struct window *w = decode_any_window (window);
c99a9eb3
RS
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
9d5405ec 766static void
5e617bc2 767calc_absolute_offset (struct window *w, int *add_x, int *add_y)
9d5405ec
J
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
bfeabdc3
JD
774#ifdef FRAME_TOOLBAR_TOP_HEIGHT
775 *add_y += FRAME_TOOLBAR_TOP_HEIGHT (f);
776#elif FRAME_TOOLBAR_HEIGHT
9d5405ec
J
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;
bfeabdc3
JD
783#ifdef FRAME_TOOLBAR_LEFT_WIDTH
784 *add_x += FRAME_TOOLBAR_LEFT_WIDTH (f);
785#endif
9d5405ec
J
786}
787
788DEFUN ("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.
791The list has the form (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at
792the top left corner of the display.
793
794RIGHT is one more than the rightmost x position occupied by WINDOW.
795BOTTOM is one more than the bottommost y position occupied by WINDOW.
796The pixel edges include the space used by WINDOW's scroll bar, display
797margins, fringes, header line, and/or mode line. For the pixel edges
c49d071a 798of just the text area, use `window-inside-absolute-pixel-edges'. */)
5842a27b 799 (Lisp_Object window)
9d5405ec
J
800{
801 register struct window *w = decode_any_window (window);
802 int add_x, add_y;
ed3751c8 803 calc_absolute_offset (w, &add_x, &add_y);
9d5405ec
J
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
c99a9eb3
RS
812DEFUN ("window-inside-edges", Fwindow_inside_edges, Swindow_inside_edges, 0, 1, 0,
813 doc: /* Return a list of the edge coordinates of WINDOW.
b35ac83e
CY
814The list has the form (LEFT TOP RIGHT BOTTOM).
815TOP and BOTTOM count by lines, and LEFT and RIGHT count by columns,
816all relative to 0, 0 at top left corner of frame.
817
818RIGHT is one more than the rightmost column of WINDOW's text area.
819BOTTOM is one more than the bottommost row of WINDOW's text area.
820The inside edges do not include the space used by the WINDOW's scroll
821bar, display margins, fringes, header line, and/or mode line. */)
5842a27b 822 (Lisp_Object window)
c99a9eb3 823{
2fbdc249 824 register struct window *w = decode_window (window);
c99a9eb3
RS
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)),
f3fbdb1f 831 make_number (WINDOW_BOX_RIGHT_EDGE_COL (w)
c99a9eb3
RS
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
838DEFUN ("window-inside-pixel-edges", Fwindow_inside_pixel_edges, Swindow_inside_pixel_edges, 0, 1, 0,
2fbdc249
CY
839 doc: /* Return a list of the edge pixel coordinates of WINDOW's text area.
840The list has the form (LEFT TOP RIGHT BOTTOM), all relative to (0,0)
841at the top left corner of the frame's window area.
b35ac83e
CY
842
843RIGHT is one more than the rightmost x position of WINDOW's text area.
844BOTTOM is one more than the bottommost y position of WINDOW's text area.
845The inside edges do not include the space used by WINDOW's scroll bar,
c99a9eb3 846display margins, fringes, header line, and/or mode line. */)
5842a27b 847 (Lisp_Object window)
c99a9eb3 848{
2fbdc249 849 register struct window *w = decode_window (window);
c99a9eb3
RS
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)),
f3fbdb1f 856 make_number (WINDOW_BOX_RIGHT_EDGE_X (w)
c99a9eb3
RS
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
9d5405ec
J
863DEFUN ("window-inside-absolute-pixel-edges",
864 Fwindow_inside_absolute_pixel_edges,
865 Swindow_inside_absolute_pixel_edges, 0, 1, 0,
2fbdc249
CY
866 doc: /* Return a list of the edge pixel coordinates of WINDOW's text area.
867The list has the form (LEFT TOP RIGHT BOTTOM), all relative to (0,0)
868at the top left corner of the frame's window area.
9d5405ec
J
869
870RIGHT is one more than the rightmost x position of WINDOW's text area.
871BOTTOM is one more than the bottommost y position of WINDOW's text area.
872The inside edges do not include the space used by WINDOW's scroll bar,
873display margins, fringes, header line, and/or mode line. */)
5842a27b 874 (Lisp_Object window)
9d5405ec 875{
2fbdc249 876 register struct window *w = decode_window (window);
9d5405ec 877 int add_x, add_y;
ed3751c8 878 calc_absolute_offset (w, &add_x, &add_y);
9d5405ec
J
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
9173a8fb 892/* Test if the character at column X, row Y is within window W.
341f3858 893 If it is not, return ON_NOTHING;
9173a8fb 894 if it is in the window's text area, return ON_TEXT;
341f3858 895 if it is on the window's modeline, return ON_MODE_LINE;
d5783c40 896 if it is on the border between the window and its right sibling,
341f3858 897 return ON_VERTICAL_BORDER.
9173a8fb 898 if it is on a scroll bar, return ON_SCROLL_BAR.
341f3858 899 if it is on the window's top line, return ON_HEADER_LINE;
81d189fd 900 if it is in left or right fringe of the window,
9173a8fb 901 return ON_LEFT_FRINGE or ON_RIGHT_FRINGE;
49b996e7 902 if it is in the marginal area to the left/right of the window,
9173a8fb 903 return ON_LEFT_MARGIN or ON_RIGHT_MARGIN.
5500c422
GM
904
905 X and Y are frame relative pixel coordinates. */
906
7442878f 907static enum window_part
9173a8fb 908coordinates_in_window (register struct window *w, int x, int y)
d5783c40 909{
b0228ace 910 struct frame *f = XFRAME (WINDOW_FRAME (w));
7442878f 911 enum window_part part;
949cf20f 912 int ux = FRAME_COLUMN_WIDTH (f);
c7b08b0d
MR
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);
dad75588
GM
917 /* The width of the area where the vertical line can be dragged.
918 (Between mode lines for instance. */
919 int grabbable_width = ux;
949cf20f 920 int lmargin_width, rmargin_width, text_left, text_right;
9173a8fb 921
c7b08b0d
MR
922 /* Outside any interesting row or column? */
923 if (y < top_y || y >= bottom_y || x < left_x || x >= right_x)
9173a8fb 924 return ON_NOTHING;
b0228ace 925
c7b08b0d
MR
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
466539bc
EZ
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. */
5500c422
GM
952 if (w->pseudo_window_p)
953 {
954 left_x = 0;
949cf20f 955 right_x = WINDOW_TOTAL_WIDTH (w) - 1;
5500c422
GM
956 }
957 else
958 {
949cf20f
KS
959 left_x = WINDOW_BOX_LEFT_EDGE_X (w);
960 right_x = WINDOW_BOX_RIGHT_EDGE_X (w) - 1;
5500c422 961 }
37962e60 962
949cf20f 963 /* Outside any interesting column? */
9173a8fb
CY
964 if (x < left_x || x > right_x)
965 return ON_SCROLL_BAR;
949cf20f
KS
966
967 lmargin_width = window_box_width (w, LEFT_MARGIN_AREA);
968 rmargin_width = window_box_width (w, RIGHT_MARGIN_AREA);
79fd290e 969
949cf20f
KS
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))
fbad6f9a 974 {
447e9da0 975 if (!w->pseudo_window_p
949cf20f 976 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
447e9da0 977 && !WINDOW_RIGHTMOST_P (w)
9173a8fb
CY
978 && (eabs (x - right_x) < grabbable_width))
979 return ON_VERTICAL_BORDER;
fbad6f9a 980 }
9173a8fb
CY
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)
949cf20f
KS
989 {
990 if (lmargin_width > 0
991 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
9173a8fb
CY
992 ? (x >= left_x + WINDOW_LEFT_FRINGE_WIDTH (w))
993 : (x < left_x + lmargin_width)))
994 return ON_LEFT_MARGIN;
995
949cf20f
KS
996 return ON_LEFT_FRINGE;
997 }
998
9173a8fb 999 if (x >= text_right)
949cf20f
KS
1000 {
1001 if (rmargin_width > 0
1002 && (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
9173a8fb
CY
1003 ? (x < right_x - WINDOW_RIGHT_FRINGE_WIDTH (w))
1004 : (x >= right_x - rmargin_width)))
1005 return ON_RIGHT_MARGIN;
1006
949cf20f
KS
1007 return ON_RIGHT_FRINGE;
1008 }
1009
1010 /* Everything special ruled out - must be on text area */
949cf20f 1011 return ON_TEXT;
d5783c40
JB
1012}
1013
9173a8fb
CY
1014/* Take X is the frame-relative pixel x-coordinate, and return the
1015 x-coordinate relative to part PART of window W. */
1016int
1017window_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
b0228ace 1051
d5783c40 1052DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
fdb82f93
PJ
1053 Scoordinates_in_window_p, 2, 2, 0,
1054 doc: /* Return non-nil if COORDINATES are in WINDOW.
90ec88df 1055WINDOW must be a live window.
fdb82f93
PJ
1056COORDINATES is a cons of the form (X . Y), X and Y being distances
1057measured in characters from the upper-left corner of the frame.
23fe745a 1058\(0 . 0) denotes the character in the upper left corner of the
fdb82f93
PJ
1059frame.
1060If COORDINATES are in the text portion of WINDOW,
1061 the coordinates relative to the window are returned.
1062If they are in the mode line of WINDOW, `mode-line' is returned.
1063If they are in the top mode line of WINDOW, `header-line' is returned.
81d189fd
KS
1064If they are in the left fringe of WINDOW, `left-fringe' is returned.
1065If they are in the right fringe of WINDOW, `right-fringe' is returned.
fdb82f93 1066If they are on the border between WINDOW and its right sibling,
49b996e7
GM
1067 `vertical-line' is returned.
1068If they are in the windows's left or right marginal areas, `left-margin'\n\
1069 or `right-margin' is returned. */)
5842a27b 1070 (register Lisp_Object coordinates, Lisp_Object window)
d5783c40 1071{
5500c422
GM
1072 struct window *w;
1073 struct frame *f;
d5783c40 1074 int x, y;
5500c422 1075 Lisp_Object lx, ly;
d5783c40 1076
90ec88df 1077 CHECK_LIVE_WINDOW (window);
5500c422
GM
1078 w = XWINDOW (window);
1079 f = XFRAME (w->frame);
b7826503 1080 CHECK_CONS (coordinates);
5500c422
GM
1081 lx = Fcar (coordinates);
1082 ly = Fcdr (coordinates);
b7826503
PJ
1083 CHECK_NUMBER_OR_FLOAT (lx);
1084 CHECK_NUMBER_OR_FLOAT (ly);
81159bb9
RS
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);
5500c422 1087
9173a8fb 1088 switch (coordinates_in_window (w, x, y))
d5783c40 1089 {
7442878f 1090 case ON_NOTHING:
d5783c40
JB
1091 return Qnil;
1092
7442878f 1093 case ON_TEXT:
9173a8fb
CY
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);
949cf20f
KS
1098 return Fcons (FRAME_CANON_X_FROM_PIXEL_X (f, x),
1099 FRAME_CANON_Y_FROM_PIXEL_Y (f, y));
d5783c40 1100
7442878f 1101 case ON_MODE_LINE:
d5783c40 1102 return Qmode_line;
37962e60 1103
7442878f 1104 case ON_VERTICAL_BORDER:
e5d77022 1105 return Qvertical_line;
d5783c40 1106
7442878f 1107 case ON_HEADER_LINE:
045dee35 1108 return Qheader_line;
5500c422 1109
7442878f
GM
1110 case ON_LEFT_FRINGE:
1111 return Qleft_fringe;
177c0ea7 1112
7442878f
GM
1113 case ON_RIGHT_FRINGE:
1114 return Qright_fringe;
fbad6f9a 1115
49b996e7
GM
1116 case ON_LEFT_MARGIN:
1117 return Qleft_margin;
177c0ea7 1118
49b996e7
GM
1119 case ON_RIGHT_MARGIN:
1120 return Qright_margin;
1121
6487f669
RS
1122 case ON_SCROLL_BAR:
1123 /* Historically we are supposed to return nil in this case. */
1124 return Qnil;
1125
d5783c40
JB
1126 default:
1127 abort ();
1128 }
1129}
1130
67492200
GM
1131
1132/* Callback for foreach_window, used in window_from_coordinates.
f95464e4
GM
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
5372262f 1138 *CW->part the part of the window under coordinates *X,*Y. Return
f95464e4
GM
1139 zero from this function to stop iterating over windows. */
1140
1141struct check_window_data
1142{
1143 Lisp_Object *window;
9173a8fb 1144 int x, y;
341f3858 1145 enum window_part *part;
f95464e4 1146};
67492200
GM
1147
1148static int
971de7fb 1149check_window_containing (struct window *w, void *user_data)
67492200 1150{
f95464e4 1151 struct check_window_data *cw = (struct check_window_data *) user_data;
7442878f
GM
1152 enum window_part found;
1153 int continue_p = 1;
67492200 1154
f95464e4 1155 found = coordinates_in_window (w, cw->x, cw->y);
7442878f 1156 if (found != ON_NOTHING)
67492200 1157 {
341f3858 1158 *cw->part = found;
f95464e4 1159 XSETWINDOW (*cw->window, w);
7442878f 1160 continue_p = 0;
67492200 1161 }
177c0ea7 1162
7442878f 1163 return continue_p;
67492200
GM
1164}
1165
1166
5500c422 1167/* Find the window containing frame-relative pixel position X/Y and
949cf20f
KS
1168 return it as a Lisp_Object.
1169
1170 If X, Y is on one of the window's special `window_part' elements,
9173a8fb 1171 set *PART to the id of that element.
949cf20f 1172
341f3858 1173 If there is no window under X, Y return nil and leave *PART
67492200
GM
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. */
5500c422 1184
7ab12479 1185Lisp_Object
9173a8fb
CY
1186window_from_coordinates (struct frame *f, int x, int y,
1187 enum window_part *part, int tool_bar_p)
7ab12479 1188{
67492200 1189 Lisp_Object window;
f95464e4 1190 struct check_window_data cw;
341f3858
KS
1191 enum window_part dummy;
1192
1193 if (part == 0)
1194 part = &dummy;
5500c422 1195
67492200 1196 window = Qnil;
9173a8fb 1197 cw.window = &window, cw.x = x, cw.y = y; cw.part = part;
f95464e4 1198 foreach_window (f, check_window_containing, &cw);
177c0ea7 1199
67492200
GM
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)
949cf20f 1205 && WINDOW_TOTAL_LINES (XWINDOW (f->tool_bar_window)) > 0
9173a8fb 1206 && (coordinates_in_window (XWINDOW (f->tool_bar_window), x, y)
7442878f 1207 != ON_NOTHING))
5500c422 1208 {
341f3858 1209 *part = ON_TEXT;
67492200 1210 window = f->tool_bar_window;
5500c422 1211 }
37962e60 1212
67492200 1213 return window;
7ab12479
JB
1214}
1215
ab17c3f2 1216DEFUN ("window-at", Fwindow_at, Swindow_at, 2, 3, 0,
fdb82f93 1217 doc: /* Return window containing coordinates X and Y on FRAME.
496e208e 1218FRAME must be a live frame and defaults to the selected one.
fdb82f93
PJ
1219The top left corner of the frame is considered to be row 0,
1220column 0. */)
5842a27b 1221 (Lisp_Object x, Lisp_Object y, Lisp_Object frame)
7ab12479 1222{
5500c422 1223 struct frame *f;
7ab12479 1224
44fa5b1e 1225 if (NILP (frame))
1ae1a37d 1226 frame = selected_frame;
b7826503 1227 CHECK_LIVE_FRAME (frame);
5500c422 1228 f = XFRAME (frame);
7ab12479 1229
5500c422 1230 /* Check that arguments are integers or floats. */
b7826503
PJ
1231 CHECK_NUMBER_OR_FLOAT (x);
1232 CHECK_NUMBER_OR_FLOAT (y);
5500c422 1233
177c0ea7 1234 return window_from_coordinates (f,
2c77cf3b
RS
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)),
9173a8fb 1239 0, 0);
7ab12479
JB
1240}
1241
1242DEFUN ("window-point", Fwindow_point, Swindow_point, 0, 1, 0,
fdb82f93 1243 doc: /* Return current value of point in WINDOW.
496e208e 1244WINDOW must be a live window and defaults to the selected one.
c85322d0 1245
fdb82f93
PJ
1246For a nonselected window, this is the value point would have
1247if that window were selected.
1248
1249Note that, when WINDOW is the selected window and its buffer
1250is also currently selected, the value returned is the same as (point).
1251It would be more strictly correct to return the `top-level' value
1252of point, outside of any save-excursion forms.
1253But that is hard to define. */)
5842a27b 1254 (Lisp_Object window)
7ab12479
JB
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
1264DEFUN ("window-start", Fwindow_start, Swindow_start, 0, 1, 0,
fdb82f93 1265 doc: /* Return position at which display currently starts in WINDOW.
496e208e 1266WINDOW must be a live window and defaults to the selected one.
fdb82f93 1267This is updated by redisplay or by calling `set-window-start'. */)
5842a27b 1268 (Lisp_Object window)
7ab12479
JB
1269{
1270 return Fmarker_position (decode_window (window)->start);
1271}
1272
8646118f
RS
1273/* This is text temporarily removed from the doc string below.
1274
fdb82f93
PJ
1275This function returns nil if the position is not currently known.
1276That happens when redisplay is preempted and doesn't finish.
1277If in that case you want to compute where the end of the window would
1278have been if redisplay had finished, do this:
1279 (save-excursion
1280 (goto-char (window-start window))
1281 (vertical-motion (1- (window-height window)) window)
8646118f
RS
1282 (point))") */
1283
478292ed 1284DEFUN ("window-end", Fwindow_end, Swindow_end, 0, 2, 0,
fdb82f93 1285 doc: /* Return position at which display currently ends in WINDOW.
496e208e 1286WINDOW must be a live window and defaults to the selected one.
fdb82f93
PJ
1287This is updated by redisplay, when it runs to completion.
1288Simply changing the buffer text or setting `window-start'
1289does not update this value.
87e68db4 1290Return nil if there is no recorded value. (This can happen if the
a0a37a6f 1291last redisplay of WINDOW was preempted, and did not finish.)
fdb82f93
PJ
1292If UPDATE is non-nil, compute the up-to-date position
1293if it isn't already recorded. */)
5842a27b 1294 (Lisp_Object window, Lisp_Object update)
7ab12479
JB
1295{
1296 Lisp_Object value;
1297 struct window *w = decode_window (window);
5a41ab94 1298 Lisp_Object buf;
31790df3 1299 struct buffer *b;
5a41ab94
RS
1300
1301 buf = w->buffer;
b7826503 1302 CHECK_BUFFER (buf);
b3a10345 1303 b = XBUFFER (buf);
5a41ab94 1304
8646118f 1305#if 0 /* This change broke some things. We should make it later. */
7250968e
RS
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;
8646118f 1312#endif
7250968e 1313
478292ed
RS
1314 if (! NILP (update)
1315 && ! (! NILP (w->window_end_valid)
dfc265a3 1316 && XFASTINT (w->last_modified) >= BUF_MODIFF (b)
4c9564e8 1317 && XFASTINT (w->last_overlay_modified) >= BUF_OVERLAY_MODIFF (b))
41791a20 1318 && !noninteractive)
478292ed 1319 {
cbc099e5
GM
1320 struct text_pos startp;
1321 struct it it;
b3a10345 1322 struct buffer *old_buffer = NULL;
57b3e30b 1323 void *itdata = NULL;
b3a10345
KS
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 }
2d6d9df0
GM
1332
1333 /* In case W->start is out of the range, use something
cb795ec4 1334 reasonable. This situation occurred when loading a file with
2d6d9df0
GM
1335 `-l' containing a call to `rmail' with subsequent other
1336 commands. At the end, W->start happened to be BEG, while
cbc099e5 1337 rmail had already narrowed the buffer. */
2d6d9df0 1338 if (XMARKER (w->start)->charpos < BEGV)
cbc099e5 1339 SET_TEXT_POS (startp, BEGV, BEGV_BYTE);
2d6d9df0 1340 else if (XMARKER (w->start)->charpos > ZV)
cbc099e5 1341 SET_TEXT_POS (startp, ZV, ZV_BYTE);
2d6d9df0 1342 else
cbc099e5
GM
1343 SET_TEXT_POS_FROM_MARKER (startp, w->start);
1344
57b3e30b 1345 itdata = bidi_shelve_cache ();
cbc099e5
GM
1346 start_display (&it, w, startp);
1347 move_it_vertically (&it, window_box_height (w));
c3c45f65
GM
1348 if (it.current_y < it.last_visible_y)
1349 move_it_past_eol (&it);
cbc099e5 1350 value = make_number (IT_CHARPOS (it));
35928349 1351 bidi_unshelve_cache (itdata, 0);
177c0ea7 1352
99593a9d
GM
1353 if (old_buffer)
1354 set_buffer_internal (old_buffer);
478292ed
RS
1355 }
1356 else
b3a10345 1357 XSETINT (value, BUF_Z (b) - XFASTINT (w->window_end_pos));
7ab12479
JB
1358
1359 return value;
1360}
1361
a7ca3326 1362DEFUN ("set-window-point", Fset_window_point, Sset_window_point, 2, 2, 0,
a0a37a6f
LT
1363 doc: /* Make point value in WINDOW be at position POS in WINDOW's buffer.
1364Return POS. */)
5842a27b 1365 (Lisp_Object window, Lisp_Object pos)
7ab12479
JB
1366{
1367 register struct window *w = decode_window (window);
1368
b7826503 1369 CHECK_NUMBER_COERCE_MARKER (pos);
e90c4fe6
RS
1370 if (w == XWINDOW (selected_window)
1371 && XBUFFER (w->buffer) == current_buffer)
7ab12479
JB
1372 Fgoto_char (pos);
1373 else
1374 set_marker_restricted (w->pointm, pos, w->buffer);
799417bd 1375
0685cb3c
GM
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))
799417bd 1379 ++windows_or_buffers_changed;
177c0ea7 1380
7ab12479
JB
1381 return pos;
1382}
1383
1384DEFUN ("set-window-start", Fset_window_start, Sset_window_start, 2, 3, 0,
fdb82f93 1385 doc: /* Make display in WINDOW start at position POS in WINDOW's buffer.
0cf34688 1386If WINDOW is nil, the selected window is used. Return POS.
d653c8cc
MR
1387Optional third arg NOFORCE non-nil inhibits next redisplay from
1388overriding motion of point in order to display at this exact start. */)
5842a27b 1389 (Lisp_Object window, Lisp_Object pos, Lisp_Object noforce)
7ab12479
JB
1390{
1391 register struct window *w = decode_window (window);
1392
b7826503 1393 CHECK_NUMBER_COERCE_MARKER (pos);
7ab12479
JB
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;
265a9e55 1397 if (NILP (noforce))
7ab12479
JB
1398 w->force_start = Qt;
1399 w->update_mode_line = Qt;
d834a2e9 1400 XSETFASTINT (w->last_modified, 0);
3cd21523 1401 XSETFASTINT (w->last_overlay_modified, 0);
62c07cc7
JB
1402 if (!EQ (window, selected_window))
1403 windows_or_buffers_changed++;
ce7fae7d 1404
7ab12479
JB
1405 return pos;
1406}
1407
496e208e
MR
1408DEFUN ("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.
1411Return nil if that position is scrolled vertically out of view.
1412If a character is only partially visible, nil is returned, unless the
1413optional argument PARTIALLY is non-nil.
1414If POS is only out of view because of horizontal scrolling, return non-nil.
1415If POS is t, it specifies the position of the last visible glyph in WINDOW.
1416POS defaults to point in WINDOW; WINDOW defaults to the selected window.
1417
1418If POS is visible, return t if PARTIALLY is nil; if PARTIALLY is non-nil,
1419return value is a list of 2 or 6 elements (X Y [RTOP RBOT ROWH VPOS]),
1420where X and Y are the pixel coordinates relative to the top left corner
1421of the window. The remaining elements are omitted if the character after
1422POS is fully visible; otherwise, RTOP and RBOT are the number of pixels
1423off-window at the top and bottom of the row, ROWH is the height of the
1424display 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
1474DEFUN ("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.
1477WINDOW defaults to the selected window.
1478
1479Return height of current line if LINE is omitted or nil. Return height of
1480header or mode line if LINE is `header-line' or `mode-line'.
1481Otherwise, LINE is a text line number starting from 0. A negative number
1482counts from the end of the window.
1483
1484Value is a list (HEIGHT VPOS YPOS OFFBOT), where HEIGHT is the height
1485in pixels of the visible part of the line, VPOS and YPOS are the
1486vertical position in lines and pixels of the line, relative to the top
1487of the first text line, and OFFBOT is the number of off-window pixels at
1488the bottom of the text line. If there are off-window pixels at the top
1489of the (first) text line, YPOS is negative.
1490
1491Return 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}
d653c8cc 1581
a7ca3326 1582DEFUN ("window-dedicated-p", Fwindow_dedicated_p, Swindow_dedicated_p,
d653c8cc
MR
1583 0, 1, 0,
1584 doc: /* Return non-nil when WINDOW is dedicated to its buffer.
12bb3111 1585More precisely, return the value assigned by the last call of
7bfac547
MR
1586`set-window-dedicated-p' for WINDOW. Return nil if that function was
1587never called with WINDOW as its argument, or the value set by that
1588function was internally reset since its last call. WINDOW defaults to
1589the selected window.
1590
1591When a window is dedicated to its buffer, `display-buffer' will refrain
1592from 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
1597Functions like `set-window-buffer' may change the buffer displayed by a
1598window, unless that window is "strongly" dedicated to its buffer, that
1599is the value returned by `window-dedicated-p' is t. */)
5842a27b 1600 (Lisp_Object window)
7ab12479
JB
1601{
1602 return decode_window (window)->dedicated;
1603}
1604
d207b766
RS
1605DEFUN ("set-window-dedicated-p", Fset_window_dedicated_p,
1606 Sset_window_dedicated_p, 2, 2, 0,
d653c8cc 1607 doc: /* Mark WINDOW as dedicated according to FLAG.
496e208e
MR
1608WINDOW must be a live window and defaults to the selected one. FLAG
1609non-nil means mark WINDOW as dedicated to its buffer. FLAG nil means
1610mark WINDOW as non-dedicated. Return FLAG.
d653c8cc 1611
7bfac547
MR
1612When a window is dedicated to its buffer, `display-buffer' will refrain
1613from displaying another buffer in it. `get-lru-window' and
1614`get-largest-window' treat dedicated windows specially.
496e208e
MR
1615`delete-windows-on', `replace-buffer-in-windows', `quit-window',
1616`quit-restore-window' and `kill-buffer' can delete a dedicated window
1617and the containing frame.
7bfac547
MR
1618
1619As a special case, if FLAG is t, mark WINDOW as "strongly" dedicated to
1620its buffer. Functions like `set-window-buffer' may change the buffer
1621displayed by a window, unless that window is strongly dedicated to its
1622buffer. If and when `set-window-buffer' displays another buffer in a
496e208e 1623window, it also makes sure that the window is no more dedicated. */)
5842a27b 1624 (Lisp_Object window, Lisp_Object flag)
7ab12479
JB
1625{
1626 register struct window *w = decode_window (window);
1627
d653c8cc 1628 w->dedicated = flag;
7ab12479
JB
1629 return w->dedicated;
1630}
1631
496e208e
MR
1632DEFUN ("window-prev-buffers", Fwindow_prev_buffers, Swindow_prev_buffers,
1633 0, 1, 0,
1634 doc: /* Return buffers previously shown in WINDOW.
1635WINDOW must be a live window and defaults to the selected one.
1636
94e0933e
CY
1637The return value is a list of elements (BUFFER WINDOW-START POS),
1638where BUFFER is a buffer, WINDOW-START is the start position of the
1639window for that buffer, and POS is a window-specific point value. */)
496e208e
MR
1640 (Lisp_Object window)
1641{
1642 return decode_window (window)->prev_buffers;
1643}
1644
1645DEFUN ("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.
94e0933e 1648WINDOW must be a live window and defaults to the selected one.
496e208e 1649
94e0933e
CY
1650PREV-BUFFERS should be a list of elements (BUFFER WINDOW-START POS),
1651where BUFFER is a buffer, WINDOW-START is the start position of the
1652window for that buffer, and POS is a window-specific point value. */)
496e208e
MR
1653 (Lisp_Object window, Lisp_Object prev_buffers)
1654{
9b1c252e 1655 return decode_window (window)->prev_buffers = prev_buffers;
496e208e
MR
1656}
1657
1658DEFUN ("window-next-buffers", Fwindow_next_buffers, Swindow_next_buffers,
1659 0, 1, 0,
1660 doc: /* Return list of buffers recently re-shown in WINDOW.
1661WINDOW 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
1667DEFUN ("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.
94e0933e
CY
1670WINDOW must be a live window and defaults to the selected one.
1671NEXT-BUFFERS should be a list of buffers. */)
496e208e
MR
1672 (Lisp_Object window, Lisp_Object next_buffers)
1673{
9b1c252e 1674 return decode_window (window)->next_buffers = next_buffers;
496e208e 1675}
d653c8cc 1676
cfbb2395
JB
1677DEFUN ("window-parameters", Fwindow_parameters, Swindow_parameters,
1678 0, 1, 0,
d653c8cc
MR
1679 doc: /* Return the parameters of WINDOW and their values.
1680WINDOW defaults to the selected window. The return value is a list of
87e68db4 1681elements of the form (PARAMETER . VALUE). */)
5842a27b 1682 (Lisp_Object window)
cfbb2395 1683{
496e208e 1684 return Fcopy_alist (decode_any_window (window)->window_parameters);
cfbb2395
JB
1685}
1686
1687DEFUN ("window-parameter", Fwindow_parameter, Swindow_parameter,
1688 2, 2, 0,
d653c8cc
MR
1689 doc: /* Return WINDOW's value for PARAMETER.
1690WINDOW defaults to the selected window. */)
5842a27b 1691 (Lisp_Object window, Lisp_Object parameter)
cfbb2395 1692{
927abf37
JB
1693 Lisp_Object result;
1694
496e208e 1695 result = Fassq (parameter, decode_any_window (window)->window_parameters);
927abf37 1696 return CDR_SAFE (result);
cfbb2395
JB
1697}
1698
cfbb2395
JB
1699DEFUN ("set-window-parameter", Fset_window_parameter,
1700 Sset_window_parameter, 3, 3, 0,
d653c8cc
MR
1701 doc: /* Set WINDOW's value of PARAMETER to VALUE.
1702WINDOW defaults to the selected window. Return VALUE. */)
5842a27b 1703 (Lisp_Object window, Lisp_Object parameter, Lisp_Object value)
cfbb2395 1704{
496e208e 1705 register struct window *w = decode_any_window (window);
cfbb2395
JB
1706 Lisp_Object old_alist_elt;
1707
1708 old_alist_elt = Fassq (parameter, w->window_parameters);
12bb3111 1709 if (NILP (old_alist_elt))
cfbb2395
JB
1710 w->window_parameters = Fcons (Fcons (parameter, value), w->window_parameters);
1711 else
1712 Fsetcdr (old_alist_elt, value);
927abf37 1713 return value;
cfbb2395
JB
1714}
1715
7ab12479
JB
1716DEFUN ("window-display-table", Fwindow_display_table, Swindow_display_table,
1717 0, 1, 0,
c85322d0
EZ
1718 doc: /* Return the display-table that WINDOW is using.
1719WINDOW defaults to the selected window. */)
5842a27b 1720 (Lisp_Object window)
7ab12479
JB
1721{
1722 return decode_window (window)->display_table;
1723}
1724
5500c422
GM
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. */
7ab12479 1729
319315f1 1730struct Lisp_Char_Table *
971de7fb 1731window_display_table (struct window *w)
7ab12479 1732{
c756cdbe
GM
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);
177c0ea7 1740
4b4deea2
TT
1741 if (DISP_TABLE_P (BVAR (b, display_table)))
1742 dp = XCHAR_TABLE (BVAR (b, display_table));
c756cdbe
GM
1743 else if (DISP_TABLE_P (Vstandard_display_table))
1744 dp = XCHAR_TABLE (Vstandard_display_table);
1745 }
171d003c 1746
c756cdbe 1747 return dp;
7ab12479
JB
1748}
1749
3a2712f9 1750DEFUN ("set-window-display-table", Fset_window_display_table, Sset_window_display_table, 2, 2, 0,
fdb82f93 1751 doc: /* Set WINDOW's display-table to TABLE. */)
5842a27b 1752 (register Lisp_Object window, Lisp_Object table)
7ab12479
JB
1753{
1754 register struct window *w;
7ab12479
JB
1755
1756 w = decode_window (window);
1757 w->display_table = table;
1758 return table;
1759}
1760\f
562dd5e9 1761/* Record info on buffer window W is displaying
7ab12479 1762 when it is about to cease to display that buffer. */
dfcf069d 1763static void
971de7fb 1764unshow_buffer (register struct window *w)
7ab12479 1765{
12cae7c0 1766 Lisp_Object buf;
b73ea88e 1767 struct buffer *b;
7ab12479 1768
12cae7c0 1769 buf = w->buffer;
b73ea88e
RS
1770 b = XBUFFER (buf);
1771 if (b != XMARKER (w->pointm)->buffer)
7ab12479
JB
1772 abort ();
1773
573f41ab 1774#if 0
7ab12479
JB
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. */
573f41ab
RS
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. */
b73ea88e 1787 b->last_window_start = marker_position (w->start);
7ab12479
JB
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. */
719eaeb1
GM
1792 if (! EQ (buf, XWINDOW (selected_window)->buffer)
1793 /* This line helps to fix Horsley's testbug.el bug. */
4b4deea2
TT
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)))
b73ea88e
RS
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)));
177c0ea7 1804
4b4deea2
TT
1805 if (WINDOWP (BVAR (b, last_selected_window))
1806 && w == XWINDOW (BVAR (b, last_selected_window)))
1807 BVAR (b, last_selected_window) = Qnil;
7ab12479
JB
1808}
1809
1a13852e
MR
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. */
dfcf069d 1813static void
1a13852e 1814replace_window (Lisp_Object old, Lisp_Object new, int setflag)
7ab12479
JB
1815{
1816 register Lisp_Object tem;
1a13852e 1817 register struct window *o = XWINDOW (old), *n = XWINDOW (new);
7ab12479 1818
1a13852e
MR
1819 /* If OLD is its frame's root window, then NEW is the new
1820 root window for that frame. */
7f4161e0 1821 if (EQ (old, FRAME_ROOT_WINDOW (XFRAME (o->frame))))
1a13852e
MR
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;
1a13852e
MR
1847 }
1848
1849 n->next = tem = o->next;
265a9e55 1850 if (!NILP (tem))
1a13852e 1851 XWINDOW (tem)->prev = new;
7ab12479 1852
1a13852e 1853 n->prev = tem = o->prev;
265a9e55 1854 if (!NILP (tem))
1a13852e 1855 XWINDOW (tem)->next = new;
7ab12479 1856
1a13852e 1857 n->parent = tem = o->parent;
265a9e55 1858 if (!NILP (tem))
7ab12479
JB
1859 {
1860 if (EQ (XWINDOW (tem)->vchild, old))
1a13852e 1861 XWINDOW (tem)->vchild = new;
7ab12479 1862 if (EQ (XWINDOW (tem)->hchild, old))
1a13852e 1863 XWINDOW (tem)->hchild = new;
7ab12479 1864 }
1a13852e
MR
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
1871static void
1872recombine_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;
b6f67890 1880 if (!NILP (parent) && NILP (w->combination_limit))
1a13852e
MR
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 }
7ab12479 1934
1a13852e
MR
1935 /* WINDOW can be deleted now. */
1936 w->vchild = w->hchild = Qnil;
1937 }
1938 }
7ab12479 1939}
6198ccd0
MR
1940
1941/* If WINDOW can be deleted, delete it. */
4475bec4 1942static void
6198ccd0
MR
1943delete_deletable_window (Lisp_Object window)
1944{
1945 if (!NILP (call1 (Qwindow_deletable_p, window)))
1946 call1 (Qdelete_window, window);
1947}
1a13852e 1948\f
67492200
GM
1949/***********************************************************************
1950 Window List
1951 ***********************************************************************/
1952
f95464e4
GM
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
496e208e 1955 the window_list function. */
67492200
GM
1956
1957static int
971de7fb 1958add_window_to_list (struct window *w, void *user_data)
67492200 1959{
f95464e4 1960 Lisp_Object *list = (Lisp_Object *) user_data;
67492200
GM
1961 Lisp_Object window;
1962 XSETWINDOW (window, w);
212116d6 1963 *list = Fcons (window, *list);
67492200
GM
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
1972static Lisp_Object
971de7fb 1973window_list (void)
67492200
GM
1974{
1975 if (!CONSP (Vwindow_list))
1976 {
1977 Lisp_Object tail;
212116d6 1978
67492200
GM
1979 Vwindow_list = Qnil;
1980 for (tail = Vframe_list; CONSP (tail); tail = XCDR (tail))
212116d6
GM
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 }
67492200 1993 }
177c0ea7 1994
67492200
GM
1995 return Vwindow_list;
1996}
1997
1998
118ea242
GM
1999/* Value is non-zero if WINDOW satisfies the constraints given by
2000 OWINDOW, MINIBUF and ALL_FRAMES.
67492200 2001
118ea242
GM
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
67492200 2005
118ea242
GM
2006 ALL_FRAMES t means search all frames,
2007 nil means search just current frame,
aa248733
MS
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,
118ea242
GM
2012 a window means search the frame that window belongs to,
2013 a frame means consider windows on that frame, only. */
67492200
GM
2014
2015static int
971de7fb 2016candidate_window_p (Lisp_Object window, Lisp_Object owindow, Lisp_Object minibuf, Lisp_Object all_frames)
67492200
GM
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 }
118ea242
GM
2032 else if (EQ (all_frames, Qt))
2033 candidate_p = 1;
67492200 2034 else if (NILP (all_frames))
118ea242
GM
2035 {
2036 xassert (WINDOWP (owindow));
2037 candidate_p = EQ (w->frame, XWINDOW (owindow)->frame);
2038 }
67492200
GM
2039 else if (EQ (all_frames, Qvisible))
2040 {
2041 FRAME_SAMPLE_VISIBILITY (f);
de509a60
SM
2042 candidate_p = FRAME_VISIBLE_P (f)
2043 && (FRAME_TERMINAL (XFRAME (w->frame))
2044 == FRAME_TERMINAL (XFRAME (selected_frame)));
2045
67492200
GM
2046 }
2047 else if (INTEGERP (all_frames) && XINT (all_frames) == 0)
2048 {
2049 FRAME_SAMPLE_VISIBILITY (f);
ca2d5566
SM
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
de509a60
SM
2061 )
2062 && (FRAME_TERMINAL (XFRAME (w->frame))
2063 == FRAME_TERMINAL (XFRAME (selected_frame)));
67492200 2064 }
67492200
GM
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)));
118ea242
GM
2069 else if (FRAMEP (all_frames))
2070 candidate_p = EQ (all_frames, w->frame);
67492200
GM
2071
2072 return candidate_p;
2073}
2074
2075
2076/* Decode arguments as allowed by Fnext_window, Fprevious_window, and
aa248733
MS
2077 Fwindow_list. See candidate_window_p for the meaning of WINDOW,
2078 MINIBUF, and ALL_FRAMES. */
67492200
GM
2079
2080static void
971de7fb 2081decode_next_window_args (Lisp_Object *window, Lisp_Object *minibuf, Lisp_Object *all_frames)
67492200
GM
2082{
2083 if (NILP (*window))
2084 *window = selected_window;
2085 else
b7826503 2086 CHECK_LIVE_WINDOW (*window);
177c0ea7 2087
67492200
GM
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;
177c0ea7 2094
67492200
GM
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 ;
0f8fe9a2 2106 else if (EQ (*all_frames, make_number (0)))
67492200
GM
2107 ;
2108 else if (FRAMEP (*all_frames))
2109 ;
2110 else if (!EQ (*all_frames, Qt))
2111 *all_frames = Qnil;
67492200
GM
2112}
2113
2114
ab6d1131 2115/* Return the next or previous window of WINDOW in cyclic ordering
67492200
GM
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
2120static Lisp_Object
971de7fb 2121next_window (Lisp_Object window, Lisp_Object minibuf, Lisp_Object all_frames, int next_p)
67492200
GM
2122{
2123 decode_next_window_args (&window, &minibuf, &all_frames);
177c0ea7 2124
67492200
GM
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);
177c0ea7 2130
212116d6 2131 if (next_p)
67492200
GM
2132 {
2133 Lisp_Object list;
177c0ea7 2134
67492200
GM
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))
118ea242 2141 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
67492200
GM
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))
118ea242 2149 if (candidate_window_p (XCAR (list), window, minibuf, all_frames))
67492200
GM
2150 break;
2151
2152 if (CONSP (list))
2153 window = XCAR (list);
2154 }
2155 else
2156 {
2157 Lisp_Object candidate, list;
177c0ea7 2158
67492200
GM
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 }
118ea242
GM
2171 else if (candidate_window_p (XCAR (list), window, minibuf,
2172 all_frames))
67492200
GM
2173 candidate = XCAR (list);
2174 }
2175
2176 if (WINDOWP (candidate))
2177 window = candidate;
2178 }
2179
2180 return window;
2181}
7ab12479 2182
7ab12479 2183
a7ca3326 2184DEFUN ("next-window", Fnext_window, Snext_window, 0, 3, 0,
a9b9b7f5 2185 doc: /* Return live window after WINDOW in the cyclic ordering of windows.
87e68db4 2186WINDOW must be a live window and defaults to the selected one. The
9397e56f
MR
2187optional arguments MINIBUF and ALL-FRAMES specify the set of windows to
2188consider.
2189
2190MINIBUF nil or omitted means consider the minibuffer window only if the
2191minibuffer is active. MINIBUF t means consider the minibuffer window
2192even if the minibuffer is not active. Any other value means do not
2193consider the minibuffer window even if the minibuffer is active.
2194
2195ALL-FRAMES nil or omitted means consider all windows on WINDOW's frame,
2196plus the minibuffer window if specified by the MINIBUF argument. If the
2197minibuffer counts, consider all windows on all frames that share that
2198minibuffer too. The following non-nil values of ALL-FRAMES have special
2199meanings:
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.
ab6d1131 2209
ab6d1131 2210Anything else means consider all windows on WINDOW's frame and no
9397e56f 2211others.
fdb82f93
PJ
2212
2213If you use consistent values for MINIBUF and ALL-FRAMES, you can use
2214`next-window' to iterate through the entire cycle of acceptable
2215windows, eventually ending up back at the window you started with.
2216`previous-window' traverses the same cycle, in the reverse order. */)
5842a27b 2217 (Lisp_Object window, Lisp_Object minibuf, Lisp_Object all_frames)
7ab12479 2218{
67492200 2219 return next_window (window, minibuf, all_frames, 1);
7ab12479
JB
2220}
2221
67492200 2222
26f6279d 2223DEFUN ("previous-window", Fprevious_window, Sprevious_window, 0, 3, 0,
a9b9b7f5 2224 doc: /* Return live window before WINDOW in the cyclic ordering of windows.
9397e56f
MR
2225WINDOW must be a live window and defaults to the selected one. The
2226optional arguments MINIBUF and ALL-FRAMES specify the set of windows to
2227consider.
2228
2229MINIBUF nil or omitted means consider the minibuffer window only if the
2230minibuffer is active. MINIBUF t means consider the minibuffer window
2231even if the minibuffer is not active. Any other value means do not
2232consider the minibuffer window even if the minibuffer is active.
2233
2234ALL-FRAMES nil or omitted means consider all windows on WINDOW's frame,
2235plus the minibuffer window if specified by the MINIBUF argument. If the
2236minibuffer counts, consider all windows on all frames that share that
2237minibuffer too. The following non-nil values of ALL-FRAMES have special
2238meanings:
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
2249Anything else means consider all windows on WINDOW's frame and no
2250others.
ab6d1131
MR
2251
2252If you use consistent values for MINIBUF and ALL-FRAMES, you can
2253use `previous-window' to iterate through the entire cycle of
2254acceptable windows, eventually ending up back at the window you
2255started with. `next-window' traverses the same cycle, in the
2256reverse order. */)
5842a27b 2257 (Lisp_Object window, Lisp_Object minibuf, Lisp_Object all_frames)
7ab12479 2258{
67492200 2259 return next_window (window, minibuf, all_frames, 0);
7ab12479
JB
2260}
2261
67492200 2262
ab6d1131 2263/* Return a list of windows in cyclic ordering. Arguments are like
cd2904bd
GM
2264 for `next-window'. */
2265
2266static Lisp_Object
971de7fb 2267window_list_1 (Lisp_Object window, Lisp_Object minibuf, Lisp_Object all_frames)
67492200 2268{
403de3b4 2269 Lisp_Object tail, list, rest;
67492200
GM
2270
2271 decode_next_window_args (&window, &minibuf, &all_frames);
2272 list = Qnil;
177c0ea7 2273
67492200 2274 for (tail = window_list (); CONSP (tail); tail = XCDR (tail))
118ea242 2275 if (candidate_window_p (XCAR (tail), window, minibuf, all_frames))
67492200 2276 list = Fcons (XCAR (tail), list);
177c0ea7 2277
403de3b4
RS
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 {
1725a7c9 2283 for (tail = list; !EQ (XCDR (tail), rest); tail = XCDR (tail))
403de3b4
RS
2284 ;
2285 XSETCDR (tail, Qnil);
2286 list = nconc2 (rest, list);
2287 }
2288 return list;
67492200
GM
2289}
2290
2291
abde8f8c
MR
2292DEFUN ("window-list", Fwindow_list, Swindow_list, 0, 3, 0,
2293 doc: /* Return a list of windows on FRAME, starting with WINDOW.
2294FRAME nil or omitted means use the selected frame.
49745b39 2295WINDOW nil or omitted means use the window selected within FRAME.
abde8f8c
MR
2296MINIBUF t means include the minibuffer window, even if it isn't active.
2297MINIBUF nil or omitted means include the minibuffer window only
2298if it's active.
2299MINIBUF 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
1a13852e
MR
2315DEFUN ("window-list-1", Fwindow_list_1, Swindow_list_1, 0, 3, 0,
2316 doc: /* Return a list of all live windows.
2317WINDOW specifies the first window to list and defaults to the selected
2318window.
2319
2320Optional argument MINIBUF nil or omitted means consider the minibuffer
2321window only if the minibuffer is active. MINIBUF t means consider the
2322minibuffer window even if the minibuffer is not active. Any other value
2323means do not consider the minibuffer window even if the minibuffer is
2324active.
2325
2326Optional argument ALL-FRAMES nil or omitted means consider all windows
2327on WINDOW's frame, plus the minibuffer window if specified by the
2328MINIBUF argument. If the minibuffer counts, consider all windows on all
2329frames that share that minibuffer too. The following non-nil values of
2330ALL-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
2341Anything else means consider all windows on WINDOW's frame and no
2342others.
2343
2344If WINDOW is not on the list of windows returned, some other window will
8350f087 2345be listed first but no error is signaled. */)
1a13852e
MR
2346 (Lisp_Object window, Lisp_Object minibuf, Lisp_Object all_frames)
2347{
2348 return window_list_1 (window, minibuf, all_frames);
2349}
7ab12479
JB
2350\f
2351/* Look at all windows, performing an operation specified by TYPE
2352 with argument OBJ.
75d8f668 2353 If FRAMES is Qt, look at all frames;
75d8f668 2354 Qnil, look at just the selected frame;
89bca612 2355 Qvisible, look at visible frames;
75d8f668 2356 a frame, just look at windows on that frame.
85fe3b5e 2357 If MINI is non-zero, perform the operation on minibuffer windows too. */
7ab12479
JB
2358
2359enum window_loop
2360{
2361 WINDOW_LOOP_UNUSED,
9397e56f
MR
2362 GET_BUFFER_WINDOW, /* Arg is buffer */
2363 REPLACE_BUFFER_IN_WINDOWS_SAFELY, /* Arg is buffer */
2364 REDISPLAY_BUFFER_WINDOWS, /* Arg is buffer */
3f8ab7bd 2365 CHECK_ALL_WINDOWS
7ab12479
JB
2366};
2367
2368static Lisp_Object
971de7fb 2369window_loop (enum window_loop type, Lisp_Object obj, int mini, Lisp_Object frames)
7ab12479 2370{
118ea242 2371 Lisp_Object window, windows, best_window, frame_arg;
9397e56f 2372 int frame_best_window_flag = 0;
118ea242 2373 struct frame *f;
ffdc852d 2374 struct gcpro gcpro1;
177c0ea7 2375
44fa5b1e
JB
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))
118ea242 2380 f = XFRAME (frames);
44fa5b1e 2381 else if (NILP (frames))
118ea242 2382 f = SELECTED_FRAME ();
7ab12479 2383 else
118ea242 2384 f = NULL;
177c0ea7 2385
118ea242 2386 if (f)
89bca612 2387 frame_arg = Qlambda;
0f8fe9a2 2388 else if (EQ (frames, make_number (0)))
f812f9c6 2389 frame_arg = frames;
89bca612
RS
2390 else if (EQ (frames, Qvisible))
2391 frame_arg = frames;
118ea242
GM
2392 else
2393 frame_arg = Qt;
7ab12479 2394
89bca612
RS
2395 /* frame_arg is Qlambda to stick to one frame,
2396 Qvisible to consider all visible frames,
2397 or Qt otherwise. */
2398
7ab12479 2399 /* Pick a window to start with. */
017b2bad 2400 if (WINDOWP (obj))
118ea242
GM
2401 window = obj;
2402 else if (f)
2403 window = FRAME_SELECTED_WINDOW (f);
7ab12479 2404 else
118ea242 2405 window = FRAME_SELECTED_WINDOW (SELECTED_FRAME ());
4b206065 2406
cd2904bd 2407 windows = window_list_1 (window, mini ? Qt : Qnil, frame_arg);
118ea242 2408 GCPRO1 (windows);
7ab12479 2409 best_window = Qnil;
118ea242 2410
e67a1dea 2411 for (; CONSP (windows); windows = XCDR (windows))
7ab12479 2412 {
118ea242 2413 struct window *w;
177c0ea7 2414
118ea242
GM
2415 window = XCAR (windows);
2416 w = XWINDOW (window);
177c0ea7 2417
118ea242
GM
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)
9397e56f
MR
2422 /* For REPLACE_BUFFER_IN_WINDOWS_SAFELY, we must always
2423 consider all windows. */
2424 || type == REPLACE_BUFFER_IN_WINDOWS_SAFELY
7ab12479
JB
2425 || (mini && minibuf_level > 0))
2426 switch (type)
2427 {
2428 case GET_BUFFER_WINDOW:
118ea242 2429 if (EQ (w->buffer, obj)
9397e56f
MR
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))
118ea242 2433 {
9397e56f
MR
2434 if (EQ (window, selected_window))
2435 /* Preferably return the selected window. */
ca2d5566 2436 RETURN_UNGCPRO (window);
9397e56f
MR
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). */
118ea242 2441 {
9397e56f
MR
2442 best_window = window;
2443 frame_best_window_flag = 1;
7ab12479 2444 }
9397e56f
MR
2445 else if (NILP (best_window))
2446 best_window = window;
7ab12479
JB
2447 }
2448 break;
2449
9397e56f
MR
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. */
118ea242 2453 if (EQ (w->buffer, obj))
7ab12479 2454 {
9397e56f
MR
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);
7ab12479
JB
2467 }
2468 break;
3f8ab7bd 2469
6b61353c
KH
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
3f8ab7bd
RS
2481 /* Check for a window that has a killed buffer. */
2482 case CHECK_ALL_WINDOWS:
118ea242 2483 if (! NILP (w->buffer)
4b4deea2 2484 && NILP (BVAR (XBUFFER (w->buffer), name)))
3f8ab7bd 2485 abort ();
118ea242 2486 break;
6bbd7a29
GM
2487
2488 case WINDOW_LOOP_UNUSED:
2489 break;
7ab12479 2490 }
7ab12479 2491 }
7ab12479 2492
118ea242 2493 UNGCPRO;
7ab12479 2494 return best_window;
37962e60 2495}
605be8af 2496
3f8ab7bd
RS
2497/* Used for debugging. Abort if any window has a dead buffer. */
2498
e3b27b31 2499extern void check_all_windows (void) EXTERNALLY_VISIBLE;
233a4a2c 2500void
971de7fb 2501check_all_windows (void)
3f8ab7bd
RS
2502{
2503 window_loop (CHECK_ALL_WINDOWS, Qnil, 1, Qt);
2504}
2505
a7ca3326 2506DEFUN ("get-buffer-window", Fget_buffer_window, Sget_buffer_window, 0, 2, 0,
fec89261 2507 doc: /* Return a window currently displaying BUFFER-OR-NAME, or nil if none.
496e208e
MR
2508BUFFER-OR-NAME may be a buffer or a buffer name and defaults to
2509the current buffer.
2510
2511The 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
2522Any other value of ALL-FRAMES means consider all windows on the
2523selected frame and no others. */)
2524 (Lisp_Object buffer_or_name, Lisp_Object all_frames)
7ab12479 2525{
fec89261
MR
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
017b2bad 2533 if (BUFFERP (buffer))
496e208e 2534 return window_loop (GET_BUFFER_WINDOW, buffer, 1, all_frames);
7ab12479
JB
2535 else
2536 return Qnil;
2537}
2538
4b66faf3 2539static Lisp_Object
1a13852e
MR
2540resize_root_window (Lisp_Object window, Lisp_Object delta, Lisp_Object horizontal, Lisp_Object ignore)
2541{
5386012d 2542 return call4 (Qwindow_resize_root_window, window, delta, horizontal, ignore);
1a13852e
MR
2543}
2544
2545
2546DEFUN ("delete-other-windows-internal", Fdelete_other_windows_internal,
2547 Sdelete_other_windows_internal, 0, 2, "",
2548 doc: /* Make WINDOW fill its frame.
2549Only the frame WINDOW is on is affected. WINDOW may be any window and
2550defaults to the selected one.
2551
be7f5545
MR
2552Optional argument ROOT, if non-nil, must specify an internal window such
2553that WINDOW is in its window subtree. If this is the case, replace ROOT
2554by WINDOW and leave alone any windows not part of ROOT's subtree.
1a13852e
MR
2555
2556When WINDOW is live try to reduce display jumps by keeping the text
2557previously visible in WINDOW in the same place on the frame. Doing this
2558depends on the value of (window-start WINDOW), so if calling this
2559function in a program gives strange scrolling, make sure the
2560window-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;
46a4ce9e
PE
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;
1a13852e
MR
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 {
be7f5545
MR
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. */
1a13852e
MR
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;
46a4ce9e 2653 resize_failed = 0;
1a13852e
MR
2654
2655 if (NILP (w->buffer))
2656 {
be7f5545 2657 /* Resize child windows vertically. */
1a13852e
MR
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);
d615d6d2
MR
2661 if (window_resize_check (w, 0))
2662 window_resize_apply (w, 0);
1a13852e
MR
2663 else
2664 {
2665 resize_root_window (window, delta, Qnil, Qt);
d615d6d2
MR
2666 if (window_resize_check (w, 0))
2667 window_resize_apply (w, 0);
1a13852e
MR
2668 else
2669 resize_failed = 1;
2670 }
2671
be7f5545 2672 /* Resize child windows horizontally. */
1a13852e
MR
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);
d615d6d2
MR
2679 if (window_resize_check (w, 1))
2680 window_resize_apply (w, 1);
1a13852e
MR
2681 else
2682 {
2683 resize_root_window (window, delta, Qt, Qt);
d615d6d2
MR
2684 if (window_resize_check (w, 1))
2685 window_resize_apply (w, 1);
1a13852e
MR
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
be7f5545 2721 /* Delete ROOT and all child windows of ROOT. */
1a13852e
MR
2722 if (!NILP (r->vchild))
2723 {
be7f5545 2724 delete_all_child_windows (r->vchild);
1a13852e
MR
2725 r->vchild = Qnil;
2726 }
2727 else if (!NILP (r->hchild))
2728 {
be7f5545 2729 delete_all_child_windows (r->hchild);
1a13852e
MR
2730 r->hchild = Qnil;
2731 }
2732
2733 replace_window (root, window, 1);
2734
1a13852e
MR
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
9397e56f
MR
2778void
2779replace_buffer_in_windows (Lisp_Object buffer)
7ab12479 2780{
9397e56f 2781 call1 (Qreplace_buffer_in_windows, buffer);
7ab12479
JB
2782}
2783
ff58478b 2784
9397e56f
MR
2785/* Safely replace BUFFER with some other buffer in all windows of all
2786 frames, even those on other keyboards. */
ff58478b
RS
2787
2788void
9397e56f 2789replace_buffer_in_windows_safely (Lisp_Object buffer)
ff58478b
RS
2790{
2791 Lisp_Object tail, frame;
2792
9397e56f
MR
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. */
ff58478b 2796 FOR_EACH_FRAME (tail, frame)
9397e56f 2797 window_loop (REPLACE_BUFFER_IN_WINDOWS_SAFELY, buffer, 1, frame);
ff58478b 2798}
7ab12479 2799\f
a481b3ea
JB
2800/* If *ROWS or *COLS are too small a size for FRAME, set them to the
2801 minimum allowable size. */
5500c422 2802
605be8af 2803void
971de7fb 2804check_frame_size (FRAME_PTR frame, int *rows, int *cols)
a481b3ea 2805{
628df3bf 2806 /* For height, we have to see:
54b8bcb5
RS
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);
177c0ea7 2813
5500c422
GM
2814 if (FRAME_TOP_MARGIN (frame) > 0)
2815 min_height += FRAME_TOP_MARGIN (frame);
a481b3ea
JB
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
79fd290e 2823/* Adjust the margins of window W if text area is too small.
949cf20f
KS
2824 Return 1 if window width is ok after adjustment; 0 if window
2825 is still too narrow. */
2826
2827static int
971de7fb 2828adjust_window_margins (struct window *w)
949cf20f
KS
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}
562dd5e9 2857\f
562dd5e9
MR
2858static Lisp_Object Fset_window_margins (Lisp_Object, Lisp_Object, Lisp_Object);
2859static Lisp_Object Fset_window_fringes (Lisp_Object, Lisp_Object, Lisp_Object,
2860 Lisp_Object);
2861static Lisp_Object Fset_window_scroll_bars (Lisp_Object, Lisp_Object,
2862 Lisp_Object, Lisp_Object);
2863static Lisp_Object Fset_window_vscroll (Lisp_Object, Lisp_Object, Lisp_Object);
6b61353c 2864
9397e56f
MR
2865/* The following three routines are needed for running a window's
2866 configuration change hook. */
562dd5e9
MR
2867static void
2868run_funs (Lisp_Object funs)
2869{
2870 for (; CONSP (funs); funs = XCDR (funs))
2871 if (!EQ (XCAR (funs), Qt))
2872 call0 (XCAR (funs));
2873}
6b61353c 2874
9397e56f
MR
2875static Lisp_Object
2876select_window_norecord (Lisp_Object window)
2877{
2878 return WINDOW_LIVE_P (window)
2879 ? Fselect_window (window, Qt) : selected_window;
2880}
2881
2882static Lisp_Object
2883select_frame_norecord (Lisp_Object frame)
2884{
2885 return FRAME_LIVE_P (XFRAME (frame))
2886 ? Fselect_frame (frame, Qt) : selected_frame;
2887}
6b61353c 2888
562dd5e9
MR
2889void
2890run_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);
6b61353c 2896
562dd5e9
MR
2897 if (NILP (Vrun_hooks))
2898 return;
6b61353c 2899
562dd5e9
MR
2900 /* Use the right buffer. Matters when running the local hooks. */
2901 if (current_buffer != XBUFFER (Fwindow_buffer (Qnil)))
6b61353c 2902 {
562dd5e9
MR
2903 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
2904 Fset_buffer (Fwindow_buffer (Qnil));
2905 }
6a44ffb3 2906
1a13852e
MR
2907 if (SELECTED_FRAME () != f)
2908 {
2909 record_unwind_protect (select_frame_norecord, Fselected_frame ());
2910 select_frame_norecord (frame);
2911 }
2912
6a44ffb3
SM
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 {
46a4ce9e 2923 int inner_count = SPECPDL_INDEX ();
6a44ffb3
SM
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));
46a4ce9e 2928 unbind_to (inner_count, Qnil);
fec89261 2929 }
6a44ffb3
SM
2930 }
2931 }
047aaeb9 2932
6a44ffb3
SM
2933 run_funs (global_wcch);
2934 unbind_to (count, Qnil);
ef264c42
SM
2935}
2936
1a13852e
MR
2937DEFUN ("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
5500c422
GM
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
949cf20f
KS
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. */
7ab12479 2952
5500c422 2953void
971de7fb 2954set_window_buffer (Lisp_Object window, Lisp_Object buffer, int run_hooks_p, int keep_margins_p)
5500c422
GM
2955{
2956 struct window *w = XWINDOW (window);
2957 struct buffer *b = XBUFFER (buffer);
aed13378 2958 int count = SPECPDL_INDEX ();
c3b232e4 2959 int samebuf = EQ (buffer, w->buffer);
7ab12479
JB
2960
2961 w->buffer = buffer;
86e48436
RS
2962
2963 if (EQ (window, selected_window))
4b4deea2 2964 BVAR (b, last_selected_window) = window;
beb4e312 2965
c49a0495
KS
2966 /* Let redisplay errors through. */
2967 b->display_error_modiff = 0;
2968
beb4e312 2969 /* Update time stamps of buffer display. */
4b4deea2
TT
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 ();
86e48436 2973
d834a2e9 2974 XSETFASTINT (w->window_end_pos, 0);
5500c422 2975 XSETFASTINT (w->window_end_vpos, 0);
72af86bd 2976 memset (&w->last_cursor, 0, sizeof w->last_cursor);
5a41ab94 2977 w->window_end_valid = Qnil;
c3b232e4 2978 if (!(keep_margins_p && samebuf))
23fe745a 2979 { /* If we're not actually changing the buffer, don't reset hscroll and
c3b232e4
SM
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. */
7ab12479 3000 windows_or_buffers_changed++;
5b03d3c0 3001
da39107c 3002 /* We must select BUFFER for running the window-scroll-functions. */
5b03d3c0
RS
3003 /* We can't check ! NILP (Vwindow_scroll_functions) here
3004 because that might itself be a local variable. */
da39107c 3005 if (window_initialized)
5b03d3c0 3006 {
da39107c 3007 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
5b03d3c0
RS
3008 Fset_buffer (buffer);
3009 }
3010
a1562258
SM
3011 XMARKER (w->pointm)->insertion_type = !NILP (Vwindow_point_insertion_type);
3012
949cf20f
KS
3013 if (!keep_margins_p)
3014 {
3015 /* Set left and right marginal area width etc. from buffer. */
3016
79fd290e 3017 /* This may call adjust_window_margins three times, so
949cf20f 3018 temporarily disable window margins. */
6b61353c
KH
3019 Lisp_Object save_left = w->left_margin_cols;
3020 Lisp_Object save_right = w->right_margin_cols;
3021
949cf20f
KS
3022 w->left_margin_cols = w->right_margin_cols = Qnil;
3023
3024 Fset_window_fringes (window,
4b4deea2
TT
3025 BVAR (b, left_fringe_width), BVAR (b, right_fringe_width),
3026 BVAR (b, fringes_outside_margins));
949cf20f
KS
3027
3028 Fset_window_scroll_bars (window,
4b4deea2
TT
3029 BVAR (b, scroll_bar_width),
3030 BVAR (b, vertical_scroll_bar_type), Qnil);
949cf20f 3031
6b61353c
KH
3032 w->left_margin_cols = save_left;
3033 w->right_margin_cols = save_right;
3034
949cf20f 3035 Fset_window_margins (window,
4b4deea2 3036 BVAR (b, left_margin_cols), BVAR (b, right_margin_cols));
949cf20f 3037 }
7ab12479 3038
5500c422
GM
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));
ef264c42 3044 run_window_configuration_change_hook (XFRAME (WINDOW_FRAME (w)));
5500c422 3045 }
543f5fb1 3046
5b03d3c0 3047 unbind_to (count, Qnil);
5500c422 3048}
5b03d3c0 3049
a7ca3326 3050DEFUN ("set-window-buffer", Fset_window_buffer, Sset_window_buffer, 2, 3, 0,
d653c8cc 3051 doc: /* Make WINDOW display BUFFER-OR-NAME as its contents.
9397e56f
MR
3052WINDOW has to be a live window and defaults to the selected one.
3053BUFFER-OR-NAME must be a buffer or the name of an existing buffer.
3054
3055Optional third argument KEEP-MARGINS non-nil means that WINDOW's current
3056display margins, fringe widths, and scroll bar settings are preserved;
3057the default is to reset these from the local settings for BUFFER-OR-NAME
3058or the frame defaults. Return nil.
d653c8cc 3059
7bfac547
MR
3060This function throws an error when WINDOW is strongly dedicated to its
3061buffer (that is `window-dedicated-p' returns t for WINDOW) and does not
3062already display BUFFER-OR-NAME.
6cb4a892 3063
8fef9de1
MR
3064This function runs `window-scroll-functions' before running
3065`window-configuration-change-hook'. */)
5842a27b 3066 (register Lisp_Object window, Lisp_Object buffer_or_name, Lisp_Object keep_margins)
5500c422 3067{
d653c8cc 3068 register Lisp_Object tem, buffer;
5500c422 3069 register struct window *w = decode_window (window);
5500c422 3070
bed0c171 3071 XSETWINDOW (window, w);
d653c8cc 3072 buffer = Fget_buffer (buffer_or_name);
b7826503 3073 CHECK_BUFFER (buffer);
4b4deea2 3074 if (NILP (BVAR (XBUFFER (buffer), name)))
5500c422
GM
3075 error ("Attempt to display deleted buffer");
3076
3077 tem = w->buffer;
aac0c6e3
MR
3078 if (NILP (tem))
3079 error ("Window is deleted");
3080 else if (!EQ (tem, Qt))
d653c8cc 3081 /* w->buffer is t when the window is first being set up. */
5500c422 3082 {
9397e56f
MR
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
e4769531 3091 dedication. */
9397e56f
MR
3092 w->dedicated = Qnil;
3093
3094 call1 (Qrecord_window_buffer, window);
3095 }
5500c422
GM
3096
3097 unshow_buffer (w);
3098 }
3099
949cf20f 3100 set_window_buffer (window, buffer, 1, !NILP (keep_margins));
7ab12479 3101
9397e56f 3102 return Qnil;
c6932ecd 3103}
b7354ddf 3104\f
7e5cf297 3105static Lisp_Object
971de7fb 3106display_buffer (Lisp_Object buffer, Lisp_Object not_this_window_p, Lisp_Object override_frame)
d07f802a 3107{
87478b52 3108 return call3 (Qdisplay_buffer, buffer, not_this_window_p, override_frame);
d07f802a
RS
3109}
3110
6b61353c
KH
3111DEFUN ("force-window-update", Fforce_window_update, Sforce_window_update,
3112 0, 1, 0,
5a1048a5 3113 doc: /* Force all windows to be updated on next redisplay.
6b61353c 3114If optional arg OBJECT is a window, force redisplay of that window only.
0cc1039f 3115If OBJECT is a buffer or buffer name, force redisplay of all windows
6b61353c 3116displaying that buffer. */)
5842a27b 3117 (Lisp_Object object)
6b61353c
KH
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 }
0cc1039f 3136
6b61353c
KH
3137 if (STRINGP (object))
3138 object = Fget_buffer (object);
4b4deea2 3139 if (BUFFERP (object) && !NILP (BVAR (XBUFFER (object), name)))
6b61353c
KH
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
7ab12479 3155void
971de7fb 3156temp_output_buffer_show (register Lisp_Object buf)
7ab12479
JB
3157{
3158 register struct buffer *old = current_buffer;
3159 register Lisp_Object window;
3160 register struct window *w;
3161
4b4deea2 3162 BVAR (XBUFFER (buf), directory) = BVAR (current_buffer, directory);
bccd3dd1 3163
7ab12479 3164 Fset_buffer (buf);
c6367666 3165 BUF_SAVE_MODIFF (XBUFFER (buf)) = MODIFF;
7ab12479
JB
3166 BEGV = BEG;
3167 ZV = Z;
3168 SET_PT (BEG);
7ab12479
JB
3169 set_buffer_internal (old);
3170
e67a1dea 3171 if (!NILP (Vtemp_buffer_show_function))
7ab12479
JB
3172 call1 (Vtemp_buffer_show_function, buf);
3173 else
3174 {
4ee88440 3175 window = display_buffer (buf, Qnil, Qnil);
7ab12479 3176
1ae1a37d 3177 if (!EQ (XWINDOW (window)->frame, selected_frame))
44fa5b1e 3178 Fmake_frame_visible (WINDOW_FRAME (XWINDOW (window)));
7ab12479
JB
3179 Vminibuf_scroll_window = window;
3180 w = XWINDOW (window);
d834a2e9 3181 XSETFASTINT (w->hscroll, 0);
ea68264b 3182 XSETFASTINT (w->min_hscroll, 0);
2d0834cc
SM
3183 set_marker_restricted_both (w->start, buf, BEG, BEG);
3184 set_marker_restricted_both (w->pointm, buf, BEG, BEG);
a58ec57d 3185
beb4e312 3186 /* Run temp-buffer-show-hook, with the chosen window selected
a5731348 3187 and its buffer current. */
dee091a3
JD
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 }
2cccc823 3205 }
7ab12479 3206}
3e21b6a7
SM
3207
3208DEFUN ("internal-temp-output-buffer-show",
3209 Ftemp_output_buffer_show, Stemp_output_buffer_show,
3210 1, 1, 0,
87e68db4 3211 doc: /* Internal function for `with-output-to-temp-buffer'. */)
3e21b6a7
SM
3212 (Lisp_Object buf)
3213{
3214 temp_output_buffer_show (buf);
3215 return Qnil;
3216}
7ab12479 3217\f
1a13852e
MR
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). */
3221static void
3222make_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);
1a13852e
MR
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;
b6f67890 3249 p->combination_limit = Qnil;
1a13852e
MR
3250 p->window_parameters = Qnil;
3251}
3252
496e208e
MR
3253/* Make new window from scratch. */
3254Lisp_Object
3255make_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);
496e208e
MR
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;
b6f67890 3296 w->combination_limit = w->window_parameters = Qnil;
496e208e
MR
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;
31b39d13 3306 w->phys_cursor_on_p = 0;
496e208e
MR
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;
496e208e
MR
3312 /* Reset window_list. */
3313 Vwindow_list = Qnil;
3314 /* Return window. */
3315 XSETWINDOW (window, w);
3316 return window;
3317}
3318\f
3319DEFUN ("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.
3321Return SIZE.
3322
3323Optional argument ADD non-nil means add SIZE to the new total size of
3324WINDOW and return the sum.
3325
be7f5545 3326Note: This function does not operate on any child windows of WINDOW. */)
496e208e
MR
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
3340DEFUN ("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.
3342Return SIZE.
3343
be7f5545 3344Note: This function does not operate on any child windows of WINDOW. */)
496e208e
MR
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;
7ab12479
JB
3351}
3352
1a13852e
MR
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)
be7f5545 3355 for window W and recursively all child windows of W.
1a13852e
MR
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). */
4b66faf3 3360static int
d615d6d2 3361window_resize_check (struct window *w, int horflag)
1a13852e
MR
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)
be7f5545 3370 /* All child windows of W must have the same width as W. */
1a13852e
MR
3371 {
3372 while (c)
3373 {
3374 if ((XINT (c->new_total) != XINT (w->new_total))
d615d6d2 3375 || !window_resize_check (c, horflag))
1a13852e
MR
3376 return 0;
3377 c = NILP (c->next) ? 0 : XWINDOW (c->next);
3378 }
3379 return 1;
3380 }
3381 else
be7f5545
MR
3382 /* The sum of the heights of the child windows of W must equal
3383 W's height. */
1a13852e
MR
3384 {
3385 int sum_of_sizes = 0;
3386 while (c)
3387 {
d615d6d2 3388 if (!window_resize_check (c, horflag))
1a13852e
MR
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)
be7f5545 3401 /* The sum of the widths of the child windows of W must equal W's
1a13852e
MR
3402 width. */
3403 {
3404 int sum_of_sizes = 0;
3405 while (c)
3406 {
d615d6d2 3407 if (!window_resize_check (c, horflag))
1a13852e
MR
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
be7f5545 3415 /* All child windows of W must have the same height as W. */
1a13852e
MR
3416 {
3417 while (c)
3418 {
3419 if ((XINT (c->new_total) != XINT (w->new_total))
d615d6d2 3420 || !window_resize_check (c, horflag))
1a13852e
MR
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
be7f5545
MR
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.
1a13852e
MR
3438
3439 This function does not perform any error checks. Make sure you have
d615d6d2 3440 run window_resize_check on W before applying this function. */
440a42e3 3441static void
d615d6d2 3442window_resize_apply (struct window *w, int horflag)
1a13852e 3443{
46a4ce9e 3444 struct window *c;
1a13852e
MR
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);
d615d6d2 3476 window_resize_apply (c, horflag);
1a13852e
MR
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);
d615d6d2 3492 window_resize_apply (c, horflag);
1a13852e
MR
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
d615d6d2 3505DEFUN ("window-resize-apply", Fwindow_resize_apply, Swindow_resize_apply, 1, 2, 0,
1a13852e
MR
3506 doc: /* Apply requested size values for window-tree of FRAME.
3507Optional argument HORIZONTAL omitted or nil means apply requested height
3508values. HORIZONTAL non-nil means apply requested width values.
3509
3510This function checks whether the requested values sum up to a valid
be7f5545
MR
3511window layout, recursively assigns the new sizes of all child windows
3512and calculates and assigns the new start positions of these windows.
1a13852e
MR
3513
3514Note: This function does not check any of `window-fixed-size-p',
3515`window-min-height' or `window-min-width'. All these checks have to
3516be 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
d615d6d2 3530 if (!window_resize_check (r, horflag)
1a13852e
MR
3531 || ! EQ (r->new_total, (horflag ? r->total_cols : r->total_lines)))
3532 return Qnil;
3533
3534 BLOCK_INPUT;
d615d6d2 3535 window_resize_apply (r, horflag);
1a13852e
MR
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. */
3556void
3557resize_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);
d615d6d2
MR
3587 if (window_resize_check (r, horflag) && new_size == XINT (r->new_total))
3588 window_resize_apply (r, horflag);
1a13852e
MR
3589 else
3590 {
3591 /* Try with "reasonable" minimum sizes next. */
3592 resize_root_window (root, delta, horflag ? Qt : Qnil, Qt);
d615d6d2 3593 if (window_resize_check (r, horflag)
1a13852e 3594 && new_size == XINT (r->new_total))
d615d6d2 3595 window_resize_apply (r, horflag);
1a13852e
MR
3596 else
3597 {
3598 /* Finally, try with "safe" minimum sizes. */
3599 resize_root_window (root, delta, horflag ? Qt : Qnil, Qsafe);
d615d6d2 3600 if (window_resize_check (r, horflag)
1a13852e 3601 && new_size == XINT (r->new_total))
d615d6d2 3602 window_resize_apply (r, horflag);
1a13852e
MR
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
3633DEFUN ("split-window-internal", Fsplit_window_internal, Ssplit_window_internal, 4, 4, 0,
3634 doc: /* Split window OLD.
3635Second argument TOTAL-SIZE specifies the number of lines or columns of the
9397e56f 3636new window. In any case TOTAL-SIZE must be a positive integer.
1a13852e
MR
3637
3638Third argument SIDE nil (or `below') specifies that the new window shall
3639be located below WINDOW. SIDE `above' means the new window shall be
3640located above WINDOW. In both cases TOTAL-SIZE specifies the number of
3641lines of the new window including space reserved for the mode and/or
3642header line.
3643
3644SIDE t (or `right') specifies that the new window shall be located on
3645the right side of WINDOW. SIDE `left' means the new window shall be
3646located on the left of WINDOW. In both cases TOTAL-SIZE specifies the
3647number of columns of the new window including space reserved for fringes
3648and the scrollbar or a divider column.
3649
3650Fourth argument NORMAL-SIZE specifies the normal size of the new window
3651according to the SIDE argument.
3652
3653The new total and normal sizes of all involved windows must have been
3654set 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);
b6f67890 3669 int combination_limit = 0;
1a13852e
MR
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
b6f67890
MR
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)
1a13852e
MR
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)");
a0c2d0ae
MR
3702 else if (!combination_limit && !NILP (Vwindow_combination_resize))
3703 /* `window-combination-resize' non-nil means try to resize OLD's siblings
1a13852e
MR
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));
d615d6d2 3711 if (!window_resize_check (p, horflag))
1a13852e
MR
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 {
d615d6d2 3719 if (!window_resize_check (o, horflag))
1a13852e
MR
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. */
b6f67890 3727 if (combination_limit)
1a13852e
MR
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);
b6f67890
MR
3736 /* Store value of `window-combination-limit' in new parent's
3737 combination_limit slot. */
3738 p->combination_limit = Vwindow_combination_limit;
1a13852e
MR
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
1a13852e
MR
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
d615d6d2 3801 /* Iso-coordinates and sizes are assigned by window_resize_apply,
1a13852e
MR
3802 get them ready here. */
3803 n->new_total = total_size;
3804 n->new_normal = normal_size;
3805
3806 BLOCK_INPUT;
d615d6d2 3807 window_resize_apply (p, horflag);
1a13852e
MR
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
3824DEFUN ("delete-window-internal", Fdelete_window_internal, Sdelete_window_internal, 1, 1, 0,
3825 doc: /* Remove WINDOW from its frame.
87e68db4
JB
3826WINDOW defaults to the selected window. Return nil.
3827Signal an error when WINDOW is the only window on its frame. */)
1a13852e
MR
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;
562dd5e9
MR
3881 if (!NILP (s->next))
3882 XWINDOW (s->next)->prev = sibling;
7ab12479
JB
3883 }
3884
d615d6d2 3885 if (window_resize_check (r, horflag)
562dd5e9
MR
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;
d615d6d2 3891 window_resize_apply (p, horflag);
0d384044 3892
562dd5e9
MR
3893 windows_or_buffers_changed++;
3894 Vwindow_list = Qnil;
3895 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
0d384044 3896
562dd5e9
MR
3897 w->next = Qnil; /* Don't delete w->next too. */
3898 free_window_matrices (w);
bd99e242 3899
562dd5e9 3900 if (!NILP (w->vchild))
0d384044 3901 {
be7f5545 3902 delete_all_child_windows (w->vchild);
562dd5e9 3903 w->vchild = Qnil;
0d384044 3904 }
562dd5e9 3905 else if (!NILP (w->hchild))
bd99e242 3906 {
be7f5545 3907 delete_all_child_windows (w->hchild);
562dd5e9 3908 w->hchild = Qnil;
bd99e242 3909 }
562dd5e9 3910 else if (!NILP (w->buffer))
bd99e242 3911 {
562dd5e9
MR
3912 unshow_buffer (w);
3913 unchain_marker (XMARKER (w->pointm));
3914 unchain_marker (XMARKER (w->start));
3915 w->buffer = Qnil;
bd99e242
RS
3916 }
3917
562dd5e9
MR
3918 if (NILP (s->prev) && NILP (s->next))
3919 /* A matrjoshka where SIBLING has become the only child of
3920 PARENT. */
c32de52a 3921 {
562dd5e9
MR
3922 /* Put SIBLING into PARENT's place. */
3923 replace_window (parent, sibling, 0);
3924 /* Have SIBLING inherit the following three slot values from
b6f67890 3925 PARENT (the combination_limit slot is not inherited). */
562dd5e9
MR
3926 s->normal_cols = p->normal_cols;
3927 s->normal_lines = p->normal_lines;
562dd5e9
MR
3928 /* Mark PARENT as deleted. */
3929 p->vchild = p->hchild = Qnil;
3930 /* Try to merge SIBLING into its new parent. */
3931 recombine_windows (sibling);
c32de52a
RS
3932 }
3933
562dd5e9
MR
3934 adjust_glyphs (f);
3935
3936 if (!WINDOW_LIVE_P (FRAME_SELECTED_WINDOW (f)))
3937 /* We deleted the frame's selected window. */
0d384044 3938 {
562dd5e9
MR
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;
0d384044 3943
562dd5e9
MR
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;
0d384044 3950
562dd5e9 3951 UNBLOCK_INPUT;
0d384044 3952
562dd5e9
MR
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;
bd99e242 3958
562dd5e9
MR
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;
0d384044
RS
3964 }
3965 else
562dd5e9 3966 UNBLOCK_INPUT;
0d384044 3967
562dd5e9
MR
3968 /* Must be run by the caller:
3969 run_window_configuration_change_hook (f); */
0d384044 3970 }
562dd5e9
MR
3971 else
3972 /* We failed: Relink WINDOW into window tree. */
0d384044 3973 {
562dd5e9
MR
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");
0d384044
RS
3989 }
3990
0d384044
RS
3991 return Qnil;
3992}
f984d4fc
GM
3993\f
3994/***********************************************************************
3995 Resizing Mini-Windows
3996 ***********************************************************************/
3997
562dd5e9
MR
3998/* Grow mini-window W by DELTA lines, DELTA >= 0, or as much as we
3999 can. */
4000void
4001grow_mini_window (struct window *w, int delta)
f984d4fc 4002{
562dd5e9
MR
4003 struct frame *f = XFRAME (w->frame);
4004 struct window *r;
4005 Lisp_Object root, value;
f984d4fc 4006
562dd5e9
MR
4007 xassert (MINI_WINDOW_P (w));
4008 xassert (delta >= 0);
f984d4fc 4009
562dd5e9
MR
4010 root = FRAME_ROOT_WINDOW (f);
4011 r = XWINDOW (root);
5386012d
MR
4012 value = call2 (Qwindow_resize_root_window_vertically,
4013 root, make_number (- delta));
d615d6d2 4014 if (INTEGERP (value) && window_resize_check (r, 0))
f984d4fc 4015 {
562dd5e9 4016 BLOCK_INPUT;
d615d6d2 4017 window_resize_apply (r, 0);
f984d4fc 4018
562dd5e9
MR
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);
f984d4fc 4024
562dd5e9
MR
4025 adjust_glyphs (f);
4026 UNBLOCK_INPUT;
f984d4fc
GM
4027 }
4028}
4029
4030
562dd5e9
MR
4031/* Shrink mini-window W. */
4032void
4033shrink_mini_window (struct window *w)
f984d4fc 4034{
562dd5e9
MR
4035 struct frame *f = XFRAME (w->frame);
4036 struct window *r;
4037 Lisp_Object root, value;
4038 EMACS_INT size;
43b4a21f 4039
562dd5e9 4040 xassert (MINI_WINDOW_P (w));
177c0ea7 4041
562dd5e9
MR
4042 size = XINT (w->total_lines);
4043 if (size > 1)
4044 {
4045 root = FRAME_ROOT_WINDOW (f);
4046 r = XWINDOW (root);
5386012d 4047 value = call2 (Qwindow_resize_root_window_vertically,
562dd5e9 4048 root, make_number (size - 1));
d615d6d2 4049 if (INTEGERP (value) && window_resize_check (r, 0))
f984d4fc 4050 {
562dd5e9 4051 BLOCK_INPUT;
d615d6d2 4052 window_resize_apply (r, 0);
43b4a21f 4053
562dd5e9
MR
4054 /* Shrink the mini-window. */
4055 XSETFASTINT (w->top_line, XFASTINT (r->top_line) + XFASTINT (r->total_lines));
4056 XSETFASTINT (w->total_lines, 1);
43b4a21f 4057
562dd5e9
MR
4058 XSETFASTINT (w->last_modified, 0);
4059 XSETFASTINT (w->last_overlay_modified, 0);
43b4a21f 4060
562dd5e9
MR
4061 adjust_glyphs (f);
4062 UNBLOCK_INPUT;
f984d4fc 4063 }
562dd5e9
MR
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. */
f984d4fc
GM
4068 }
4069}
4070
562dd5e9
MR
4071DEFUN ("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)
f984d4fc 4074{
562dd5e9
MR
4075 struct window *w = XWINDOW (window);
4076 struct window *r;
4077 struct frame *f;
4078 int height;
177c0ea7 4079
562dd5e9
MR
4080 CHECK_WINDOW (window);
4081 f = XFRAME (w->frame);
177c0ea7 4082
562dd5e9
MR
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");
177c0ea7 4087
562dd5e9
MR
4088 r = XWINDOW (FRAME_ROOT_WINDOW (f));
4089 height = XINT (r->total_lines) + XINT (w->total_lines);
d615d6d2 4090 if (window_resize_check (r, 0)
562dd5e9
MR
4091 && XINT (w->new_total) > 0
4092 && height == XINT (r->new_total) + XINT (w->new_total))
f984d4fc 4093 {
562dd5e9 4094 BLOCK_INPUT;
d615d6d2 4095 window_resize_apply (r, 0);
f984d4fc 4096
562dd5e9
MR
4097 w->total_lines = w->new_total;
4098 XSETFASTINT (w->top_line, XINT (r->top_line) + XINT (r->total_lines));
177c0ea7 4099
562dd5e9
MR
4100 windows_or_buffers_changed++;
4101 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
f984d4fc 4102 adjust_glyphs (f);
562dd5e9 4103 UNBLOCK_INPUT;
f984d4fc 4104
562dd5e9
MR
4105 run_window_configuration_change_hook (f);
4106 return Qt;
86c8e823 4107 }
562dd5e9 4108 else error ("Failed to resize minibuffer window");
f984d4fc 4109}
562dd5e9 4110\f
5500c422
GM
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
4116void
971de7fb 4117mark_window_cursors_off (struct window *w)
5500c422
GM
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
e9c195b1 4133/* Return number of lines of text (not counting mode lines) in W. */
7ab12479
JB
4134
4135int
971de7fb 4136window_internal_height (struct window *w)
7ab12479 4137{
949cf20f 4138 int ht = XFASTINT (w->total_lines);
7ab12479 4139
e9c195b1
GM
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;
7ab12479 4149
e9c195b1
GM
4150 if (WINDOW_WANTS_HEADER_LINE_P (w))
4151 --ht;
4152 }
7ab12479
JB
4153
4154 return ht;
4155}
5500c422
GM
4156\f
4157/************************************************************************
4158 Window Scrolling
4159 ***********************************************************************/
535e0b8e 4160
5500c422 4161/* Scroll contents of window WINDOW up. If WHOLE is non-zero, scroll
d4e7cf01 4162 N screen-fulls, which is defined as the height of the window minus
5500c422
GM
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. */
7ab12479 4167
101d1605 4168static void
971de7fb 4169window_scroll (Lisp_Object window, int n, int whole, int noerror)
5500c422 4170{
cba59f77
RS
4171 immediate_quit = 1;
4172
5500c422
GM
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);
cba59f77
RS
4179
4180 immediate_quit = 0;
5500c422
GM
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
4188static void
971de7fb 4189window_scroll_pixel_based (Lisp_Object window, int n, int whole, int noerror)
5500c422
GM
4190{
4191 struct it it;
4192 struct window *w = XWINDOW (window);
4193 struct text_pos start;
5500c422 4194 int this_scroll_margin;
9d14503e 4195 /* True if we fiddled the window vscroll field without really scrolling. */
5cdb3cf3 4196 int vscrolled = 0;
5a857365 4197 int x, y, rtop, rbot, rowh, vpos;
57b3e30b 4198 void *itdata = NULL;
5500c422
GM
4199
4200 SET_TEXT_POS_FROM_MARKER (start, w->start);
177c0ea7 4201
5500c422 4202 /* If PT is not visible in WINDOW, move back one half of
288d4e06
GM
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. */
5a857365
KS
4206
4207 if (!pos_visible_p (w, PT, &x, &y, &rtop, &rbot, &rowh, &vpos))
5500c422 4208 {
57b3e30b 4209 itdata = bidi_shelve_cache ();
5500c422
GM
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;
f204989e 4215 move_it_vertically_backward (&it, window_box_height (w) / 2);
177c0ea7 4216
5500c422
GM
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);
f204989e 4225 move_it_vertically_backward (&it, 0);
5500c422
GM
4226 it.current_y = 0;
4227 }
4228
4229 start = it.current.pos;
35928349 4230 bidi_unshelve_cache (itdata, 0);
5500c422 4231 }
e56263e5
KS
4232 else if (auto_window_vscroll_p)
4233 {
5a857365 4234 if (rtop || rbot) /* partially visible */
e56263e5
KS
4235 {
4236 int px;
4237 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
4238 if (whole)
e856c216
KS
4239 dy = max ((window_box_height (w)
4240 - next_screen_context_lines * dy),
4241 dy);
e56263e5
KS
4242 dy *= n;
4243
5a857365 4244 if (n < 0)
e56263e5 4245 {
5a857365
KS
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 }
e56263e5 4253 }
5a857365 4254 if (n > 0)
e56263e5 4255 {
5a857365
KS
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 {
2452438f 4267 EMACS_INT spos;
5a857365
KS
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 }
e56263e5
KS
4287 }
4288 }
5a857365 4289 /* Cancel previous vscroll. */
e56263e5
KS
4290 Fset_window_vscroll (window, make_number (0), Qt);
4291 }
5500c422 4292
57b3e30b 4293 itdata = bidi_shelve_cache ();
d0c38d63 4294 /* If scroll_preserve_screen_position is non-nil, we try to set
5500c422
GM
4295 point in the same window line as it is now, so get that line. */
4296 if (!NILP (Vscroll_preserve_screen_position))
4297 {
c525d842 4298 /* We preserve the goal pixel coordinate across consecutive
a4b000fb
JL
4299 calls to scroll-up, scroll-down and other commands that
4300 have the `scroll-command' property. This avoids the
c525d842
CY
4301 possibility of point becoming "stuck" on a tall line when
4302 scrolling by one line. */
66fe93d1 4303 if (window_scroll_pixel_based_preserve_y < 0
1344aad4
TT
4304 || !SYMBOLP (KVAR (current_kboard, Vlast_command))
4305 || NILP (Fget (KVAR (current_kboard, Vlast_command), Qscroll_command)))
c525d842
CY
4306 {
4307 start_display (&it, w, start);
4308 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
66fe93d1 4309 window_scroll_pixel_based_preserve_y = it.current_y;
c876b227 4310 window_scroll_pixel_based_preserve_x = it.current_x;
c525d842 4311 }
5500c422
GM
4312 }
4313 else
c876b227
SM
4314 window_scroll_pixel_based_preserve_y
4315 = window_scroll_pixel_based_preserve_x = -1;
5500c422
GM
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 {
2452438f 4322 EMACS_INT start_pos = IT_CHARPOS (it);
e856c216
KS
4323 int dy = WINDOW_FRAME_LINE_HEIGHT (w);
4324 dy = max ((window_box_height (w)
4325 - next_screen_context_lines * dy),
4326 dy) * n;
d72340d4
GM
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)
e856c216
KS
4332 {
4333 move_it_vertically_backward (&it, -dy);
5a857365 4334 /* Ensure we actually do move, e.g. in case we are currently
e856c216
KS
4335 looking at an image that is taller that the window height. */
4336 while (start_pos == IT_CHARPOS (it)
4337 && start_pos > BEGV)
e4cc2dfc 4338 move_it_by_lines (&it, -1);
e856c216 4339 }
d72340d4 4340 else if (dy > 0)
bed83ee4 4341 {
bed83ee4
KS
4342 move_it_to (&it, ZV, -1, it.current_y + dy, -1,
4343 MOVE_TO_POS | MOVE_TO_Y);
5a857365 4344 /* Ensure we actually do move, e.g. in case we are currently
bed83ee4
KS
4345 looking at an image that is taller that the window height. */
4346 while (start_pos == IT_CHARPOS (it)
4347 && start_pos < ZV)
e4cc2dfc 4348 move_it_by_lines (&it, 1);
bed83ee4 4349 }
5500c422
GM
4350 }
4351 else
e4cc2dfc 4352 move_it_by_lines (&it, n);
5500c422 4353
96ae58c8
RS
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). */
5500c422 4357 if ((n > 0 && IT_CHARPOS (it) == ZV)
96ae58c8 4358 || (n < 0 && IT_CHARPOS (it) == CHARPOS (start)))
5500c422 4359 {
5cdb3cf3
MB
4360 if (IT_CHARPOS (it) == ZV)
4361 {
07ce8b53
RS
4362 if (it.current_y < it.last_visible_y
4363 && (it.current_y + it.max_ascent + it.max_descent
3f489dc7 4364 > it.last_visible_y))
a74eca50
GM
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 }
5cdb3cf3 4372 else
57b3e30b 4373 {
35928349 4374 bidi_unshelve_cache (itdata, 0);
57b3e30b
EZ
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 }
5cdb3cf3 4382 }
5500c422 4383 else
5cdb3cf3
MB
4384 {
4385 if (w->vscroll != 0)
4386 /* The first line was only partially visible, make it fully
4387 visible. */
4388 w->vscroll = 0;
5cdb3cf3 4389 else
57b3e30b 4390 {
35928349 4391 bidi_unshelve_cache (itdata, 0);
57b3e30b
EZ
4392 if (noerror)
4393 return;
4394 else
4395 xsignal0 (Qbeginning_of_buffer);
4396 }
5cdb3cf3
MB
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;
5500c422
GM
4405 }
4406
5cdb3cf3
MB
4407 if (! vscrolled)
4408 {
2452438f
EZ
4409 EMACS_INT pos = IT_CHARPOS (it);
4410 EMACS_INT bytepos;
e68def1e
AS
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
5cdb3cf3 4420 /* Set the window start, and set up the window for redisplay. */
dad67609 4421 set_marker_restricted (w->start, make_number (pos),
5cdb3cf3 4422 w->buffer);
dad67609
RS
4423 bytepos = XMARKER (w->start)->bytepos;
4424 w->start_at_line_beg = ((pos == BEGV || FETCH_BYTE (bytepos - 1) == '\n')
4425 ? Qt : Qnil);
5cdb3cf3
MB
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 }
177c0ea7 4433
dc297565
RS
4434 /* The rest of this function uses current_y in a nonstandard way,
4435 not including the height of the header line if any. */
5500c422 4436 it.current_y = it.vpos = 0;
177c0ea7 4437
940f53e5
RS
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)
5500c422 4446 {
940f53e5
RS
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);
bdf4ec93
RS
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)))
940f53e5
RS
4453 /* We found PT at a legitimate height. Leave it alone. */
4454 ;
66fe93d1 4455 else if (window_scroll_pixel_based_preserve_y >= 0)
940f53e5 4456 {
fa3c3426
RS
4457 /* If we have a header line, take account of it.
4458 This is necessary because we set it.current_y to 0, above. */
c876b227
SM
4459 move_it_to (&it, -1,
4460 window_scroll_pixel_based_preserve_x,
66fe93d1
LT
4461 window_scroll_pixel_based_preserve_y
4462 - (WINDOW_WANTS_HEADER_LINE_P (w) ? 1 : 0 ),
c876b227 4463 -1, MOVE_TO_Y | MOVE_TO_X);
940f53e5
RS
4464 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4465 }
4466 else
5500c422 4467 {
5500c422 4468 while (it.current_y < this_scroll_margin)
e9b2c961
RS
4469 {
4470 int prev = it.current_y;
e4cc2dfc 4471 move_it_by_lines (&it, 1);
e9b2c961
RS
4472 if (prev == it.current_y)
4473 break;
4474 }
5500c422
GM
4475 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4476 }
940f53e5
RS
4477 }
4478 else if (n < 0)
4479 {
2452438f 4480 EMACS_INT charpos, bytepos;
aed328bf 4481 int partial_p;
940f53e5 4482
66fe93d1
LT
4483 /* Save our position, for the
4484 window_scroll_pixel_based_preserve_y case. */
940f53e5
RS
4485 charpos = IT_CHARPOS (it);
4486 bytepos = IT_BYTEPOS (it);
5cdb3cf3 4487
940f53e5
RS
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,
7ad53239
RS
4491 (it.last_visible_y - CURRENT_HEADER_LINE_HEIGHT (w)
4492 - this_scroll_margin - 1),
4493 -1,
940f53e5
RS
4494 MOVE_TO_POS | MOVE_TO_Y);
4495
aed328bf
KS
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 {
e4cc2dfc 4505 move_it_by_lines (&it, 1);
aed328bf
KS
4506 partial_p = it.current_y > it.last_visible_y;
4507 }
4508
bdf4ec93
RS
4509 if (charpos == PT && !partial_p
4510 && (NILP (Vscroll_preserve_screen_position)
4511 || EQ (Vscroll_preserve_screen_position, Qt)))
940f53e5
RS
4512 /* We found PT before we found the display margin, so PT is ok. */
4513 ;
66fe93d1 4514 else if (window_scroll_pixel_based_preserve_y >= 0)
940f53e5
RS
4515 {
4516 SET_TEXT_POS_FROM_MARKER (start, w->start);
4517 start_display (&it, w, start);
c525d842
CY
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. */
c876b227
SM
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);
940f53e5
RS
4524 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
4525 }
4526 else
4527 {
aed328bf 4528 if (partial_p)
5cdb3cf3
MB
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 {
e4cc2dfc 4532 move_it_by_lines (&it, -2);
5cdb3cf3
MB
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);
5500c422
GM
4538 }
4539 }
35928349 4540 bidi_unshelve_cache (itdata, 0);
5500c422
GM
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
4547static void
971de7fb 4548window_scroll_line_based (Lisp_Object window, int n, int whole, int noerror)
7ab12479
JB
4549{
4550 register struct window *w = XWINDOW (window);
03ab8921
EZ
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 ();
2452438f 4557 register EMACS_INT pos, pos_byte;
7ab12479
JB
4558 register int ht = window_internal_height (w);
4559 register Lisp_Object tem;
4560 int lose;
5500c422 4561 Lisp_Object bolp;
2452438f 4562 EMACS_INT startpos;
c876b227 4563 Lisp_Object original_pos = Qnil;
101d1605 4564
d4e7cf01
GM
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
101d1605
RS
4570 startpos = marker_position (w->start);
4571
c876b227
SM
4572 if (!NILP (Vscroll_preserve_screen_position))
4573 {
4574 if (window_scroll_preserve_vpos <= 0
1344aad4
TT
4575 || !SYMBOLP (KVAR (current_kboard, Vlast_command))
4576 || NILP (Fget (KVAR (current_kboard, Vlast_command), Qscroll_command)))
c876b227
SM
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 }
0a1f771a 4590
d834a2e9 4591 XSETFASTINT (tem, PT);
6ffdb539 4592 tem = Fpos_visible_in_window_p (tem, window, Qnil);
7ab12479 4593
265a9e55 4594 if (NILP (tem))
7ab12479 4595 {
cd2be1dd 4596 Fvertical_motion (make_number (- (ht / 2)), window);
345d45b2 4597 startpos = PT;
7ab12479
JB
4598 }
4599
345d45b2 4600 SET_PT (startpos);
5ce7b543 4601 lose = n < 0 && PT == BEGV;
540b6aa0 4602 Fvertical_motion (make_number (n), window);
5ce7b543 4603 pos = PT;
b73ea88e 4604 pos_byte = PT_BYTE;
7ab12479 4605 bolp = Fbolp ();
03ab8921
EZ
4606 SET_PT_BOTH (marker_position (opoint_marker),
4607 marker_byte_position (opoint_marker));
7ab12479
JB
4608
4609 if (lose)
f8026fd8
JB
4610 {
4611 if (noerror)
4612 return;
4613 else
ba96a5cf 4614 xsignal0 (Qbeginning_of_buffer);
f8026fd8 4615 }
7ab12479
JB
4616
4617 if (pos < ZV)
7ab12479 4618 {
0c7da84e 4619 /* Don't use a scroll margin that is negative or too large. */
71f02bc5
PE
4620 int this_scroll_margin =
4621 max (0, min (scroll_margin, XINT (w->total_lines) / 4));
0c7da84e 4622
b73ea88e 4623 set_marker_restricted_both (w->start, w->buffer, pos, pos_byte);
7ab12479
JB
4624 w->start_at_line_beg = bolp;
4625 w->update_mode_line = Qt;
d834a2e9 4626 XSETFASTINT (w->last_modified, 0);
3cd21523 4627 XSETFASTINT (w->last_overlay_modified, 0);
345d45b2
RS
4628 /* Set force_start so that redisplay_window will run
4629 the window-scroll-functions. */
4630 w->force_start = Qt;
0c7da84e 4631
bdf4ec93
RS
4632 if (!NILP (Vscroll_preserve_screen_position)
4633 && (whole || !EQ (Vscroll_preserve_screen_position, Qt)))
0c7da84e 4634 {
b73ea88e 4635 SET_PT_BOTH (pos, pos_byte);
c876b227 4636 Fvertical_motion (original_pos, window);
0c7da84e 4637 }
101d1605
RS
4638 /* If we scrolled forward, put point enough lines down
4639 that it is outside the scroll margin. */
4640 else if (n > 0)
0c7da84e 4641 {
101d1605
RS
4642 int top_margin;
4643
4644 if (this_scroll_margin > 0)
4645 {
b73ea88e 4646 SET_PT_BOTH (pos, pos_byte);
101d1605
RS
4647 Fvertical_motion (make_number (this_scroll_margin), window);
4648 top_margin = PT;
4649 }
4650 else
4651 top_margin = pos;
4652
03ab8921
EZ
4653 if (top_margin <= marker_position (opoint_marker))
4654 SET_PT_BOTH (marker_position (opoint_marker),
4655 marker_byte_position (opoint_marker));
5500c422 4656 else if (!NILP (Vscroll_preserve_screen_position))
101d1605 4657 {
b73ea88e 4658 SET_PT_BOTH (pos, pos_byte);
c876b227 4659 Fvertical_motion (original_pos, window);
101d1605 4660 }
9317a85d 4661 else
335406fc 4662 SET_PT (top_margin);
0c7da84e 4663 }
101d1605 4664 else if (n < 0)
7ab12479 4665 {
101d1605
RS
4666 int bottom_margin;
4667
0c7da84e
RS
4668 /* If we scrolled backward, put point near the end of the window
4669 but not within the scroll margin. */
b73ea88e 4670 SET_PT_BOTH (pos, pos_byte);
0c7da84e 4671 tem = Fvertical_motion (make_number (ht - this_scroll_margin), window);
101d1605
RS
4672 if (XFASTINT (tem) == ht - this_scroll_margin)
4673 bottom_margin = PT;
4674 else
4675 bottom_margin = PT + 1;
4676
03ab8921
EZ
4677 if (bottom_margin > marker_position (opoint_marker))
4678 SET_PT_BOTH (marker_position (opoint_marker),
4679 marker_byte_position (opoint_marker));
7ab12479 4680 else
101d1605 4681 {
5500c422 4682 if (!NILP (Vscroll_preserve_screen_position))
9317a85d 4683 {
b73ea88e 4684 SET_PT_BOTH (pos, pos_byte);
c876b227 4685 Fvertical_motion (original_pos, window);
9317a85d
RS
4686 }
4687 else
4688 Fvertical_motion (make_number (-1), window);
101d1605 4689 }
7ab12479
JB
4690 }
4691 }
4692 else
f8026fd8
JB
4693 {
4694 if (noerror)
4695 return;
4696 else
ba96a5cf 4697 xsignal0 (Qend_of_buffer);
f8026fd8 4698 }
7ab12479 4699}
5500c422
GM
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. */
7ab12479
JB
4707
4708static void
971de7fb 4709scroll_command (Lisp_Object n, int direction)
7ab12479 4710{
331379bf 4711 int count = SPECPDL_INDEX ();
7ab12479 4712
1ea40aa2 4713 xassert (eabs (direction) == 1);
5500c422
GM
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. */
7ab12479 4717 if (XBUFFER (XWINDOW (selected_window)->buffer) != current_buffer)
95605e15
JB
4718 {
4719 record_unwind_protect (save_excursion_restore, save_excursion_save ());
4720 Fset_buffer (XWINDOW (selected_window)->buffer);
5500c422
GM
4721
4722 /* Make redisplay consider other windows than just selected_window. */
4723 ++windows_or_buffers_changed;
95605e15 4724 }
7ab12479 4725
265a9e55 4726 if (NILP (n))
d4e7cf01 4727 window_scroll (selected_window, direction, 1, 0);
7ab12479 4728 else if (EQ (n, Qminus))
d4e7cf01 4729 window_scroll (selected_window, -direction, 1, 0);
7ab12479
JB
4730 else
4731 {
4732 n = Fprefix_numeric_value (n);
101d1605 4733 window_scroll (selected_window, XINT (n) * direction, 0, 0);
7ab12479 4734 }
95605e15
JB
4735
4736 unbind_to (count, Qnil);
7ab12479
JB
4737}
4738
e0965597 4739DEFUN ("scroll-up", Fscroll_up, Sscroll_up, 0, 1, "^P",
12bb3111 4740 doc: /* Scroll text of selected window upward ARG lines.
a0a37a6f 4741If ARG is omitted or nil, scroll upward by a near full screen.
fdb82f93
PJ
4742A near full screen is `next-screen-context-lines' less than a full screen.
4743Negative ARG means scroll downward.
4744If ARG is the atom `-', scroll downward by nearly full screen.
4745When calling from a program, supply as argument a number, nil, or `-'. */)
5842a27b 4746 (Lisp_Object arg)
7ab12479 4747{
413430c5 4748 scroll_command (arg, 1);
7ab12479
JB
4749 return Qnil;
4750}
4751
e0965597 4752DEFUN ("scroll-down", Fscroll_down, Sscroll_down, 0, 1, "^P",
12bb3111 4753 doc: /* Scroll text of selected window down ARG lines.
a0a37a6f 4754If ARG is omitted or nil, scroll down by a near full screen.
fdb82f93
PJ
4755A near full screen is `next-screen-context-lines' less than a full screen.
4756Negative ARG means scroll upward.
4757If ARG is the atom `-', scroll upward by nearly full screen.
4758When calling from a program, supply as argument a number, nil, or `-'. */)
5842a27b 4759 (Lisp_Object arg)
7ab12479 4760{
413430c5 4761 scroll_command (arg, -1);
7ab12479
JB
4762 return Qnil;
4763}
ccd0664b
RS
4764\f
4765DEFUN ("other-window-for-scrolling", Fother_window_for_scrolling, Sother_window_for_scrolling, 0, 0, 0,
fdb82f93 4766 doc: /* Return the other window for \"other window scroll\" commands.
fdb82f93 4767If `other-window-scroll-buffer' is non-nil, a window
a0a37a6f
LT
4768showing that buffer is used.
4769If in the minibuffer, `minibuffer-scroll-window' if non-nil
4770specifies the window. This takes precedence over
4771`other-window-scroll-buffer'. */)
5842a27b 4772 (void)
7ab12479 4773{
ccd0664b 4774 Lisp_Object window;
7ab12479
JB
4775
4776 if (MINI_WINDOW_P (XWINDOW (selected_window))
265a9e55 4777 && !NILP (Vminibuf_scroll_window))
7ab12479
JB
4778 window = Vminibuf_scroll_window;
4779 /* If buffer is specified, scroll that buffer. */
265a9e55 4780 else if (!NILP (Vother_window_scroll_buffer))
7ab12479
JB
4781 {
4782 window = Fget_buffer_window (Vother_window_scroll_buffer, Qnil);
265a9e55 4783 if (NILP (window))
87478b52 4784 window = display_buffer (Vother_window_scroll_buffer, Qt, Qnil);
7ab12479
JB
4785 }
4786 else
dbc4e1c1
JB
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
b7826503 4801 CHECK_LIVE_WINDOW (window);
7ab12479
JB
4802
4803 if (EQ (window, selected_window))
4804 error ("There is no other window");
4805
ccd0664b
RS
4806 return window;
4807}
4808
4809DEFUN ("scroll-other-window", Fscroll_other_window, Sscroll_other_window, 0, 1, "P",
fdb82f93
PJ
4810 doc: /* Scroll next window upward ARG lines; or near full screen if no ARG.
4811A near full screen is `next-screen-context-lines' less than a full screen.
4812The next window is the one below the current one; or the one at the top
4813if the current one is at the bottom. Negative ARG means scroll downward.
4814If ARG is the atom `-', scroll downward by nearly full screen.
4815When calling from a program, supply as argument a number, nil, or `-'.
4816
fdb82f93 4817If `other-window-scroll-buffer' is non-nil, scroll the window
a0a37a6f
LT
4818showing that buffer, popping the buffer up if necessary.
4819If in the minibuffer, `minibuffer-scroll-window' if non-nil
4820specifies the window to scroll. This takes precedence over
4821`other-window-scroll-buffer'. */)
5842a27b 4822 (Lisp_Object arg)
ccd0664b 4823{
d4e7cf01
GM
4824 Lisp_Object window;
4825 struct window *w;
331379bf 4826 int count = SPECPDL_INDEX ();
ccd0664b
RS
4827
4828 window = Fother_window_for_scrolling ();
7ab12479 4829 w = XWINDOW (window);
7ab12479
JB
4830
4831 /* Don't screw up if window_scroll gets an error. */
4832 record_unwind_protect (save_excursion_restore, save_excursion_save ());
5500c422 4833 ++windows_or_buffers_changed;
7ab12479
JB
4834
4835 Fset_buffer (w->buffer);
4836 SET_PT (marker_position (w->pointm));
4837
413430c5 4838 if (NILP (arg))
d4e7cf01 4839 window_scroll (window, 1, 1, 1);
413430c5 4840 else if (EQ (arg, Qminus))
d4e7cf01 4841 window_scroll (window, -1, 1, 1);
7ab12479
JB
4842 else
4843 {
413430c5
EN
4844 if (CONSP (arg))
4845 arg = Fcar (arg);
b7826503 4846 CHECK_NUMBER (arg);
101d1605 4847 window_scroll (window, XINT (arg), 0, 1);
7ab12479
JB
4848 }
4849
b73ea88e 4850 set_marker_both (w->pointm, Qnil, PT, PT_BYTE);
f4e7b2c2 4851 unbind_to (count, Qnil);
7ab12479
JB
4852
4853 return Qnil;
4854}
4855\f
e0965597 4856DEFUN ("scroll-left", Fscroll_left, Sscroll_left, 0, 2, "^P\np",
fdb82f93 4857 doc: /* Scroll selected window display ARG columns left.
2fe41216
EZ
4858Default for ARG is window width minus 2.
4859Value is the total amount of leftward horizontal scrolling in
4860effect after the change.
23fe745a 4861If SET-MINIMUM is non-nil, the new scroll amount becomes the
dc297565 4862lower bound for automatic scrolling, i.e. automatic scrolling
2fe41216 4863will not scroll a window to a column less than the value returned
dc297565 4864by this function. This happens in an interactive call. */)
5842a27b 4865 (register Lisp_Object arg, Lisp_Object set_minimum)
7ab12479 4866{
c67fa410
GM
4867 Lisp_Object result;
4868 int hscroll;
4869 struct window *w = XWINDOW (selected_window);
177c0ea7 4870
265a9e55 4871 if (NILP (arg))
abde8f8c 4872 XSETFASTINT (arg, window_body_cols (w) - 2);
7ab12479
JB
4873 else
4874 arg = Fprefix_numeric_value (arg);
4875
c67fa410
GM
4876 hscroll = XINT (w->hscroll) + XINT (arg);
4877 result = Fset_window_hscroll (selected_window, make_number (hscroll));
4878
dc297565 4879 if (!NILP (set_minimum))
c67fa410
GM
4880 w->min_hscroll = w->hscroll;
4881
4882 return result;
7ab12479
JB
4883}
4884
e0965597 4885DEFUN ("scroll-right", Fscroll_right, Sscroll_right, 0, 2, "^P\np",
fdb82f93 4886 doc: /* Scroll selected window display ARG columns right.
2fe41216
EZ
4887Default for ARG is window width minus 2.
4888Value is the total amount of leftward horizontal scrolling in
4889effect after the change.
23fe745a 4890If SET-MINIMUM is non-nil, the new scroll amount becomes the
dc297565 4891lower bound for automatic scrolling, i.e. automatic scrolling
2fe41216 4892will not scroll a window to a column less than the value returned
dc297565 4893by this function. This happens in an interactive call. */)
5842a27b 4894 (register Lisp_Object arg, Lisp_Object set_minimum)
7ab12479 4895{
c67fa410
GM
4896 Lisp_Object result;
4897 int hscroll;
4898 struct window *w = XWINDOW (selected_window);
177c0ea7 4899
265a9e55 4900 if (NILP (arg))
abde8f8c 4901 XSETFASTINT (arg, window_body_cols (w) - 2);
7ab12479
JB
4902 else
4903 arg = Fprefix_numeric_value (arg);
4904
c67fa410
GM
4905 hscroll = XINT (w->hscroll) - XINT (arg);
4906 result = Fset_window_hscroll (selected_window, make_number (hscroll));
177c0ea7 4907
dc297565 4908 if (!NILP (set_minimum))
c67fa410
GM
4909 w->min_hscroll = w->hscroll;
4910
4911 return result;
7ab12479
JB
4912}
4913
fa832261
KS
4914DEFUN ("minibuffer-selected-window", Fminibuffer_selected_window, Sminibuffer_selected_window, 0, 0, 0,
4915 doc: /* Return the window which was selected when entering the minibuffer.
12bb3111 4916Returns nil, if selected window is not a minibuffer window. */)
5842a27b 4917 (void)
fa832261
KS
4918{
4919 if (minibuf_level > 0
4920 && MINI_WINDOW_P (XWINDOW (selected_window))
fa832261
KS
4921 && WINDOW_LIVE_P (minibuf_selected_window))
4922 return minibuf_selected_window;
4923
4924 return Qnil;
4925}
4926
12c8b416
GM
4927/* Value is the number of lines actually displayed in window W,
4928 as opposed to its height. */
4929
4930static int
971de7fb 4931displayed_window_lines (struct window *w)
12c8b416
GM
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;
57b3e30b 4938 void *itdata = NULL;
12c8b416
GM
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
521b203e
GM
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
57b3e30b 4958 itdata = bidi_shelve_cache ();
12c8b416
GM
4959 start_display (&it, w, start);
4960 move_it_vertically (&it, height);
c8bc6f65 4961 bottom_y = line_bottom_y (&it);
35928349 4962 bidi_unshelve_cache (itdata, 0);
12c8b416 4963
1de65f51
RS
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
12c8b416
GM
4973 /* Add in empty lines at the bottom of the window. */
4974 if (bottom_y < height)
4975 {
949cf20f 4976 int uy = FRAME_LINE_HEIGHT (it.f);
c8bc6f65 4977 it.vpos += (height - bottom_y + uy - 1) / uy;
12c8b416
GM
4978 }
4979
c8bc6f65
GM
4980 if (old_buffer)
4981 set_buffer_internal (old_buffer);
4982
12c8b416
GM
4983 return it.vpos;
4984}
4985
4986
a7ca3326 4987DEFUN ("recenter", Frecenter, Srecenter, 0, 1, "P",
666e158e 4988 doc: /* Center point in selected window and maybe redisplay frame.
fdb82f93 4989With prefix argument ARG, recenter putting point on screen line ARG
12bb3111 4990relative to the selected window. If ARG is negative, it counts up from the
fdb82f93
PJ
4991bottom of the window. (ARG should be less than the height of the window.)
4992
666e158e
MB
4993If ARG is omitted or nil, then recenter with point on the middle line of
4994the selected window; if the variable `recenter-redisplay' is non-nil,
4995also erase the entire frame and redraw it (when `auto-resize-tool-bars'
4996is set to `grow-only', this resets the tool-bar's height to the minimum
4997height needed); if `recenter-redisplay' has the special value `tty',
53524d93 4998then only tty frames are redrawn.
7d1d98ee 4999
fdb82f93
PJ
5000Just C-u as prefix means put point in the center of the window
5001and redisplay normally--don't erase and redraw the frame. */)
5842a27b 5002 (register Lisp_Object arg)
7ab12479 5003{
6df47b59 5004 struct window *w = XWINDOW (selected_window);
478292ed
RS
5005 struct buffer *buf = XBUFFER (w->buffer);
5006 struct buffer *obuf = current_buffer;
6df47b59 5007 int center_p = 0;
2452438f 5008 EMACS_INT charpos, bytepos;
71f02bc5 5009 EMACS_INT iarg IF_LINT (= 0);
f6b43440 5010 int this_scroll_margin;
7ab12479 5011
0fa5d25b
RS
5012 /* If redisplay is suppressed due to an error, try again. */
5013 obuf->display_error_modiff = 0;
5014
413430c5 5015 if (NILP (arg))
7ab12479 5016 {
666e158e
MB
5017 if (!NILP (Vrecenter_redisplay)
5018 && (!EQ (Vrecenter_redisplay, Qtty)
5019 || !NILP (Ftty_type (selected_frame))))
5020 {
ebfa62c0 5021 ptrdiff_t i;
f02d6d5c 5022
666e158e
MB
5023 /* Invalidate pixel data calculated for all compositions. */
5024 for (i = 0; i < n_compositions; i++)
5025 composition_table[i]->font = NULL;
7ab12479 5026
666e158e
MB
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 }
7d1d98ee 5032
6df47b59 5033 center_p = 1;
7ab12479 5034 }
413430c5 5035 else if (CONSP (arg)) /* Just C-u. */
6df47b59 5036 center_p = 1;
7ab12479
JB
5037 else
5038 {
413430c5 5039 arg = Fprefix_numeric_value (arg);
b7826503 5040 CHECK_NUMBER (arg);
ae12ecd7 5041 iarg = XINT (arg);
7ab12479
JB
5042 }
5043
478292ed 5044 set_buffer_internal (buf);
7ab12479 5045
f6b43440
RS
5046 /* Do this after making BUF current
5047 in case scroll_margin is buffer-local. */
71f02bc5
PE
5048 this_scroll_margin =
5049 max (0, min (scroll_margin, XFASTINT (w->total_lines) / 4));
f6b43440 5050
521b203e 5051 /* Handle centering on a graphical frame specially. Such frames can
6df47b59
GM
5052 have variable-height lines and centering point on the basis of
5053 line counts would lead to strange effects. */
521b203e 5054 if (FRAME_WINDOW_P (XFRAME (w->frame)))
6df47b59 5055 {
6df47b59
GM
5056 if (center_p)
5057 {
521b203e
GM
5058 struct it it;
5059 struct text_pos pt;
57b3e30b 5060 void *itdata = bidi_shelve_cache ();
177c0ea7 5061
521b203e
GM
5062 SET_TEXT_POS (pt, PT, PT_BYTE);
5063 start_display (&it, w, pt);
f204989e 5064 move_it_vertically_backward (&it, window_box_height (w) / 2);
521b203e
GM
5065 charpos = IT_CHARPOS (it);
5066 bytepos = IT_BYTEPOS (it);
35928349 5067 bidi_unshelve_cache (itdata, 0);
6df47b59 5068 }
f6b43440 5069 else if (iarg < 0)
6df47b59 5070 {
521b203e
GM
5071 struct it it;
5072 struct text_pos pt;
71f02bc5 5073 int nlines = min (INT_MAX, -iarg);
f204989e
KS
5074 int extra_line_spacing;
5075 int h = window_box_height (w);
57b3e30b 5076 void *itdata = bidi_shelve_cache ();
177c0ea7 5077
f6b43440
RS
5078 iarg = - max (-iarg, this_scroll_margin);
5079
521b203e
GM
5080 SET_TEXT_POS (pt, PT, PT_BYTE);
5081 start_display (&it, w, pt);
f204989e
KS
5082
5083 /* Be sure we have the exact height of the full line containing PT. */
e4cc2dfc 5084 move_it_by_lines (&it, 0);
521b203e 5085
d466fa4d 5086 /* The amount of pixels we have to move back is the window
521b203e
GM
5087 height minus what's displayed in the line containing PT,
5088 and the lines below. */
f204989e
KS
5089 it.current_y = 0;
5090 it.vpos = 0;
e4cc2dfc 5091 move_it_by_lines (&it, nlines);
d466fa4d 5092
f204989e
KS
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;
d466fa4d
GM
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)
f204989e
KS
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)
57b3e30b 5114 {
35928349 5115 bidi_unshelve_cache (itdata, 0);
57b3e30b
EZ
5116 return Qnil;
5117 }
201c831a 5118
f204989e 5119 /* Now find the new top line (starting position) of the window. */
521b203e 5120 start_display (&it, w, pt);
f204989e
KS
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)
e4cc2dfc 5133 move_it_by_lines (&it, 1);
f204989e 5134
521b203e
GM
5135 charpos = IT_CHARPOS (it);
5136 bytepos = IT_BYTEPOS (it);
57b3e30b 5137
35928349 5138 bidi_unshelve_cache (itdata, 0);
6df47b59 5139 }
521b203e
GM
5140 else
5141 {
5142 struct position pos;
f6b43440 5143
f6b43440
RS
5144 iarg = max (iarg, this_scroll_margin);
5145
5146 pos = *vmotion (PT, -iarg, w);
521b203e
GM
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)
a4429c5b 5157 iarg = ht / 2;
f567c488
KS
5158 else if (iarg < 0)
5159 iarg += ht;
f6b43440
RS
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);
177c0ea7 5164
f6b43440 5165 pos = *vmotion (PT, - iarg, w);
6df47b59
GM
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);
2f3cad6c 5172 w->window_end_valid = Qnil;
177c0ea7 5173
95605b1b
RS
5174 w->optional_new_start = Qt;
5175
6df47b59
GM
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;
177c0ea7 5180
478292ed 5181 set_buffer_internal (obuf);
7ab12479
JB
5182 return Qnil;
5183}
b7617575 5184
81fe0836 5185DEFUN ("window-text-height", Fwindow_text_height, Swindow_text_height,
fdb82f93
PJ
5186 0, 1, 0,
5187 doc: /* Return the height in lines of the text display area of WINDOW.
105216ed 5188If WINDOW is omitted or nil, it defaults to the selected window.
8fef9de1 5189
105216ed
CY
5190The returned height does not include the mode line, any header line,
5191nor any partial-height lines at the bottom of the text area. */)
5842a27b 5192 (Lisp_Object window)
81fe0836
MB
5193{
5194 struct window *w = decode_window (window);
5195 int pixel_height = window_box_height (w);
949cf20f 5196 int line_height = pixel_height / FRAME_LINE_HEIGHT (XFRAME (w->frame));
81fe0836
MB
5197 return make_number (line_height);
5198}
5199
5200
7ab12479
JB
5201\f
5202DEFUN ("move-to-window-line", Fmove_to_window_line, Smove_to_window_line,
fdb82f93
PJ
5203 1, 1, "P",
5204 doc: /* Position point relative to window.
87e68db4
JB
5205ARG nil means position point at center of window.
5206Else, ARG specifies vertical position within the window;
fdb82f93 5207zero means top of window, negative means relative to bottom of window. */)
5842a27b 5208 (Lisp_Object arg)
7ab12479 5209{
b7617575
GM
5210 struct window *w = XWINDOW (selected_window);
5211 int lines, start;
540b6aa0 5212 Lisp_Object window;
f6b43440
RS
5213#if 0
5214 int this_scroll_margin;
5215#endif
7ab12479 5216
794b75c7
SM
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");
6dc1d2d3 5222
b7617575 5223 window = selected_window;
7ab12479
JB
5224 start = marker_position (w->start);
5225 if (start < BEGV || start > ZV)
5226 {
b7617575 5227 int height = window_internal_height (w);
cd2be1dd 5228 Fvertical_motion (make_number (- (height / 2)), window);
b73ea88e 5229 set_marker_both (w->start, w->buffer, PT, PT_BYTE);
7ab12479
JB
5230 w->start_at_line_beg = Fbolp ();
5231 w->force_start = Qt;
5232 }
5233 else
b73ea88e 5234 Fgoto_char (w->start);
7ab12479 5235
b7617575 5236 lines = displayed_window_lines (w);
f6b43440
RS
5237
5238#if 0
71f02bc5 5239 this_scroll_margin = max (0, min (scroll_margin, lines / 4));
f6b43440
RS
5240#endif
5241
b7617575
GM
5242 if (NILP (arg))
5243 XSETFASTINT (arg, lines / 2);
5244 else
5245 {
71f02bc5 5246 EMACS_INT iarg = XINT (Fprefix_numeric_value (arg));
f6b43440
RS
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);
b7617575
GM
5263 }
5264
c8bc6f65 5265 /* Skip past a partially visible first line. */
163784df 5266 if (w->vscroll)
163784df
MB
5267 XSETINT (arg, XINT (arg) + 1);
5268
540b6aa0 5269 return Fvertical_motion (arg, window);
7ab12479 5270}
5500c422
GM
5271
5272
7ab12479 5273\f
5500c422
GM
5274/***********************************************************************
5275 Window Configuration
5276 ***********************************************************************/
5277
7ab12479
JB
5278struct save_window_data
5279 {
b102ceb1 5280 struct vectorlike_header header;
bdc727bf 5281 Lisp_Object selected_frame;
7ab12479
JB
5282 Lisp_Object current_window;
5283 Lisp_Object current_buffer;
5284 Lisp_Object minibuf_scroll_window;
3f49fddc 5285 Lisp_Object minibuf_selected_window;
7ab12479 5286 Lisp_Object root_window;
bdc727bf 5287 Lisp_Object focus_frame;
cbff28e8
RS
5288 /* A vector, each of whose elements is a struct saved_window
5289 for one window. */
7ab12479 5290 Lisp_Object saved_windows;
b05b4e27
SM
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;
7ab12479 5297 };
ff06df24 5298
cbff28e8 5299/* This is saved as a Lisp_Vector */
7ab12479 5300struct saved_window
ea68264b 5301{
b102ceb1 5302 struct vectorlike_header header;
496e208e 5303
28545e04 5304 Lisp_Object window, buffer, start, pointm, mark;
949cf20f 5305 Lisp_Object left_col, top_line, total_cols, total_lines;
496e208e 5306 Lisp_Object normal_cols, normal_lines;
949cf20f 5307 Lisp_Object hscroll, min_hscroll;
ea68264b
GM
5308 Lisp_Object parent, prev;
5309 Lisp_Object start_at_line_beg;
5310 Lisp_Object display_table;
949cf20f
KS
5311 Lisp_Object left_margin_cols, right_margin_cols;
5312 Lisp_Object left_fringe_width, right_fringe_width, fringes_outside_margins;
562dd5e9 5313 Lisp_Object scroll_bar_width, vertical_scroll_bar_type, dedicated;
b6f67890 5314 Lisp_Object combination_limit, window_parameters;
ea68264b
GM
5315};
5316
7ab12479
JB
5317#define SAVED_WINDOW_N(swv,n) \
5318 ((struct saved_window *) (XVECTOR ((swv)->contents[(n)])))
5319
5320DEFUN ("window-configuration-p", Fwindow_configuration_p, Swindow_configuration_p, 1, 1, 0,
fdb82f93 5321 doc: /* Return t if OBJECT is a window-configuration object. */)
5842a27b 5322 (Lisp_Object object)
7ab12479 5323{
6ad0381c 5324 return WINDOW_CONFIGURATIONP (object) ? Qt : Qnil;
7ab12479
JB
5325}
5326
3f8ab7bd 5327DEFUN ("window-configuration-frame", Fwindow_configuration_frame, Swindow_configuration_frame, 1, 1, 0,
fdb82f93 5328 doc: /* Return the frame that CONFIG, a window-configuration object, is about. */)
5842a27b 5329 (Lisp_Object config)
3f8ab7bd
RS
5330{
5331 register struct save_window_data *data;
5332 struct Lisp_Vector *saved_windows;
5333
663fbbba 5334 CHECK_WINDOW_CONFIGURATION (config);
3f8ab7bd
RS
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
a7ca3326 5341DEFUN ("set-window-configuration", Fset_window_configuration,
fdb82f93
PJ
5342 Sset_window_configuration, 1, 1, 0,
5343 doc: /* Set the configuration of windows and buffers as specified by CONFIGURATION.
5344CONFIGURATION must be a value previously returned
5345by `current-window-configuration' (which see).
5346If CONFIGURATION was made from a frame that is now deleted,
5347only frame-independent values can be restored. In this case,
5348the return value is nil. Otherwise the value is t. */)
5842a27b 5349 (Lisp_Object configuration)
7ab12479 5350{
7ab12479
JB
5351 register struct save_window_data *data;
5352 struct Lisp_Vector *saved_windows;
7ab12479 5353 Lisp_Object new_current_buffer;
fd482be5 5354 Lisp_Object frame;
6198ccd0 5355 Lisp_Object auto_buffer_name;
44fa5b1e 5356 FRAME_PTR f;
2452438f 5357 EMACS_INT old_point = -1;
7ab12479 5358
663fbbba 5359 CHECK_WINDOW_CONFIGURATION (configuration);
7ab12479 5360
2f83aebe 5361 data = (struct save_window_data *) XVECTOR (configuration);
7ab12479
JB
5362 saved_windows = XVECTOR (data->saved_windows);
5363
7ab12479 5364 new_current_buffer = data->current_buffer;
4b4deea2 5365 if (NILP (BVAR (XBUFFER (new_current_buffer), name)))
7ab12479 5366 new_current_buffer = Qnil;
72695e47 5367 else
73cadfc1
DK
5368 {
5369 if (XBUFFER (new_current_buffer) == current_buffer)
e67a1dea
SM
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;
73cadfc1 5387 else
203eb0aa
SM
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));
73cadfc1 5402 }
7ab12479 5403
fd482be5
JB
5404 frame = XWINDOW (SAVED_WINDOW_N (saved_windows, 0)->window)->frame;
5405 f = XFRAME (frame);
177c0ea7 5406
fd482be5
JB
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))
7ab12479 5410 {
6198ccd0
MR
5411 Lisp_Object window;
5412 Lisp_Object dead_windows = Qnil;
fd482be5
JB
5413 register struct window *w;
5414 register struct saved_window *p;
5500c422
GM
5415 struct window *root_window;
5416 struct window **leaf_windows;
5417 int n_leaf_windows;
71f02bc5
PE
5418 ptrdiff_t k;
5419 int i, n;
fd482be5
JB
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. */
949cf20f
KS
5425 int previous_frame_lines = FRAME_LINES (f);
5426 int previous_frame_cols = FRAME_COLS (f);
8f6ea2e9 5427 int previous_frame_menu_bar_lines = FRAME_MENU_BAR_LINES (f);
9ea173e8 5428 int previous_frame_tool_bar_lines = FRAME_TOOL_BAR_LINES (f);
fd482be5 5429
d2b35234
RS
5430 /* The mouse highlighting code could get screwed up
5431 if it runs during this. */
5432 BLOCK_INPUT;
5433
b05b4e27
SM
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);
e3678b64 5438#if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
b05b4e27 5439 if (data->frame_menu_bar_lines
8f6ea2e9 5440 != previous_frame_menu_bar_lines)
b05b4e27
SM
5441 x_set_menu_bar_lines (f, make_number (data->frame_menu_bar_lines),
5442 make_number (0));
4314246f 5443#ifdef HAVE_WINDOW_SYSTEM
b05b4e27 5444 if (data->frame_tool_bar_lines
9ea173e8 5445 != previous_frame_tool_bar_lines)
b05b4e27
SM
5446 x_set_tool_bar_lines (f, make_number (data->frame_tool_bar_lines),
5447 make_number (0));
4314246f 5448#endif
217f2871 5449#endif
fd482be5 5450
a46c0153
RS
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
719eaeb1
GM
5454 restoring the window contents, and prevent it from
5455 being done later on when we select a new window. */
596ae0cf
RS
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
fd482be5 5465 windows_or_buffers_changed++;
29aeee73 5466 FRAME_WINDOW_SIZES_CHANGED (f) = 1;
fd482be5 5467
5500c422 5468 /* Problem: Freeing all matrices and later allocating them again
177c0ea7 5469 is a serious redisplay flickering problem. What we would
5500c422 5470 really like to do is to free only those matrices not reused
9d14503e 5471 below. */
5500c422
GM
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
fd482be5
JB
5478 /* Kludge Alert!
5479 Mark all windows now on frame as "deleted".
5480 Restoring the new configuration "undeletes" any that are in it.
37962e60 5481
fd482be5
JB
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. */
be7f5545 5485 delete_all_child_windows (FRAME_ROOT_WINDOW (f));
fd482be5 5486
eab3844f 5487 for (k = 0; k < saved_windows->header.size; k++)
fd482be5
JB
5488 {
5489 p = SAVED_WINDOW_N (saved_windows, k);
6198ccd0
MR
5490 window = p->window;
5491 w = XWINDOW (window);
fd482be5 5492 w->next = Qnil;
7ab12479 5493
fd482be5
JB
5494 if (!NILP (p->parent))
5495 w->parent = SAVED_WINDOW_N (saved_windows,
5496 XFASTINT (p->parent))->window;
5497 else
5498 w->parent = Qnil;
7ab12479 5499
fd482be5 5500 if (!NILP (p->prev))
7ab12479 5501 {
fd482be5
JB
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 {
949cf20f 5511 if (EQ (p->total_cols, XWINDOW (w->parent)->total_cols))
fd482be5
JB
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. */
949cf20f
KS
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;
496e208e
MR
5532 w->normal_cols = p->normal_cols;
5533 w->normal_lines = p->normal_lines;
fd482be5 5534 w->hscroll = p->hscroll;
ea68264b 5535 w->min_hscroll = p->min_hscroll;
fd482be5 5536 w->display_table = p->display_table;
949cf20f
KS
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;
6ad0381c 5544 w->dedicated = p->dedicated;
b6f67890 5545 w->combination_limit = p->combination_limit;
496e208e 5546 w->window_parameters = p->window_parameters;
d834a2e9 5547 XSETFASTINT (w->last_modified, 0);
3cd21523 5548 XSETFASTINT (w->last_overlay_modified, 0);
fd482be5
JB
5549
5550 /* Reinstall the saved buffer and pointers into it. */
5551 if (NILP (p->buffer))
6198ccd0 5552 /* An internal window. */
fd482be5 5553 w->buffer = p->buffer;
6198ccd0
MR
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 }
fd482be5 5594 else
6198ccd0 5595 /* Window has no live buffer, get one. */
fd482be5 5596 {
6198ccd0
MR
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;
7ab12479
JB
5612 }
5613 }
9ace597f 5614
fd482be5 5615 FRAME_ROOT_WINDOW (f) = data->root_window;
a46c0153
RS
5616 /* Arrange *not* to restore point in the buffer that was
5617 current when the window configuration was saved. */
243a5ce6
RS
5618 if (EQ (XWINDOW (data->current_window)->buffer, new_current_buffer))
5619 set_marker_restricted (XWINDOW (data->current_window)->pointm,
18787f5e 5620 make_number (old_point),
243a5ce6 5621 XWINDOW (data->current_window)->buffer);
177c0ea7 5622
6198ccd0
MR
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. */
e6b84b30 5627 select_window (data->current_window, Qnil, 1);
4b4deea2 5628 BVAR (XBUFFER (XWINDOW (selected_window)->buffer), last_selected_window)
396a830c 5629 = selected_window;
7ab12479 5630
db269683 5631 if (NILP (data->focus_frame)
017b2bad 5632 || (FRAMEP (data->focus_frame)
db269683
JB
5633 && FRAME_LIVE_P (XFRAME (data->focus_frame))))
5634 Fredirect_frame_focus (frame, data->focus_frame);
7ab12479 5635
fd482be5 5636 /* Set the screen height to the value it had before this function. */
949cf20f
KS
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,
2b653806 5640 0, 0, 0);
e3678b64 5641#if defined (HAVE_WINDOW_SYSTEM) || defined (MSDOS)
8f6ea2e9 5642 if (previous_frame_menu_bar_lines != FRAME_MENU_BAR_LINES (f))
f8ad443a
AS
5643 x_set_menu_bar_lines (f, make_number (previous_frame_menu_bar_lines),
5644 make_number (0));
4314246f 5645#ifdef HAVE_WINDOW_SYSTEM
9ea173e8
GM
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));
4314246f 5649#endif
217f2871 5650#endif
d2b35234 5651
5500c422 5652 /* Now, free glyph matrices in windows that were not reused. */
c4280705
GM
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. */
177c0ea7 5658 xassert (NILP (leaf_windows[i]->hchild)
c4280705
GM
5659 && NILP (leaf_windows[i]->vchild));
5660 free_window_matrices (leaf_windows[i]);
c4280705
GM
5661 }
5662 else if (EQ (leaf_windows[i]->buffer, new_current_buffer))
5663 ++n;
5664 }
177c0ea7 5665
5500c422 5666 adjust_glyphs (f);
d2b35234 5667 UNBLOCK_INPUT;
756b6edc 5668
6198ccd0
MR
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
478292ed
RS
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)))
c6932ecd 5683 do_switch_frame (data->selected_frame, 0, 0, Qnil);
478292ed 5684
eeca6f6f 5685 run_window_configuration_change_hook (f);
478292ed 5686 }
bdc727bf
JB
5687
5688 if (!NILP (new_current_buffer))
243a5ce6 5689 Fset_buffer (new_current_buffer);
bdc727bf 5690
478292ed 5691 Vminibuf_scroll_window = data->minibuf_scroll_window;
3dbab091 5692 minibuf_selected_window = data->minibuf_selected_window;
543f5fb1 5693
3f8ab7bd 5694 return (FRAME_LIVE_P (f) ? Qt : Qnil);
7ab12479
JB
5695}
5696
562dd5e9 5697
be7f5545
MR
5698/* Recursively delete all child windows reachable via the next, vchild,
5699 and hchild slots of WINDOW. */
fd482be5 5700void
be7f5545 5701delete_all_child_windows (Lisp_Object window)
7ab12479 5702{
fa8a67e6
MR
5703 register struct window *w;
5704
5705 w = XWINDOW (window);
5706
265a9e55 5707 if (!NILP (w->next))
fa8a67e6 5708 /* Delete WINDOW's siblings (we traverse postorderly). */
be7f5545 5709 delete_all_child_windows (w->next);
605be8af 5710
949cf20f 5711 w->total_lines = w->buffer; /* See Fset_window_configuration for excuse. */
605be8af 5712
fa8a67e6
MR
5713 if (!NILP (w->vchild))
5714 {
be7f5545 5715 delete_all_child_windows (w->vchild);
fa8a67e6
MR
5716 w->vchild = Qnil;
5717 }
5718 else if (!NILP (w->hchild))
5719 {
be7f5545 5720 delete_all_child_windows (w->hchild);
fa8a67e6
MR
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 }
acf70840
GM
5730
5731 Vwindow_list = Qnil;
7ab12479
JB
5732}
5733\f
5734static int
971de7fb 5735count_windows (register struct window *window)
7ab12479
JB
5736{
5737 register int count = 1;
265a9e55 5738 if (!NILP (window->next))
7ab12479 5739 count += count_windows (XWINDOW (window->next));
265a9e55 5740 if (!NILP (window->vchild))
7ab12479 5741 count += count_windows (XWINDOW (window->vchild));
265a9e55 5742 if (!NILP (window->hchild))
7ab12479
JB
5743 count += count_windows (XWINDOW (window->hchild));
5744 return count;
5745}
5746
5500c422 5747
177c0ea7 5748/* Fill vector FLAT with leaf windows under W, starting at index I.
5500c422 5749 Value is last index + 1. */
5500c422 5750static int
971de7fb 5751get_leaf_windows (struct window *w, struct window **flat, int i)
5500c422
GM
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);
177c0ea7 5759 else
5500c422
GM
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
c80e3b4a 5770 null if W's current matrix is invalid, so that no meaningful glyph
5500c422 5771 can be returned. */
5500c422 5772struct glyph *
971de7fb 5773get_phys_cursor_glyph (struct window *w)
5500c422
GM
5774{
5775 struct glyph_row *row;
5776 struct glyph *glyph;
f8fe6f96 5777 int hpos = w->phys_cursor.hpos;
5500c422 5778
f8fe6f96
EZ
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
b0d15b4f 5787 if (XINT (w->hscroll))
f8fe6f96
EZ
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;
5500c422
GM
5801 else
5802 glyph = NULL;
5803
5804 return glyph;
5805}
5806
5807
7ab12479 5808static int
971de7fb 5809save_window_save (Lisp_Object window, struct Lisp_Vector *vector, int i)
7ab12479
JB
5810{
5811 register struct saved_window *p;
5812 register struct window *w;
5813 register Lisp_Object tem;
5814
265a9e55 5815 for (;!NILP (window); window = w->next)
7ab12479
JB
5816 {
5817 p = SAVED_WINDOW_N (vector, i);
5818 w = XWINDOW (window);
5819
2a1893f4 5820 XSETFASTINT (w->temslot, i); i++;
7ab12479
JB
5821 p->window = window;
5822 p->buffer = w->buffer;
949cf20f
KS
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;
496e208e
MR
5827 p->normal_cols = w->normal_cols;
5828 p->normal_lines = w->normal_lines;
7ab12479 5829 p->hscroll = w->hscroll;
ea68264b 5830 p->min_hscroll = w->min_hscroll;
7ab12479 5831 p->display_table = w->display_table;
949cf20f
KS
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;
6ad0381c 5839 p->dedicated = w->dedicated;
b6f67890 5840 p->combination_limit = w->combination_limit;
496e208e 5841 p->window_parameters = w->window_parameters;
265a9e55 5842 if (!NILP (w->buffer))
7ab12479
JB
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 ();
b73ea88e
RS
5850 set_marker_both (p->pointm, w->buffer,
5851 BUF_PT (XBUFFER (w->buffer)),
5852 BUF_PT_BYTE (XBUFFER (w->buffer)));
7ab12479
JB
5853 }
5854 else
eeb82665 5855 p->pointm = Fcopy_marker (w->pointm, Qnil);
7ab12479 5856
eeb82665 5857 p->start = Fcopy_marker (w->start, Qnil);
7ab12479
JB
5858 p->start_at_line_beg = w->start_at_line_beg;
5859
4b4deea2 5860 tem = BVAR (XBUFFER (w->buffer), mark);
eeb82665 5861 p->mark = Fcopy_marker (tem, Qnil);
7ab12479
JB
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
265a9e55 5871 if (NILP (w->parent))
7ab12479
JB
5872 p->parent = Qnil;
5873 else
5874 p->parent = XWINDOW (w->parent)->temslot;
5875
265a9e55 5876 if (NILP (w->prev))
7ab12479
JB
5877 p->prev = Qnil;
5878 else
5879 p->prev = XWINDOW (w->prev)->temslot;
5880
265a9e55 5881 if (!NILP (w->vchild))
7ab12479 5882 i = save_window_save (w->vchild, vector, i);
265a9e55 5883 if (!NILP (w->hchild))
7ab12479
JB
5884 i = save_window_save (w->hchild, vector, i);
5885 }
5886
5887 return i;
5888}
5889
a7ca3326 5890DEFUN ("current-window-configuration", Fcurrent_window_configuration,
fdb82f93
PJ
5891 Scurrent_window_configuration, 0, 1, 0,
5892 doc: /* Return an object representing the current window configuration of FRAME.
5893If FRAME is nil or omitted, use the selected frame.
5894This describes the number of windows, their sizes and current buffers,
5895and for each displayed buffer, where display starts, and the positions of
5896point and mark. An exception is made for point in the current buffer:
5897its value is -not- saved.
5898This also records the currently selected frame, and FRAME's focus
5899redirection (see `redirect-frame-focus'). */)
5842a27b 5900 (Lisp_Object frame)
7ab12479
JB
5901{
5902 register Lisp_Object tem;
5903 register int n_windows;
5904 register struct save_window_data *data;
5905 register int i;
44fa5b1e 5906 FRAME_PTR f;
43bad991 5907
44fa5b1e 5908 if (NILP (frame))
1ae1a37d 5909 frame = selected_frame;
b7826503 5910 CHECK_LIVE_FRAME (frame);
1ae1a37d 5911 f = XFRAME (frame);
7ab12479 5912
44fa5b1e 5913 n_windows = count_windows (XWINDOW (FRAME_ROOT_WINDOW (f)));
b05b4e27
SM
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);
1ae1a37d 5921 data->selected_frame = selected_frame;
44fa5b1e 5922 data->current_window = FRAME_SELECTED_WINDOW (f);
74112613 5923 XSETBUFFER (data->current_buffer, current_buffer);
3f49fddc 5924 data->minibuf_scroll_window = minibuf_level > 0 ? Vminibuf_scroll_window : Qnil;
3dbab091 5925 data->minibuf_selected_window = minibuf_level > 0 ? minibuf_selected_window : Qnil;
44fa5b1e 5926 data->root_window = FRAME_ROOT_WINDOW (f);
bdc727bf 5927 data->focus_frame = FRAME_FOCUS_FRAME (f);
7ab12479
JB
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]
8a450f0a 5932 = Fmake_vector (make_number (VECSIZE (struct saved_window)), Qnil);
a1d58e5b 5933 save_window_save (FRAME_ROOT_WINDOW (f), XVECTOR (tem), 0);
74112613 5934 XSETWINDOW_CONFIGURATION (tem, data);
7ab12479
JB
5935 return (tem);
5936}
5500c422
GM
5937\f
5938/***********************************************************************
5939 Marginal Areas
5940 ***********************************************************************/
5941
5942DEFUN ("set-window-margins", Fset_window_margins, Sset_window_margins,
a7bdfc08 5943 2, 3, 0,
fdb82f93 5944 doc: /* Set width of marginal areas of window WINDOW.
6b61353c
KH
5945If WINDOW is nil, set margins of the currently selected window.
5946Second arg LEFT-WIDTH specifies the number of character cells to
5947reserve for the left marginal area. Optional third arg RIGHT-WIDTH
5948does the same for the right marginal area. A nil width parameter
5949means no margin. */)
5842a27b 5950 (Lisp_Object window, Lisp_Object left_width, Lisp_Object right_width)
5500c422
GM
5951{
5952 struct window *w = decode_window (window);
5500c422 5953
6b61353c
KH
5954 /* Translate negative or zero widths to nil.
5955 Margins that are too wide have to be checked elsewhere. */
949cf20f 5956
c10ce82e 5957 if (!NILP (left_width))
6b61353c 5958 {
c10ce82e
JB
5959 CHECK_NUMBER (left_width);
5960 if (XINT (left_width) <= 0)
5961 left_width = Qnil;
6b61353c 5962 }
5500c422 5963
c10ce82e 5964 if (!NILP (right_width))
6b61353c 5965 {
c10ce82e
JB
5966 CHECK_NUMBER (right_width);
5967 if (XINT (right_width) <= 0)
5968 right_width = Qnil;
6b61353c 5969 }
5500c422 5970
c10ce82e
JB
5971 if (!EQ (w->left_margin_cols, left_width)
5972 || !EQ (w->right_margin_cols, right_width))
949cf20f 5973 {
c10ce82e
JB
5974 w->left_margin_cols = left_width;
5975 w->right_margin_cols = right_width;
949cf20f
KS
5976
5977 adjust_window_margins (w);
5978
5979 ++windows_or_buffers_changed;
5980 adjust_glyphs (XFRAME (WINDOW_FRAME (w)));
5981 }
5500c422 5982
5500c422
GM
5983 return Qnil;
5984}
5985
5986
5987DEFUN ("window-margins", Fwindow_margins, Swindow_margins,
5988 0, 1, 0,
fdb82f93 5989 doc: /* Get width of marginal areas of window WINDOW.
49745b39 5990If WINDOW is omitted or nil, it defaults to the selected window.
fdb82f93
PJ
5991Value is a cons of the form (LEFT-WIDTH . RIGHT-WIDTH).
5992If a marginal area does not exist, its width will be returned
5993as nil. */)
5842a27b 5994 (Lisp_Object window)
5500c422
GM
5995{
5996 struct window *w = decode_window (window);
949cf20f
KS
5997 return Fcons (w->left_margin_cols, w->right_margin_cols);
5998}
5999
6000
6001\f
6002/***********************************************************************
6003 Fringes
6004 ***********************************************************************/
6005
a7ca3326 6006DEFUN ("set-window-fringes", Fset_window_fringes, Sset_window_fringes,
949cf20f 6007 2, 4, 0,
6b61353c
KH
6008 doc: /* Set the fringe widths of window WINDOW.
6009If WINDOW is nil, set the fringe widths of the currently selected
6010window.
6011Second arg LEFT-WIDTH specifies the number of pixels to reserve for
6012the left fringe. Optional third arg RIGHT-WIDTH specifies the right
6013fringe width. If a fringe width arg is nil, that means to use the
6014frame's default fringe width. Default fringe widths can be set with
6015the command `set-fringe-style'.
6016If optional fourth arg OUTSIDE-MARGINS is non-nil, draw the fringes
6017outside of the display margins. By default, fringes are drawn between
6018display marginal areas and the text area. */)
5842a27b 6019 (Lisp_Object window, Lisp_Object left_width, Lisp_Object right_width, Lisp_Object outside_margins)
949cf20f
KS
6020{
6021 struct window *w = decode_window (window);
6022
c10ce82e
JB
6023 if (!NILP (left_width))
6024 CHECK_NATNUM (left_width);
6025 if (!NILP (right_width))
6026 CHECK_NATNUM (right_width);
5a857365 6027
017e297e 6028 /* Do nothing on a tty. */
d46c6df5
NR
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)))
949cf20f 6033 {
c10ce82e
JB
6034 w->left_fringe_width = left_width;
6035 w->right_fringe_width = right_width;
949cf20f
KS
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
6051DEFUN ("window-fringes", Fwindow_fringes, Swindow_fringes,
6052 0, 1, 0,
6053 doc: /* Get width of fringes of window WINDOW.
49745b39 6054If WINDOW is omitted or nil, it defaults to the selected window.
6b61353c 6055Value is a list of the form (LEFT-WIDTH RIGHT-WIDTH OUTSIDE-MARGINS). */)
5842a27b 6056 (Lisp_Object window)
949cf20f
KS
6057{
6058 struct window *w = decode_window (window);
d46c6df5 6059
949cf20f
KS
6060 return Fcons (make_number (WINDOW_LEFT_FRINGE_WIDTH (w)),
6061 Fcons (make_number (WINDOW_RIGHT_FRINGE_WIDTH (w)),
d46c6df5
NR
6062 Fcons ((WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
6063 ? Qt : Qnil), Qnil)));
949cf20f
KS
6064}
6065
6066
6067\f
6068/***********************************************************************
6069 Scroll bars
6070 ***********************************************************************/
6071
a7ca3326 6072DEFUN ("set-window-scroll-bars", Fset_window_scroll_bars,
16a97296 6073 Sset_window_scroll_bars, 2, 4, 0,
949cf20f
KS
6074 doc: /* Set width and type of scroll bars of window WINDOW.
6075If window is nil, set scroll bars of the currently selected window.
6076Second parameter WIDTH specifies the pixel width for the scroll bar;
6077this is automatically adjusted to a multiple of the frame column width.
6078Third parameter VERTICAL-TYPE specifies the type of the vertical scroll
6079bar: left, right, or nil.
6b61353c 6080If WIDTH is nil, use the frame's scroll-bar width.
a53d44a8
JB
6081If VERTICAL-TYPE is t, use the frame's scroll-bar type.
6082Fourth parameter HORIZONTAL-TYPE is currently unused. */)
5842a27b 6083 (Lisp_Object window, Lisp_Object width, Lisp_Object vertical_type, Lisp_Object horizontal_type)
949cf20f
KS
6084{
6085 struct window *w = decode_window (window);
6086
6087 if (!NILP (width))
0f8fe9a2
SM
6088 {
6089 CHECK_NATNUM (width);
949cf20f 6090
0f8fe9a2
SM
6091 if (XINT (width) == 0)
6092 vertical_type = Qnil;
6093 }
949cf20f 6094
413a79ad 6095 if (!(NILP (vertical_type)
0cc1039f 6096 || EQ (vertical_type, Qleft)
6b61353c
KH
6097 || EQ (vertical_type, Qright)
6098 || EQ (vertical_type, Qt)))
6099 error ("Invalid type of vertical scroll bar");
6100
949cf20f
KS
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
6120DEFUN ("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.
49745b39 6123If WINDOW is omitted or nil, it defaults to the selected window.
6b61353c
KH
6124Value is a list of the form (WIDTH COLS VERTICAL-TYPE HORIZONTAL-TYPE).
6125If WIDTH is nil or TYPE is t, the window is using the frame's corresponding
6126value. */)
5842a27b 6127 (Lisp_Object window)
949cf20f
KS
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))));
5500c422
GM
6136}
6137
6138
7ab12479 6139\f
5500c422
GM
6140/***********************************************************************
6141 Smooth scrolling
6142 ***********************************************************************/
6143
0cc1039f 6144DEFUN ("window-vscroll", Fwindow_vscroll, Swindow_vscroll, 0, 2, 0,
fdb82f93 6145 doc: /* Return the amount by which WINDOW is scrolled vertically.
49745b39 6146If WINDOW is omitted or nil, it defaults to the selected window.
0cc1039f 6147Normally, value is a multiple of the canonical character height of WINDOW;
8cd0d661 6148optional second arg PIXELS-P means value is measured in pixels. */)
5842a27b 6149 (Lisp_Object window, Lisp_Object pixels_p)
5500c422 6150{
47004952 6151 Lisp_Object result;
5500c422
GM
6152 struct frame *f;
6153 struct window *w;
177c0ea7 6154
5500c422
GM
6155 if (NILP (window))
6156 window = selected_window;
47004952 6157 else
b7826503 6158 CHECK_WINDOW (window);
5500c422
GM
6159 w = XWINDOW (window);
6160 f = XFRAME (w->frame);
177c0ea7 6161
5500c422 6162 if (FRAME_WINDOW_P (f))
0cc1039f
KS
6163 result = (NILP (pixels_p)
6164 ? FRAME_CANON_Y_FROM_PIXEL_Y (f, -w->vscroll)
6165 : make_number (-w->vscroll));
5500c422 6166 else
47004952
GM
6167 result = make_number (0);
6168 return result;
5500c422
GM
6169}
6170
6171
6172DEFUN ("set-window-vscroll", Fset_window_vscroll, Sset_window_vscroll,
0cc1039f 6173 2, 3, 0,
fdb82f93 6174 doc: /* Set amount by which WINDOW should be scrolled vertically to VSCROLL.
0cc1039f
KS
6175WINDOW nil means use the selected window. Normally, VSCROLL is a
6176non-negative multiple of the canonical character height of WINDOW;
8cd0d661 6177optional third arg PIXELS-P non-nil means that VSCROLL is in pixels.
a0a37a6f
LT
6178If PIXELS-P is nil, VSCROLL may have to be rounded so that it
6179corresponds to an integral number of pixels. The return value is the
6180result of this rounding.
6181If PIXELS-P is non-nil, the return value is VSCROLL. */)
5842a27b 6182 (Lisp_Object window, Lisp_Object vscroll, Lisp_Object pixels_p)
5500c422
GM
6183{
6184 struct window *w;
6185 struct frame *f;
177c0ea7 6186
5500c422
GM
6187 if (NILP (window))
6188 window = selected_window;
47004952 6189 else
b7826503
PJ
6190 CHECK_WINDOW (window);
6191 CHECK_NUMBER_OR_FLOAT (vscroll);
177c0ea7 6192
5500c422
GM
6193 w = XWINDOW (window);
6194 f = XFRAME (w->frame);
6195
6196 if (FRAME_WINDOW_P (f))
6197 {
6198 int old_dy = w->vscroll;
177c0ea7 6199
0cc1039f
KS
6200 w->vscroll = - (NILP (pixels_p)
6201 ? FRAME_LINE_HEIGHT (f) * XFLOATINT (vscroll)
6202 : XFLOATINT (vscroll));
47004952 6203 w->vscroll = min (w->vscroll, 0);
5500c422 6204
e56263e5
KS
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);
177c0ea7 6211
e56263e5
KS
6212 /* Prevent redisplay shortcuts. */
6213 XBUFFER (w->buffer)->prevent_redisplay_optimizations_p = 1;
6214 }
5500c422 6215 }
177c0ea7 6216
0cc1039f 6217 return Fwindow_vscroll (window, pixels_p);
5500c422 6218}
177c0ea7 6219
7bbb5782
GM
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
f95464e4 6223 additional argument USER_DATA. Stops when FN returns 0. */
7bbb5782 6224
2f7c71a1
AS
6225static void
6226foreach_window (struct frame *f, int (*fn) (struct window *, void *),
6227 void *user_data)
7bbb5782 6228{
56f2de10 6229 /* delete_frame may set FRAME_ROOT_WINDOW (f) to Qnil. */
76fb556f
YM
6230 if (WINDOWP (FRAME_ROOT_WINDOW (f)))
6231 foreach_window_1 (XWINDOW (FRAME_ROOT_WINDOW (f)), fn, user_data);
7bbb5782
GM
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
f95464e4 6237 pointer to the leaf window, and with additional argument USER_DATA.
67492200 6238 Stop when FN returns 0. Value is 0 if stopped by FN. */
7bbb5782 6239
67492200 6240static int
971de7fb 6241foreach_window_1 (struct window *w, int (*fn) (struct window *, void *), void *user_data)
7bbb5782 6242{
67492200 6243 int cont;
177c0ea7 6244
67492200 6245 for (cont = 1; w && cont;)
7bbb5782
GM
6246 {
6247 if (!NILP (w->hchild))
f95464e4 6248 cont = foreach_window_1 (XWINDOW (w->hchild), fn, user_data);
7bbb5782 6249 else if (!NILP (w->vchild))
f95464e4 6250 cont = foreach_window_1 (XWINDOW (w->vchild), fn, user_data);
177c0ea7 6251 else
0f532a9a 6252 cont = fn (w, user_data);
177c0ea7 6253
7bbb5782
GM
6254 w = NILP (w->next) ? 0 : XWINDOW (w->next);
6255 }
67492200
GM
6256
6257 return cont;
7bbb5782
GM
6258}
6259
6260
6d194a45 6261/* Freeze or unfreeze the window start of W unless it is a
f95464e4 6262 mini-window or the selected window. FREEZE_P non-null means freeze
7bbb5782
GM
6263 the window start. */
6264
67492200 6265static int
971de7fb 6266freeze_window_start (struct window *w, void *freeze_p)
7bbb5782 6267{
08c1d235
SM
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)))))
f95464e4 6274 freeze_p = NULL;
177c0ea7 6275
f95464e4 6276 w->frozen_window_start_p = freeze_p != NULL;
67492200 6277 return 1;
7bbb5782
GM
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
6285void
971de7fb 6286freeze_window_starts (struct frame *f, int freeze_p)
7bbb5782 6287{
cbccabec 6288 foreach_window (f, freeze_window_start, (void *) (freeze_p ? f : 0));
7bbb5782 6289}
5500c422
GM
6290
6291\f
6292/***********************************************************************
6293 Initialization
6294 ***********************************************************************/
6295
6198ccd0
MR
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
e4769531 6302 This ignores a couple of things like the dedication status of
b6f67890
MR
6303 window, combination_limit and the like. This might have to be
6304 fixed. */
cbff28e8
RS
6305
6306int
6198ccd0 6307compare_window_configurations (Lisp_Object configuration1, Lisp_Object configuration2, int ignore_positions)
cbff28e8
RS
6308{
6309 register struct save_window_data *d1, *d2;
6198ccd0 6310 struct Lisp_Vector *sws1, *sws2;
71f02bc5 6311 ptrdiff_t i;
cbff28e8 6312
6198ccd0
MR
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)
cbff28e8 6333 return 0;
cbff28e8 6334
6198ccd0 6335 for (i = 0; i < sws1->header.size; i++)
cbff28e8 6336 {
6198ccd0 6337 struct saved_window *sw1, *sw2;
cbff28e8 6338
6198ccd0
MR
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))
949cf20f 6372 return 0;
cbff28e8
RS
6373 }
6374
6375 return 1;
6376}
2f8274be
RS
6377
6378DEFUN ("compare-window-configurations", Fcompare_window_configurations,
6379 Scompare_window_configurations, 2, 2, 0,
fdb82f93
PJ
6380 doc: /* Compare two window configurations as regards the structure of windows.
6381This function ignores details such as the values of point and mark
6382and scrolling positions. */)
5842a27b 6383 (Lisp_Object x, Lisp_Object y)
2f8274be
RS
6384{
6385 if (compare_window_configurations (x, y, 1))
6386 return Qt;
6387 return Qnil;
6388}
cbff28e8 6389\f
dfcf069d 6390void
971de7fb 6391init_window_once (void)
7ab12479 6392{
3224dac1 6393 struct frame *f = make_initial_frame ();
1ae1a37d
GM
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;
5b03d3c0
RS
6399
6400 window_initialized = 1;
7ab12479
JB
6401}
6402
67492200 6403void
971de7fb 6404init_window (void)
67492200
GM
6405{
6406 Vwindow_list = Qnil;
6407}
6408
dfcf069d 6409void
971de7fb 6410syms_of_window (void)
7ab12479 6411{
cd3520a4
JB
6412 DEFSYM (Qscroll_up, "scroll-up");
6413 DEFSYM (Qscroll_down, "scroll-down");
6414 DEFSYM (Qscroll_command, "scroll-command");
a4b000fb
JL
6415
6416 Fput (Qscroll_up, Qscroll_command, Qt);
6417 Fput (Qscroll_down, Qscroll_command, Qt);
6418
cd3520a4
JB
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");
5386012d
MR
6425 DEFSYM (Qwindow_resize_root_window, "window--resize-root-window");
6426 DEFSYM (Qwindow_resize_root_window_vertically, "window--resize-root-window-vertically");
cd3520a4
JB
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");
b9e809c2 6436
67492200 6437 staticpro (&Vwindow_list);
8bfb170b
KS
6438
6439 minibuf_selected_window = Qnil;
3dbab091 6440 staticpro (&minibuf_selected_window);
67492200 6441
c876b227 6442 window_scroll_pixel_based_preserve_x = -1;
66fe93d1 6443 window_scroll_pixel_based_preserve_y = -1;
c876b227
SM
6444 window_scroll_preserve_hpos = -1;
6445 window_scroll_preserve_vpos = -1;
66d43aea 6446
29208e82 6447 DEFVAR_LISP ("temp-buffer-show-function", Vtemp_buffer_show_function,
fdb82f93
PJ
6448 doc: /* Non-nil means call as function to display a help buffer.
6449The function is called with one argument, the buffer to be displayed.
6450Used by `with-output-to-temp-buffer'.
6451If this function is used, then it must do the entire job of showing
6452the buffer; `temp-buffer-show-hook' is not run unless this function runs it. */);
7ab12479 6453 Vtemp_buffer_show_function = Qnil;
e10ac9f1 6454
29208e82 6455 DEFVAR_LISP ("minibuffer-scroll-window", Vminibuf_scroll_window,
fdb82f93 6456 doc: /* Non-nil means it is the window that C-M-v in minibuffer should scroll. */);
7ab12479
JB
6457 Vminibuf_scroll_window = Qnil;
6458
29208e82 6459 DEFVAR_BOOL ("mode-line-in-non-selected-windows", mode_line_in_non_selected_windows,
26124d5e 6460 doc: /* Non-nil means to use `mode-line-inactive' face in non-selected windows.
cc91894c
KS
6461If the minibuffer is active, the `minibuffer-scroll-window' mode line
6462is displayed in the `mode-line' face. */);
6463 mode_line_in_non_selected_windows = 1;
26124d5e 6464
29208e82 6465 DEFVAR_LISP ("other-window-scroll-buffer", Vother_window_scroll_buffer,
fdb82f93 6466 doc: /* If non-nil, this is a buffer and \\[scroll-other-window] should scroll its window. */);
7ab12479
JB
6467 Vother_window_scroll_buffer = Qnil;
6468
29208e82 6469 DEFVAR_BOOL ("auto-window-vscroll", auto_window_vscroll_p,
e10ac9f1 6470 doc: /* Non-nil means to automatically adjust `window-vscroll' to view tall lines. */);
e56263e5
KS
6471 auto_window_vscroll_p = 1;
6472
29208e82 6473 DEFVAR_INT ("next-screen-context-lines", next_screen_context_lines,
e10ac9f1 6474 doc: /* Number of lines of continuity when scrolling by screenfuls. */);
7ab12479
JB
6475 next_screen_context_lines = 2;
6476
5500c422 6477 DEFVAR_LISP ("scroll-preserve-screen-position",
29208e82 6478 Vscroll_preserve_screen_position,
e10ac9f1 6479 doc: /* Controls if scroll commands move point to keep its screen position unchanged.
bdf4ec93
RS
6480A value of nil means point does not keep its screen position except
6481at the scroll margin or window boundary respectively.
6482A value of t means point keeps its screen position if the scroll
6483command moved it vertically out of the window, e.g. when scrolling
6484by full screens.
9013a7f8 6485Any other value means point always keeps its screen position.
a4b000fb
JL
6486Scroll commands should have the `scroll-command' property
6487on their symbols to be controlled by this variable. */);
5500c422 6488 Vscroll_preserve_screen_position = Qnil;
9317a85d 6489
29208e82 6490 DEFVAR_LISP ("window-point-insertion-type", Vwindow_point_insertion_type,
a1562258
SM
6491 doc: /* Type of marker to use for `window-point'. */);
6492 Vwindow_point_insertion_type = Qnil;
6493
543f5fb1 6494 DEFVAR_LISP ("window-configuration-change-hook",
29208e82 6495 Vwindow_configuration_change_hook,
fdb82f93 6496 doc: /* Functions to call when window configuration changes.
6a44ffb3
SM
6497The buffer-local part is run once per window, with the relevant window
6498selected; while the global part is run only once for the modified frame,
6499with the relevant frame selected. */);
543f5fb1
RS
6500 Vwindow_configuration_change_hook = Qnil;
6501
29208e82 6502 DEFVAR_LISP ("recenter-redisplay", Vrecenter_redisplay,
61d4b438
MR
6503 doc: /* Non-nil means `recenter' redraws entire frame.
6504If this option is non-nil, then the `recenter' command with a nil
6505argument will redraw the entire frame; the special value `tty' causes
6506the frame to be redrawn only if it is a tty frame. */);
666e158e
MB
6507 Vrecenter_redisplay = Qtty;
6508
a0c2d0ae 6509 DEFVAR_LISP ("window-combination-resize", Vwindow_combination_resize,
454592a6 6510 doc: /* If t, resize window combinations proportionally.
1a13852e 6511If this variable is nil, splitting a window gets the entire screen space
a0c2d0ae 6512for displaying the new window from the window to split. Deleting and
df85d315 6513resizing a window preferably resizes one adjacent window only.
a0c2d0ae 6514
454592a6 6515If this variable is t, splitting a window tries to get the space
a0c2d0ae
MR
6516proportionally from all windows in the same combination. This also
6517allows to split a window that is otherwise too small or of fixed size.
6518Resizing and deleting a window proportionally resize all windows in the
6519same combination.
1a13852e 6520
454592a6
MR
6521Other values are reserved for future use.
6522
b6f67890 6523This variable takes no effect if `window-combination-limit' is non-nil. */);
a0c2d0ae 6524 Vwindow_combination_resize = Qnil;
1a13852e 6525
b6f67890 6526 DEFVAR_LISP ("window-combination-limit", Vwindow_combination_limit,
454592a6 6527 doc: /* If t, splitting a window makes a new parent window.
1a13852e
MR
6528If this variable is nil, splitting a window will create a new parent
6529window only if the window has no parent window or the window shall
58179cce 6530become a combination orthogonal to the one it is part of.
1a13852e 6531
b6f67890
MR
6532If this variable is t, splitting a window always creates a new parent
6533window. If all splits behave this way, each frame's window tree is a
6534binary tree and every window but the frame's root window has exactly one
6535sibling.
1a13852e 6536
b6f67890
MR
6537Other values are reserved for future use.
6538
d2999b1a
MR
6539The value of this variable is also assigned to the combination limit of
6540the new parent window. The combination limit of a window can be
6541retrieved via the function `window-combination-limit' and altered by the
6542function `set-window-combination-limit'. */);
b6f67890 6543 Vwindow_combination_limit = Qnil;
666e158e 6544
7ab12479
JB
6545 defsubr (&Sselected_window);
6546 defsubr (&Sminibuffer_window);
6547 defsubr (&Swindow_minibuffer_p);
6548 defsubr (&Swindowp);
806b4d9b 6549 defsubr (&Swindow_live_p);
727e958e
MR
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);
7ab12479 6555 defsubr (&Spos_visible_in_window_p);
536833ab 6556 defsubr (&Swindow_line_height);
7ab12479 6557 defsubr (&Swindow_buffer);
bf60a96b 6558 defsubr (&Swindow_parent);
d68443dc
MR
6559 defsubr (&Swindow_top_child);
6560 defsubr (&Swindow_left_child);
6561 defsubr (&Swindow_next_sibling);
6562 defsubr (&Swindow_prev_sibling);
b6f67890
MR
6563 defsubr (&Swindow_combination_limit);
6564 defsubr (&Sset_window_combination_limit);
abde8f8c
MR
6565 defsubr (&Swindow_use_time);
6566 defsubr (&Swindow_top_line);
6567 defsubr (&Swindow_left_column);
105216ed
CY
6568 defsubr (&Swindow_total_height);
6569 defsubr (&Swindow_total_width);
496e208e
MR
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);
d615d6d2 6575 defsubr (&Swindow_resize_apply);
105216ed
CY
6576 defsubr (&Swindow_body_height);
6577 defsubr (&Swindow_body_width);
7ab12479
JB
6578 defsubr (&Swindow_hscroll);
6579 defsubr (&Sset_window_hscroll);
190eb263
RS
6580 defsubr (&Swindow_redisplay_end_trigger);
6581 defsubr (&Sset_window_redisplay_end_trigger);
7ab12479 6582 defsubr (&Swindow_edges);
c99a9eb3 6583 defsubr (&Swindow_pixel_edges);
9d5405ec 6584 defsubr (&Swindow_absolute_pixel_edges);
c99a9eb3
RS
6585 defsubr (&Swindow_inside_edges);
6586 defsubr (&Swindow_inside_pixel_edges);
9d5405ec 6587 defsubr (&Swindow_inside_absolute_pixel_edges);
d5783c40
JB
6588 defsubr (&Scoordinates_in_window_p);
6589 defsubr (&Swindow_at);
7ab12479
JB
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);
d207b766 6596 defsubr (&Sset_window_dedicated_p);
7ab12479
JB
6597 defsubr (&Swindow_display_table);
6598 defsubr (&Sset_window_display_table);
6599 defsubr (&Snext_window);
6600 defsubr (&Sprevious_window);
7ab12479 6601 defsubr (&Sget_buffer_window);
1a13852e
MR
6602 defsubr (&Sdelete_other_windows_internal);
6603 defsubr (&Sdelete_window_internal);
6604 defsubr (&Sresize_mini_window_internal);
7ab12479 6605 defsubr (&Sset_window_buffer);
1a13852e 6606 defsubr (&Srun_window_configuration_change_hook);
7ab12479 6607 defsubr (&Sselect_window);
6b61353c 6608 defsubr (&Sforce_window_update);
3e21b6a7 6609 defsubr (&Stemp_output_buffer_show);
1a13852e 6610 defsubr (&Ssplit_window_internal);
7ab12479
JB
6611 defsubr (&Sscroll_up);
6612 defsubr (&Sscroll_down);
6613 defsubr (&Sscroll_left);
6614 defsubr (&Sscroll_right);
ccd0664b 6615 defsubr (&Sother_window_for_scrolling);
7ab12479 6616 defsubr (&Sscroll_other_window);
fa832261 6617 defsubr (&Sminibuffer_selected_window);
7ab12479 6618 defsubr (&Srecenter);
81fe0836 6619 defsubr (&Swindow_text_height);
7ab12479
JB
6620 defsubr (&Smove_to_window_line);
6621 defsubr (&Swindow_configuration_p);
3f8ab7bd 6622 defsubr (&Swindow_configuration_frame);
7ab12479
JB
6623 defsubr (&Sset_window_configuration);
6624 defsubr (&Scurrent_window_configuration);
5500c422
GM
6625 defsubr (&Sset_window_margins);
6626 defsubr (&Swindow_margins);
949cf20f
KS
6627 defsubr (&Sset_window_fringes);
6628 defsubr (&Swindow_fringes);
6629 defsubr (&Sset_window_scroll_bars);
6630 defsubr (&Swindow_scroll_bars);
5500c422
GM
6631 defsubr (&Swindow_vscroll);
6632 defsubr (&Sset_window_vscroll);
2f8274be 6633 defsubr (&Scompare_window_configurations);
67492200 6634 defsubr (&Swindow_list);
abde8f8c 6635 defsubr (&Swindow_list_1);
496e208e
MR
6636 defsubr (&Swindow_prev_buffers);
6637 defsubr (&Sset_window_prev_buffers);
6638 defsubr (&Swindow_next_buffers);
6639 defsubr (&Sset_window_next_buffers);
cfbb2395
JB
6640 defsubr (&Swindow_parameters);
6641 defsubr (&Swindow_parameter);
6642 defsubr (&Sset_window_parameter);
7ab12479
JB
6643}
6644
dfcf069d 6645void
971de7fb 6646keys_of_window (void)
7ab12479 6647{
7ab12479
JB
6648 initial_define_key (control_x_map, '<', "scroll-left");
6649 initial_define_key (control_x_map, '>', "scroll-right");
6650
32129746 6651 initial_define_key (global_map, Ctl ('V'), "scroll-up-command");
7ab12479 6652 initial_define_key (meta_map, Ctl ('V'), "scroll-other-window");
32129746 6653 initial_define_key (meta_map, 'v', "scroll-down-command");
7ab12479 6654}