From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 13 Oct 2018 08:36:04 +0000 (+0300)
Subject: Update the description of startup in ELisp manual
X-Git-Tag: emacs-26.1.90~87
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=91c4c46;p=emacs.git

Update the description of startup in ELisp manual

* doc/lispref/os.texi (Startup Summary): Remove stale
reference to window-system-initialization-alist.  Reported by
Zhang Haijun <ccsmile2008@outlook.com>.
---

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index e60a2c5a708..44fc9a1eea2 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -96,24 +96,29 @@ if requested by environment variables such as @env{LANG}.
 It does some basic parsing of the command-line arguments.
 
 @vindex initial-window-system@r{, and startup}
-@vindex window-system-initialization-alist
+@findex window-system-initialization
 @item
 If not running in batch mode, it initializes the window system that
 the variable @code{initial-window-system} specifies (@pxref{Window
-Systems, initial-window-system}).  The initialization function for
-each supported window system is specified by
-@code{window-system-initialization-alist}.  If the value
-of @code{initial-window-system} is @var{windowsystem}, then the
-appropriate initialization function is defined in the file
-@file{term/@var{windowsystem}-win.el}.  This file should have been
-compiled into the Emacs executable when it was built.
+Systems, initial-window-system}).  The initialization function,
+@code{window-system-initialization}, is a @dfn{generic function}
+(@pxref{Generic Functions}) whose actual implementation is different
+for each supported window system.  If the value of
+@code{initial-window-system} is @var{windowsystem}, then the
+appropriate implementation of the initialization function is defined
+in the file @file{term/@var{windowsystem}-win.el}.  This file should
+have been compiled into the Emacs executable when it was built.
 
 @item
 It runs the normal hook @code{before-init-hook}.
 
 @item
-If appropriate, it creates a graphical frame.  This is not done in
-batch (noninteractive) or daemon mode.
+If appropriate, it creates a graphical frame.  As part of creating the
+graphical frame, it initializes the window system specified by
+@code{initial-frame-alist} and @code{default-frame-alist}
+(@pxref{Initial Parameters}) for the graphical frame, by calling the
+@code{window-system-initialization} function for that window system.
+This is not done in batch (noninteractive) or daemon mode.
 
 @item
 It initializes the initial frame's faces, and sets up the menu bar