startup.el 91.6 KB
Newer Older
1
;;; startup.el --- process Emacs shell arguments  -*- lexical-binding: t -*-
Eric S. Raymond's avatar
Eric S. Raymond committed
2

3
;; Copyright (C) 1985-1986, 1992, 1994-2012  Free Software Foundation, Inc.
Eric S. Raymond's avatar
Eric S. Raymond committed
4

Eric S. Raymond's avatar
Eric S. Raymond committed
5
;; Maintainer: FSF
Eric S. Raymond's avatar
Eric S. Raymond committed
6
;; Keywords: internal
7
;; Package: emacs
Eric S. Raymond's avatar
Eric S. Raymond committed
8

Jim Blandy's avatar
Jim Blandy committed
9 10
;; This file is part of GNU Emacs.

11
;; GNU Emacs is free software: you can redistribute it and/or modify
Jim Blandy's avatar
Jim Blandy committed
12
;; it under the terms of the GNU General Public License as published by
13 14
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
Jim Blandy's avatar
Jim Blandy committed
15 16 17 18 19 20 21

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
22
;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
Jim Blandy's avatar
Jim Blandy committed
23

Eric S. Raymond's avatar
Eric S. Raymond committed
24
;;; Commentary:
Jim Blandy's avatar
Jim Blandy committed
25

Kenichi Handa's avatar
Kenichi Handa committed
26 27 28
;; This file parses the command line and gets Emacs running.  Options
;; on the command line are handled in precedence order.  For priorities
;; see the structure standard_args in the emacs.c file.
Jim Blandy's avatar
Jim Blandy committed
29

Eric S. Raymond's avatar
Eric S. Raymond committed
30 31
;;; Code:

