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 ?

[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?