-;;; frame.el --- multi-frame management independent of window systems.
-
-;; Maintainer: FSF
-;; Last-Modified: 09 Jul 92
-;; Keywords: internal
-
-;;;; Copyright (C) 1990, 1992 Free Software Foundation, Inc.
-
-;;; 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
-;;; the Free Software Foundation; either version 2, or (at your option)
-;;; 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
-;;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
-
-;;; Code:
-
-(defvar frame-creation-function nil
- "Window-system dependent function to call to create a new frame.
-The window system startup file should set this to its frame creation
-function, which should take an alist of parameters as its argument.")
-
-;;; The default value for this must ask for a minibuffer. There must
-;;; always exist a frame with a minibuffer, and after we delete the
-;;; terminal frame, this will be the only frame.
-(defvar initial-frame-alist '((minibuffer . nil))
- "Alist of values used when creating the initial emacs text frame.
-These may be set in your init file, like this:
- (setq initial-frame-alist '((top . 1) (left . 1) (width . 80) (height . 55)))
-These supercede the values given in frame-default-alist.")
-
-(defvar minibuffer-frame-alist nil
- "Alist of values to apply to a minibuffer frame.
-These may be set in your init file, like this:
- (setq minibuffer-frame-alist
- '((top . 1) (left . 1) (width . 80) (height . 1)))
-These supercede the values given in default-frame-alist.")
-
-(defvar pop-up-frame-alist nil
- "Alist of values used when creating pop-up frames.
-Pop-up frames are used for completions, help, and the like.
-This variable can be set in your init file, like this:
- (setq pop-up-frame-alist '((width . 80) (height . 20)))
-These supercede the values given in default-frame-alist.")
-
-(setq pop-up-frame-function
- (function (lambda ()
- (new-frame pop-up-frame-alist))))
-
-\f
-;;;; Arrangement of frames at startup
-
-;;; 1) Load the window system startup file from the lisp library and read the
-;;; high-priority arguments (-q and the like). The window system startup
-;;; file should create any frames specified in the window system defaults.
-;;;
-;;; 2) If no frames have been opened, we open an initial text frame.
-;;;
-;;; 3) Once the init file is done, we apply any newly set parameters
-;;; in initial-frame-alist to the frame.
-
-(add-hook 'before-init-hook 'frame-initialize)
-(add-hook 'window-setup-hook 'frame-notice-user-settings)
-
-;;; If we create the initial frame, this is it.
-(defvar frame-initial-frame nil)
-
-;;; startup.el calls this function before loading the user's init
-;;; file - if there is no frame with a minibuffer open now, create
-;;; one to display messages while loading the init file.
-(defun frame-initialize ()
-
- ;; Are we actually running under a window system at all?
- (if (and window-system (not noninteractive))
- (let ((frames (frame-list)))
-
- ;; Look for a frame that has a minibuffer.
- (while (and frames
- (or (eq (car frames) terminal-frame)
- (not (cdr (assq 'minibuffer
- (frame-parameters
- (car frames)))))))
- (setq frames (cdr frames)))
-
- ;; If there was none, then we need to create the opening frame.
- (or frames
- (setq default-minibuffer-frame
- (setq frame-initial-frame
- (new-frame initial-frame-alist))))
-
- ;; At this point, we know that we have a frame open, so we
- ;; can delete the terminal frame.
- (delete-frame terminal-frame)
- (setq terminal-frame nil))
-
- ;; No, we're not running a window system. Arrange to cause errors.
- (setq frame-creation-function
- (function
- (lambda (parameters)
- (error
- "Can't create multiple frames without a window system."))))))
-
-;;; startup.el calls this function after loading the user's init file.
-;;; If we created a minibuffer before knowing if we had permission, we
-;;; need to see if it should go away or change. Create a text frame
-;;; here.
-(defun frame-notice-user-settings ()
- (if frame-initial-frame
- (progn
-
- ;; If the user wants a minibuffer-only frame, we'll have to
- ;; make a new one; you can't remove or add a root window to/from
- ;; an existing frame.
- (if (eq (cdr (or (assq 'minibuffer initial-frame-alist)
- '(minibuffer . t)))
- 'only)
- (progn
- (setq default-minibuffer-frame
- (new-frame
- (append initial-frame-alist
- (frame-parameters frame-initial-frame))))
- (delete-frame frame-initial-frame))
- (modify-frame-parameters frame-initial-frame
- initial-frame-alist))))
-
- ;; Make sure the initial frame can be GC'd if it is ever deleted.
- (makunbound 'frame-initial-frame))
-
-\f
-;;;; Creation of additional frames
-
-;;; Return some frame other than the current frame,
-;;; creating one if neccessary. Note that the minibuffer frame, if
-;;; separate, is not considered (see next-frame).
-(defun get-other-frame ()
- (let ((s (if (equal (next-frame (selected-frame)) (selected-frame))
- (new-frame)
- (next-frame (selected-frame)))))
- s))
-
-(defun next-multiframe-window ()
- "Select the next window, regardless of which frame it is on."
- (interactive)
- (select-window (next-window (selected-window)
- (> (minibuffer-depth) 0)
- t)))
-
-(defun previous-multiframe-window ()
- "Select the previous window, regardless of which frame it is on."
- (interactive)
- (select-window (previous-window (selected-window)
- (> (minibuffer-depth) 0)
- t)))
-
-(defun new-frame (&optional parameters)
- "Create a new frame, displaying the current buffer.
-
-Optional argument PARAMETERS is an alist of parameters for the new
-frame. Specifically, PARAMETERS is a list of pairs, each having one
-of the following forms:
-
-(name . STRING) - The frame should be named STRING.
-
-(height . NUMBER) - The frame should be NUMBER text lines high. If
- this parameter is present, the width parameter must also be
- given.
-
-(width . NUMBER) - The frame should be NUMBER characters in width.
- If this parameter is present, the height parameter must also
- be given.
-
-(minibuffer . t) - the frame should have a minibuffer
-(minibuffer . none) - the frame should have no minibuffer
-(minibuffer . only) - the frame should contain only a minibuffer
-(minibuffer . WINDOW) - the frame should use WINDOW as its minibuffer window.
-
-(NAME . VALUE), specifying the parameter and the value it should have.
-NAME should be one of the following symbols:
- name VALUE
-
-The documentation for the function x-create-frame describes
-additional frame parameters that Emacs will recognize when running
-under the X Window System."
- (interactive)
- (funcall frame-creation-function parameters))
-
-\f
-;;;; Iconification
-
-;;; A possible enhancement for the below: if you iconify a surrogate
-;;; minibuffer frame, iconify all of its minibuffer's users too;
-;;; de-iconify them as a group. This will need to wait until frames
-;;; have mapping and unmapping hooks.
-
-(defun iconify ()
- "Iconify or deiconify the selected frame."
- (interactive)
- (let ((frame (selected-frame)))
- (if (eq (frame-visible-p frame) t)
- (iconify-frame frame)
- (make-frame-visible frame))))
-
-\f
-;;;; Frame configurations
-
-(defun current-frame-configuration ()
- "Return a list describing the positions and states of all frames.
-Each element is a list of the form (FRAME ALIST WINDOW-CONFIG), where
-FRAME is a frame object, ALIST is an association list specifying
-some of FRAME's parameters, and WINDOW-CONFIG is a window
-configuration object for FRAME."
- (mapcar (function
- (lambda (frame)
- (list frame
- (frame-parameters frame)
- (current-window-configuration frame))))
- (frame-list)))
-
-(defun set-frame-configuration (configuration)
- "Restore the frames to the state described by CONFIGURATION.
-Each frame listed in CONFIGURATION has its position, size, window
-configuration, and other parameters set as specified in CONFIGURATION."
- (let (frames-to-delete)
- (mapcar (function
- (lambda (frame)
- (let ((parameters (assq frame configuration)))
- (if parameters
- (progn
- (modify-frame-parameters frame (nth 1 parameters))
- (set-window-configuration (nth 2 parameters)))
- (setq frames-to-delete (cons frame frames-to-delete))))))
- (frame-list))
- (mapcar 'delete-frame frames-to-delete)))
-
-\f
-;;;; Convenience functions for accessing and interactively changing
-;;;; frame parameters.
-
-(defun frame-height (&optional frame)
- "Return number of lines available for display on FRAME.
-If FRAME is omitted, describe the currently selected frame."
- (cdr (assq 'height (frame-parameters frame))))
-
-(defun frame-width (&optional frame)
- "Return number of columns available for display on FRAME.
-If FRAME is omitted, describe the currently selected frame."
- (cdr (assq 'width (frame-parameters frame))))
-
-(defun set-frame-height (h)
- (interactive "NHeight: ")
- (let* ((frame (selected-frame))
- (width (cdr (assoc 'width (frame-parameters (selected-frame))))))
- (set-frame-size (selected-frame) width h)))
-
-(defun set-frame-width (w)
- (interactive "NWidth: ")
- (let* ((frame (selected-frame))
- (height (cdr (assoc 'height (frame-parameters (selected-frame))))))
- (set-frame-size (selected-frame) w height)))
-
-(defun set-default-font (font-name)
- (interactive "sFont name: ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'font font-name))))
-
-(defun set-frame-background (color-name)
- (interactive "sColor: ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'background-color color-name))))
-
-(defun set-frame-foreground (color-name)
- (interactive "sColor: ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'foreground-color color-name))))
-
-(defun set-cursor-color (color-name)
- (interactive "sColor: ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'cursor-color color-name))))
-
-(defun set-pointer-color (color-name)
- (interactive "sColor: ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'mouse-color color-name))))
-
-(defun set-auto-raise (toggle)
- (interactive "xt or nil? ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'auto-raise toggle))))
-
-(defun set-auto-lower (toggle)
- (interactive "xt or nil? ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'auto-lower toggle))))
-
-(defun set-vertical-bar (toggle)
- (interactive "xt or nil? ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'vertical-scroll-bar toggle))))
-
-(defun set-horizontal-bar (toggle)
- (interactive "xt or nil? ")
- (modify-frame-parameters (selected-frame)
- (list (cons 'horizontal-scroll-bar toggle))))
-\f
-;;;; Aliases for backward compatibility with Emacs 18.
-(fset 'screen-height 'frame-height)
-(fset 'screen-width 'frame-width)
-(fset 'set-screen-width 'set-frame-width)
-(fset 'set-screen-height 'set-frame-height)
-
-\f
-;;;; Key bindings
-(defvar ctl-x-5-map (make-sparse-keymap)
- "Keymap for frame commands.")
-(fset 'ctl-x-5-prefix ctl-x-5-map)
-(define-key ctl-x-map "5" 'ctl-x-5-prefix)
-
-(define-key ctl-x-5-map "2" 'new-frame)
-(define-key ctl-x-5-map "0" 'delete-frame)
-
-(provide 'frame)
-
-;;; frame.el ends here
+;;; frame.el --- multi-frame management independent of window systems.
+
+;; Copyright (C) 1993, 1994, 1996, 1997 Free Software Foundation, Inc.
+
+;; Maintainer: FSF
+;; Keywords: internal
+
+;; 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
+;; the Free Software Foundation; either version 2, or (at your option)
+;; 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 the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Code:
+
+(defvar frame-creation-function nil
+ "Window-system dependent function to call to create a new frame.
+The window system startup file should set this to its frame creation
+function, which should take an alist of parameters as its argument.")
+
+;;; The initial value given here for used to ask for a minibuffer.
+;;; But that's not necessary, because the default is to have one.
+;;; By not specifying it here, we let an X resource specify it.
+(defvar initial-frame-alist nil
+ "Alist of frame parameters for creating the initial X window frame.
+You can set this in your `.emacs' file; for example,
+ (setq initial-frame-alist '((top . 1) (left . 1) (width . 80) (height . 55)))
+Parameters specified here supersede the values given in `default-frame-alist'.
+
+If the value calls for a frame without a minibuffer, and you have not created
+a minibuffer frame on your own, one is created according to
+`minibuffer-frame-alist'.
+
+You can specify geometry-related options for just the initial frame
+by setting this variable in your `.emacs' file; however, they won't
+take effect until Emacs reads `.emacs', which happens after first creating
+the frame. If you want the frame to have the proper geometry as soon
+as it appears, you need to use this three-step process:
+* Specify X resources to give the geometry you want.
+* Set `default-frame-alist' to override these options so that they
+ don't affect subsequent frames.
+* Set `initial-frame-alist' in a way that matches the X resources,
+ to override what you put in `default-frame-alist'.")
+
+(defvar minibuffer-frame-alist '((width . 80) (height . 2))
+ "Alist of frame parameters for initially creating a minibuffer frame.
+You can set this in your `.emacs' file; for example,
+ (setq minibuffer-frame-alist
+ '((top . 1) (left . 1) (width . 80) (height . 2)))
+Parameters specified here supersede the values given in
+`default-frame-alist'.")
+
+(defvar pop-up-frame-alist nil
+ "Alist of frame parameters used when creating pop-up frames.
+Pop-up frames are used for completions, help, and the like.
+This variable can be set in your init file, like this:
+ (setq pop-up-frame-alist '((width . 80) (height . 20)))
+These supersede the values given in `default-frame-alist'.")
+
+(setq pop-up-frame-function
+ (function (lambda ()
+ (make-frame pop-up-frame-alist))))
+
+(defcustom special-display-frame-alist
+ '((height . 14) (width . 80) (unsplittable . t))
+ "*Alist of frame parameters used when creating special frames.
+Special frames are used for buffers whose names are in
+`special-display-buffer-names' and for buffers whose names match
+one of the regular expressions in `special-display-regexps'.
+This variable can be set in your init file, like this:
+ (setq special-display-frame-alist '((width . 80) (height . 20)))
+These supersede the values given in `default-frame-alist'."
+ :type '(repeat (cons :format "%v"
+ (symbol :tag "Parameter")
+ (sexp :tag "Value")))
+ :group 'frames)
+
+;; Display BUFFER in its own frame, reusing an existing window if any.
+;; Return the window chosen.
+;; Currently we do not insist on selecting the window within its frame.
+;; If ARGS is an alist, use it as a list of frame parameter specs.
+;; If ARGS is a list whose car is a symbol,
+;; use (car ARGS) as a function to do the work.
+;; Pass it BUFFER as first arg, and (cdr ARGS) gives the rest of the args.
+(defun special-display-popup-frame (buffer &optional args)
+ (if (and args (symbolp (car args)))
+ (apply (car args) buffer (cdr args))
+ (let ((window (get-buffer-window buffer t)))
+ (if window
+ ;; If we have a window already, make it visible.
+ (let ((frame (window-frame window)))
+ (make-frame-visible frame)
+ (raise-frame frame)
+ window)
+ ;; If no window yet, make one in a new frame.
+ (let ((frame (make-frame (append args special-display-frame-alist))))
+ (set-window-buffer (frame-selected-window frame) buffer)
+ (set-window-dedicated-p (frame-selected-window frame) t)
+ (frame-selected-window frame))))))
+
+;; Handle delete-frame events from the X server.
+(defun handle-delete-frame (event)
+ (interactive "e")
+ (let ((frame (posn-window (event-start event)))
+ (i 0)
+ (tail (frame-list)))
+ (while tail
+ (and (frame-visible-p (car tail))
+ (not (eq (car tail) frame))
+ (setq i (1+ i)))
+ (setq tail (cdr tail)))
+ (if (> i 0)
+ (delete-frame frame t)
+ ;; Gildea@x.org says it is ok to ask questions before terminating.
+ (save-buffers-kill-emacs))))
+\f
+;;;; Arrangement of frames at startup
+
+;;; 1) Load the window system startup file from the lisp library and read the
+;;; high-priority arguments (-q and the like). The window system startup
+;;; file should create any frames specified in the window system defaults.
+;;;
+;;; 2) If no frames have been opened, we open an initial text frame.
+;;;
+;;; 3) Once the init file is done, we apply any newly set parameters
+;;; in initial-frame-alist to the frame.
+
+;; These are now called explicitly at the proper times,
+;; since that is easier to understand.
+;; Actually using hooks within Emacs is bad for future maintenance. --rms.
+;; (add-hook 'before-init-hook 'frame-initialize)
+;; (add-hook 'window-setup-hook 'frame-notice-user-settings)
+
+;;; If we create the initial frame, this is it.
+(defvar frame-initial-frame nil)
+
+;; Record the parameters used in frame-initialize to make the initial frame.
+(defvar frame-initial-frame-alist)
+
+(defvar frame-initial-geometry-arguments nil)
+
+;;; startup.el calls this function before loading the user's init
+;;; file - if there is no frame with a minibuffer open now, create
+;;; one to display messages while loading the init file.
+(defun frame-initialize ()
+
+ ;; Are we actually running under a window system at all?
+ (if (and window-system (not noninteractive) (not (eq window-system 'pc)))
+ (progn
+ ;; Turn on special-display processing only if there's a window system.
+ (setq special-display-function 'special-display-popup-frame)
+
+ ;; If there is no frame with a minibuffer besides the terminal
+ ;; frame, then we need to create the opening frame. Make sure
+ ;; it has a minibuffer, but let initial-frame-alist omit the
+ ;; minibuffer spec.
+ (or (delq terminal-frame (minibuffer-frame-list))
+ (progn
+ (setq frame-initial-frame-alist
+ (append initial-frame-alist default-frame-alist))
+ (or (assq 'horizontal-scroll-bars frame-initial-frame-alist)
+ (setq frame-initial-frame-alist
+ (cons '(horizontal-scroll-bars . t)
+ frame-initial-frame-alist)))
+ (setq default-minibuffer-frame
+ (setq frame-initial-frame
+ (make-frame frame-initial-frame-alist)))
+ ;; Delete any specifications for window geometry parameters
+ ;; so that we won't reapply them in frame-notice-user-settings.
+ ;; It would be wrong to reapply them then,
+ ;; because that would override explicit user resizing.
+ (setq initial-frame-alist
+ (frame-remove-geometry-params initial-frame-alist))))
+ ;; At this point, we know that we have a frame open, so we
+ ;; can delete the terminal frame.
+ (delete-frame terminal-frame)
+ (setq terminal-frame nil))
+
+ ;; No, we're not running a window system. Use make-terminal-frame if
+ ;; we support that feature, otherwise arrange to cause errors.
+ (or (eq window-system 'pc)
+ (setq frame-creation-function
+ (if (fboundp 'make-terminal-frame)
+ 'make-terminal-frame
+ (function
+ (lambda (parameters)
+ (error
+ "Can't create multiple frames without a window system"))))))))
+
+;;; startup.el calls this function after loading the user's init
+;;; file. Now default-frame-alist and initial-frame-alist contain
+;;; information to which we must react; do what needs to be done.
+(defun frame-notice-user-settings ()
+
+ ;; Make menu-bar-mode and default-frame-alist consistent.
+ (if (boundp 'menu-bar-mode)
+ (let ((default (assq 'menu-bar-lines default-frame-alist)))
+ (if default
+ (setq menu-bar-mode (not (eq (cdr default) 0)))
+ (setq default-frame-alist
+ (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
+ default-frame-alist)))))
+
+ ;; Creating and deleting frames may shift the selected frame around,
+ ;; and thus the current buffer. Protect against that. We don't
+ ;; want to use save-excursion here, because that may also try to set
+ ;; the buffer of the selected window, which fails when the selected
+ ;; window is the minibuffer.
+ (let ((old-buffer (current-buffer)))
+
+ ;; If the initial frame is still around, apply initial-frame-alist
+ ;; and default-frame-alist to it.
+ (if (frame-live-p frame-initial-frame)
+
+ ;; The initial frame we create above always has a minibuffer.
+ ;; If the user wants to remove it, or make it a minibuffer-only
+ ;; frame, then we'll have to delete the current frame and make a
+ ;; new one; you can't remove or add a root window to/from an
+ ;; existing frame.
+ ;;
+ ;; NOTE: default-frame-alist was nil when we created the
+ ;; existing frame. We need to explicitly include
+ ;; default-frame-alist in the parameters of the screen we
+ ;; create here, so that its new value, gleaned from the user's
+ ;; .emacs file, will be applied to the existing screen.
+ (if (not (eq (cdr (or (assq 'minibuffer initial-frame-alist)
+ (assq 'minibuffer default-frame-alist)
+ '(minibuffer . t)))
+ t))
+ ;; Create the new frame.
+ (let (parms new)
+ ;; If the frame isn't visible yet, wait till it is.
+ ;; If the user has to position the window,
+ ;; Emacs doesn't know its real position until
+ ;; the frame is seen to be visible.
+ (while (not (cdr (assq 'visibility
+ (frame-parameters frame-initial-frame))))
+ (sleep-for 1))
+ (setq parms (frame-parameters frame-initial-frame))
+ ;; Get rid of `name' unless it was specified explicitly before.
+ (or (assq 'name frame-initial-frame-alist)
+ (setq parms (delq (assq 'name parms) parms)))
+ (setq parms (append initial-frame-alist
+ default-frame-alist
+ parms
+ nil))
+ ;; Get rid of `reverse', because that was handled
+ ;; when we first made the frame.
+ (setq parms (cons '(reverse) (delq (assq 'reverse parms) parms)))
+ (if (assq 'height frame-initial-geometry-arguments)
+ (setq parms (frame-delete-all 'height parms)))
+ (if (assq 'width frame-initial-geometry-arguments)
+ (setq parms (frame-delete-all 'width parms)))
+ (if (assq 'left frame-initial-geometry-arguments)
+ (setq parms (frame-delete-all 'left parms)))
+ (if (assq 'top frame-initial-geometry-arguments)
+ (setq parms (frame-delete-all 'top parms)))
+ (setq new
+ (make-frame
+ ;; Use the geometry args that created the existing
+ ;; frame, rather than the parms we get for it.
+ (append frame-initial-geometry-arguments
+ '((user-size . t) (user-position . t))
+ parms)))
+ ;; The initial frame, which we are about to delete, may be
+ ;; the only frame with a minibuffer. If it is, create a
+ ;; new one.
+ (or (delq frame-initial-frame (minibuffer-frame-list))
+ (make-initial-minibuffer-frame nil))
+
+ ;; If the initial frame is serving as a surrogate
+ ;; minibuffer frame for any frames, we need to wean them
+ ;; onto a new frame. The default-minibuffer-frame
+ ;; variable must be handled similarly.
+ (let ((users-of-initial
+ (filtered-frame-list
+ (function (lambda (frame)
+ (and (not (eq frame frame-initial-frame))
+ (eq (window-frame
+ (minibuffer-window frame))
+ frame-initial-frame)))))))
+ (if (or users-of-initial
+ (eq default-minibuffer-frame frame-initial-frame))
+
+ ;; Choose an appropriate frame. Prefer frames which
+ ;; are only minibuffers.
+ (let* ((new-surrogate
+ (car
+ (or (filtered-frame-list
+ (function
+ (lambda (frame)
+ (eq (cdr (assq 'minibuffer
+ (frame-parameters frame)))
+ 'only))))
+ (minibuffer-frame-list))))
+ (new-minibuffer (minibuffer-window new-surrogate)))
+
+ (if (eq default-minibuffer-frame frame-initial-frame)
+ (setq default-minibuffer-frame new-surrogate))
+
+ ;; Wean the frames using frame-initial-frame as
+ ;; their minibuffer frame.
+ (mapcar
+ (function
+ (lambda (frame)
+ (modify-frame-parameters
+ frame (list (cons 'minibuffer new-minibuffer)))))
+ users-of-initial))))
+
+ ;; Redirect events enqueued at this frame to the new frame.
+ ;; Is this a good idea?
+ (redirect-frame-focus frame-initial-frame new)
+
+ ;; Finally, get rid of the old frame.
+ (delete-frame frame-initial-frame t))
+
+ ;; Otherwise, we don't need all that rigamarole; just apply
+ ;; the new parameters.
+ (let (newparms allparms tail)
+ (setq allparms (append initial-frame-alist
+ default-frame-alist))
+ (if (assq 'height frame-initial-geometry-arguments)
+ (setq allparms (frame-delete-all 'height allparms)))
+ (if (assq 'width frame-initial-geometry-arguments)
+ (setq allparms (frame-delete-all 'width allparms)))
+ (if (assq 'left frame-initial-geometry-arguments)
+ (setq allparms (frame-delete-all 'left allparms)))
+ (if (assq 'top frame-initial-geometry-arguments)
+ (setq allparms (frame-delete-all 'top allparms)))
+ (setq tail allparms)
+ ;; Find just the parms that have changed since we first
+ ;; made this frame. Those are the ones actually set by
+ ;; the init file. For those parms whose values we already knew
+ ;; (such as those spec'd by command line options)
+ ;; it is undesirable to specify the parm again
+ ;; once the user has seen the frame and been able to alter it
+ ;; manually.
+ (while tail
+ (let (newval oldval)
+ (setq oldval (assq (car (car tail))
+ frame-initial-frame-alist))
+ (setq newval (cdr (assq (car (car tail)) allparms)))
+ (or (and oldval (eq (cdr oldval) newval))
+ (setq newparms
+ (cons (cons (car (car tail)) newval) newparms))))
+ (setq tail (cdr tail)))
+ (setq newparms (nreverse newparms))
+ (modify-frame-parameters frame-initial-frame
+ newparms)
+ (if (assq 'font newparms)
+ (frame-update-faces frame-initial-frame)))))
+
+ ;; Restore the original buffer.
+ (set-buffer old-buffer)
+
+ ;; Make sure the initial frame can be GC'd if it is ever deleted.
+ ;; Make sure frame-notice-user-settings does nothing if called twice.
+ (setq frame-initial-frame nil)))
+
+(defun make-initial-minibuffer-frame (display)
+ (let ((parms (append minibuffer-frame-alist '((minibuffer . only)))))
+ (if display
+ (make-frame-on-display display parms)
+ (make-frame parms))))
+
+;; Delete from ALIST all elements whose car is KEY.
+;; Return the modified alist.
+(defun frame-delete-all (key alist)
+ (setq alist (copy-sequence alist))
+ (let ((tail alist))
+ (while tail
+ (if (eq (car (car tail)) key)
+ (setq alist (delq (car tail) alist)))
+ (setq tail (cdr tail)))
+ alist))
+\f
+;;;; Creation of additional frames, and other frame miscellanea
+
+;;; Return some frame other than the current frame, creating one if
+;;; necessary. Note that the minibuffer frame, if separate, is not
+;;; considered (see next-frame).
+(defun get-other-frame ()
+ (let ((s (if (equal (next-frame (selected-frame)) (selected-frame))
+ (make-frame)
+ (next-frame (selected-frame)))))
+ s))
+
+(defun next-multiframe-window ()
+ "Select the next window, regardless of which frame it is on."
+ (interactive)
+ (select-window (next-window (selected-window)
+ (> (minibuffer-depth) 0)
+ t)))
+
+(defun previous-multiframe-window ()
+ "Select the previous window, regardless of which frame it is on."
+ (interactive)
+ (select-window (previous-window (selected-window)
+ (> (minibuffer-depth) 0)
+ t)))
+
+(defun make-frame-on-display (display &optional parameters)
+ "Make a frame on display DISPLAY.
+The optional second argument PARAMETERS specifies additional frame parameters."
+ (interactive "sMake frame on display: ")
+ (make-frame (cons (cons 'display display) parameters)))
+
+(defun make-frame-command ()
+ "Make a new frame, and select it if the terminal displays only one frame."
+ (interactive)
+ (if (and window-system (not (eq window-system 'pc)))
+ (make-frame)
+ (select-frame (make-frame))))
+
+(defvar before-make-frame-hook nil
+ "Functions to run before a frame is created.")
+
+(defvar after-make-frame-functions nil
+ "Functions to run after a frame is created.
+The functions are run with one arg, the newly created frame.")
+
+;; Alias, kept temporarily.
+(defalias 'new-frame 'make-frame)
+
+(defun make-frame (&optional parameters)
+ "Return a newly created frame displaying the current buffer.
+Optional argument PARAMETERS is an alist of parameters for the new frame.
+Each element of PARAMETERS should have the form (NAME . VALUE), for example:
+
+ (name . STRING) The frame should be named STRING.
+
+ (width . NUMBER) The frame should be NUMBER characters in width.
+ (height . NUMBER) The frame should be NUMBER text lines high.
+
+You cannot specify either `width' or `height', you must use neither or both.
+
+ (minibuffer . t) The frame should have a minibuffer.
+ (minibuffer . nil) The frame should have no minibuffer.
+ (minibuffer . only) The frame should contain only a minibuffer.
+ (minibuffer . WINDOW) The frame should use WINDOW as its minibuffer window.
+
+Before the frame is created (via `frame-creation-function'), functions on the
+hook `before-make-frame-hook' are run. After the frame is created, functions
+on `after-make-frame-functions' are run with one arg, the newly created frame."
+ (interactive)
+ (run-hooks 'before-make-frame-hook)
+ (let ((frame (funcall frame-creation-function parameters)))
+ (run-hook-with-args 'after-make-frame-functions frame)
+ frame))
+
+(defun filtered-frame-list (predicate)
+ "Return a list of all live frames which satisfy PREDICATE."
+ (let ((frames (frame-list))
+ good-frames)
+ (while (consp frames)
+ (if (funcall predicate (car frames))
+ (setq good-frames (cons (car frames) good-frames)))
+ (setq frames (cdr frames)))
+ good-frames))
+
+(defun minibuffer-frame-list ()
+ "Return a list of all frames with their own minibuffers."
+ (filtered-frame-list
+ (function (lambda (frame)
+ (eq frame (window-frame (minibuffer-window frame)))))))
+
+(defun frame-remove-geometry-params (param-list)
+ "Return the parameter list PARAM-LIST, but with geometry specs removed.
+This deletes all bindings in PARAM-LIST for `top', `left', `width',
+`height', `user-size' and `user-position' parameters.
+Emacs uses this to avoid overriding explicit moves and resizings from
+the user during startup."
+ (setq param-list (cons nil param-list))
+ (let ((tail param-list))
+ (while (consp (cdr tail))
+ (if (and (consp (car (cdr tail)))
+ (memq (car (car (cdr tail)))
+ '(height width top left user-position user-size)))
+ (progn
+ (setq frame-initial-geometry-arguments
+ (cons (car (cdr tail)) frame-initial-geometry-arguments))
+ (setcdr tail (cdr (cdr tail))))
+ (setq tail (cdr tail)))))
+ (setq frame-initial-geometry-arguments
+ (nreverse frame-initial-geometry-arguments))
+ (cdr param-list))
+
+
+(defun other-frame (arg)
+ "Select the ARG'th different visible frame, and raise it.
+All frames are arranged in a cyclic order.
+This command selects the frame ARG steps away in that order.
+A negative ARG moves in the opposite order."
+ (interactive "p")
+ (let ((frame (selected-frame)))
+ (while (> arg 0)
+ (setq frame (next-frame frame))
+ (while (not (eq (frame-visible-p frame) t))
+ (setq frame (next-frame frame)))
+ (setq arg (1- arg)))
+ (while (< arg 0)
+ (setq frame (previous-frame frame))
+ (while (not (eq (frame-visible-p frame) t))
+ (setq frame (previous-frame frame)))
+ (setq arg (1+ arg)))
+ (raise-frame frame)
+ (select-frame frame)
+ ;; Ensure, if possible, that frame gets input focus.
+ (if (eq window-system 'w32)
+ (w32-focus-frame frame)
+ (set-mouse-position (selected-frame) (1- (frame-width)) 0))))
+\f
+;;;; Frame configurations
+
+(defun current-frame-configuration ()
+ "Return a list describing the positions and states of all frames.
+Its car is `frame-configuration'.
+Each element of the cdr is a list of the form (FRAME ALIST WINDOW-CONFIG),
+where
+ FRAME is a frame object,
+ ALIST is an association list specifying some of FRAME's parameters, and
+ WINDOW-CONFIG is a window configuration object for FRAME."
+ (cons 'frame-configuration
+ (mapcar (function
+ (lambda (frame)
+ (list frame
+ (frame-parameters frame)
+ (current-window-configuration frame))))
+ (frame-list))))
+
+(defun set-frame-configuration (configuration &optional nodelete)
+ "Restore the frames to the state described by CONFIGURATION.
+Each frame listed in CONFIGURATION has its position, size, window
+configuration, and other parameters set as specified in CONFIGURATION.
+Ordinarily, this function deletes all existing frames not
+listed in CONFIGURATION. But if optional second argument NODELETE
+is given and non-nil, the unwanted frames are iconified instead."
+ (or (frame-configuration-p configuration)
+ (signal 'wrong-type-argument
+ (list 'frame-configuration-p configuration)))
+ (let ((config-alist (cdr configuration))
+ frames-to-delete)
+ (mapcar (function
+ (lambda (frame)
+ (let ((parameters (assq frame config-alist)))
+ (if parameters
+ (progn
+ (modify-frame-parameters
+ frame
+ ;; Since we can't set a frame's minibuffer status,
+ ;; we might as well omit the parameter altogether.
+ (let* ((parms (nth 1 parameters))
+ (mini (assq 'minibuffer parms)))
+ (if mini (setq parms (delq mini parms)))
+ parms))
+ (set-window-configuration (nth 2 parameters)))
+ (setq frames-to-delete (cons frame frames-to-delete))))))
+ (frame-list))
+ (if nodelete
+ ;; Note: making frames invisible here was tried
+ ;; but led to some strange behavior--each time the frame
+ ;; was made visible again, the window manager asked afresh
+ ;; for where to put it.
+ (mapcar 'iconify-frame frames-to-delete)
+ (mapcar 'delete-frame frames-to-delete))))
+\f
+;;;; Convenience functions for accessing and interactively changing
+;;;; frame parameters.
+
+(defun frame-parameter (frame parameter)
+ "Return FRAME's value for parameter PARAMETER.
+If FRAME is omitted, describe the currently selected frame."
+ (cdr (assq parameter (frame-parameters frame))))
+
+(defun frame-height (&optional frame)
+ "Return number of lines available for display on FRAME.
+If FRAME is omitted, describe the currently selected frame."
+ (cdr (assq 'height (frame-parameters frame))))
+
+(defun frame-width (&optional frame)
+ "Return number of columns available for display on FRAME.
+If FRAME is omitted, describe the currently selected frame."
+ (cdr (assq 'width (frame-parameters frame))))
+
+(defalias 'set-default-font 'set-frame-font)
+(defun set-frame-font (font-name)
+ "Set the font of the selected frame to FONT.
+When called interactively, prompt for the name of the font to use.
+To get the frame's current default font, use `frame-parameters'."
+ (interactive "sFont name: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'font font-name)))
+ ;; Update faces that want a bold or italic version of the default font.
+ (frame-update-faces (selected-frame)))
+
+(defun set-background-color (color-name)
+ "Set the background color of the selected frame to COLOR.
+When called interactively, prompt for the name of the color to use.
+To get the frame's current background color, use `frame-parameters'."
+ (interactive "sColor: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'background-color color-name)))
+ (frame-update-face-colors (selected-frame)))
+
+(defun set-foreground-color (color-name)
+ "Set the foreground color of the selected frame to COLOR.
+When called interactively, prompt for the name of the color to use.
+To get the frame's current foreground color, use `frame-parameters'."
+ (interactive "sColor: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'foreground-color color-name)))
+ (frame-update-face-colors (selected-frame)))
+
+(defun set-cursor-color (color-name)
+ "Set the text cursor color of the selected frame to COLOR.
+When called interactively, prompt for the name of the color to use.
+To get the frame's current cursor color, use `frame-parameters'."
+ (interactive "sColor: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'cursor-color color-name))))
+
+(defun set-mouse-color (color-name)
+ "Set the color of the mouse pointer of the selected frame to COLOR.
+When called interactively, prompt for the name of the color to use.
+To get the frame's current mouse color, use `frame-parameters'."
+ (interactive "sColor: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'mouse-color color-name))))
+
+(defun set-border-color (color-name)
+ "Set the color of the border of the selected frame to COLOR.
+When called interactively, prompt for the name of the color to use.
+To get the frame's current border color, use `frame-parameters'."
+ (interactive "sColor: ")
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'border-color color-name))))
+
+(defun auto-raise-mode (arg)
+ "Toggle whether or not the selected frame should auto-raise.
+With arg, turn auto-raise mode on if and only if arg is positive.
+Note that this controls Emacs's own auto-raise feature.
+Some window managers allow you to enable auto-raise for certain windows.
+You can use that for Emacs windows if you wish, but if you do,
+that is beyond the control of Emacs and this command has no effect on it."
+ (interactive "P")
+ (if (null arg)
+ (setq arg
+ (if (cdr (assq 'auto-raise (frame-parameters (selected-frame))))
+ -1 1)))
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'auto-raise (> arg 0)))))
+
+(defun auto-lower-mode (arg)
+ "Toggle whether or not the selected frame should auto-lower.
+With arg, turn auto-lower mode on if and only if arg is positive.
+Note that this controls Emacs's own auto-lower feature.
+Some window managers allow you to enable auto-lower for certain windows.
+You can use that for Emacs windows if you wish, but if you do,
+that is beyond the control of Emacs and this command has no effect on it."
+ (interactive "P")
+ (if (null arg)
+ (setq arg
+ (if (cdr (assq 'auto-lower (frame-parameters (selected-frame))))
+ -1 1)))
+ (modify-frame-parameters (selected-frame)
+ (list (cons 'auto-lower (> arg 0)))))
+\f
+;;;; Aliases for backward compatibility with Emacs 18.
+(defalias 'screen-height 'frame-height)
+(defalias 'screen-width 'frame-width)
+
+(defun set-screen-width (cols &optional pretend)
+ "Obsolete function to change the size of the screen to COLS columns.\n\
+Optional second arg non-nil means that redisplay should use COLS columns\n\
+but that the idea of the actual width of the frame should not be changed.\n\
+This function is provided only for compatibility with Emacs 18; new code\n\
+should use `set-frame-width instead'."
+ (set-frame-width (selected-frame) cols pretend))
+
+(defun set-screen-height (lines &optional pretend)
+ "Obsolete function to change the height of the screen to LINES lines.\n\
+Optional second arg non-nil means that redisplay should use LINES lines\n\
+but that the idea of the actual height of the screen should not be changed.\n\
+This function is provided only for compatibility with Emacs 18; new code\n\
+should use `set-frame-height' instead."
+ (set-frame-height (selected-frame) lines pretend))
+
+(make-obsolete 'screen-height 'frame-height)
+(make-obsolete 'screen-width 'frame-width)
+(make-obsolete 'set-screen-width 'set-frame-width)
+(make-obsolete 'set-screen-height 'set-frame-height)
+
+\f
+;;;; Key bindings
+
+(define-key ctl-x-5-map "2" 'make-frame-command)
+(define-key ctl-x-5-map "0" 'delete-frame)
+(define-key ctl-x-5-map "o" 'other-frame)
+
+(provide 'frame)
+
+;;; frame.el ends here