frame.c 69.6 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Generic frame functions.
2
   Copyright (C) 1993, 1994, 1995 Free Software Foundation.
Jim Blandy's avatar
Jim Blandy committed
3 4 5 6 7

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Jim Blandy's avatar
Jim Blandy committed
8
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
9 10 11 12 13 14 15 16 17
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
18 19
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
20

21
#include <config.h>
22 23

#include <stdio.h>
24 25
#include "lisp.h"
#include "frame.h"
26
#include "termhooks.h"
27
#include "window.h"
Morten Welinder's avatar
Morten Welinder committed
28 29 30
#ifdef MSDOS
#include "msdos.h"
#endif
Jim Blandy's avatar
Jim Blandy committed
31

32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
/* Evaluate this expression to rebuild the section of syms_of_frame
   that initializes and staticpros the symbols declared below.  Note
   that Emacs 18 has a bug that keeps C-x C-e from being able to
   evaluate this expression.

(progn
  ;; Accumulate a list of the symbols we want to initialize from the
  ;; declarations at the top of the file.
  (goto-char (point-min))
  (search-forward "/\*&&& symbols declared here &&&*\/\n")
  (let (symbol-list)
    (while (looking-at "Lisp_Object \\(Q[a-z_]+\\)")
      (setq symbol-list
	    (cons (buffer-substring (match-beginning 1) (match-end 1))
		  symbol-list))
      (forward-line 1))
    (setq symbol-list (nreverse symbol-list))
    ;; Delete the section of syms_of_... where we initialize the symbols.
    (search-forward "\n  /\*&&& init symbols here &&&*\/\n")
    (let ((start (point)))
      (while (looking-at "^  Q")
	(forward-line 2))
      (kill-region start (point)))
    ;; Write a new symbol initialization section.
    (while symbol-list
      (insert (format "  %s = intern (\"" (car symbol-list)))
      (let ((start (point)))
	(insert (substring (car symbol-list) 1))
	(subst-char-in-region start (point) ?_ ?-))
      (insert (format "\");\n  staticpro (&%s);\n" (car symbol-list)))
      (setq symbol-list (cdr symbol-list)))))
  */        

65 66
/* We need most of these symbols even if not MULTI_FRAME;
   easiest to define them all, all of the time.  */
67 68
/*&&& symbols declared here &&&*/
Lisp_Object Qframep;
Jim Blandy's avatar
Jim Blandy committed
69
Lisp_Object Qframe_live_p;
70 71
Lisp_Object Qheight;
Lisp_Object Qicon;
Jim Blandy's avatar
Jim Blandy committed
72
Lisp_Object Qminibuffer;
73 74 75 76
Lisp_Object Qmodeline;
Lisp_Object Qname;
Lisp_Object Qonly;
Lisp_Object Qunsplittable;
77
Lisp_Object Qmenu_bar_lines;
78 79
Lisp_Object Qwidth;
Lisp_Object Qx;
80
Lisp_Object Qwin32;
81
Lisp_Object Qvisible;
82
Lisp_Object Qbuffer_predicate;
Jim Blandy's avatar
Jim Blandy committed
83

84
Lisp_Object Vterminal_frame;
85
Lisp_Object Vdefault_frame_alist;
86

87 88
Lisp_Object Qmouse_leave_buffer_hook;

89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
static void
syms_of_frame_1 ()
{
  /*&&& init symbols here &&&*/
  Qframep = intern ("framep");
  staticpro (&Qframep);
  Qframe_live_p = intern ("frame-live-p");
  staticpro (&Qframe_live_p);
  Qheight = intern ("height");
  staticpro (&Qheight);
  Qicon = intern ("icon");
  staticpro (&Qicon);
  Qminibuffer = intern ("minibuffer");
  staticpro (&Qminibuffer);
  Qmodeline = intern ("modeline");
  staticpro (&Qmodeline);
  Qname = intern ("name");
  staticpro (&Qname);
  Qonly = intern ("only");
  staticpro (&Qonly);
  Qunsplittable = intern ("unsplittable");
  staticpro (&Qunsplittable);
  Qmenu_bar_lines = intern ("menu-bar-lines");
  staticpro (&Qmenu_bar_lines);
  Qwidth = intern ("width");
  staticpro (&Qwidth);
  Qx = intern ("x");
  staticpro (&Qx);
117 118
  Qwin32 = intern ("win32");
  staticpro (&Qwin32);
119 120 121 122
  Qvisible = intern ("visible");
  staticpro (&Qvisible);
  Qbuffer_predicate = intern ("buffer-predicate");
  staticpro (&Qbuffer_predicate);
123 124 125

  Qmouse_leave_buffer_hook = intern ("mouse-leave-buffer-hook");
  staticpro (&Qmouse_leave_buffer_hook);
126 127 128 129 130 131 132 133 134 135 136 137 138

  DEFVAR_LISP ("default-frame-alist", &Vdefault_frame_alist,
    "Alist of default values for frame creation.\n\
These may be set in your init file, like this:\n\
  (setq default-frame-alist '((width . 80) (height . 55) (menu-bar-lines . 1))\n\
These override values given in window system configuration data,\n\
 including X Windows' defaults database.\n\
For values specific to the first Emacs frame, see `initial-frame-alist'.\n\
For values specific to the separate minibuffer frame, see\n\
 `minibuffer-frame-alist'.\n\
The `menu-bar-lines' element of the list controls whether new frames\n\
 have menu bars; `menu-bar-mode' works by altering this element.");
  Vdefault_frame_alist = Qnil;
139 140 141 142 143 144 145 146 147
}

static void
set_menu_bar_lines_1 (window, n)
  Lisp_Object window;
  int n;
{
  struct window *w = XWINDOW (window);

148
  XSETFASTINT (w->last_modified, 0);
149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183
  XSETFASTINT (w->top, XFASTINT (w->top) + n);
  XSETFASTINT (w->height, XFASTINT (w->height) - n);

  /* Handle just the top child in a vertical split.  */
  if (!NILP (w->vchild))
    set_menu_bar_lines_1 (w->vchild, n);

  /* Adjust all children in a horizontal split.  */
  for (window = w->hchild; !NILP (window); window = w->next)
    {
      w = XWINDOW (window);
      set_menu_bar_lines_1 (window, n);
    }
}

static void
set_menu_bar_lines (f, value, oldval)
     struct frame *f;
     Lisp_Object value, oldval;
{
  int nlines;
  int olines = FRAME_MENU_BAR_LINES (f);

  /* Right now, menu bars don't work properly in minibuf-only frames;
     most of the commands try to apply themselves to the minibuffer
     frame itslef, and get an error because you can't switch buffers
     in or split the minibuffer window.  */
  if (FRAME_MINIBUF_ONLY_P (f))
    return;

  if (INTEGERP (value))
    nlines = XINT (value);
  else
    nlines = 0;

184 185 186 187 188 189 190
  if (nlines != olines)
    {
      windows_or_buffers_changed++;
      FRAME_WINDOW_SIZES_CHANGED (f) = 1;
      FRAME_MENU_BAR_LINES (f) = nlines;
      set_menu_bar_lines_1 (f->root_window, nlines - olines);
    }
191 192 193 194 195 196 197 198 199 200 201 202 203
}

