[Emacs-diffs] /srv/bzr/emacs/trunk r107624: lispref/os.texi edits

[Glenn Morris]

------------------------------------------------------------
revno: 107624
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2012-03-17 17:23:20 -0700
message:
  lispref/os.texi edits
  
  * doc/lispref/os.texi (System Interface): Flow control was removed.
  (Startup Summary): General update.
  (Init File): Don't mention compiling it.
modified:
  doc/lispref/ChangeLog
  doc/lispref/os.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-03-17 11:11:08 +0000
+++ b/doc/lispref/ChangeLog     2012-03-18 00:23:20 +0000
@@ -1,3 +1,9 @@
+2012-03-18  Glenn Morris  <address@hidden>
+
+       * os.texi (System Interface): Flow control was removed.
+       (Startup Summary): General update.
+       (Init File): Don't mention compiling it.
+
 2012-03-17  Chong Yidong  <address@hidden>
 
        * os.texi (Startup Summary): Mention package loading.

=== modified file 'doc/lispref/os.texi'
--- a/doc/lispref/os.texi       2012-03-17 11:11:08 +0000
+++ b/doc/lispref/os.texi       2012-03-18 00:23:20 +0000
@@ -8,8 +8,7 @@
 @chapter Operating System Interface
 
   This chapter is about starting and getting out of Emacs, access to
-values in the operating system environment, and terminal input, output,
-and flow control.
+values in the operating system environment, and terminal input, output.
 
   @xref{Building Emacs}, for related information.  @xref{Display}, for
 additional operating system status information pertaining to the
@@ -60,7 +59,7 @@
 @cindex @file{startup.el}
 
   When Emacs is started up, it performs the following operations
-(which are defined in @file{startup.el}):
+(see @code{normal-top-level} in @file{startup.el}):
 
 @enumerate
 @item
@@ -70,6 +69,15 @@
 in their turn.  The files @file{subdirs.el} are normally generated
 automatically when Emacs is installed.
 
address@hidden
+It registers input methods by loading any @file{leim-list.el} file
+found in the @code{load-path}.
+
address@hidden It removes PWD from the environment if it is not accurate.
address@hidden It abbreviates default-directory.
+
address@hidden Now normal-top-level calls command-line.
+
 @vindex before-init-time
 @item
 It sets the variable @code{before-init-time} to the value of
@@ -77,32 +85,49 @@
 @code{after-init-time} to @code{nil}, which signals to Lisp programs
 that Emacs is being initialized.
 
address@hidden set-locale-environment
address@hidden
+It sets the language environment and the terminal coding system,
+if requested by environment variables such as @code{LANG}.
+
address@hidden
+It does some basic parsing of the command-line arguments.
+
 @vindex address@hidden, and startup}
 @vindex window-system-initialization-alist
 @item
-It loads the initialization library for the window system specified by
-the variable @code{initial-window-system} (@pxref{Window Systems,
-initial-window-system}).  This library's name is
address@hidden/@var{windowsystem}-win.el}, where @var{windowsystem} is the
-value of @code{initial-window-system}.  From that library, it calls
-the appropriate initialization function.  The initialization function
-for each supported window system is specified by
address@hidden
-
address@hidden
-It sets the language environment and the terminal coding system,
-if requested by environment variables such as @code{LANG}.
-
address@hidden
-It processes the initial options.  (Some of them are handled
-even earlier than this.)
+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
address@hidden  If the value
+of @code{initial-window-system} is @var{windowsystem}, then the
+appropriate initialization function is defined in the file
address@hidden/@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
-It initializes the initial frame's faces, and turns on the menu bar
-and tool bar if needed.
+If appropriate (e.g., not in batch mode or started as a daemon), it
+creates a graphical frame.
+
address@hidden
+It initializes the initial frame's faces, and sets up the menu bar
+and tool bar if needed.  If graphical frames are supported, it sets up
+the tool bar even if the current frame is not a graphical one, since a
+graphical frame may be created later on.
+
address@hidden
+It use @code{custom-reevaluate-setting} to re-initialize the members
+of the list @code{custom-delayed-init-variables}.  These are any
+pre-loaded user options whose default value depends on the run-time,
+rather than build-time, context.
address@hidden Emacs, custom-initialize-delay}.
+
address@hidden @item
address@hidden It registers the colors available for tty frames.
 
 @item
 It loads the library @file{site-start}, if it exists.  This is not
