From 0e59541fa203d7ecb6afcf0ce7805e87d41bdc65 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Sat, 4 Nov 2023 14:51:33 +0100 Subject: [PATCH] Make FAQ on starting Emacs maximized portable * doc/misc/efaq.texi (Start Emacs Maximized): Rename node from "Fullscreen mode on MS-Windows". Make advice portable to other platforms, and remove MS-Windows specific hacks. Ref: https://lists.gnu.org/r/emacs-devel/2023-10/msg00733.html Co-authored-by: David Hedlund --- doc/misc/efaq.texi | 41 +++++++++-------------------------------- 1 file changed, 9 insertions(+), 32 deletions(-) diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 631d7016acf..c20ad87f5f9 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi @@ -3113,45 +3113,22 @@ prints using ANSI color escape sequences. Emacs includes the @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 Start Emacs Maximized +@section How can I start Emacs in full screen? @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? -- 2.39.2