Jim Blandy's avatar
Jim Blandy committed
32 33
(setq top-level '(normal-top-level))

Richard M. Stallman's avatar
Richard M. Stallman committed
34
(defvar command-line-processed nil
35
  "Non-nil once command line has been processed.")
Jim Blandy's avatar
Jim Blandy committed
36

Richard M. Stallman's avatar
Richard M. Stallman committed
37
(defgroup initialization nil
38
  "Emacs start-up procedure."
39 40 41 42
  :group 'environment)

(defcustom initial-buffer-choice nil
  "Buffer to show after starting Emacs.
43
If the value is nil and `inhibit-startup-screen' is nil, show the
44 45 46 47
startup screen.  If the value is a string, switch to a buffer
visiting the file or directory specified by that string.  If the
value is a function, switch to the buffer returned by that
function.  If t, open the `*scratch*' buffer.
48 49 50

A string value also causes emacsclient to open the specified file
or directory when no target file is specified."
51
  :type '(choice
52
	  (const     :tag "Startup screen" nil)
53
	  (directory :tag "Directory" :value "~/")
54
	  (file      :tag "File" :value "~/.emacs")
55
          (function  :tag "Function")
56
	  (const     :tag "Lisp scratch buffer" t))
57
  :version "24.4"
58
  :group 'initialization)
Richard M. Stallman's avatar
Richard M. Stallman committed
59

60
(defcustom inhibit-startup-screen nil
61 62
  "Non-nil inhibits the startup screen.

63 64
This is for use in your personal init file (but NOT site-start.el),
once you are familiar with the contents of the startup screen."
Richard M. Stallman's avatar
Richard M. Stallman committed
65 66
  :type 'boolean
  :group 'initialization)
Jim Blandy's avatar
Jim Blandy committed
67

68 69
(defvaralias 'inhibit-splash-screen 'inhibit-startup-screen)
(defvaralias 'inhibit-startup-message 'inhibit-startup-screen)
70

71
(defvar startup-screen-inhibit-startup-screen nil)
72

Glenn Morris's avatar
Glenn Morris committed
73 74
;; FIXME? Why does this get such weirdly extreme treatment, when the
;; more important inhibit-startup-screen does not.
Richard M. Stallman's avatar
Richard M. Stallman committed
75
(defcustom inhibit-startup-echo-area-message nil
76
  "Non-nil inhibits the initial startup echo area message.
Richard M. Stallman's avatar
Richard M. Stallman committed
77 78
Setting this variable takes effect
only if you do it with the customization buffer
79
or if your init file contains a line of this form:
80
 (setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\")
81 82
If your init file is byte-compiled, use the following form
instead:
83
 (eval '(setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\"))
84 85
Thus, someone else using a copy of your init file will see the
startup message unless he personally acts to inhibit it."
Richard M. Stallman's avatar
Richard M. Stallman committed
86 87 88
  :type '(choice (const :tag "Don't inhibit")
		 (string :tag "Enter your user name, to inhibit"))
  :group 'initialization)
89

Richard M. Stallman's avatar
Richard M. Stallman committed
90
(defcustom inhibit-default-init nil
91
  "Non-nil inhibits loading the `default' library."
Richard M. Stallman's avatar
Richard M. Stallman committed
92 93
  :type 'boolean
  :group 'initialization)
Jim Blandy's avatar
Jim Blandy committed
94

95
(defcustom inhibit-startup-buffer-menu nil
96
  "Non-nil inhibits display of buffer list when more than 2 files are loaded."
97 98 99
  :type 'boolean
  :group 'initialization)

100
(defvar command-switch-alist nil
Jim Blandy's avatar
Jim Blandy committed
101 102
  "Alist of command-line switches.
Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
Kenichi Handa's avatar
Kenichi Handa committed
103 104
HANDLER-FUNCTION receives the switch string as its sole argument;
the remaining command-line args are in the variable `command-line-args-left'.")
Jim Blandy's avatar
Jim Blandy committed
105

106 107 108
(defvar command-line-args-left nil
  "List of command-line args not yet processed.")

109 110 111 112 113
(defvaralias 'argv 'command-line-args-left
  "List of command-line args not yet processed.
This is a convenience alias, so that one can write \(pop argv\)
inside of --eval command line arguments in order to access
following arguments.")
114
(internal-make-var-non-special 'argv)
115

116 117 118
(defvar argi nil
  "Current command-line argument.")
(internal-make-var-non-special 'argi)
119

Jim Blandy's avatar
Jim Blandy committed
120 121 122
(defvar command-line-functions nil    ;; lrs 7/31/89
  "List of functions to process unrecognized command-line arguments.
Each function should access the dynamically bound variables
Richard M. Stallman's avatar
Richard M. Stallman committed
123
`argi' (the current argument) and `command-line-args-left' (the remaining
Jim Blandy's avatar
Jim Blandy committed
124
arguments).  The function should return non-nil only if it recognizes and
Richard M. Stallman's avatar
Richard M. Stallman committed
125 126
processes `argi'.  If it does so, it may consume successive arguments by
altering `command-line-args-left' to remove them.")
Jim Blandy's avatar
Jim Blandy committed
127

128 129 130 131
(defvar command-line-default-directory nil
  "Default directory to use for command line arguments.
This is normally copied from `default-directory' when Emacs starts.")

Stefan Monnier's avatar
Stefan Monnier committed
132 133
;; This is here, rather than in x-win.el, so that we can ignore these
;; options when we are not using X.
134
(defconst command-line-x-option-alist
135 136 137
  '(("-bw" 1 x-handle-numeric-switch border-width)
    ("-d" 1 x-handle-display)
    ("-display" 1 x-handle-display)
138
    ("-name" 1 x-handle-name-switch)
139 140
    ("-title" 1 x-handle-switch title)
    ("-T" 1 x-handle-switch title)
141 142 143 144 145 146
    ("-r" 0 x-handle-switch reverse t)
    ("-rv" 0 x-handle-switch reverse t)
    ("-reverse" 0 x-handle-switch reverse t)
    ("-reverse-video" 0 x-handle-switch reverse t)
    ("-fn" 1 x-handle-switch font)
    ("-font" 1 x-handle-switch font)
147 148 149
    ("-fs" 0 x-handle-initial-switch fullscreen fullboth)
    ("-fw" 0 x-handle-initial-switch fullscreen fullwidth)
    ("-fh" 0 x-handle-initial-switch fullscreen fullheight)
150
    ("-mm" 0 x-handle-initial-switch fullscreen maximized)
151
    ("-ib" 1 x-handle-numeric-switch internal-border-width)
152
    ("-g" 1 x-handle-geometry)
153
    ("-lsp" 1 x-handle-numeric-switch line-spacing)
154
    ("-geometry" 1 x-handle-geometry)
155 156 157 158 159
    ("-fg" 1 x-handle-switch foreground-color)
    ("-foreground" 1 x-handle-switch foreground-color)
    ("-bg" 1 x-handle-switch background-color)
    ("-background" 1 x-handle-switch background-color)
    ("-ms" 1 x-handle-switch mouse-color)
160
    ("-nbi" 0 x-handle-switch icon-type nil)
161 162 163 164 165 166 167 168
    ("-iconic" 0 x-handle-iconic)
    ("-xrm" 1 x-handle-xrm-switch)
    ("-cr" 1 x-handle-switch cursor-color)
    ("-vb" 0 x-handle-switch vertical-scroll-bars t)
    ("-hb" 0 x-handle-switch horizontal-scroll-bars t)
    ("-bd" 1 x-handle-switch)
    ("--border-width" 1 x-handle-numeric-switch border-width)
    ("--display" 1 x-handle-display)
169
    ("--name" 1 x-handle-name-switch)
170
    ("--title" 1 x-handle-switch title)
171 172
    ("--reverse-video" 0 x-handle-switch reverse t)
    ("--font" 1 x-handle-switch font)
173 174 175
    ("--fullscreen" 0 x-handle-initial-switch fullscreen fullboth)
    ("--fullwidth" 0 x-handle-initial-switch fullscreen fullwidth)
    ("--fullheight" 0 x-handle-initial-switch fullscreen fullheight)
176
    ("--maximized" 0 x-handle-initial-switch fullscreen maximized)
177
    ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
178
    ("--geometry" 1 x-handle-geometry)
179 180 181
    ("--foreground-color" 1 x-handle-switch foreground-color)
    ("--background-color" 1 x-handle-switch background-color)
    ("--mouse-color" 1 x-handle-switch mouse-color)
182
    ("--no-bitmap-icon" 0 x-handle-no-bitmap-icon)
183 184 185 186
    ("--iconic" 0 x-handle-iconic)
    ("--xrm" 1 x-handle-xrm-switch)
    ("--cursor-color" 1 x-handle-switch cursor-color)
    ("--vertical-scroll-bars" 0 x-handle-switch vertical-scroll-bars t)
187
    ("--line-spacing" 1 x-handle-numeric-switch line-spacing)
188
    ("--border-color" 1 x-handle-switch border-color)
189 190
    ("--smid" 1 x-handle-smid)
    ("--parent-id" 1 x-handle-parent-id))
191 192 193 194 195 196 197 198 199
  "Alist of X Windows options.
Each element has the form
  (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
where NAME is the option name string, NUMARGS is the number of arguments
that the option accepts, HANDLER is a function to call to handle the option.
FRAME-PARAM (optional) is the frame parameter this option specifies,
and VALUE is the value which is given to that frame parameter
\(most options use the argument for this, so VALUE is not present).")

200 201 202
(defconst command-line-ns-option-alist
  '(("-NSAutoLaunch" 1 ns-ignore-1-arg)
    ("-NXAutoLaunch" 1 ns-ignore-1-arg)
203
    ("-macosx" 0 ignore)
204 205 206 207 208 209 210 211 212 213 214
    ("-NSHost" 1 ns-ignore-1-arg)
    ("-_NSMachLaunch" 1 ns-ignore-1-arg)
    ("-MachLaunch" 1 ns-ignore-1-arg)
    ("-NXOpen" 1 ns-ignore-1-arg)
    ("-NSOpen" 1 ns-handle-nxopen)
    ("-NXOpenTemp" 1 ns-ignore-1-arg)
    ("-NSOpenTemp" 1 ns-handle-nxopentemp)
    ("-GSFilePath" 1 ns-handle-nxopen)
    ;;("-bw" .              x-handle-numeric-switch)
    ;;("-d" .               x-handle-display)
    ;;("-display" .         x-handle-display)
215 216 217 218 219 220 221 222 223
    ("-name" 1 x-handle-name-switch)
    ("-title" 1 x-handle-switch title)
    ("-T" 1 x-handle-switch title)
    ("-r" 0 x-handle-switch reverse t)
    ("-rv" 0 x-handle-switch reverse t)
    ("-reverse" 0 x-handle-switch reverse t)
    ("-fn" 1 x-handle-switch font)
    ("-font" 1 x-handle-switch font)
    ("-ib" 1 x-handle-numeric-switch internal-border-width)
224 225
    ("-g" 1 x-handle-geometry)
    ("-geometry" 1 x-handle-geometry)
226 227 228 229 230 231 232 233
    ("-fg" 1 x-handle-switch foreground-color)
    ("-foreground" 1 x-handle-switch foreground-color)
    ("-bg" 1 x-handle-switch background-color)
    ("-background" 1 x-handle-switch background-color)
;    ("-ms" 1 x-handle-switch mouse-color)
    ("-itype" 0 x-handle-switch icon-type t)
    ("-i" 0 x-handle-switch icon-type t)
    ("-iconic" 0 x-handle-iconic icon-type t)
234
    ;;("-xrm" .             x-handle-xrm-switch)
235 236 237 238 239
    ("-cr" 1 x-handle-switch cursor-color)
    ("-vb" 0 x-handle-switch vertical-scroll-bars t)
    ("-hb" 0 x-handle-switch horizontal-scroll-bars t)
    ("-bd" 1 x-handle-switch)
    ;; ("--border-width" 1 x-handle-numeric-switch border-width)
240
    ;; ("--display" 1 ns-handle-display)
241 242 243 244 245
    ("--name" 1 x-handle-name-switch)
    ("--title" 1 x-handle-switch title)
    ("--reverse-video" 0 x-handle-switch reverse t)
    ("--font" 1 x-handle-switch font)
    ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
246
    ;; ("--geometry" 1 ns-handle-geometry)
247 248 249 250 251
    ("--foreground-color" 1 x-handle-switch foreground-color)
    ("--background-color" 1 x-handle-switch background-color)
    ("--mouse-color" 1 x-handle-switch mouse-color)
    ("--icon-type" 0 x-handle-switch icon-type t)
    ("--iconic" 0 x-handle-iconic)
252
    ;; ("--xrm" 1 ns-handle-xrm-switch)
253 254 255
    ("--cursor-color" 1 x-handle-switch cursor-color)
    ("--vertical-scroll-bars" 0 x-handle-switch vertical-scroll-bars t)
    ("--border-color" 1 x-handle-switch border-width))
256 257 258 259 260 261 262 263 264 265
  "Alist of NS options.
Each element has the form
  (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
where NAME is the option name string, NUMARGS is the number of arguments
that the option accepts, HANDLER is a function to call to handle the option.
FRAME-PARAM (optional) is the frame parameter this option specifies,
and VALUE is the value which is given to that frame parameter
\(most options use the argument for this, so VALUE is not present).")


Roland McGrath's avatar
Roland McGrath committed
266
(defvar before-init-hook nil
267
  "Normal hook run after handling urgent options but before loading init files.")
Jim Blandy's avatar
Jim Blandy committed
268

Roland McGrath's avatar
Roland McGrath committed
269
(defvar after-init-hook nil
270 271 272 273 274 275 276 277
  "Normal hook run after initializing the Emacs session.
It is run after Emacs loads the init file, `default' library, the
abbrevs file, and additional Lisp packages (if any), and setting
the value of `after-init-time'.

There is no `condition-case' around the running of this hook;
therefore, if `debug-on-error' is non-nil, an error in one of
these functions will invoke the debugger.")
278 279 280

(defvar emacs-startup-hook nil
  "Normal hook run after loading init files and handling the command line.")
Roland McGrath's avatar
Roland McGrath committed
281

Jim Blandy's avatar
Jim Blandy committed
282
(defvar term-setup-hook nil
283 284
  "Normal hook run after loading terminal-specific Lisp code.
It also follows `emacs-startup-hook'.  This hook exists for users to set,
Jim Blandy's avatar
Jim Blandy committed
285 286 287
so as to override the definitions made by the terminal-specific file.
Emacs never sets this variable itself.")

288 289 290 291
(defvar inhibit-startup-hooks nil
  "Non-nil means don't run `term-setup-hook' and `emacs-startup-hook'.
This is because we already did so.")

Jim Blandy's avatar
Jim Blandy committed
292
(defvar keyboard-type nil
Richard M. Stallman's avatar
Richard M. Stallman committed
293
  "The brand of keyboard you are using.
294 295 296
This variable is used to define the proper function and keypad
keys for use under X.  It is used in a fashion analogous to the
environment variable TERM.")
Jim Blandy's avatar
Jim Blandy committed
297 298

(defvar window-setup-hook nil
Richard M. Stallman's avatar
Richard M. Stallman committed
299 300 301
  "Normal hook run to initialize window system display.
Emacs runs this hook after processing the command line arguments and loading
the user's init file.")
Jim Blandy's avatar
Jim Blandy committed
302

Richard M. Stallman's avatar
Richard M. Stallman committed
303
(defcustom initial-major-mode 'lisp-interaction-mode
304
  "Major mode command symbol to use for the initial `*scratch*' buffer."
305
  :type 'function
Richard M. Stallman's avatar
Richard M. Stallman committed
306
  :group 'initialization)
Jim Blandy's avatar
Jim Blandy committed
307

308
(defvar init-file-user nil
309
  "Identity of user whose init file is or was read.
310 311 312
The value is nil if `-q' or `--no-init-file' was specified,
meaning do not load any init file.

Eli Zaretskii's avatar
Eli Zaretskii committed
313 314 315 316
Otherwise, the value may be an empty string, meaning
use the init file for the user who originally logged in,
or it may be a string containing a user's name meaning
use that person's init file.
Jim Blandy's avatar
Jim Blandy committed
317

Karl Heuer's avatar
Karl Heuer committed
318
In either of the latter cases, `(concat \"~\" init-file-user \"/\")'
319
evaluates to the name of the directory where the init file was
320 321 322
looked for.

Setting `init-file-user' does not prevent Emacs from loading
323
`site-start.el'.  The only way to do that is to use `--no-site-file'.")
Jim Blandy's avatar
Jim Blandy committed
324

325
(defcustom site-run-file (purecopy "site-start")
326 327 328
  "File containing site-wide run-time initializations.
This file is loaded at run-time before `~/.emacs'.  It contains inits
that need to be in place for the entire site, but which, due to their
329
higher incidence of change, don't make sense to load into Emacs's
330
dumped image.  Thus, the run-time load order is: 1. file described in
331 332 333 334 335 336 337
this variable, if non-nil; 2. `~/.emacs'; 3. `default.el'.

Don't use the `site-start.el' file for things some users may not like.
Put them in `default.el' instead, so that users can more easily
override them.  Users can prevent loading `default.el' with the `-q'
option or by setting `inhibit-default-init' in their own init files,
but inhibiting `site-start.el' requires `--no-site-file', which
338 339 340 341 342
is less convenient.

This variable is defined for customization so as to make
it visible in the relevant context.  However, actually customizing it
is not allowed, since it would not work anyway.  The only way to set
343
this variable usefully is to set it while building and dumping Emacs."
344
  :type '(choice (const :tag "none" nil) string)
345 346
  :group 'initialization
  :initialize 'custom-initialize-default
347
  :set (lambda (_variable _value)
348
	  (error "Customizing `site-run-file' does not work")))
349

Richard M. Stallman's avatar
Richard M. Stallman committed
350
(defcustom mail-host-address nil
351 352 353
  "Name of this machine, for purposes of naming users.
If non-nil, Emacs uses this instead of `system-name' when constructing
email addresses."
Richard M. Stallman's avatar
Richard M. Stallman committed
354 355
  :type '(choice (const nil) string)
  :group 'mail)
356

357
(defcustom user-mail-address (if command-line-processed
358 359 360 361
				 (or (getenv "EMAIL")
				     (concat (user-login-name) "@"
					     (or mail-host-address
						 (system-name))))
362 363
			       ;; Empty string means "not set yet".
			       "")
364
  "Full mailing address of this user.
365
This is initialized with environment variable `EMAIL' or, as a
366
fallback, using `mail-host-address'.  This is done after your
367
init file is read, in case it sets `mail-host-address'."
Richard M. Stallman's avatar
Richard M. Stallman committed
368 369
  :type 'string
  :group 'mail)
370

Richard M. Stallman's avatar
Richard M. Stallman committed
371
(defcustom auto-save-list-file-prefix
372 373
  (cond ((eq system-type 'ms-dos)
	 ;; MS-DOS cannot have initial dot, and allows only 8.3 names
374
	 (concat user-emacs-directory "auto-save.list/_s"))
375
	(t
376
	 (concat user-emacs-directory "auto-save-list/.saves-")))
377
  "Prefix for generating `auto-save-list-file-name'.
378
This is used after reading your init file to initialize
379 380
`auto-save-list-file-name', by appending Emacs's pid and the system name,
if you have not already set `auto-save-list-file-name' yourself.
381
Directories in the prefix will be created if necessary.
382
Set this to nil if you want to prevent `auto-save-list-file-name'
Richard M. Stallman's avatar
Richard M. Stallman committed
383
from being initialized."
384 385
  :type '(choice (const :tag "Don't record a session's auto save list" nil)
		 string)
Richard M. Stallman's avatar
Richard M. Stallman committed
386
  :group 'auto-save)
387

388 389
(defvar emacs-basic-display nil)

Jim Blandy's avatar
Jim Blandy committed
390 391
(defvar init-file-debug nil)

392 393
(defvar init-file-had-error nil
  "Non-nil if there was an error loading the user's init file.")
394

395 396
(defvar normal-top-level-add-subdirs-inode-list nil)

397 398
(defvar no-blinking-cursor nil)

399 400
(defvar default-frame-background-mode)

401 402 403
(defvar pure-space-overflow nil
  "Non-nil if building Emacs overflowed pure space.")

404
(defvar pure-space-overflow-message (purecopy "\
405
Warning Warning!!!  Pure space overflow    !!!Warning Warning
406
\(See the node Pure Storage in the Lisp manual for details.)\n"))
407

408 409 410 411 412 413
(defcustom tutorial-directory
  (file-name-as-directory (expand-file-name "tutorials" data-directory))
  "Directory containing the Emacs TUTORIAL files."
  :group 'installation
  :type 'directory
  :initialize 'custom-initialize-delay)
414

415 416 417 418 419 420 421 422 423
(defconst package-subdirectory-regexp
  "\\([^.].*?\\)-\\([0-9]+\\(?:[.][0-9]+\\|\\(?:pre\\|beta\\|alpha\\)[0-9]+\\)*\\)"
  "Regular expression matching the name of a package subdirectory.
The first subexpression is the package name.
The second subexpression is the version string.

The regexp should not contain a starting \"\\`\" or a trailing
 \"\\'\"; those are added automatically by callers.")

424
(defun normal-top-level-add-subdirs-to-load-path ()
425
  "Add all subdirectories of `default-directory' to `load-path'.
426
More precisely, this uses only the subdirectories whose names
427 428
start with letters or digits; it excludes any subdirectory named `RCS'
or `CVS', and any subdirectory that contains a file named `.nosearch'."
429
  (let (dirs
430
	attrs
431 432 433 434
	(pending (list default-directory)))
    ;; This loop does a breadth-first tree walk on DIR's subtree,
    ;; putting each subdir into DIRS as its contents are examined.
    (while pending
435
      (push (pop pending) dirs)
436 437 438
      (let* ((this-dir (car dirs))
	     (contents (directory-files this-dir))
	     (default-directory this-dir)
439 440
	     (canonicalized (if (fboundp 'untranslated-canonical-name)
				(untranslated-canonical-name this-dir))))
Glenn Morris's avatar
Glenn Morris committed
441 442
	;; The Windows version doesn't report meaningful inode numbers, so
	;; use the canonicalized absolute file name of the directory instead.
443 444
	(setq attrs (or canonicalized
			(nthcdr 10 (file-attributes this-dir))))
445
	(unless (member attrs normal-top-level-add-subdirs-inode-list)
446 447
	  (push attrs normal-top-level-add-subdirs-inode-list)
	  (dolist (file contents)
Glenn Morris's avatar
Glenn Morris committed
448 449 450 451 452 453 454 455 456 457
	    (and (string-match "\\`[[:alnum:]]" file)
		 ;; The lower-case variants of RCS and CVS are for DOS/Windows.
		 (not (member file '("RCS" "CVS" "rcs" "cvs")))
		 ;; Avoid doing a `stat' when it isn't necessary because
		 ;; that can cause trouble when an NFS server is down.
		 (not (string-match "\\.elc?\\'" file))
		 (file-directory-p file)
		 (let ((expanded (expand-file-name file)))
		   (or (file-exists-p (expand-file-name ".nosearch" expanded))
		       (setq pending (nconc pending (list expanded))))))))))
458
    (normal-top-level-add-to-load-path (cdr (nreverse dirs)))))
459

460
(defun normal-top-level-add-to-load-path (dirs)
Glenn Morris's avatar
Glenn Morris committed
461 462 463 464 465
  "This function is called from a subdirs.el file.
It assumes that `default-directory' is the directory in which the
subdirs.el file exists, and it adds to `load-path' the subdirs of
that directory as specified in DIRS.  Normally the elements of
DIRS are relative."
466 467 468
  (let ((tail load-path)
	(thisdir (directory-file-name default-directory)))
    (while (and tail
469 470
		;;Don't go all the way to the nil terminator.
		(cdr tail)
471 472 473 474
		(not (equal thisdir (car tail)))
		(not (and (memq system-type '(ms-dos windows-nt))
			  (equal (downcase thisdir) (downcase (car tail))))))
      (setq tail (cdr tail)))
475 476 477
    ;;Splice the new section in.
    (when tail
      (setcdr tail (append (mapcar 'expand-file-name dirs) (cdr tail))))))
478

Jim Blandy's avatar
Jim Blandy committed
479
(defun normal-top-level ()
Glenn Morris's avatar
Glenn Morris committed
480 481 482 483
  "Emacs calls this function when it first starts up.
It sets `command-line-processed', processes the command-line,
reads the initialization files, etc.
It is the default value of the variable `top-level'."
Jim Blandy's avatar
Jim Blandy committed
484 485 486
  (if command-line-processed
      (message "Back to top level.")
    (setq command-line-processed t)
487
    (let ((dir default-directory))
488
      (with-current-buffer "*Messages*"
489 490 491 492
        ;; Make it easy to do like "tail -f".
        (set (make-local-variable 'window-point-insertion-type) t)
        ;; Give *Messages* the same default-directory as *scratch*,
        ;; just to keep things predictable.
493
	(setq default-directory dir)))
494 495 496
    ;; `user-full-name' is now known; reset its standard-value here.
    (put 'user-full-name 'standard-value
	 (list (default-value 'user-full-name)))
497 498 499
    ;; Look in each dir in load-path for a subdirs.el file.
    ;; If we find one, load it, which will add the appropriate subdirs
    ;; of that dir into load-path,
500 501
    ;; Look for a leim-list.el file too.  Loading it will register
    ;; available input methods.
502 503 504 505 506
    (let ((tail load-path)
          (lispdir (expand-file-name "../lisp" data-directory))
	  ;; For out-of-tree builds, leim-list is generated in the build dir.
;;;          (leimdir (expand-file-name "../leim" doc-directory))
          dir)
507 508 509 510
      (while tail
        (setq dir (car tail))
        (let ((default-directory dir))
          (load (expand-file-name "subdirs.el") t t t))
511 512 513 514 515
	;; Do not scan standard directories that won't contain a leim-list.el.
	;; http://lists.gnu.org/archive/html/emacs-devel/2009-10/msg00502.html
	(or (string-match (concat "\\`" lispdir) dir)
	    (let ((default-directory dir))
	      (load (expand-file-name "leim-list.el") t t t)))
516 517 518 519
        ;; We don't use a dolist loop and we put this "setq-cdr" command at
        ;; the end, because the subdirs.el files may add elements to the end
        ;; of load-path and we want to take it into account.
        (setq tail (cdr tail))))
Dan Nicolaescu's avatar
Dan Nicolaescu committed
520 521 522 523 524 525 526 527 528 529 530 531 532
    ;; If the PWD environment variable isn't accurate, delete it.
    (let ((pwd (getenv "PWD")))
      (and (stringp pwd)
	   ;; Use FOO/., so that if FOO is a symlink, file-attributes
	   ;; describes the directory linked to, not FOO itself.
	   (or (equal (file-attributes
		       (concat (file-name-as-directory pwd) "."))
		      (file-attributes
		       (concat (file-name-as-directory default-directory)
			       ".")))
	       (setq process-environment
		     (delete (concat "PWD=" pwd)
			     process-environment)))))
Jim Blandy's avatar
Jim Blandy committed
533
    (setq default-directory (abbreviate-file-name default-directory))
534
    (let ((old-face-font-rescale-alist face-font-rescale-alist))
535 536 537 538
      (unwind-protect
	  (command-line)
	;; Do this again, in case .emacs defined more abbreviations.
	(setq default-directory (abbreviate-file-name default-directory))
539 540
	;; Specify the file for recording all the auto save files of this session.
	;; This is used by recover-session.
541 542 543
	(or auto-save-list-file-name
	    (and auto-save-list-file-prefix
		 (setq auto-save-list-file-name
544 545
		       ;; Under MS-DOS our PID is almost always reused between
		       ;; Emacs invocations.  We need something more unique.
546 547 548 549 550 551
		       (cond ((eq system-type 'ms-dos)
			      ;; We are going to access the auto-save
			      ;; directory, so make sure it exists.
			      (make-directory
			       (file-name-directory auto-save-list-file-prefix)
			       t)
552
			      (concat
553 554 555 556 557 558 559 560 561 562
			       (make-temp-name
				(expand-file-name
				 auto-save-list-file-prefix))
			       "~"))
			     (t
			      (expand-file-name
			       (format "%s%d-%s~"
				       auto-save-list-file-prefix
				       (emacs-pid)
				       (system-name))))))))
563 564 565 566
	(unless inhibit-startup-hooks
	  (run-hooks 'emacs-startup-hook)
	  (and term-setup-hook
	       (run-hooks 'term-setup-hook)))
567 568 569

	;; Don't do this if we failed to create the initial frame,
	;; for instance due to a dense colormap.
570 571
	(when (or frame-initial-frame
		  ;; If frame-initial-frame has no meaning, do this anyway.
572
		  (not (and initial-window-system
573
			    (not noninteractive)
574
			    (not (eq initial-window-system 'pc)))))
575 576 577 578 579 580 581 582 583 584 585 586 587

	  ;; FIXME: The user's init file may change
	  ;; face-font-rescale-alist.  However, the default face
	  ;; already has an assigned font object, which does not take
	  ;; face-font-rescale-alist into account.  For such
	  ;; situations, we ought to have a way to find all font
	  ;; objects and regenerate them; currently we do not.  As a
	  ;; workaround, we specifically reset te default face's :font
	  ;; attribute here.  See bug#1785.
	  (unless (eq face-font-rescale-alist
		      old-face-font-rescale-alist)
	    (set-face-attribute 'default nil :font (font-spec)))

588 589 590 591
	  ;; Modify the initial frame based on what .emacs puts into
	  ;; ...-frame-alist.
	  (if (fboundp 'frame-notice-user-settings)
	      (frame-notice-user-settings))
592 593 594 595
	  ;; Set the faces for the initial background mode even if
	  ;; frame-notice-user-settings didn't (such as on a tty).
	  ;; frame-set-background-mode is idempotent, so it won't
	  ;; cause any harm if it's already been done.
596
	  (if (fboundp 'frame-set-background-mode)
597
	      (frame-set-background-mode (selected-frame))))
Miles Bader's avatar
Miles Bader committed
598

599 600 601 602
	;; Now we know the user's default font, so add it to the menu.
	(if (fboundp 'font-menu-add-default)
	    (font-menu-add-default))
	(and window-setup-hook
603
	     (run-hooks 'window-setup-hook))))
604 605 606 607
    ;; Subprocesses of Emacs do not have direct access to the terminal, so
    ;; unless told otherwise they should only assume a dumb terminal.
    ;; We are careful to do it late (after term-setup-hook), although the
    ;; new multi-tty code does not use $TERM any more there anyway.
608 609 610 611 612 613 614 615 616 617 618 619 620 621
    (setenv "TERM" "dumb")
    ;; Remove DISPLAY from the process-environment as well.  This allows
    ;; `callproc.c' to give it a useful adaptive default which is either
    ;; the value of the `display' frame-parameter or the DISPLAY value
    ;; from initial-environment.
    (let ((display (frame-parameter nil 'display)))
      ;; Be careful which DISPLAY to remove from process-environment: follow
      ;; the logic of `callproc.c'.
      (if (stringp display) (setq display (concat "DISPLAY=" display))
        (dolist (varval initial-environment)
          (if (string-match "\\`DISPLAY=" varval)
              (setq display varval))))
      (when display
        (delete display process-environment)))))
622 623

;; Precompute the keyboard equivalents in the menu bar items.
624 625
;; Command-line options supported by tty's:
(defconst tty-long-option-alist
626 627 628
  '(("--name"		  . "-name")
    ("--title"		  . "-T")
    ("--reverse-video"	  . "-reverse")
629
    ("--foreground-color" . "-fg")
630 631
    ("--background-color" . "-bg")
    ("--color"		  . "-color")))
632

633
(defconst tool-bar-images-pixel-height 24
634
  "Height in pixels of images in the tool-bar.")
635

636 637 638
(defvar tool-bar-originally-present nil
  "Non-nil if tool-bars are present before user and site init files are read.")

639 640 641 642 643 644 645 646 647 648 649 650
(defvar handle-args-function-alist '((nil . tty-handle-args))
  "Functions for processing window-system dependent command-line arguments.
Window system startup files should add their own function to this
alist, which should parse the command line arguments.  Those
pertaining to the window system should be processed and removed
from the returned command line.")

(defvar window-system-initialization-alist '((nil . ignore))
  "Alist of window-system initialization functions.
Window-system startup files should add their own initialization
function to this list.  The function should take no arguments,
and initialize the window system environment to prepare for
651
opening the first frame (e.g. open a connection to an X server).")
652

653
(defun tty-handle-args (args)
Glenn Morris's avatar
Glenn Morris committed
654
  "Handle the X-like command-line arguments \"-fg\", \"-bg\", \"-name\", etc."
655
  (let (rest)
656
    (message "%S" args)
657 658
    (while (and args
		(not (equal (car args) "--")))
659 660 661
      (let* ((argi (pop args))
	     (orig-argi argi)
	     argval completion)
662 663
	;; Check for long options with attached arguments
	;; and separate out the attached option argument into argval.
664 665 666 667 668
	(when (string-match "^\\(--[^=]*\\)=" argi)
          (setq argval (substring argi (match-end 0))
                argi (match-string 1 argi)))
	(when (string-match "^--" argi)
	  (setq completion (try-completion argi tty-long-option-alist))
669 670
	  (if (eq completion t)
	      ;; Exact match for long option.
671
	      (setq argi (cdr (assoc argi tty-long-option-alist)))
672 673 674 675
	    (if (stringp completion)
		(let ((elt (assoc completion tty-long-option-alist)))
		  ;; Check for abbreviated long option.
		  (or elt
676 677
		      (error "Option `%s' is ambiguous" argi))
		  (setq argi (cdr elt)))
678
	      ;; Check for a short option.
679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717
	      (setq argval nil
                    argi orig-argi))))
	(cond ((member argi '("-fg" "-foreground"))
	       (push (cons 'foreground-color (or argval (pop args)))
                     default-frame-alist))
	      ((member argi '("-bg" "-background"))
	       (push (cons 'background-color (or argval (pop args)))
                     default-frame-alist))
	      ((member argi '("-T" "-name"))
	       (unless argval (setq argval (pop args)))
	       (push (cons 'title
                           (if (stringp argval)
                               argval
                             (let ((case-fold-search t)
                                   i)
                               (setq argval (invocation-name))

                               ;; Change any . or * characters in name to
                               ;; hyphens, so as to emulate behavior on X.
                               (while
                                   (setq i (string-match "[.*]" argval))
                                 (aset argval i ?-))
                               argval)))
                     default-frame-alist))
	      ((member argi '("-r" "-rv" "-reverse"))
	       (push '(reverse . t)
                     default-frame-alist))
	      ((equal argi "-color")
	       (unless argval (setq argval 8)) ; default --color means 8 ANSI colors
	       (push (cons 'tty-color-mode
                           (cond
                            ((numberp argval) argval)
                            ((string-match "-?[0-9]+" argval)
                             (string-to-number argval))
                            (t (intern argval))))
                     default-frame-alist))
	      (t
               (push argi rest)))))
    (nreverse rest)))
718

719 720 721
(declare-function x-get-resource "frame.c"
		  (attribute class &optional component subclass))
(declare-function tool-bar-mode "tool-bar" (&optional arg))
722
(declare-function tool-bar-setup "tool-bar")
723

724
(defvar server-name)
725
(defvar server-process)
726

Jim Blandy's avatar
Jim Blandy committed
727
(defun command-line ()
Glenn Morris's avatar
Glenn Morris committed
728 729
  "A subroutine of `normal-top-level'.
Amongst another things, it parses the command-line arguments."
730
  (setq before-init-time (current-time)
731
	after-init-time nil
732
        command-line-default-directory default-directory)
733

734 735
  ;; Force recomputation, in case it was computed during the dump.
  (setq abbreviated-home-dir nil)
736

Roland McGrath's avatar
Roland McGrath committed
737
  ;; See if we should import version-control from the environment variable.
Jim Blandy's avatar
Jim Blandy committed
738 739
  (let ((vc (getenv "VERSION_CONTROL")))
    (cond ((eq vc nil))			;don't do anything if not set
740
	  ((member vc '("t" "numbered"))
Jim Blandy's avatar
Jim Blandy committed
741
	   (setq version-control t))
742
	  ((member vc '("nil" "existing"))
Jim Blandy's avatar
Jim Blandy committed
743
	   (setq version-control nil))
744
	  ((member vc '("never" "simple"))
Jim Blandy's avatar
Jim Blandy committed
745 746
	   (setq version-control 'never))))

Jim Blandy's avatar
Jim Blandy committed
747 748 749 750 751
  ;;! This has been commented out; I currently find the behavior when
  ;;! split-window-keep-point is nil disturbing, but if I can get used
  ;;! to it, then it would be better to eliminate the option.
  ;;! ;; Choose a good default value for split-window-keep-point.
  ;;! (setq split-window-keep-point (> baud-rate 2400))
Jim Blandy's avatar
Jim Blandy committed
752

753 754 755
  ;; Set the default strings to display in mode line for
  ;; end-of-line formats that aren't native to this platform.
  (cond
756
   ((memq system-type '(ms-dos windows-nt))
757 758 759 760 761
    (setq eol-mnemonic-unix "(Unix)"
          eol-mnemonic-mac  "(Mac)"))
   (t                                   ; this is for Unix/GNU/Linux systems
    (setq eol-mnemonic-dos  "(DOS)"
          eol-mnemonic-mac  "(Mac)")))
762

763 764
  (set-locale-environment nil)

765 766
  ;; Convert preloaded file names in load-history to absolute.
  (let ((simple-file-name
767 768
	 ;; Look for simple.el or simple.elc and use their directory
	 ;; as the place where all Lisp files live.
769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786
	 (locate-file "simple" load-path (get-load-suffixes)))
	lisp-dir)
    ;; Don't abort if simple.el cannot be found, but print a warning.
    (if (null simple-file-name)
	(progn
	  (princ "Warning: Could not find simple.el nor simple.elc"
		 'external-debugging-output)
	  (terpri 'external-debugging-output))
      (setq lisp-dir (file-truename (file-name-directory simple-file-name)))
      (setq load-history
	    (mapcar (lambda (elt)
		      (if (and (stringp (car elt))
			       (not (file-name-absolute-p (car elt))))
			  (cons (concat lisp-dir
					(car elt))
				(cdr elt))
			elt))
		    load-history))))
787

788 789 790 791 792
  ;; Convert the arguments to Emacs internal representation.
  (let ((args (cdr command-line-args)))
    (while args
      (setcar args
	      (decode-coding-string (car args) locale-coding-system t))
793
      (pop args)))
794

Jim Blandy's avatar
Jim Blandy committed
795
  (let ((done nil)
796 797
	(args (cdr command-line-args))
	display-arg)
Jim Blandy's avatar
Jim Blandy committed
798

Jim Blandy's avatar
Jim Blandy committed
799 800 801 802
    ;; Figure out which user's init file to load,
    ;; either from the environment or from the options.
    (setq init-file-user (if noninteractive nil (user-login-name)))
    ;; If user has not done su, use current $HOME to find .emacs.
803 804
    (and init-file-user
         (equal init-file-user (user-real-login-name))
Jim Blandy's avatar
Jim Blandy committed
805
	 (setq init-file-user ""))
Jim Blandy's avatar
Jim Blandy committed
806 807 808 809

    ;; Process the command-line args, and delete the arguments
    ;; processed.  This is consistent with the way main in emacs.c
    ;; does things.
Jim Blandy's avatar
Jim Blandy committed
810
    (while (and (not done) args)
811 812 813
      (let* ((longopts '(("--no-init-file") ("--no-site-file") ("--debug-init")
                         ("--user") ("--iconic") ("--icon-type") ("--quick")
			 ("--no-blinking-cursor") ("--basic-display")))
814 815 816
             (argi (pop args))
             (orig-argi argi)
             argval)
817
	;; Handle --OPTION=VALUE format.
818
	(when (string-match "\\`\\(--[^=]*\\)=" argi)
819
	  (setq argval (substring argi (match-end 0))
820
                argi (match-string 1 argi)))
821
	(when (string-match "\\`--." orig-argi)
822
	  (let ((completion (try-completion argi longopts)))
823 824 825 826 827 828 829 830 831 832
	    (cond ((eq completion t)
		   (setq argi (substring argi 1)))
		  ((stringp completion)
		   (let ((elt (assoc completion longopts)))
		     (unless elt
		       (error "Option `%s' is ambiguous" argi))
		     (setq argi (substring (car elt) 1))))
		  (t
		   (setq argval nil
			 argi orig-argi)))))
Jim Blandy's avatar
Jim Blandy committed
833
	(cond
834 835 836 837 838
	 ;; The --display arg is handled partly in C, partly in Lisp.
	 ;; When it shows up here, we just put it back to be handled
	 ;; by `command-line-1'.
	 ((member argi '("-d" "-display"))
	  (setq display-arg (list argi (pop args))))
839
	 ((member argi '("-Q" "-quick"))
Kenichi Handa's avatar
Kenichi Handa committed
840 841
	  (setq init-file-user nil
		site-run-file nil
842
		inhibit-x-resources t))
843 844 845
	 ((member argi '("-D" "-basic-display"))
	  (setq no-blinking-cursor t
		emacs-basic-display t)
Kenichi Handa's avatar
Kenichi Handa committed
846
	  (push '(vertical-scroll-bars . nil) initial-frame-alist))
847 848 849
	 ((member argi '("-q" "-no-init-file"))
	  (setq init-file-user nil))
	 ((member argi '("-u" "-user"))
850
	  (setq init-file-user (or argval (pop args))
851
		argval nil))
852
	 ((equal argi "-no-site-file")
853
	  (setq site-run-file nil))
854
	 ((equal argi "-debug-init")
855
	  (setq init-file-debug t))
856
	 ((equal argi "-iconic")
857
	  (push '(visibility . icon) initial-frame-alist))
858 859
	 ((member argi '("-nbc" "-no-blinking-cursor"))
	  (setq no-blinking-cursor t))
860
	 ;; Push the popped arg back on the list of arguments.
861 862 863
	 (t
          (push argi args)
          (setq done t)))
864 865 866 867
	;; Was argval set but not used?
	(and argval
	     (error "Option `%s' doesn't allow an argument" argi))))

868 869 870
    ;; Re-attach the --display arg.
    (and display-arg (setq args (append display-arg args)))

Jim Blandy's avatar
Jim Blandy committed
871
    ;; Re-attach the program name to the front of the arg list.
872 873
    (and command-line-args
         (setcdr command-line-args args)))
Jim Blandy's avatar
Jim Blandy committed
874

875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894
  ;; Make sure window system's init file was loaded in loadup.el if
  ;; using a window system.
  ;; Initialize the window-system only after processing the command-line
  ;; args so that -Q can influence this initialization.
  (condition-case error
    (unless noninteractive
      (if (and initial-window-system
	       (not (featurep
		     (intern
		      (concat (symbol-name initial-window-system) "-win")))))
	  (error "Unsupported window system `%s'" initial-window-system))
      ;; Process window-system specific command line parameters.
      (setq command-line-args
	    (funcall
	     (or (cdr (assq initial-window-system handle-args-function-alist))
		 (error "Unsupported window system `%s'" initial-window-system))
	     command-line-args))
      ;; Initialize the window system. (Open connection, etc.)
      (funcall
       (or (cdr (assq initial-window-system window-system-initialization-alist))
895 896
	   (error "Unsupported window system `%s'" initial-window-system)))
      (put initial-window-system 'window-system-initialized t))
897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915
    ;; If there was an error, print the error message and exit.
    (error
     (princ
      (if (eq (car error) 'error)
	  (apply 'concat (cdr error))
	(if (memq 'file-error (get (car error) 'error-conditions))
	    (format "%s: %s"
                    (nth 1 error)
                    (mapconcat (lambda (obj) (prin1-to-string obj t))
                               (cdr (cdr error)) ", "))
	  (format "%s: %s"
                  (get (car error) 'error-message)
                  (mapconcat (lambda (obj) (prin1-to-string obj t))
                             (cdr error) ", "))))
      'external-debugging-output)
     (terpri 'external-debugging-output)
     (setq initial-window-system nil)
     (kill-emacs)))

916 917
  (run-hooks 'before-init-hook)

918
  ;; Under X, create the X frame and delete the terminal frame.
919
  (unless (daemonp)
920 921 922 923
    (if (or noninteractive emacs-basic-display)
	(setq menu-bar-mode nil
	      tool-bar-mode nil
	      no-blinking-cursor t))
924
    (frame-initialize))
925

926 927 928 929 930
  (when (fboundp 'x-create-frame)
    ;; Set up the tool-bar (even in tty frames, since Emacs might open a
    ;; graphical frame later).
    (unless noninteractive
      (tool-bar-setup)))
931

932
  ;; Turn off blinking cursor if so specified in X resources.  This is here
Jan Djärv's avatar
Jan Djärv committed
933
  ;; only because all other settings of no-blinking-cursor are here.
934 935
  (unless (or noninteractive
	      emacs-basic-display
936
	      (and (memq window-system '(x w32 ns))