@@ -154,13 +179,17 @@
 @code{term-file-prefix} (@pxref{Terminal-Specific}).  This is not done
 in @code{--batch} mode, nor if @code{term-file-prefix} is @code{nil}.
 
address@hidden Now command-line calls command-line-1.
+
 @item
 It displays the initial echo area message, unless you have suppressed
 that with @code{inhibit-startup-echo-area-message}.
 
 @item
-It processes the action arguments from the command line.
+It processes any command-line options that were not handled earlier.
 
address@hidden This next one is back in command-line, but the remaining bits of
address@hidden command-line-1 are not done if noninteractive.
 @item
 It now exits if the option @code{--batch} was specified.
 
@@ -169,6 +198,15 @@
 that name.  Furthermore, if the @samp{*scratch*} buffer exists and is
 empty, it inserts @code{initial-scratch-message} into that buffer.
 
address@hidden To make things nice and confusing, the next three items can be
address@hidden called from two places.  If displaying a startup screen, they are
address@hidden called in command-line-1 before the startup screen is shown.
address@hidden inhibit-startup-hooks is then set and window-setup-hook set to 
nil.
address@hidden If not displaying a startup screen, they are are called in
address@hidden normal-top-level.
address@hidden FIXME?  So it seems they can be called before or after the
address@hidden daemon/session restore step?
+
 @item
 It runs @code{emacs-startup-hook} and then @code{term-setup-hook}.
 
@@ -181,21 +219,33 @@
 It runs @code{window-setup-hook}.  @xref{Window Systems}.
 
 @item
-If the option @code{--daemon} was specified, it calls
address@hidden and detaches from the controlling terminal.
address@hidden Server,,, emacs, The GNU Emacs Manual}.
-
address@hidden
 It displays the @dfn{startup screen}, which is a special buffer that
 contains information about copyleft and basic Emacs usage.  This is
 not done if @code{initial-buffer-choice} or
 @code{inhibit-startup-screen} are @code{nil}, nor if the
 @samp{--no-splash} or @samp{-Q} command-line options were specified.
 
address@hidden End of command-line-1.
+
address@hidden Back to command-line from command-line-1.
+
address@hidden This is the point at which we actually exit in batch mode, but 
the
address@hidden last few bits of command-line-1 are not done in batch mode.
+
address@hidden
+If the option @code{--daemon} was specified, it calls
address@hidden and detaches from the controlling terminal.
address@hidden Server,,, emacs, The GNU Emacs Manual}.
+
 @item
 If started by the X session manager, it calls
 @code{emacs-session-restore} passing it as argument the ID of the
 previous session.  @xref{Session Management}.
+
address@hidden End of command-line.
+
address@hidden Back to normal-top-level from command-line.
+
 @end enumerate
 
 @defopt inhibit-startup-screen
@@ -255,10 +305,12 @@
   When you start Emacs, it normally attempts to load your @dfn{init
 file}.  This is either a file named @file{.emacs} or @file{.emacs.el}
 in your home directory, or a file named @file{init.el} in a
-subdirectory named @file{.emacs.d} in your home directory.  Whichever
-place you use, you can also compile the file (@pxref{Byte
+subdirectory named @file{.emacs.d} in your home directory.
address@hidden
+Whichever place you use, you can also compile the file (@pxref{Byte
 Compilation}); then the actual file loaded will be @file{.emacs.elc}
 or @file{init.elc}.
address@hidden ignore
 
   The command-line switches @samp{-q}, @samp{-Q}, and @samp{-u}
 control whether and where to find the init file; @samp{-q} (and the