#ifdef MULTI_FRAME

#include "buffer.h"

/* These help us bind and responding to switch-frame events.  */
#include "commands.h"
#include "keyboard.h"

Lisp_Object Vemacs_iconified;
Lisp_Object Vframe_list;

Jim Blandy's avatar
Jim Blandy committed
204 205
extern Lisp_Object Vminibuffer_list;
extern Lisp_Object get_minibuffer ();
206 207
extern Lisp_Object Fhandle_switch_frame ();
extern Lisp_Object Fredirect_frame_focus ();
Karl Heuer's avatar
Karl Heuer committed
208
extern Lisp_Object x_get_focus_frame ();
Jim Blandy's avatar
Jim Blandy committed
209

Jim Blandy's avatar
Jim Blandy committed
210 211 212
DEFUN ("framep", Fframep, Sframep, 1, 1, 0,
  "Return non-nil if OBJECT is a frame.\n\
Value is t for a termcap frame (a character-only terminal),\n\
Morten Welinder's avatar
Morten Welinder committed
213 214
`x' for an Emacs frame that is really an X window,\n\
`pc' for a direct-write MS-DOS frame.\n\
Richard M. Stallman's avatar
Richard M. Stallman committed
215
See also `frame-live-p'.")
Jim Blandy's avatar
Jim Blandy committed
216 217
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
218
{
219
  if (!FRAMEP (object))
Jim Blandy's avatar
Jim Blandy committed
220
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
221
  switch (XFRAME (object)->output_method)
Jim Blandy's avatar
Jim Blandy committed
222 223 224 225
    {
    case output_termcap:
      return Qt;
    case output_x_window:
226
      return Qx;
227 228
    case output_win32:
      return Qwin32;
Morten Welinder's avatar
Morten Welinder committed
229
      /* The `pc' case is in the Fframep below.  */
Jim Blandy's avatar
Jim Blandy committed
230 231 232 233 234
    default:
      abort ();
    }
}

Jim Blandy's avatar
Jim Blandy committed
235
DEFUN ("frame-live-p", Fframe_live_p, Sframe_live_p, 1, 1, 0,
Jim Blandy's avatar
Jim Blandy committed
236 237 238 239 240
  "Return non-nil if OBJECT is a frame which has not been deleted.\n\
Value is nil if OBJECT is not a live frame.  If object is a live\n\
frame, the return value indicates what sort of output device it is\n\
displayed on.  Value is t for a termcap frame (a character-only\n\
terminal), `x' for an Emacs frame being displayed in an X window.")
Jim Blandy's avatar
Jim Blandy committed
241 242 243
  (object)
     Lisp_Object object;
{
Jim Blandy's avatar
Jim Blandy committed
244 245 246
  return ((FRAMEP (object)
	   && FRAME_LIVE_P (XFRAME (object)))
	  ? Fframep (object)
Jim Blandy's avatar
Jim Blandy committed
247 248 249
	  : Qnil);
}

Jim Blandy's avatar
Jim Blandy committed
250 251
struct frame *
make_frame (mini_p)
Jim Blandy's avatar
Jim Blandy committed
252 253
     int mini_p;
{
Jim Blandy's avatar
Jim Blandy committed
254 255
  Lisp_Object frame;
  register struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
256 257
  register Lisp_Object root_window;
  register Lisp_Object mini_window;
258 259 260 261 262 263 264 265 266
  register struct Lisp_Vector *vec;
  int i;

  vec = allocate_vectorlike ((EMACS_INT) VECSIZE (struct frame));
  for (i = 0; i < VECSIZE (struct frame); i++)
    XSETFASTINT (vec->contents[i], 0);
  vec->size = VECSIZE (struct frame);
  f = (struct frame *)vec;
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
267 268 269 270 271 272

  f->cursor_x = 0;
  f->cursor_y = 0;
  f->current_glyphs = 0;
  f->desired_glyphs = 0;
  f->visible = 0;
273
  f->async_visible = 0;
274
  f->output_data.nothing = 0;
Jim Blandy's avatar
Jim Blandy committed
275
  f->iconified = 0;
276
  f->async_iconified = 0;
Jim Blandy's avatar
Jim Blandy committed
277 278 279 280 281 282
  f->wants_modeline = 1;
  f->auto_raise = 0;
  f->auto_lower = 0;
  f->no_split = 0;
  f->garbaged = 0;
  f->has_minibuffer = mini_p;
283
  f->focus_frame = Qnil;
284
  f->explicit_name = 0;
285 286
  f->can_have_scroll_bars = 0;
  f->has_vertical_scroll_bars = 0;
Jim Blandy's avatar
Jim Blandy committed
287
  f->param_alist = Qnil;
288 289
  f->scroll_bars = Qnil;
  f->condemned_scroll_bars = Qnil;
290
  f->face_alist = Qnil;
291
  f->menu_bar_items = Qnil;
292 293
  f->menu_bar_vector = Qnil;
  f->menu_bar_items_used = 0;
294
  f->buffer_predicate = Qnil;
295 296 297
#ifdef MULTI_KBOARD
  f->kboard = initial_kboard;
#endif
298
  f->namebuf = 0;
Jim Blandy's avatar
Jim Blandy committed
299

300
  root_window = make_window ();
Jim Blandy's avatar
Jim Blandy committed
301 302
  if (mini_p)
    {
303
      mini_window = make_window ();
Jim Blandy's avatar
Jim Blandy committed
304 305 306
      XWINDOW (root_window)->next = mini_window;
      XWINDOW (mini_window)->prev = root_window;
      XWINDOW (mini_window)->mini_p = Qt;
Jim Blandy's avatar
Jim Blandy committed
307 308
      XWINDOW (mini_window)->frame = frame;
      f->minibuffer_window = mini_window;
Jim Blandy's avatar
Jim Blandy committed
309 310 311 312 313
    }
  else
    {
      mini_window = Qnil;
      XWINDOW (root_window)->next = Qnil;
Jim Blandy's avatar
Jim Blandy committed
314
      f->minibuffer_window = Qnil;
Jim Blandy's avatar
Jim Blandy committed
315 316
    }

Jim Blandy's avatar
Jim Blandy committed
317
  XWINDOW (root_window)->frame = frame;
Jim Blandy's avatar
Jim Blandy committed
318 319 320

  /* 10 is arbitrary,
     just so that there is "something there."
Jim Blandy's avatar
Jim Blandy committed
321
     Correct size will be set up later with change_frame_size.  */
Jim Blandy's avatar
Jim Blandy committed
322

Jim Blandy's avatar
Jim Blandy committed
323 324
  f->width = 10;
  f->height = 10;
Jim Blandy's avatar
Jim Blandy committed
325

326 327
  XSETFASTINT (XWINDOW (root_window)->width, 10);
  XSETFASTINT (XWINDOW (root_window)->height, (mini_p ? 9 : 10));
Jim Blandy's avatar
Jim Blandy committed
328 329 330

  if (mini_p)
    {
331 332 333
      XSETFASTINT (XWINDOW (mini_window)->width, 10);
      XSETFASTINT (XWINDOW (mini_window)->top, 9);
      XSETFASTINT (XWINDOW (mini_window)->height, 1);
Jim Blandy's avatar
Jim Blandy committed
334 335
    }

Jim Blandy's avatar
Jim Blandy committed
336
  /* Choose a buffer for the frame's root window.  */
Jim Blandy's avatar
Jim Blandy committed
337 338 339 340 341 342 343 344
  {
    Lisp_Object buf;

    XWINDOW (root_window)->buffer = Qt;
    buf = Fcurrent_buffer ();
    /* If buf is a 'hidden' buffer (i.e. one whose name starts with
       a space), try to find another one.  */
    if (XSTRING (Fbuffer_name (buf))->data[0] == ' ')
345
      buf = Fother_buffer (buf, Qnil);
Jim Blandy's avatar
Jim Blandy committed
346 347 348
    Fset_window_buffer (root_window, buf);
  }

Jim Blandy's avatar
Jim Blandy committed
349 350 351 352
  if (mini_p)
    {
      XWINDOW (mini_window)->buffer = Qt;
      Fset_window_buffer (mini_window,
Jim Blandy's avatar
Jim Blandy committed
353
			  (NILP (Vminibuffer_list)
Jim Blandy's avatar
Jim Blandy committed
354 355 356 357
			   ? get_minibuffer (0)
			   : Fcar (Vminibuffer_list)));
    }

Jim Blandy's avatar
Jim Blandy committed
358 359
  f->root_window = root_window;
  f->selected_window = root_window;
Jim Blandy's avatar
Jim Blandy committed
360 361
  /* Make sure this window seems more recently used than
     a newly-created, never-selected window.  */
362
  XSETFASTINT (XWINDOW (f->selected_window)->use_time, ++window_select_count);
Jim Blandy's avatar
Jim Blandy committed
363

Jim Blandy's avatar
Jim Blandy committed
364
  return f;
Jim Blandy's avatar
Jim Blandy committed
365 366
}

