startup.el 91.3 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
Chong Yidong's avatar
Chong Yidong committed
44
startup screen.  If the value is a string, visit the specified file
45
or directory using `find-file'.  If t, open the `*scratch*'
46 47 48 49
buffer.

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

58
(defcustom inhibit-startup-screen nil
59 60
  "Non-nil inhibits the startup screen.

61 62
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
63 64
  :type 'boolean
  :group 'initialization)
Jim Blandy's avatar
Jim Blandy committed
65

66 67
(defvaralias 'inhibit-splash-screen 'inhibit-startup-screen)
(defvaralias 'inhibit-startup-message 'inhibit-startup-screen)
68

69
(defvar startup-screen-inhibit-startup-screen nil)
70

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

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

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

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

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

107 108 109 110 111
(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.")
112
(internal-make-var-non-special 'argv)
113

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

386 387
(defvar emacs-basic-display nil)

Jim Blandy's avatar
Jim Blandy committed
388 389
(defvar init-file-debug nil)

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

393 394
(defvar normal-top-level-add-subdirs-inode-list nil)

395 396
(defvar no-blinking-cursor nil)

397 398
(defvar default-frame-background-mode)

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

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

406 407 408 409 410 411
(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)
412

413 414 415 416 417 418 419 420 421
(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.")

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

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

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

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

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

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

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

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

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

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

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

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

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

722
(defvar server-name)
723
(defvar server-process)
724

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

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

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

Jim Blandy's avatar
Jim Blandy committed
745 746 747 748 749
  ;;! 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
750

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

761 762
  (set-locale-environment nil)

763 764
  ;; Convert preloaded file names in load-history to absolute.
  (let ((simple-file-name
765 766
	 ;; Look for simple.el or simple.elc and use their directory
	 ;; as the place where all Lisp files live.
767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784
	 (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))))
785

786 787 788 789 790
  ;; 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))
791
      (pop args)))
792

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

Jim Blandy's avatar
Jim Blandy committed
797 798 799 800
    ;; 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.
801 802
    (and init-file-user
         (equal init-file-user (user-real-login-name))
Jim Blandy's avatar
Jim Blandy committed
803
	 (setq init-file-user ""))
Jim Blandy's avatar
Jim Blandy committed
804 805 806 807

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

866 867 868
    ;; Re-attach the --display arg.
    (and display-arg (setq args (append display-arg args)))

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

873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892
  ;; 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))
893 894
	   (error "Unsupported window system `%s'" initial-window-system)))
      (put initial-window-system 'window-system-initialized t))
895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913
    ;; 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)))

914 915
  (run-hooks 'before-init-hook)

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

924 925 926 927 928
  (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)))
929

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