Mercurial > emacs
diff lispref/frames.texi @ 8110:bf6ecdddf78b
*** empty log message ***
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Fri, 01 Jul 1994 20:11:01 +0000 |
parents | ec7caebc4a1d |
children | bc548090f760 |
line wrap: on
line diff
--- a/lispref/frames.texi Fri Jul 01 17:31:42 1994 +0000 +++ b/lispref/frames.texi Fri Jul 01 20:11:01 1994 +0000 @@ -71,33 +71,6 @@ when creating an X window frame. @end defun -@defvar default-frame-alist -This is an alist specifying default values of frame parameters. -Each element has the form: - -@example -(@var{parameter} . @var{value}) -@end example -@end defvar - -@defvar initial-frame-alist -This is an alist specifying frame parameters for the initial Emacs frame. - -Emacs creates the initial X frame before it reads the user's init file, -which is the first occasion that the user has to set this variable. So -after reading the init file, Emacs modifies the parameters according to -the value of this variable. In most cases, that is good enough. -However, for window position parameters, it may be inconvenient that the -window initially appears in the wrong place or the wrong size. The way -to overcome this annoyance is to specify the initial frame's geometry -with an X resource. -@end defvar - -If you use options that specify window appearance when you invoke Emacs, -they take effect by adding elements to @code{default-frame-alist}. One -exception is @samp{-geometry}, which adds to @code{initial-frame-alist} -instead. @xref{Command Arguments,,, emacs, The GNU Emacs Manual}. - @defvar before-make-frame-hook A normal hook run by @code{make-frame} before it actually creates the frame. @@ -153,7 +126,30 @@ @defvar initial-frame-alist This variable's value is an alist of parameter values used when creating -the initial X window frame. +the initial X window frame. Each element has the form: + +@example +(@var{parameter} . @var{value}) +@end example + +Emacs creates the initial frame before it reads your @file{~/.emacs} +file. After reading that file, Emacs checks @code{initial-frame-alist}, +and applies the parameter settings in the altered value to the already +created initial frame. + +If these settings affect the frame geometry, you'll see the frame appear +with the wrong geometry and then change to the specified one. If you +like, you can specify the same geometry with X resources; those do take +affect before the frame is created. @xref{Resources X,, X Resources, +emacs, The GNU Emacs Manual}. + +X resource settings typically apply to all frames. If you want to +specify some X resources solely for the sake of the initial frame, and +you don't want them to apply to subsequent frames, here's how to achieve +this. Specify parameters in @code{default-frame-alist} to override the +X resources for subsequent frames; then, to prevent these from affecting +the initial frame, specify the same parameters in +@code{initial-frame-alist} with values that match the X resources. @end defvar If these parameters specify a separate minibuffer-only frame, @@ -165,6 +161,21 @@ to the parameters for the main initial frame. @end defvar +@defvar special-display-frame-alist +The variable @code{special-display-frame-alist} specifies the frame +parameters for special display frames. +@end defvar + +@defvar default-frame-alist +This is an alist specifying default values of frame parameters for +subsequent Emacs frames (not the initial ones). +@end defvar + +If you use options that specify window appearance when you invoke Emacs, +they take effect by adding elements to @code{default-frame-alist}. One +exception is @samp{-geometry}, which adds to @code{initial-frame-alist} +instead. @xref{Command Arguments,,, emacs, The GNU Emacs Manual}. + @node X Frame Parameters @subsection X Window Frame Parameters