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

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

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

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

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

;; 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
23
;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
Jim Blandy's avatar
Jim Blandy committed
24

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

Kenichi Handa's avatar
Kenichi Handa committed
27 28 29
;; 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
30

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

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

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

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

(defcustom initial-buffer-choice nil
  "Buffer to show after starting Emacs.
44
If the value is nil and `inhibit-startup-screen' is nil, show the
45 46 47 48
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.
49 50 51

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

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

64 65
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
66 67
  :type 'boolean
  :group 'initialization)
Jim Blandy's avatar
Jim Blandy committed
68

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

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

Glenn Morris's avatar
Glenn Morris committed
74 75
;; 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
76
(defcustom inhibit-startup-echo-area-message nil
77
  "Non-nil inhibits the initial startup echo area message.
Richard M. Stallman's avatar
Richard M. Stallman committed
78 79
Setting this variable takes effect
only if you do it with the customization buffer
80
or if your init file contains a line of this form:
81
 (setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\")
82 83
If your init file is byte-compiled, use the following form
instead:
84
 (eval '(setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\"))
85 86
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
87 88 89
  :type '(choice (const :tag "Don't inhibit")
		 (string :tag "Enter your user name, to inhibit"))
  :group 'initialization)
90

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

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

101
(defvar command-switch-alist nil
Jim Blandy's avatar
Jim Blandy committed
102 103
  "Alist of command-line switches.
Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
Kenichi Handa's avatar
Kenichi Handa committed
104 105
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
106

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

110 111 112 113 114
(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.")
115
(internal-make-var-non-special 'argv)
116

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

Jim Blandy's avatar
Jim Blandy committed
121 122 123
(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
124
`argi' (the current argument) and `command-line-args-left' (the remaining
Jim Blandy's avatar
Jim Blandy committed
125
arguments).  The function should return non-nil only if it recognizes and
Richard M. Stallman's avatar
Richard M. Stallman committed
126 127
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
128

129 130 131 132
(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
133 134
;; This is here, rather than in x-win.el, so that we can ignore these
;; options when we are not using X.
135
(defconst command-line-x-option-alist
136 137 138
  '(("-bw" 1 x-handle-numeric-switch border-width)
    ("-d" 1 x-handle-display)
    ("-display" 1 x-handle-display)
139
    ("-name" 1 x-handle-name-switch)
140 141
    ("-title" 1 x-handle-switch title)
    ("-T" 1 x-handle-switch title)
142 143 144 145 146 147
    ("-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)
148 149 150
    ("-fs" 0 x-handle-initial-switch fullscreen fullboth)
    ("-fw" 0 x-handle-initial-switch fullscreen fullwidth)
    ("-fh" 0 x-handle-initial-switch fullscreen fullheight)
151
    ("-mm" 0 x-handle-initial-switch fullscreen maximized)
152
    ("-ib" 1 x-handle-numeric-switch internal-border-width)
153
    ("-g" 1 x-handle-geometry)
154
    ("-lsp" 1 x-handle-numeric-switch line-spacing)
155
    ("-geometry" 1 x-handle-geometry)
156 157 158 159 160
    ("-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)
161
    ("-nbi" 0 x-handle-switch icon-type nil)
162 163 164 165 166 167 168 169
    ("-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)
170
    ("--name" 1 x-handle-name-switch)
171
    ("--title" 1 x-handle-switch title)
172 173
    ("--reverse-video" 0 x-handle-switch reverse t)
    ("--font" 1 x-handle-switch font)
174 175 176
    ("--fullscreen" 0 x-handle-initial-switch fullscreen fullboth)
    ("--fullwidth" 0 x-handle-initial-switch fullscreen fullwidth)
    ("--fullheight" 0 x-handle-initial-switch fullscreen fullheight)
177
    ("--maximized" 0 x-handle-initial-switch fullscreen maximized)
178
    ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
179
    ("--geometry" 1 x-handle-geometry)
180 181 182
    ("--foreground-color" 1 x-handle-switch foreground-color)
    ("--background-color" 1 x-handle-switch background-color)
    ("--mouse-color" 1 x-handle-switch mouse-color)
183
    ("--no-bitmap-icon" 0 x-handle-no-bitmap-icon)
184 185 186 187
    ("--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)
188
    ("--line-spacing" 1 x-handle-numeric-switch line-spacing)
189
    ("--border-color" 1 x-handle-switch border-color)
190 191
    ("--smid" 1 x-handle-smid)
    ("--parent-id" 1 x-handle-parent-id))
192 193 194 195 196 197 198 199 200
  "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).")

201 202 203
(defconst command-line-ns-option-alist
  '(("-NSAutoLaunch" 1 ns-ignore-1-arg)
    ("-NXAutoLaunch" 1 ns-ignore-1-arg)
204
    ("-macosx" 0 ignore)
205 206 207 208 209 210 211 212 213 214 215
    ("-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)
216 217 218 219 220 221 222 223 224
    ("-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)
225 226
    ("-g" 1 x-handle-geometry)
    ("-geometry" 1 x-handle-geometry)
227 228 229 230 231 232 233 234
    ("-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)
235
    ;;("-xrm" .             x-handle-xrm-switch)
236 237 238 239 240
    ("-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)
241
    ;; ("--display" 1 ns-handle-display)
242 243 244 245 246
    ("--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)
247
    ;; ("--geometry" 1 ns-handle-geometry)
248 249 250 251 252
    ("--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)
253
    ;; ("--xrm" 1 ns-handle-xrm-switch)
254 255 256
    ("--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))
257 258 259 260 261 262 263 264 265 266
  "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
267
(defvar before-init-hook nil
268
  "Normal hook run after handling urgent options but before loading init files.")
Jim Blandy's avatar
Jim Blandy committed
269

Roland McGrath's avatar
Roland McGrath committed
270
(defvar after-init-hook nil
271 272 273 274 275 276 277 278
  "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.")
279 280 281

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

Jim Blandy's avatar
Jim Blandy committed
283
(defvar term-setup-hook nil
284 285
  "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
286 287 288
so as to override the definitions made by the terminal-specific file.
Emacs never sets this variable itself.")

289 290 291 292
(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
293
(defvar keyboard-type nil
Richard M. Stallman's avatar
Richard M. Stallman committed
294
  "The brand of keyboard you are using.
295 296 297
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
298 299

(defvar window-setup-hook nil
Richard M. Stallman's avatar
Richard M. Stallman committed
300 301 302
  "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
303

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

309
(defvar init-file-user nil
310
  "Identity of user whose init file is or was read.
311 312 313
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
314 315 316 317
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
318

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

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

326
(defcustom site-run-file (purecopy "site-start")
327 328 329
  "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
330
higher incidence of change, don't make sense to load into Emacs's
331
dumped image.  Thus, the run-time load order is: 1. file described in
332 333 334 335 336 337 338
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
339 340 341 342 343
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
344
this variable usefully is to set it while building and dumping Emacs."
345
  :type '(choice (const :tag "none" nil) string)
346 347
  :group 'initialization
  :initialize 'custom-initialize-default
348
  :set (lambda (_variable _value)
349
	  (error "Customizing `site-run-file' does not work")))
350

Richard M. Stallman's avatar
Richard M. Stallman committed
351
(defcustom mail-host-address nil
352 353 354
  "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
355 356
  :type '(choice (const nil) string)
  :group 'mail)
357

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

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

389 390
(defvar emacs-basic-display nil)

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

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

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

398 399
(defvar no-blinking-cursor nil)

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

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

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

409 410 411 412 413 414
(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)
415

416 417 418 419 420 421 422 423 424
(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.")

425
(defun normal-top-level-add-subdirs-to-load-path ()
426
  "Add all subdirectories of `default-directory' to `load-path'.
427
More precisely, this uses only the subdirectories whose names
428 429
start with letters or digits; it excludes any subdirectory named `RCS'
or `CVS', and any subdirectory that contains a file named `.nosearch'."
430
  (let (dirs
431
	attrs
432 433 434 435
	(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
436
      (push (pop pending) dirs)
437 438 439
      (let* ((this-dir (car dirs))
	     (contents (directory-files this-dir))
	     (default-directory this-dir)
440 441
	     (canonicalized (if (fboundp 'untranslated-canonical-name)
				(untranslated-canonical-name this-dir))))
Glenn Morris's avatar
Glenn Morris committed
442 443
	;; The Windows version doesn't report meaningful inode numbers, so
	;; use the canonicalized absolute file name of the directory instead.
444 445
	(setq attrs (or canonicalized
			(nthcdr 10 (file-attributes this-dir))))
446
	(unless (member attrs normal-top-level-add-subdirs-inode-list)
447 448
	  (push attrs normal-top-level-add-subdirs-inode-list)
	  (dolist (file contents)
Glenn Morris's avatar
Glenn Morris committed
449 450 451 452 453 454 455 456 457 458
	    (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))))))))))
459
    (normal-top-level-add-to-load-path (cdr (nreverse dirs)))))
460

461
(defun normal-top-level-add-to-load-path (dirs)
Glenn Morris's avatar
Glenn Morris committed
462 463 464 465 466
  "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."
467 468 469
  (let ((tail load-path)
	(thisdir (directory-file-name default-directory)))
    (while (and tail
470 471
		;;Don't go all the way to the nil terminator.
		(cdr tail)
472 473 474 475
		(not (equal thisdir (car tail)))
		(not (and (memq system-type '(ms-dos windows-nt))
			  (equal (downcase thisdir) (downcase (car tail))))))
      (setq tail (cdr tail)))
476 477 478
    ;;Splice the new section in.
    (when tail
      (setcdr tail (append (mapcar 'expand-file-name dirs) (cdr tail))))))
479

Jim Blandy's avatar
Jim Blandy committed
480
(defun normal-top-level ()
Glenn Morris's avatar
Glenn Morris committed
481 482 483 484
  "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
485 486 487
  (if command-line-processed
      (message "Back to top level.")
    (setq command-line-processed t)
488
    (let ((dir default-directory))
489
      (with-current-buffer "*Messages*"
490 491 492 493
        ;; 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.
494
	(setq default-directory dir)))
495 496 497
    ;; `user-full-name' is now known; reset its standard-value here.
    (put 'user-full-name 'standard-value
	 (list (default-value 'user-full-name)))
498 499 500
    ;; 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,
501 502
    ;; Look for a leim-list.el file too.  Loading it will register
    ;; available input methods.
503 504 505 506 507
    (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)
508 509 510 511
      (while tail
        (setq dir (car tail))
        (let ((default-directory dir))
          (load (expand-file-name "subdirs.el") t t t))
512 513 514 515 516
	;; 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)))
517 518 519 520
        ;; 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
521 522 523 524 525 526 527 528 529 530 531 532 533
    ;; 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
534
    (setq default-directory (abbreviate-file-name default-directory))
535
    (let ((old-face-font-rescale-alist face-font-rescale-alist))
536 537 538 539
      (unwind-protect
	  (command-line)
	;; Do this again, in case .emacs defined more abbreviations.
	(setq default-directory (abbreviate-file-name default-directory))
540 541
	;; Specify the file for recording all the auto save files of this session.
	;; This is used by recover-session.
542 543 544
	(or auto-save-list-file-name
	    (and auto-save-list-file-prefix
		 (setq auto-save-list-file-name
545 546
		       ;; Under MS-DOS our PID is almost always reused between
		       ;; Emacs invocations.  We need something more unique.
547 548 549 550 551 552
		       (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)
553
			      (concat
554 555 556 557 558 559 560 561 562 563
			       (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))))))))
564 565 566 567
	(unless inhibit-startup-hooks
	  (run-hooks 'emacs-startup-hook)
	  (and term-setup-hook
	       (run-hooks 'term-setup-hook)))
568 569 570

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

	  ;; 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)))

589 590 591 592
	  ;; Modify the initial frame based on what .emacs puts into
	  ;; ...-frame-alist.
	  (if (fboundp 'frame-notice-user-settings)
	      (frame-notice-user-settings))
593 594 595 596
	  ;; 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.
597
	  (if (fboundp 'frame-set-background-mode)
598
	      (frame-set-background-mode (selected-frame))))
Miles Bader's avatar
Miles Bader committed
599

600 601 602 603
	;; 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
604
	     (run-hooks 'window-setup-hook))))
605 606 607 608
    ;; 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.
609 610 611 612 613 614 615 616 617 618 619 620 621 622
    (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)))))
623 624

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

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

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

640 641 642 643 644 645 646 647 648 649 650 651
(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
652
opening the first frame (e.g. open a connection to an X server).")
653

654
(defun tty-handle-args (args)
Glenn Morris's avatar
Glenn Morris committed
655
  "Handle the X-like command-line arguments \"-fg\", \"-bg\", \"-name\", etc."
656
  (let (rest)
657
    (message "%S" args)
658 659
    (while (and args
		(not (equal (car args) "--")))
660 661 662
      (let* ((argi (pop args))
	     (orig-argi argi)
	     argval completion)
663 664
	;; Check for long options with attached arguments
	;; and separate out the attached option argument into argval.
665 666 667 668 669
	(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))
670 671
	  (if (eq completion t)
	      ;; Exact match for long option.
672
	      (setq argi (cdr (assoc argi tty-long-option-alist)))
673 674 675 676
	    (if (stringp completion)
		(let ((elt (assoc completion tty-long-option-alist)))
		  ;; Check for abbreviated long option.
		  (or elt
677 678
		      (error "Option `%s' is ambiguous" argi))
		  (setq argi (cdr elt)))
679
	      ;; Check for a short option.
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 718
	      (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)))
719

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

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

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

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

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

Jim Blandy's avatar
Jim Blandy committed
748 749 750 751 752
  ;;! 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
753

754 755 756
  ;; Set the default strings to display in mode line for
  ;; end-of-line formats that aren't native to this platform.
  (cond
757
   ((memq system-type '(ms-dos windows-nt))
758 759 760 761 762
    (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)")))
763

764 765
  (set-locale-environment nil)

766 767
  ;; Convert preloaded file names in load-history to absolute.
  (let ((simple-file-name
768 769
	 ;; Look for simple.el or simple.elc and use their directory
	 ;; as the place where all Lisp files live.
770 771 772
	 (locate-file "simple" load-path (get-load-suffixes)))
	lisp-dir)
    ;; Don't abort if simple.el cannot be found, but print a warning.
773 774
    ;; Although in most usage we are going to cryptically abort a moment
    ;; later anyway, due to missing required bidi data files (eg bug#13430).
775
    (if (null simple-file-name)
776 777 778 779 780 781 782 783 784 785 786
	(let ((standard-output 'external-debugging-output)
	      (lispdir (expand-file-name "../lisp" data-directory)))
	  (princ "Warning: Could not find simple.el or simple.elc")
	  (terpri)
	  (when (getenv "EMACSLOADPATH")
	    (princ "The EMACSLOADPATH environment variable is set, \
please check its value")
	    (terpri))
	  (unless (file-readable-p lispdir)
	    (princ (format "Lisp directory %s not readable?" lispdir))
	    (terpri)))
787 788 789 790 791 792 793 794 795 796
      (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))))
797

798 799 800 801 802
  ;; 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))
803
      (pop args)))
804

Jim Blandy's avatar
Jim Blandy committed
805
  (let ((done nil)
806 807
	(args (cdr command-line-args))
	display-arg)
Jim Blandy's avatar
Jim Blandy committed
808

Jim Blandy's avatar
Jim Blandy committed
809 810 811 812
    ;; 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.
813 814
    (and init-file-user
         (equal init-file-user (user-real-login-name))
Jim Blandy's avatar
Jim Blandy committed
815
	 (setq init-file-user ""))
Jim Blandy's avatar
Jim Blandy committed
816 817 818 819

    ;; 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
820
    (while (and (not done) args)
821 822 823
      (let* ((longopts '(("--no-init-file") ("--no-site-file") ("--debug-init")
                         ("--user") ("--iconic") ("--icon-type") ("--quick")
			 ("--no-blinking-cursor") ("--basic-display")))
824 825 826
             (argi (pop args))
             (orig-argi argi)
             argval)
827
	;; Handle --OPTION=VALUE format.
828
	(when (string-match "\\`\\(--[^=]*\\)=" argi)
829
	  (setq argval (substring argi (match-end 0))
830
                argi (match-string 1 argi)))
831
	(when (string-match "\\`--." orig-argi)
832
	  (let ((completion (try-completion argi longopts)))
833 834 835 836 837 838 839 840 841 842
	    (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
843
	(cond
844 845 846 847 848
	 ;; 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))))
849
	 ((member argi '("-Q" "-quick"))
Kenichi Handa's avatar
Kenichi Handa committed
850 851
	  (setq init-file-user nil
		site-run-file nil
852
		inhibit-x-resources t))
853 854 855
	 ((member argi '("-D" "-basic-display"))
	  (setq no-blinking-cursor t
		emacs-basic-display t)
Kenichi Handa's avatar
Kenichi Handa committed
856
	  (push '(vertical-scroll-bars . nil) initial-frame-alist))
857 858 859
	 ((member argi '("-q" "-no-init-file"))
	  (setq init-file-user nil))
	 ((member argi '("-u" "-user"))
860
	  (setq init-file-user (or argval (pop args))
861
		argval nil))
862
	 ((equal argi "-no-site-file")
863
	  (setq site-run-file nil))
864
	 ((equal argi "-debug-init")
865
	  (setq init-file-debug t))
866
	 ((equal argi "-iconic")
867
	  (push '(visibility . icon) initial-frame-alist))
868 869
	 ((member argi '("-nbc" "-no-blinking-cursor"))
	  (setq no-blinking-cursor t))
870
	 ;; Push the popped arg back on the list of arguments.
871 872 873
	 (t
          (push argi args)
          (setq done t)))
874 875 876 877
	;; Was argval set but not used?
	(and argval
	     (error "Option `%s' doesn't allow an argument" argi))))

878 879 880
    ;; Re-attach the --display arg.
    (and display-arg (setq args (append display-arg args)))

Jim Blandy's avatar
Jim Blandy committed
881
    ;; Re-attach the program name to the front of the arg list.
882 883
    (and command-line-args
         (setcdr command-line-args args)))
Jim Blandy's avatar
Jim Blandy committed
884

885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904
  ;; 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))
905 906
	   (error "Unsupported window system `%s'" initial-window-system)))
      (put initial-window-system 'window-system-initialized t))
907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925
    ;; 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)))

926 927
  (run-hooks 'before-init-hook)

928
  ;; Under X, create the X frame and delete the terminal frame.
929
  (unless (daemonp)
930 931 932 933
    (if (or noninteractive emacs-basic-display)
	(setq menu-bar-mode nil
	      tool-bar-mode nil
	      no-blinking-cursor t))
934
    (frame-initialize))
935

936 937 938 939 940
  (when (fboundp 'x-create-frame)
    ;; Set up the tool-bar (even in tty frames, since Emacs might open a