[Emacs-diffs] master 061c7e2: Add manual entry for fullscreen-restore parameter.

[Martin Rudalics]

branch: master
commit 061c7e2b5a5a5854b2b85f2ace5b1d9222dd7f11
Author: Martin Rudalics <address@hidden>
Commit: Martin Rudalics <address@hidden>

    Add manual entry for fullscreen-restore parameter.
    
    * frames.texi (Size Parameters): Describe `fullscreen-restore'
    parameter.
---
 doc/lispref/ChangeLog   |    3 ++-
 doc/lispref/frames.texi |   18 ++++++++++++++++++
 lisp/frame.el           |    2 +-
 3 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 3e5d9ac..d82be3c 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,7 +1,8 @@
 2015-02-11  Martin Rudalics  <address@hidden>
 
        * frames.texi (Size Parameters): Update description of
-       fullscreen frame parameter.
+       fullscreen frame parameter.  Describe `fullscreen-restore'
+       parameter.
 
 2015-02-09  Eli Zaretskii  <address@hidden>
 
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 559f4cc..0b8106d 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.
+
address@hidden fullscreen-restore, a frame parameter
address@hidden 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
+
address@hidden
+(setq default-frame-alist
+    '((fullscreen . fullboth) (fullscreen-restore . fullheight)))
address@hidden 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 dfcebf1..0096ef9 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