Re: Should https://www.gnu.org/software/emacs/manual/html_node/efaq/Fullscreen-mode-on-MS_002dWindows.html be renamed to Maxmize-mode-on-MS_002dWindows.html ?

[David Hedlund]

Oct 28, 2023 19:26:31 Stefan Kangas <stefankangas@gmail.com>:

> David Hedlund <public@beloved.name> writes:
> 
>>> You are correct, sorry for the confusion.  It's good to learn that
>>> --maximized works without issue.
>>> 
>>> So I guess this discussion is about:
>>> 
>>>      (add-hook 'emacs-startup-hook 'toggle-frame-maximized)
>>> 
>>> Then I guess I have the same question, but for that customization.  Why
>>> do we suggest a customization which has a "slighty distracting visual
>>> effect"?
>> 
>> That is why I wrote this section in
>> https://www.gnu.org/software/emacs/manual/html_node/efaq/Fullscreen-mode-on-MS_002dWindows.html
> 
> So how about installing something like the below (on master)?
> 
> diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
> index d8097a8d21e..9f0dce288bc 100644
> --- a/doc/misc/efaq.texi
> +++ b/doc/misc/efaq.texi
> @@ -3110,45 +3110,22 @@ Escape sequences in shell output
> @code{ansi-color} package, which lets Shell mode recognize these
> escape sequences.  It is enabled by default.
> 
> -@node Fullscreen mode on MS-Windows
> -@section How can I start Emacs in fullscreen mode on MS-Windows?
> +@node Fullscreen mode
> +@section How can I start Emacs in fullscreen mode?
> @cindex Maximize frame
> @cindex Fullscreen mode
> 
> -Beginning with Emacs 24.4 either run Emacs with the @samp{--maximized}
> -command-line option or put the following form in your init file
> -(@pxref{Setting up a customization file}):
> -
> -@lisp
> -(add-hook 'emacs-startup-hook 'toggle-frame-maximized)
> -@end lisp
> -
> -With older versions use the function @code{w32-send-sys-command}.  For
> -example, you can put the following in your init file:
> -
> -@lisp
> -(add-hook 'emacs-startup-hook
> -          (lambda () (w32-send-sys-command ?\xF030)))
> -@end lisp
> -
> -To avoid the slightly distracting visual effect of Emacs starting with
> -its default frame size and then growing to fullscreen, you can add an
> -@samp{Emacs.Geometry} entry to the Windows Registry settings.  @xref{X
> -Resources,,, emacs, The GNU Emacs Manual}.  To compute the correct
> -values for width and height you use in the Registry settings, first
> -maximize the Emacs frame and then evaluate @code{(frame-height)} and
> -@code{(frame-width)} with @kbd{M-:}.
> -
> -Alternatively, you can avoid the visual effect of Emacs changing its
> -frame size entirely in your init file (i.e., without using the
> -Registry), like this:
> +Run Emacs with the @samp{--maximized} command-line option or put the
> +following form in your early init file (@pxref{Early Init File,,,
> +emacs, The GNU Emacs Manual}).
> 
> @lisp
> -(setq frame-resize-pixelwise t)
> -(set-frame-position nil 0 0)
> -(set-frame-size nil (display-pixel-width) (display-pixel-height) t)
> +(push '(fullscreen . maximized) default-frame-alist)
> @end lisp
> 
> +Note that while some customizations of @code{default-frame-alist}
> +could have undesirable effects when modified in @file{early-init.el},
> +it is okay to do it in this particular case.
> 
> @node Emacs in a Linux console
> @section How can I alleviate the limitations of the Linux console?
Thank you very much for the patch Stefan, it's an improvement in my. But don't 
forget to keep:

-To avoid the slightly distracting visual effect of Emacs starting with
-its default frame size and then growing to fullscreen, you can add