Jim Blandy's avatar
Jim Blandy committed
367
/* Make a frame using a separate minibuffer window on another frame.
Jim Blandy's avatar
Jim Blandy committed
368 369 370
   MINI_WINDOW is the minibuffer window to use.  nil means use the
   default (the global minibuffer).  */

Jim Blandy's avatar
Jim Blandy committed
371
struct frame *
372
make_frame_without_minibuffer (mini_window, kb, display)
Jim Blandy's avatar
Jim Blandy committed
373
     register Lisp_Object mini_window;
374
     KBOARD *kb;
375
     Lisp_Object display;
Jim Blandy's avatar
Jim Blandy committed
376
{
Jim Blandy's avatar
Jim Blandy committed
377
  register struct frame *f;
Jim Blandy's avatar
Jim Blandy committed
378

379 380
  if (!NILP (mini_window))
    CHECK_LIVE_WINDOW (mini_window, 0);
Jim Blandy's avatar
Jim Blandy committed
381

382
#ifdef MULTI_KBOARD
383 384
  if (!NILP (mini_window)
      && XFRAME (XWINDOW (mini_window)->frame)->kboard != kb)
385 386 387
    error ("frame and minibuffer must be on the same display");
#endif

Jim Blandy's avatar
Jim Blandy committed
388 389
  /* Make a frame containing just a root window.  */
  f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
390

391 392 393 394 395 396 397 398 399 400 401 402
  if (NILP (mini_window))
    {
      /* Use default-minibuffer-frame if possible.  */
      if (!FRAMEP (kb->Vdefault_minibuffer_frame)
	  || ! FRAME_LIVE_P (XFRAME (kb->Vdefault_minibuffer_frame)))
	{
	  /* If there's no minibuffer frame to use, create one.  */
	  kb->Vdefault_minibuffer_frame
	    = call1 (intern ("make-initial-minibuffer-frame"), display);
	}
      mini_window = XFRAME (kb->Vdefault_minibuffer_frame)->minibuffer_window;
    }
Jim Blandy's avatar
Jim Blandy committed
403
  /* Install the chosen minibuffer window, with proper buffer.  */
Jim Blandy's avatar
Jim Blandy committed
404
  f->minibuffer_window = mini_window;
Jim Blandy's avatar
Jim Blandy committed
405
  Fset_window_buffer (mini_window,
Jim Blandy's avatar
Jim Blandy committed
406
		      (NILP (Vminibuffer_list)
Jim Blandy's avatar
Jim Blandy committed
407 408
		       ? get_minibuffer (0)
		       : Fcar (Vminibuffer_list)));
Jim Blandy's avatar
Jim Blandy committed
409
  return f;
Jim Blandy's avatar
Jim Blandy committed
410 411
}

Jim Blandy's avatar
Jim Blandy committed
412
/* Make a frame containing only a minibuffer window.  */
Jim Blandy's avatar
Jim Blandy committed
413

Jim Blandy's avatar
Jim Blandy committed
414 415
struct frame *
make_minibuffer_frame ()
Jim Blandy's avatar
Jim Blandy committed
416
{
Jim Blandy's avatar
Jim Blandy committed
417
  /* First make a frame containing just a root window, no minibuffer.  */
Jim Blandy's avatar
Jim Blandy committed
418

Jim Blandy's avatar
Jim Blandy committed
419
  register struct frame *f = make_frame (0);
Jim Blandy's avatar
Jim Blandy committed
420
  register Lisp_Object mini_window;
Jim Blandy's avatar
Jim Blandy committed
421
  register Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
422

423
  XSETFRAME (frame, f);
Jim Blandy's avatar
Jim Blandy committed
424

425
  f->auto_raise = 0;
Jim Blandy's avatar
Jim Blandy committed
426 427 428 429
  f->auto_lower = 0;
  f->no_split = 1;
  f->wants_modeline = 0;
  f->has_minibuffer = 1;
Jim Blandy's avatar
Jim Blandy committed
430 431 432 433 434

  /* Now label the root window as also being the minibuffer.
     Avoid infinite looping on the window chain by marking next pointer
     as nil. */

Jim Blandy's avatar
Jim Blandy committed
435
  mini_window = f->minibuffer_window = f->root_window;
Jim Blandy's avatar
Jim Blandy committed
436 437
  XWINDOW (mini_window)->mini_p = Qt;
  XWINDOW (mini_window)->next = Qnil;
438
  XWINDOW (mini_window)->prev = Qnil;
Jim Blandy's avatar
Jim Blandy committed
439
  XWINDOW (mini_window)->frame = frame;
Jim Blandy's avatar
Jim Blandy committed
440 441 442 443

  /* Put the proper buffer in that window.  */

  Fset_window_buffer (mini_window,
Jim Blandy's avatar
Jim Blandy committed
444
		      (NILP (Vminibuffer_list)
Jim Blandy's avatar
Jim Blandy committed
445 446
		       ? get_minibuffer (0)
		       : Fcar (Vminibuffer_list)));
Jim Blandy's avatar
Jim Blandy committed
447
  return f;
Jim Blandy's avatar
Jim Blandy committed
448 449
}

