From 4fb04348e54f91a29de30057896bb351b11377a8 Mon Sep 17 00:00:00 2001
From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 15 Oct 2008 12:25:19 +0000
Subject: [PATCH] (Creating Frames): Document frame-inherited-parameters.
 (Parameter Access): Document set-frame-parameter.

---
 doc/lispref/ChangeLog   |  3 +++
 doc/lispref/frames.texi | 21 +++++++++++++++++++++
 etc/NEWS                |  2 ++
 3 files changed, 26 insertions(+)

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
-- 
2.39.5