I'm trying to catch up here, as David Hedlund asked me if I could help
out (as English is not his most comfortable language), and the
conversation has splintered somewhat. I myself joined the conversation
a bit late, so I might be confused myself.
The issue that DH has raised, as I understand it, surrounds the FAQ
entry in the Emacs manual titled "Fullscreen mode on MS-Windows". This
FAQ covers a few different ways to adjust the emacs frame under
MS-Windows, including older versions of emacs that predate the emacs
function toggle-frame-maximized (or perhaps predate it functioning
under MS-Windows). He also prefers to avoid the situation where Emacs
maps a "normal" window and then resizes it later (perhaps because it's
distracting, because it seems to take longer, or some other reason).
The FAQ entry in the most recent release talks about avoiding this
"distracting visual effect" by setting ersatz X Resources via the
Windows registry or a short set of emacs commands. IIUC, DH was
searching for a solution that would cause emacs to start with a
fullscreen window (rather than start and quickly grow to fullscreen),
and that would work across platforms. This is where I jumped in.
The solution I proposed was: add this line to the early-init.el file:
(push '(fullscreen . maximized) default-frame-alist)
There is a variant of this solution that instead uses:
(push '(fullscreen . maximized) initial-frame-alist)
to effect only the initial window.
With that as the background, I think the proposal is:
In the efaq node "Fullscreen mode on MS-Windows", replace the
following text:
>Beginning with Emacs 24.4 either run Emacs with the ‘--maximized’
>command-line option or put the following form in your init file (*note
>Setting up a customization file::):
>
> (add-hook 'emacs-startup-hook 'toggle-frame-maximized)
With something like this:
>Beginning with Emacs 24.4 either run Emacs with the ‘--maximized’
>command-line option or put the following form in your early-init file
>(*note*note (emacs)Early Init File::):
>
> (push '(fullscreen . maximized) default-frame-alist)
I don't know if it would be better to use initial-frame-alist or
default-frame-alist for this, and I'm not sure if there are
policy/practice details for the efaq manual to ref out to the emacs
manual, and I'm not in a good position to test the doc change myself,
so I'm not currently in position to send a patch. These changes seem
quite small and obvious to me, and I have a signed copyright
assignment on file from way back (if it matters and you have trouble
finding it, feel free to contact me and I'll figure out which email
address I used for it).
I hope that helps. Thanks!
~Chad