Jim Blandy's avatar
Jim Blandy committed
450
/* Construct a frame that refers to the terminal (stdin and stdout).  */
Jim Blandy's avatar
Jim Blandy committed
451

452 453
static int terminal_frame_count;

Jim Blandy's avatar
Jim Blandy committed
454 455
struct frame *
make_terminal_frame ()
Jim Blandy's avatar
Jim Blandy committed
456
{
Jim Blandy's avatar
Jim Blandy committed
457
  register struct frame *f;
458
  Lisp_Object frame;
459 460
  char name[20];

461 462 463 464 465
#ifdef MULTI_KBOARD
  if (!initial_kboard)
    {
      initial_kboard = (KBOARD *) xmalloc (sizeof (KBOARD));
      init_kboard (initial_kboard);
466 467
      initial_kboard->next_kboard = all_kboards;
      all_kboards = initial_kboard;
468 469 470
    }
#endif

471 472 473
  /* The first call must initialize Vframe_list.  */
  if (! (NILP (Vframe_list) || CONSP (Vframe_list)))
    Vframe_list = Qnil;
Jim Blandy's avatar
Jim Blandy committed
474 475

  f = make_frame (1);
476

477
  XSETFRAME (frame, f);
478 479
  Vframe_list = Fcons (frame, Vframe_list);

480
  terminal_frame_count++;
481 482 483 484 485 486 487 488 489
  if (terminal_frame_count == 1)
    {
      f->name = build_string ("Emacs");
    }
  else
    {
      sprintf (name, "Emacs-%d", terminal_frame_count);
      f->name = build_string (name);
    }
490 491 492

  f->visible = 1;		/* FRAME_SET_VISIBLE wd set frame_garbaged. */
  f->async_visible = 1;		/* Don't let visible be cleared later. */
493
  f->output_data.nothing = 1;	/* Nonzero means frame isn't deleted.  */
Jim Blandy's avatar
Jim Blandy committed
494
  return f;
Jim Blandy's avatar
Jim Blandy committed
495
}
496 497

DEFUN ("make-terminal-frame", Fmake_terminal_frame, Smake_terminal_frame,
498 499 500 501 502 503
       1, 1, 0, "Create an additional terminal frame.\n\
You can create multiple frames on a text-only terminal in this way.\n\
Only the selected terminal frame is actually displayed.\n\
This function takes one argument, an alist specifying frame parameters.\n\
In practice, generally you don't need to specify any parameters.\n\
Note that changing the size of one terminal frame automatically affects all.")
504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519
  (parms)
     Lisp_Object parms;
{
  struct frame *f;
  Lisp_Object frame;

  if (selected_frame->output_method != output_termcap)
    error ("Not using an ASCII terminal now; cannot make a new ASCII frame");

  f = make_terminal_frame ();
  change_frame_size (f, FRAME_HEIGHT (selected_frame),
		     FRAME_WIDTH (selected_frame), 0, 0);
  remake_frame_glyphs (f);
  calculate_costs (f);
  XSETFRAME (frame, f);
  Fmodify_frame_parameters (frame, parms);
520
  f->face_alist = selected_frame->face_alist;
521 522
  return frame;
}
Jim Blandy's avatar
Jim Blandy committed
523

524
Lisp_Object
525
do_switch_frame (frame, no_enter, track)
Jim Blandy's avatar
Jim Blandy committed
526
     Lisp_Object frame, no_enter;
527
     int track;
Jim Blandy's avatar
Jim Blandy committed
528
{
529 530 531 532 533 534 535
  /* If FRAME is a switch-frame event, extract the frame we should
     switch to.  */
  if (CONSP (frame)
      && EQ (XCONS (frame)->car, Qswitch_frame)
      && CONSP (XCONS (frame)->cdr))
    frame = XCONS (XCONS (frame)->cdr)->car;

536 537 538 539 540 541
  /* This used to say CHECK_LIVE_FRAME, but apparently it's possible for
     a switch-frame event to arrive after a frame is no longer live,
     especially when deleting the initial frame during startup.  */
  CHECK_FRAME (frame, 0);
  if (! FRAME_LIVE_P (XFRAME (frame)))
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
542

Jim Blandy's avatar
Jim Blandy committed
543 544
  if (selected_frame == XFRAME (frame))
    return frame;
Jim Blandy's avatar
Jim Blandy committed
545

546 547 548
  /* This is too greedy; it causes inappropriate focus redirection
     that's hard to get rid of.  */
#if 0
549 550 551 552 553 554 555
  /* If a frame's focus has been redirected toward the currently
     selected frame, we should change the redirection to point to the
     newly selected frame.  This means that if the focus is redirected
     from a minibufferless frame to a surrogate minibuffer frame, we
     can use `other-window' to switch between all the frames using
     that minibuffer frame, and the focus redirection will follow us
     around.  */
556 557 558
  if (track)
    {
      Lisp_Object tail;
559

560 561 562
      for (tail = Vframe_list; CONSP (tail); tail = XCONS (tail)->cdr)
	{
	  Lisp_Object focus;
563

564
	  if (!FRAMEP (XCONS (tail)->car))
565
	    abort ();
566

567
	  focus = FRAME_FOCUS_FRAME (XFRAME (XCONS (tail)->car));
568

569
	  if (FRAMEP (focus) && XFRAME (focus) == selected_frame)
570 571 572 573 574
	    Fredirect_frame_focus (XCONS (tail)->car, frame);
	}
    }
#else /* ! 0 */
  /* Instead, apply it only to the frame we're pointing to.  */
575 576
#ifdef HAVE_WINDOW_SYSTEM
  if (track && (FRAME_WINDOW_P (XFRAME (frame))))
577 578 579
    {
      Lisp_Object focus, xfocus;

580
      xfocus = x_get_focus_frame (XFRAME (frame));
581 582 583 584 585 586 587 588 589
      if (FRAMEP (xfocus))
	{
	  focus = FRAME_FOCUS_FRAME (XFRAME (xfocus));
	  if (FRAMEP (focus) && XFRAME (focus) == selected_frame)
	    Fredirect_frame_focus (xfocus, frame);
	}
    }
#endif /* HAVE_X_WINDOWS */
#endif /* ! 0 */
590

Jim Blandy's avatar
Jim Blandy committed
591 592 593
  selected_frame = XFRAME (frame);
  if (! FRAME_MINIBUF_ONLY_P (selected_frame))
    last_nonminibuf_frame = selected_frame;
Jim Blandy's avatar
Jim Blandy committed
594

Jim Blandy's avatar
Jim Blandy committed
595
  Fselect_window (XFRAME (frame)->selected_window);
Jim Blandy's avatar
Jim Blandy committed
596

597
  /* We want to make sure that the next event generates a frame-switch
598
     event to the appropriate frame.  This seems kludgy to me, but
599 600 601 602
     before you take it out, make sure that evaluating something like
     (select-window (frame-root-window (new-frame))) doesn't end up
     with your typing being interpreted in the new frame instead of
     the one you're actually typing in.  */
603
  internal_last_event_frame = Qnil;
604

Jim Blandy's avatar
Jim Blandy committed
605
  return frame;
Jim Blandy's avatar
Jim Blandy committed
606 607
}

