From f63bd04be9c6a1a9b09749a86ac693726994bda2 Mon Sep 17 00:00:00 2001 From: Martin Rudalics Date: Fri, 3 Oct 2014 11:18:49 +0200 Subject: [PATCH] Mention `frame-resize-pixelwise' to make frames truly fullscreen or maximized. * frame.el (toggle-frame-maximized, toggle-frame-fullscreen): In doc-string mention need of setting `frame-resize-pixelwise'. * frames.texi (Frame Commands): * cmdargs.texi (Window Size X): Mention the use of `frame-resize-pixelwise' to make frames truly fullscreen or maximized. * frames.texi (Size Parameters, Size and Position): Mention that with some window managers you have to set `frame-resize-pixelwise' in order make a frame truly fullscreen or maximized. --- doc/emacs/ChangeLog | 7 +++++++ doc/emacs/cmdargs.texi | 8 ++++---- doc/emacs/frames.texi | 4 ++++ doc/lispref/ChangeLog | 7 +++++++ doc/lispref/frames.texi | 10 +++++++++- lisp/ChangeLog | 5 +++++ lisp/frame.el | 10 ++++++++++ 7 files changed, 46 insertions(+), 5 deletions(-) diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index b4d13d24325..5d262c00c33 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,10 @@ +2014-10-03 Martin Rudalics + + * frames.texi (Frame Commands): + * cmdargs.texi (Window Size X): Mention the use of + `frame-resize-pixelwise' to make frames truly fullscreen or + maximized. + 2014-10-01 Glenn Morris * package.texi (Package Installation): Mention etc/package-keyring.gpg. diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi index 8b3654dae68..56137272be6 100644 --- a/doc/emacs/cmdargs.texi +++ b/doc/emacs/cmdargs.texi @@ -987,10 +987,10 @@ size with no tool bar, use an X resource to specify ``no tool bar'' (@pxref{Table of Resources}); then Emacs will already know there's no tool bar when it processes the specified geometry. - When using one of @samp{--fullscreen}, @samp{--maximized}, @samp{--fullwidth} -or @samp{--fullheight} there may be some space around the frame -anyway. That is because Emacs rounds the sizes so they are an -even number of character heights and widths. + When using one of @samp{--fullscreen}, @samp{--maximized}, +@samp{--fullwidth} or @samp{--fullheight}, some window managers require +to set the variable @code{frame-resize-pixelwise} to a non-@code{nil} +value to make a frame appear truly ``maximized'' or ``fullscreen''. Some window managers have options that can make them ignore both program-specified and user-specified positions. If these are set, diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 036e8cf65eb..8c2289b83de 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -469,6 +469,10 @@ hides window manager decorations, giving slightly more screen space to Emacs itself.) @end table + Note that with some window managers you may have to customize the +variable @code{frame-resize-pixelwise} to a non-@code{nil} value in +order to make a frame truly ``maximized'' or ``fullscreen''. + The @kbd{C-x 5 0} (@code{delete-frame}) command deletes the selected frame. However, it will refuse to delete the last frame in an Emacs session, to prevent you from losing the ability to interact with the diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index e8efcaa923c..1272e740745 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,10 @@ +2014-10-03 Martin Rudalics + + * frames.texi (Size Parameters, Size and Position): Mention that + with some window managers you have to set + `frame-resize-pixelwise' in order make a frame truly fullscreen + or maximized. + 2014-09-04 Stefan Monnier * functions.texi (Core Advising Primitives): Add a note about the diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index b6513426909..92b5791051b 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -686,6 +686,11 @@ difference between @code{maximized} and @code{fullboth} is that the former can still be resized by dragging window manager decorations with the mouse, while the latter really covers the whole screen and does not allow resizing by mouse dragging. + +With some window managers you may have to customize the variable +@code{frame-resize-pixelwise} to a non-@code{nil} value in order to make +a frame appear ``maximized'' or ``fullscreen''. + @end table @node Layout Parameters @@ -1163,7 +1168,10 @@ on the toolkit used: Dragging the frame border with the mouse is usually always done character-wise. Calling @code{set-frame-size} (see below) with arguments that do not specify the frame size as an integer multiple of its character size may be, however, either ignored or cause a -rounding (GTK+, Windows) or get accepted (Lucid, Motif). +rounding (GTK+) or get accepted (Lucid, Motif, Windows). + +With some window managers you may have to set this to non-@code{nil} in +order to make a frame appear truly ``maximized'' or ``fullscreen''. @end defopt @defun set-frame-size frame width height pixelwise diff --git a/lisp/ChangeLog b/lisp/ChangeLog index 2aa8f2ab5b0..a2f8ba55ceb 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,3 +1,8 @@ +2014-10-03 Martin Rudalics + + * frame.el (toggle-frame-maximized, toggle-frame-fullscreen): + In doc-string mention need of setting `frame-resize-pixelwise'. + 2014-10-03 Stefan Monnier * vc/vc-svn.el (vc-svn-after-dir-status): Fix the non-remote regexp, diff --git a/lisp/frame.el b/lisp/frame.el index 5e9b5351005..a14b0c29103 100644 --- a/lisp/frame.el +++ b/lisp/frame.el @@ -1844,6 +1844,11 @@ If the frame is in fullscreen mode, don't change its mode, just toggle the temporary frame parameter `maximized', so the frame will go to the right maximization state after disabling fullscreen mode. + +Note that with some window managers you may have to set +`frame-resize-pixelwise' to non-nil in order to make a frame +appear truly maximized. + See also `toggle-frame-fullscreen'." (interactive) (if (memq (frame-parameter nil 'fullscreen) '(fullscreen fullboth)) @@ -1865,6 +1870,11 @@ already fullscreen. Ignore window manager screen decorations. When turning on fullscreen mode, remember the previous value of the maximization state in the temporary frame parameter `maximized'. Restore the maximization state when turning off fullscreen mode. + +Note that with some window managers you may have to set +`frame-resize-pixelwise' to non-nil in order to make a frame +appear truly fullscreen. + See also `toggle-frame-maximized'." (interactive) (modify-frame-parameters -- 2.39.2