(Creating Frames): Document frame-inherited-parameters.

(Parameter Access): Document set-frame-parameter.

3 files changed, 26 insertions, 0 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index e12c210061e..84884e3cbe3 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,8 @@
 2008-10-15  Eli Zaretskii  <eliz@gnu.org>
 
+        * frames.texi (Creating Frames): Document frame-inherited-parameters.
+        (Parameter Access): Document set-frame-parameter.
+
         * variables.texi (Creating Buffer-Local): Add an xref to "Setting
         Hooks" for the effect of kill-all-local-variables on local hook
         functions.
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 5c00c1cc02f..4f9686a36ec 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -98,6 +98,12 @@ variable @code{default-frame-alist}; parameters not specified even there
 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 @@ Each function in @code{after-make-frame-functions} receives one argument, the
 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 @@ You can use this function to define frame-local bindings for
 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}
diff --git a/etc/NEWS b/etc/NEWS
index a11cf88f40d..ea0a76e69c3 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1118,9 +1118,11 @@ Use this instead of "~/.emacs.d".
 property, `kill-all-local-variables' does not remove it from the local
 value of the hook variable; it remains even if you change major modes.
 
++++
 ** `frame-inherited-parameters' lets new frames inherit parameters from
 the selected frame.
 
++++
 ** New keymap `input-decode-map' overrides like key-translation-map, but
 applies before function-key-map.  Also it is terminal-local contrary to
 key-translation-map.  Terminal-specific key-sequences are generally added to