Add manual entry for fullscreen-restore parameter.

* frames.texi (Size Parameters): Describe `fullscreen-restore'
parameter.

2 files changed, 20 insertions, 1 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 3e5d9acba86..d82be3c83e7 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,7 +1,8 @@
 2015-02-11  Martin Rudalics  <rudalics@gmx.at>
 
         * frames.texi (Size Parameters): Update description of
-        fullscreen frame parameter.
+        fullscreen frame parameter.  Describe `fullscreen-restore'
+        parameter.
 
 2015-02-09  Eli Zaretskii  <eliz@gnu.org>
 
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 559f4cc56dc..0b8106dfc9c 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -757,6 +757,24 @@ make a frame truly appear ``maximized'' or ``fullscreen''.  Moreover,
 some window managers might not support smooth transition between the
 various fullscreen or maximization states.  Customizing the variable
 @code{x-frame-normalize-before-maximize} can help to overcome that.
+
+@vindex fullscreen-restore, a frame parameter
+@item fullscreen-restore
+This parameter specifies the desired ``fullscreen'' state of the frame
+after invoking the @code{toggle-frame-fullscreen} command (@pxref{Frame
+Commands,,, emacs, The GNU Emacs Manual}) in the ``fullboth'' state.
+Normally this parameter is installed automatically by that command when
+toggling the state to fullboth.  If, however, you start Emacs in the
+fullboth state, you have to specify the desired behavior in your initial
+file as, for example
+
+@example
+(setq default-frame-alist
+    '((fullscreen . fullboth) (fullscreen-restore . fullheight)))
+@end example
+
+This will give a new frame full height after typing in it @key{F11} for
+the first time.
 @end table