Add manual entry for fullscreen-restore parameter.

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

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 3e5d9acba861b2f3ee47dc8dbf62eb48744ed78f..d82be3c83e77b3a7eff493cef36bcb77a6c7b08e 100644 (file)
--- 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 559f4cc56dc41f31232adb56bb72406099618f7f..0b8106dfc9cf39c2c146bc91f52d699a54ba28ba 100644 (file)
--- 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 dfcebf16455556211fb75cd2fb123663eb7f7533..0096ef9696a722cf33005e6963e0c955d3fed9a5 100644 (file)
--- 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