From 061c7e2b5a5a5854b2b85f2ace5b1d9222dd7f11 Mon Sep 17 00:00:00 2001 From: Martin Rudalics Date: Wed, 11 Feb 2015 11:02:03 +0100 Subject: [PATCH] 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 3e5d9acba86..d82be3c83e7 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,7 +1,8 @@ 2015-02-11 Martin Rudalics * frames.texi (Size Parameters): Update description of - fullscreen frame parameter. + fullscreen frame parameter. Describe `fullscreen-restore' + parameter. 2015-02-09 Eli Zaretskii 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 -- 2.11.4.GIT