Add manual entry for fullscreen-restore parameter.

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

3 files changed, 21 insertions, 2 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
 
 
diff --git a/lisp/frame.el b/lisp/frame.el
index dfcebf16455..0096ef9696a 100644
--- a/lisp/frame.el
+++ b/lisp/frame.el
@@ -1906,7 +1906,7 @@ is already fullscreen.
 Before making the frame fullscreen remember the current value of
 the frame's `fullscreen' parameter in the `fullscreen-restore'
 parameter of the frame.  That value is used to restore the
-frame's size when toggling fullscreen the next time.
+frame's fullscreen state when toggling fullscreen the next time.
 
 Note that with some window managers you may have to set
 `frame-resize-pixelwise' to non-nil in order to make a frame