changeset 98737:40fea3019362

(Creating Frames): Document frame-inherited-parameters. (Parameter Access): Document set-frame-parameter.
author Eli Zaretskii <eliz@gnu.org>
date Wed, 15 Oct 2008 12:22:07 +0000
parents 54ba73f04e0b
children 2d0218e038ba
files doc/lispref/frames.texi
diffstat 1 files changed, 21 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/lispref/frames.texi	Wed Oct 15 11:49:10 2008 +0000
+++ b/doc/lispref/frames.texi	Wed Oct 15 12:22:07 2008 +0000
@@ -98,6 +98,12 @@
 default from the standard X resources or whatever is used instead on
 your system.
 
+After the frame is created, this function applies to it the
+parameters, if any, listed in the value of
+@code{frame-inherited-parameters} (see below) and not present in the
+argument, taking the values from the frame that was selected when
+@code{make-frame} was called.
+
 The set of possible parameters depends in principle on what kind of
 window system Emacs uses to display its frames.  @xref{Window Frame
 Parameters}, for documentation of individual parameters you can specify.
@@ -120,6 +126,15 @@
 frame just created.
 @end defvar
 
+@defvar frame-inherited-parameters
+This variable specifies the list of frame parameters that a newly
+created frame inherits from the currently selected frame.  For each
+parameter (a symbol) that is an element in the list and is not present
+in the argument to @code{make-frame}, the function sets the value of
+that parameter in the created frame to its value in the selected
+frame.
+@end defvar
+
 @node Multiple Displays
 @section Multiple Displays
 @cindex multiple X displays
@@ -258,6 +273,12 @@
 variables, see @ref{Frame-Local Variables}.
 @end defun
 
+@defun set-frame-parameter frame parm value
+This function sets the the frame parameter @var{parm} to the specified
+@var{value}.  If @var{frame} is @code{nil}, it defaults to the
+selected frame.
+@end defun
+
 @defun modify-all-frames-parameters alist
 This function alters the frame parameters of all existing frames
 according to @var{alist}, then modifies @code{default-frame-alist}