608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629
DEFUN ("select-frame", Fselect_frame, Sselect_frame, 1, 2, "e",
  "Select the frame FRAME.\n\
Subsequent editing commands apply to its selected window.\n\
The selection of FRAME lasts until the next time the user does\n\
something to select a different frame, or until the next time this\n\
function is called.")
  (frame, no_enter)
    Lisp_Object frame, no_enter;
{
  return do_switch_frame (frame, no_enter, 1);
}


DEFUN ("handle-switch-frame", Fhandle_switch_frame, Shandle_switch_frame, 1, 2, "e",
  "Handle a switch-frame event EVENT.\n\
Switch-frame events are usually bound to this function.\n\
A switch-frame event tells Emacs that the window manager has requested\n\
that the user's events be directed to the frame mentioned in the event.\n\
This function selects the selected window of the frame of EVENT.\n\
\n\
If EVENT is frame object, handle it as if it were a switch-frame event\n\
to that frame.")
630 631
  (event, no_enter)
     Lisp_Object event, no_enter;
632
{
633 634
  /* Preserve prefix arg that the command loop just cleared.  */
  current_kboard->Vprefix_arg = Vcurrent_prefix_arg;
635
  call1 (Vrun_hooks, Qmouse_leave_buffer_hook);
636
  return do_switch_frame (event, no_enter, 0);
637 638
}

639 640 641 642 643 644 645 646
DEFUN ("ignore-event", Fignore_event, Signore_event, 0, 0, "",
  "Do nothing, but preserve any prefix argument already specified.\n\
This is a suitable binding for iconify-frame and make-frame-visible.")
     ()
{
  current_kboard->Vprefix_arg = Vcurrent_prefix_arg;
  return Qnil;
}
647

Jim Blandy's avatar
Jim Blandy committed
648 649
DEFUN ("selected-frame", Fselected_frame, Sselected_frame, 0, 0, 0,
  "Return the frame that is now selected.")
Jim Blandy's avatar
Jim Blandy committed
650 651 652
  ()
{
  Lisp_Object tem;
653
  XSETFRAME (tem, selected_frame);
Jim Blandy's avatar
Jim Blandy committed
654 655
  return tem;
}
656

Jim Blandy's avatar
Jim Blandy committed
657 658
DEFUN ("window-frame", Fwindow_frame, Swindow_frame, 1, 1, 0,
  "Return the frame object that window WINDOW is on.")
Jim Blandy's avatar
Jim Blandy committed
659 660 661
  (window)
     Lisp_Object window;
{
662
  CHECK_LIVE_WINDOW (window, 0);
Jim Blandy's avatar
Jim Blandy committed
663
  return XWINDOW (window)->frame;
Jim Blandy's avatar
Jim Blandy committed
664 665
}

666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692
DEFUN ("frame-first-window", Fframe_first_window, Sframe_first_window, 0, 1, 0,
  "Returns the topmost, leftmost window of FRAME.\n\
If omitted, FRAME defaults to the currently selected frame.")
  (frame)
     Lisp_Object frame;
{
  Lisp_Object w;

  if (NILP (frame))
    w = selected_frame->root_window;
  else
    {
      CHECK_LIVE_FRAME (frame, 0);
      w = XFRAME (frame)->root_window;
    }
  while (NILP (XWINDOW (w)->buffer))
    {
      if (! NILP (XWINDOW (w)->hchild))
	w = XWINDOW (w)->hchild;
      else if (! NILP (XWINDOW (w)->vchild))
	w = XWINDOW (w)->vchild;
      else
	abort ();
    }
  return w;
}

693 694 695 696 697 698 699 700
DEFUN ("active-minibuffer-window", Factive_minibuffer_window,
       Sactive_minibuffer_window, 0, 0, 0,
       "Return the currently active minibuffer window, or nil if none.")
  ()
{
  return minibuf_level ? minibuf_window : Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
701
DEFUN ("frame-root-window", Fframe_root_window, Sframe_root_window, 0, 1, 0,
702 703
       "Returns the root-window of FRAME.\n\
If omitted, FRAME defaults to the currently selected frame.")
Jim Blandy's avatar
Jim Blandy committed
704 705
  (frame)
     Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
706
{
Jim Blandy's avatar
Jim Blandy committed
707
  if (NILP (frame))
708
    XSETFRAME (frame, selected_frame);
Jim Blandy's avatar
Jim Blandy committed
709
  else
Jim Blandy's avatar
Jim Blandy committed
710
    CHECK_LIVE_FRAME (frame, 0);
Jim Blandy's avatar
Jim Blandy committed
711

Jim Blandy's avatar
Jim Blandy committed
712
  return XFRAME (frame)->root_window;
Jim Blandy's avatar
Jim Blandy committed
713 714
}

Jim Blandy's avatar
Jim Blandy committed
715 716
DEFUN ("frame-selected-window", Fframe_selected_window,
       Sframe_selected_window, 0, 1, 0,
717 718
  "Return the selected window of frame object FRAME.\n\
If omitted, FRAME defaults to the currently selected frame.")
Jim Blandy's avatar
Jim Blandy committed
719 720
  (frame)
     Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
721
{
Jim Blandy's avatar
Jim Blandy committed
722
  if (NILP (frame))
723
    XSETFRAME (frame, selected_frame);
Jim Blandy's avatar
Jim Blandy committed
724
  else
Jim Blandy's avatar
Jim Blandy committed
725
    CHECK_LIVE_FRAME (frame, 0);
Jim Blandy's avatar
Jim Blandy committed
726

Jim Blandy's avatar
Jim Blandy committed
727
  return XFRAME (frame)->selected_window;
Jim Blandy's avatar
Jim Blandy committed
728 729
}

730 731 732 733 734 735 736 737 738
DEFUN ("set-frame-selected-window", Fset_frame_selected_window,
       Sset_frame_selected_window, 2, 2, 0,
  "Set the selected window of frame object FRAME to WINDOW.\n\
If FRAME is nil, the selected frame is used.\n\
If FRAME is the selected frame, this makes WINDOW the selected window.")
  (frame, window)
     Lisp_Object frame, window;
{
  if (NILP (frame))
739
    XSETFRAME (frame, selected_frame);
740 741 742 743 744 745 746 747 748 749 750 751 752 753
  else
    CHECK_LIVE_FRAME (frame, 0);

  CHECK_LIVE_WINDOW (window, 1);

  if (! EQ (frame, WINDOW_FRAME (XWINDOW (window))))
    error ("In `set-frame-selected-window', WINDOW is not on FRAME");

  if (XFRAME (frame) == selected_frame)
    return Fselect_window (window);

  return XFRAME (frame)->selected_window = window;
}

Jim Blandy's avatar
Jim Blandy committed
754
DEFUN ("frame-list", Fframe_list, Sframe_list,
Jim Blandy's avatar
Jim Blandy committed
755
       0, 0, 0,
Jim Blandy's avatar
Jim Blandy committed
756
       "Return a list of all frames.")
Jim Blandy's avatar
Jim Blandy committed
757 758
  ()
{
Jim Blandy's avatar
Jim Blandy committed
759
  return Fcopy_sequence (Vframe_list);
Jim Blandy's avatar
Jim Blandy committed
760 761
}

Jim Blandy's avatar
Jim Blandy committed
762 763
/* Return the next frame in the frame list after FRAME.
   If MINIBUF is nil, exclude minibuffer-only frames.
764 765
   If MINIBUF is a window, include only its own frame
   and any frame now using that window as the minibuffer.
766
   If MINIBUF is `visible', include all visible frames.
767
   If MINIBUF is 0, include all visible and iconified frames.
768 769
   Otherwise, include all frames.  */

Jim Blandy's avatar
Jim Blandy committed
770
Lisp_Object
Jim Blandy's avatar
Jim Blandy committed
771 772
next_frame (frame, minibuf)
     Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
773
     Lisp_Object minibuf;
Jim Blandy's avatar
Jim Blandy committed
774 775 776 777
{
  Lisp_Object tail;
  int passed = 0;

Jim Blandy's avatar
Jim Blandy committed
778 779
  /* There must always be at least one frame in Vframe_list.  */
  if (! CONSP (Vframe_list))
Jim Blandy's avatar
Jim Blandy committed
780 781
    abort ();

Jim Blandy's avatar
Jim Blandy committed
782 783 784 785
  /* If this frame is dead, it won't be in Vframe_list, and we'll loop
     forever.  Forestall that.  */
  CHECK_LIVE_FRAME (frame, 0);

Jim Blandy's avatar
Jim Blandy committed
786
  while (1)
Jim Blandy's avatar
Jim Blandy committed
787
    for (tail = Vframe_list; CONSP (tail); tail = XCONS (tail)->cdr)
Jim Blandy's avatar
Jim Blandy committed
788
      {
789
	Lisp_Object f;
790

791
	f = XCONS (tail)->car;
792 793 794

	if (passed
	    && FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
Jim Blandy's avatar
Jim Blandy committed
795
	  {
796 797 798 799 800 801 802 803 804 805 806 807 808
	    /* Decide whether this frame is eligible to be returned.  */

	    /* If we've looped all the way around without finding any
	       eligible frames, return the original frame.  */
	    if (EQ (f, frame))
	      return f;

	    /* Let minibuf decide if this frame is acceptable.  */
	    if (NILP (minibuf))
	      {
		if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
		  return f;
	      }
809 810 811 812 813 814
	    else if (EQ (minibuf, Qvisible))
	      {
		FRAME_SAMPLE_VISIBILITY (XFRAME (f));
		if (FRAME_VISIBLE_P (XFRAME (f)))
		  return f;
	      }
815 816 817 818 819 820 821
	    else if (XFASTINT (minibuf) == 0)
	      {
		FRAME_SAMPLE_VISIBILITY (XFRAME (f));
		if (FRAME_VISIBLE_P (XFRAME (f))
		    || FRAME_ICONIFIED_P (XFRAME (f)))
		  return f;
	      }
822
	    else if (WINDOWP (minibuf))
823
	      {
824 825 826 827 828 829
		if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
		    /* Check that F either is, or has forwarded its focus to,
		       MINIBUF's frame.  */
		    && (EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
			|| EQ (WINDOW_FRAME (XWINDOW (minibuf)),
			       FRAME_FOCUS_FRAME (XFRAME (f)))))
830 831 832
		  return f;
	      }
	    else
Jim Blandy's avatar
Jim Blandy committed
833
	      return f;
Jim Blandy's avatar
Jim Blandy committed
834
	  }
Jim Blandy's avatar
Jim Blandy committed
835

836
	if (EQ (frame, f))
Jim Blandy's avatar
Jim Blandy committed
837 838 839 840
	  passed++;
      }
}

Jim Blandy's avatar
Jim Blandy committed
841 842
/* Return the previous frame in the frame list before FRAME.
   If MINIBUF is nil, exclude minibuffer-only frames.
843 844
   If MINIBUF is a window, include only its own frame
   and any frame now using that window as the minibuffer.
845
   If MINIBUF is `visible', include all visible frames.
846
   If MINIBUF is 0, include all visible and iconified frames.
847 848
   Otherwise, include all frames.  */

Jim Blandy's avatar
Jim Blandy committed
849
Lisp_Object
Jim Blandy's avatar
Jim Blandy committed
850 851
prev_frame (frame, minibuf)
     Lisp_Object frame;
Jim Blandy's avatar
Jim Blandy committed
852
     Lisp_Object minibuf;
Jim Blandy's avatar
Jim Blandy committed
853 854 855 856
{
  Lisp_Object tail;
  Lisp_Object prev;

Jim Blandy's avatar
Jim Blandy committed
857 858
  /* There must always be at least one frame in Vframe_list.  */
  if (! CONSP (Vframe_list))
Jim Blandy's avatar
Jim Blandy committed
859 860
    abort ();

Jim Blandy's avatar
Jim Blandy committed
861
  prev = Qnil;
862
  for (tail = Vframe_list; CONSP (tail); tail = XCONS (tail)->cdr)
Jim Blandy's avatar
Jim Blandy committed
863
    {
864
      Lisp_Object f;
Jim Blandy's avatar
Jim Blandy committed
865

866
      f = XCONS (tail)->car;
867
      if (!FRAMEP (f))
868
	abort ();
Jim Blandy's avatar
Jim Blandy committed
869

870 871
      if (EQ (frame, f) && !NILP (prev))
	return prev;
Jim Blandy's avatar
Jim Blandy committed
872

873
      if (FRAME_KBOARD (XFRAME (f)) == FRAME_KBOARD (XFRAME (frame)))
874
	{
875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905
	  /* Decide whether this frame is eligible to be returned,
	     according to minibuf.  */
	  if (NILP (minibuf))
	    {
	      if (! FRAME_MINIBUF_ONLY_P (XFRAME (f)))
		prev = f;
	    }
	  else if (WINDOWP (minibuf))
	    {
	      if (EQ (FRAME_MINIBUF_WINDOW (XFRAME (f)), minibuf)
		  /* Check that F either is, or has forwarded its focus to,
		     MINIBUF's frame.  */
		  && (EQ (WINDOW_FRAME (XWINDOW (minibuf)), f)
		      || EQ (WINDOW_FRAME (XWINDOW (minibuf)),
			     FRAME_FOCUS_FRAME (XFRAME (f)))))
		prev = f;
	    }
	  else if (EQ (minibuf, Qvisible))
	    {
	      FRAME_SAMPLE_VISIBILITY (XFRAME (f));
	      if (FRAME_VISIBLE_P (XFRAME (f)))
		prev = f;
	    }
	  else if (XFASTINT (minibuf) == 0)
	    {
	      FRAME_SAMPLE_VISIBILITY (XFRAME (f));
	      if (FRAME_VISIBLE_P (XFRAME (f))
		  || FRAME_ICONIFIED_P (XFRAME (f)))
		prev = f;
	    }
	  else
906 907
	    prev = f;
	}
Jim Blandy's avatar
Jim Blandy committed
908
    }
909 910 911 912 913 914 915 916 917 918 919

  /* We've scanned the entire list.  */
  if (NILP (prev))
    /* We went through the whole frame list without finding a single
       acceptable frame.  Return the original frame.  */
    return frame;
  else
    /* There were no acceptable frames in the list before FRAME; otherwise,
       we would have returned directly from the loop.  Since PREV is the last
       acceptable frame in the list, return it.  */
    return prev;
Jim Blandy's avatar
Jim Blandy committed
920 921
}

922

Jim Blandy's avatar
Jim Blandy committed
923 924
DEFUN ("next-frame", Fnext_frame, Snext_frame, 0, 2, 0,
  "Return the next frame in the frame list after FRAME.\n\
925
It considers only frames on the same terminal as FRAME.\n\
926
By default, skip minibuffer-only frames.\n\
927
If omitted, FRAME defaults to the selected frame.\n\
928
If optional argument MINIFRAME is nil, exclude minibuffer-only frames.\n\
929
If MINIFRAME is a window, include only its own frame\n\
930
and any frame now using that window as the minibuffer.\n\
931
If MINIFRAME is `visible', include all visible frames.\n\
932
If MINIFRAME is 0, include all visible and iconified frames.\n\
933
Otherwise, include all frames.")
Jim Blandy's avatar
Jim Blandy committed
934
  (frame, miniframe)
935
     Lisp_Object frame, miniframe;
Jim Blandy's avatar
Jim Blandy committed
936 937 938
{
  Lisp_Object tail;

Jim Blandy's avatar
Jim Blandy committed
939
  if (NILP (frame))
940
    XSETFRAME (frame, selected_frame);
Jim Blandy's avatar
Jim Blandy committed
941
  else
Jim Blandy's avatar
Jim Blandy committed
942
    CHECK_LIVE_FRAME (frame, 0);
Jim Blandy's avatar
Jim Blandy committed
943

Jim Blandy's avatar
Jim Blandy committed
944
  return next_frame (frame, miniframe);
Jim Blandy's avatar
Jim Blandy committed
945
}
Jim Blandy's avatar
Jim Blandy committed
946

947 948
DEFUN ("previous-frame", Fprevious_frame, Sprevious_frame, 0, 2, 0,
  "Return the previous frame in the frame list before FRAME.\n\
949
It considers only frames on the same terminal as FRAME.\n\
950 951 952
By default, skip minibuffer-only frames.\n\
If omitted, FRAME defaults to the selected frame.\n\
If optional argument MINIFRAME is nil, exclude minibuffer-only frames.\n\
953
If MINIFRAME is a window, include only its own frame\n\
954
and any frame now using that window as the minibuffer.\n\
955
If MINIFRAME is `visible', include all visible frames.\n\
956
If MINIFRAME is 0, include all visible and iconified frames.\n\
957
Otherwise, include all frames.")
958 959 960 961 962 963
  (frame, miniframe)
     Lisp_Object frame, miniframe;
{
  Lisp_Object tail;

  if (NILP (frame))
964
    XSETFRAME (frame, selected_frame);
965 966 967 968 969
  else
    CHECK_LIVE_FRAME (frame, 0);

  return prev_frame (frame, miniframe);
}
Jim Blandy's avatar
Jim Blandy committed
970

971 972 973
/* Return 1 if it is ok to delete frame F;
   0 if all frames aside from F are invisible.
   (Exception: if F is the terminal frame, and we are using X, return 1.)  */
Jim Blandy's avatar
Jim Blandy committed
974

975
int
976 977 978 979 980 981
other_visible_frames (f)
     FRAME_PTR f;
{
  /* We know the selected frame is visible,
     so if F is some other frame, it can't be the sole visible one.  */
  if (f == selected_frame)
982 983 984 985 986 987 988 989
    {
      Lisp_Object frames;
      int count = 0;

      for (frames = Vframe_list;
	   CONSP (frames);
	   frames = XCONS (frames)->cdr)
	{
990
	  Lisp_Object this;
991

992
	  this = XCONS (frames)->car;
993 994 995
	  /* Verify that the frame's window still exists
	     and we can still talk to it.  And note any recent change
	     in visibility.  */
996 997
#ifdef HAVE_WINDOW_SYSTEM
	  if (FRAME_WINDOW_P (XFRAME (this)))
998
	    {
999
	      x_sync (XFRAME (this));
1000 1001 1002 1003
	      FRAME_SAMPLE_VISIBILITY (XFRAME (this));
	    }
#endif

1004 1005 1006 1007
	  if (FRAME_VISIBLE_P (XFRAME (this))
	      || FRAME_ICONIFIED_P (XFRAME (this))
	      /* Allow deleting the terminal frame when at least
		 one X frame exists!  */
1008
	      || (FRAME_WINDOW_P (XFRAME (this)) && !FRAME_WINDOW_P (f)))
1009 1010
	    count++;
	}
1011
      return count > 1;
1012
    }
1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025
  return 1;
}

DEFUN ("delete-frame", Fdelete_frame, Sdelete_frame, 0, 2, "",
  "Delete FRAME, permanently eliminating it from use.\n\
If omitted, FRAME defaults to the selected frame.\n\
A frame may not be deleted if its minibuffer is used by other frames.\n\
Normally, you may not delete a frame if all other frames are invisible,\n\
but if the second optional argument FORCE is non-nil, you may do so.")
  (frame, force)
     Lisp_Object frame, force;
{
  struct frame *f;
1026
  int minibuffer_selected;
1027 1028 1029 1030

  if (EQ (frame, Qnil))
    {
      f = selected_frame;
1031
      XSETFRAME (frame, f);
1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
    }
  else
    {
      CHECK_FRAME (frame, 0);
      f = XFRAME (frame);
    }

  if (! FRAME_LIVE_P (f))
    return Qnil;

  if (NILP (force) && !other_visible_frames (f))
    error ("Attempt to delete the sole visible or iconified frame");
Jim Blandy's avatar
Jim Blandy committed
1044

Jim Blandy's avatar
Jim Blandy committed
1045 1046
  /* Does this frame have a minibuffer, and is it the surrogate
     minibuffer for any other frame?  */
1047
  if (FRAME_HAS_MINIBUF_P (XFRAME (frame)))
Jim Blandy's avatar
Jim Blandy committed
1048
    {
Jim Blandy's avatar
Jim Blandy committed
1049
      Lisp_Object frames;
Jim Blandy's avatar
Jim Blandy committed
1050

Jim Blandy's avatar
Jim Blandy committed
1051 1052 1053
      for (frames = Vframe_list;
	   CONSP (frames);
	   frames = XCONS (frames)->cdr)
Jim Blandy's avatar
Jim Blandy committed
1054
	{
1055 1056
	  Lisp_Object this;
	  this = XCONS (frames)->car;
Jim Blandy's avatar
Jim Blandy committed
1057

Jim Blandy's avatar
Jim Blandy committed
1058 1059
	  if (! EQ (this, frame)
	      && EQ (frame,
1060 1061
		     WINDOW_FRAME (XWINDOW
				   (FRAME_MINIBUF_WINDOW (XFRAME (this))))))
Jim Blandy's avatar
Jim Blandy committed
1062
	    error ("Attempt to delete a surrogate minibuffer frame");
Jim Blandy's avatar
Jim Blandy committed
1063
	}
Jim Blandy's avatar
Jim Blandy committed
1064 1065
    }

1066 1067
  minibuffer_selected = EQ (minibuf_window, selected_window);

Jim Blandy's avatar
Jim Blandy committed
1068 1069
  /* Don't let the frame remain selected.  */
  if (f == selected_frame)
1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087
    {
      Lisp_Object tail, frame1;

      /* Look for another visible frame on the same terminal.  */
      frame1 = next_frame (frame, Qvisible);

      /* If there is none, find *some* other frame.  */
      if (NILP (frame1) || EQ (frame1, frame))
	{
	  FOR_EACH_FRAME (tail, frame1)
	    {
	      if (! EQ (frame, frame1))
		break;
	    }
	}

      do_switch_frame (frame1, Qnil, 0);
    }
Jim Blandy's avatar
Jim Blandy committed
1088

Jim Blandy's avatar
Jim Blandy committed
1089 1090
  /* Don't allow minibuf_window to remain on a deleted frame.  */
  if (EQ (f->minibuffer_window, minibuf_window))
Jim Blandy's avatar
Jim Blandy committed
1091
    {
Jim Blandy's avatar
Jim Blandy committed
1092
      Fset_window_buffer (selected_frame->minibuffer_window,
Jim Blandy's avatar
Jim Blandy committed
1093
			  XWINDOW (minibuf_window)->buffer);
Jim Blandy's avatar
Jim Blandy committed
1094
      minibuf_window = selected_frame->minibuffer_window;
1095 1096 1097 1098 1099

      /* If the dying minibuffer window was selected,
	 select the new one.  */
      if (minibuffer_selected)
	Fselect_window (minibuf_window);
Jim Blandy's avatar
Jim Blandy committed
1100 1101
    }

1102 1103 1104 1105 1106 1107
  /* Clear any X selections for this frame.  */
#ifdef HAVE_X_WINDOWS
  if (FRAME_X_P (f))
    x_clear_frame_selections (f);
#endif

1108 1109 1110 1111 1112
  /* Mark all the windows that used to be on FRAME as deleted, and then
     remove the reference to them.  */
  delete_all_subwindows (XWINDOW (f->root_window));
  f->root_window = Qnil;

Jim Blandy's avatar
Jim Blandy committed
1113
  Vframe_list = Fdelq (frame, Vframe_list);
1114
  FRAME_SET_VISIBLE (f, 0);
Jim Blandy's avatar
Jim Blandy committed
1115

Karl Heuer's avatar
Karl Heuer committed
1116 1117
  if (f->namebuf)
    free (f->namebuf);
1118 1119 1120 1121 1122 1123 1124 1125 1126
  if (FRAME_CURRENT_GLYPHS (f))
    free_frame_glyphs (f, FRAME_CURRENT_GLYPHS (f));
  if (FRAME_DESIRED_GLYPHS (f))
    free_frame_glyphs (f, FRAME_DESIRED_GLYPHS (f));
  if (FRAME_TEMP_GLYPHS (f))
    free_frame_glyphs (f, FRAME_TEMP_GLYPHS (f));
  if (FRAME_INSERT_COST (f))
    free (FRAME_INSERT_COST (f));
  if (FRAME_DELETEN_COST (f))
1127
    free (FRAME_DELETEN_COST (f));
1128
  if (FRAME_INSERTN_COST (f))
1129
    free (FRAME_INSERTN_COST (f));
1130
  if (FRAME_DELETE_COST (f))
1131
    free (FRAME_DELETE_COST (f));
1132

1133 1134 1135 1136 1137
  /* Since some events are handled at the interrupt level, we may get
     an event for f at any time; if we zero out the frame's display
     now, then we may trip up the event-handling code.  Instead, we'll
     promise that the display of the frame must be valid until we have
     called the window-system-dependent frame destruction routine.  */
Jim Blandy's avatar
Jim Blandy committed
1138 1139

  /* I think this should be done with a hook.  */
1140 1141
#ifdef HAVE_WINDOW_SYSTEM
  if (FRAME_WINDOW_P (f))
1142
    x_destroy_window (f);
Jim Blandy's avatar
Jim Blandy committed
1143 1144
#endif

1145
  f->output_data.nothing = 0;