(symbol-file): Doc fix.
[bpt/emacs.git] / lisp / startup.el
CommitLineData
c88ab9ce
ER
1;;; startup.el --- process Emacs shell arguments
2
a3194d03 3;; Copyright (C) 1985, 1986, 1992, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
0d30b337 4;; 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
eea8d4ef 5
630cc463 6;; Maintainer: FSF
d7b4d18f 7;; Keywords: internal
630cc463 8
a726e0d1
JB
9;; This file is part of GNU Emacs.
10
11;; GNU Emacs is free software; you can redistribute it and/or modify
12;; it under the terms of the GNU General Public License as published by
4746118a 13;; the Free Software Foundation; either version 2, or (at your option)
a726e0d1
JB
14;; any later version.
15
16;; GNU Emacs is distributed in the hope that it will be useful,
17;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19;; GNU General Public License for more details.
20
21;; You should have received a copy of the GNU General Public License
b578f267 22;; along with GNU Emacs; see the file COPYING. If not, write to the
086add15
LK
23;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
24;; Boston, MA 02110-1301, USA.
a726e0d1 25
630cc463 26;;; Commentary:
a726e0d1 27
32e51983
EZ
28;; This file parses the command line and gets Emacs running. Options
29;; on the command line are handled in precedence order. For priorities
30;; see the structure standard_args in the emacs.c file.
a726e0d1 31
630cc463
ER
32;;; Code:
33
a726e0d1
JB
34(setq top-level '(normal-top-level))
35
42a3e6fa 36(defvar command-line-processed nil
2879a13b 37 "Non-nil once command line has been processed.")
a726e0d1 38
42a3e6fa 39(defgroup initialization nil
ca3685a3 40 "Emacs start-up procedure."
42a3e6fa
RS
41 :group 'internal)
42
43(defcustom inhibit-startup-message nil
1d7da582 44 "*Non-nil inhibits the initial startup message.
a726e0d1 45This is for use in your personal init file, once you are familiar
42a3e6fa
RS
46with the contents of the startup message."
47 :type 'boolean
48 :group 'initialization)
a726e0d1 49
1b207153
CW
50(defvaralias 'inhibit-splash-screen 'inhibit-startup-message)
51
42a3e6fa 52(defcustom inhibit-startup-echo-area-message nil
1d7da582 53 "*Non-nil inhibits the initial startup echo area message.
42a3e6fa
RS
54Setting this variable takes effect
55only if you do it with the customization buffer
94487c4e 56or if your `.emacs' file contains a line of this form:
54a003f7 57 (setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\")
e5575c06
RS
58If your `.emacs' file is byte-compiled, use the following form instead:
59 (eval '(setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\"))
1d7da582 60Thus, someone else using a copy of your `.emacs' file will see
42a3e6fa
RS
61the startup message unless he personally acts to inhibit it."
62 :type '(choice (const :tag "Don't inhibit")
63 (string :tag "Enter your user name, to inhibit"))
64 :group 'initialization)
1d7da582 65
42a3e6fa
RS
66(defcustom inhibit-default-init nil
67 "*Non-nil inhibits loading the `default' library."
68 :type 'boolean
69 :group 'initialization)
a726e0d1 70
802a980a
GM
71(defcustom inhibit-startup-buffer-menu nil
72 "*Non-nil inhibits display of buffer list when more than 2 files are loaded."
73 :type 'boolean
74 :group 'initialization)
75
d7fa5aa2 76(defvar command-switch-alist nil
a726e0d1
JB
77 "Alist of command-line switches.
78Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
5bb54c61
RS
79HANDLER-FUNCTION receives the switch string as its sole argument;
80the remaining command-line args are in the variable `command-line-args-left'.")
a726e0d1 81
860befc8
RS
82(defvar command-line-args-left nil
83 "List of command-line args not yet processed.")
84
a726e0d1
JB
85(defvar command-line-functions nil ;; lrs 7/31/89
86 "List of functions to process unrecognized command-line arguments.
87Each function should access the dynamically bound variables
b4484ea8 88`argi' (the current argument) and `command-line-args-left' (the remaining
a726e0d1 89arguments). The function should return non-nil only if it recognizes and
b4484ea8
RS
90processes `argi'. If it does so, it may consume successive arguments by
91altering `command-line-args-left' to remove them.")
a726e0d1 92
09a1077c
RS
93(defvar command-line-default-directory nil
94 "Default directory to use for command line arguments.
95This is normally copied from `default-directory' when Emacs starts.")
96
b3afdeb8
RS
97;;; This is here, rather than in x-win.el, so that we can ignore these
98;;; options when we are not using X.
46cfd295 99(defconst command-line-x-option-alist
b3afdeb8
RS
100 '(("-bw" 1 x-handle-numeric-switch border-width)
101 ("-d" 1 x-handle-display)
102 ("-display" 1 x-handle-display)
5676ab57 103 ("-name" 1 x-handle-name-switch)
2c3fef40
RS
104 ("-title" 1 x-handle-switch title)
105 ("-T" 1 x-handle-switch title)
b3afdeb8
RS
106 ("-r" 0 x-handle-switch reverse t)
107 ("-rv" 0 x-handle-switch reverse t)
108 ("-reverse" 0 x-handle-switch reverse t)
109 ("-reverse-video" 0 x-handle-switch reverse t)
110 ("-fn" 1 x-handle-switch font)
111 ("-font" 1 x-handle-switch font)
188b6a5e
EZ
112 ("-fs" 0 x-handle-initial-switch fullscreen fullboth)
113 ("-fw" 0 x-handle-initial-switch fullscreen fullwidth)
114 ("-fh" 0 x-handle-initial-switch fullscreen fullheight)
b3afdeb8 115 ("-ib" 1 x-handle-numeric-switch internal-border-width)
1f7f78f1 116 ("-g" 1 x-handle-geometry)
9ff6bda1 117 ("-lsp" 1 x-handle-numeric-switch line-spacing)
1f7f78f1 118 ("-geometry" 1 x-handle-geometry)
b3afdeb8
RS
119 ("-fg" 1 x-handle-switch foreground-color)
120 ("-foreground" 1 x-handle-switch foreground-color)
121 ("-bg" 1 x-handle-switch background-color)
122 ("-background" 1 x-handle-switch background-color)
123 ("-ms" 1 x-handle-switch mouse-color)
c755acf3 124 ("-nbi" 0 x-handle-switch icon-type nil)
b3afdeb8
RS
125 ("-iconic" 0 x-handle-iconic)
126 ("-xrm" 1 x-handle-xrm-switch)
127 ("-cr" 1 x-handle-switch cursor-color)
128 ("-vb" 0 x-handle-switch vertical-scroll-bars t)
129 ("-hb" 0 x-handle-switch horizontal-scroll-bars t)
130 ("-bd" 1 x-handle-switch)
131 ("--border-width" 1 x-handle-numeric-switch border-width)
132 ("--display" 1 x-handle-display)
5676ab57 133 ("--name" 1 x-handle-name-switch)
7775acb8 134 ("--title" 1 x-handle-switch title)
b3afdeb8
RS
135 ("--reverse-video" 0 x-handle-switch reverse t)
136 ("--font" 1 x-handle-switch font)
188b6a5e
EZ
137 ("--fullscreen" 0 x-handle-initial-switch fullscreen fullboth)
138 ("--fullwidth" 0 x-handle-initial-switch fullscreen fullwidth)
139 ("--fullheight" 0 x-handle-initial-switch fullscreen fullheight)
b3afdeb8 140 ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
1f7f78f1 141 ("--geometry" 1 x-handle-geometry)
b3afdeb8
RS
142 ("--foreground-color" 1 x-handle-switch foreground-color)
143 ("--background-color" 1 x-handle-switch background-color)
144 ("--mouse-color" 1 x-handle-switch mouse-color)
1c1db08a 145 ("--no-bitmap-icon" 0 x-handle-switch icon-type nil)
b3afdeb8
RS
146 ("--iconic" 0 x-handle-iconic)
147 ("--xrm" 1 x-handle-xrm-switch)
148 ("--cursor-color" 1 x-handle-switch cursor-color)
149 ("--vertical-scroll-bars" 0 x-handle-switch vertical-scroll-bars t)
9ff6bda1 150 ("--line-spacing" 1 x-handle-numeric-switch line-spacing)
7f944e8e 151 ("--border-color" 1 x-handle-switch border-color)
ca57f55d 152 ("--smid" 1 x-handle-smid))
b3afdeb8
RS
153 "Alist of X Windows options.
154Each element has the form
155 (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
156where NAME is the option name string, NUMARGS is the number of arguments
157that the option accepts, HANDLER is a function to call to handle the option.
158FRAME-PARAM (optional) is the frame parameter this option specifies,
159and VALUE is the value which is given to that frame parameter
160\(most options use the argument for this, so VALUE is not present).")
161
e3bd99f5 162(defvar before-init-hook nil
db3f571a 163 "Normal hook run after handling urgent options but before loading init files.")
3fc958a4 164
e3bd99f5 165(defvar after-init-hook nil
db3f571a
KH
166 "Normal hook run after loading the init files, `~/.emacs' and `default.el'.
167There is no `condition-case' around the running of these functions;
168therefore, if you set `debug-on-error' non-nil in `.emacs',
169an error in one of these functions will invoke the debugger.")
170
171(defvar emacs-startup-hook nil
172 "Normal hook run after loading init files and handling the command line.")
e3bd99f5 173
a726e0d1 174(defvar term-setup-hook nil
db3f571a
KH
175 "Normal hook run after loading terminal-specific Lisp code.
176It also follows `emacs-startup-hook'. This hook exists for users to set,
a726e0d1
JB
177so as to override the definitions made by the terminal-specific file.
178Emacs never sets this variable itself.")
179
deebb0e9
RS
180(defvar inhibit-startup-hooks nil
181 "Non-nil means don't run `term-setup-hook' and `emacs-startup-hook'.
182This is because we already did so.")
183
a726e0d1 184(defvar keyboard-type nil
b4484ea8 185 "The brand of keyboard you are using.
9ab281f0
JB
186This variable is used to define the proper function and keypad
187keys for use under X. It is used in a fashion analogous to the
188environment variable TERM.")
a726e0d1
JB
189
190(defvar window-setup-hook nil
b4484ea8
RS
191 "Normal hook run to initialize window system display.
192Emacs runs this hook after processing the command line arguments and loading
193the user's init file.")
a726e0d1 194
42a3e6fa
RS
195(defcustom initial-major-mode 'lisp-interaction-mode
196 "Major mode command symbol to use for the initial *scratch* buffer."
ce2f921e 197 :type 'function
42a3e6fa 198 :group 'initialization)
a726e0d1 199
42a3e6fa 200(defcustom init-file-user nil
a726e0d1 201 "Identity of user whose `.emacs' file is or was read.
d7fa5aa2
RS
202The value is nil if `-q' or `--no-init-file' was specified,
203meaning do not load any init file.
204
205Otherwise, the value may be the null string, meaning use the init file
206for the user that originally logged in, or it may be a
207string containing a user's name meaning use that person's init file.
a726e0d1 208
2bdfaa42
KH
209In either of the latter cases, `(concat \"~\" init-file-user \"/\")'
210evaluates to the name of the directory where the `.emacs' file was
13fce4e6
RS
211looked for.
212
213Setting `init-file-user' does not prevent Emacs from loading
42a3e6fa
RS
214`site-start.el'. The only way to do that is to use `--no-site-file'."
215 :type '(choice (const :tag "none" nil) string)
216 :group 'initialization)
a726e0d1 217
42a3e6fa 218(defcustom site-run-file "site-start"
b7444d31
RS
219 "File containing site-wide run-time initializations.
220This file is loaded at run-time before `~/.emacs'. It contains inits
221that need to be in place for the entire site, but which, due to their
fcaf7de9 222higher incidence of change, don't make sense to load into Emacs's
b7444d31 223dumped image. Thus, the run-time load order is: 1. file described in
13fce4e6
RS
224this variable, if non-nil; 2. `~/.emacs'; 3. `default.el'.
225
226Don't use the `site-start.el' file for things some users may not like.
227Put them in `default.el' instead, so that users can more easily
228override them. Users can prevent loading `default.el' with the `-q'
229option or by setting `inhibit-default-init' in their own init files,
230but inhibiting `site-start.el' requires `--no-site-file', which
842a1eac
RS
231is less convenient.
232
233This variable is defined for customization so as to make
234it visible in the relevant context. However, actually customizing it
235is not allowed, since it would not work anyway. The only way to set
9ab281f0 236this variable usefully is to set it while building and dumping Emacs."
93812130 237 :type '(choice (const :tag "none" nil) string)
842a1eac
RS
238 :group 'initialization
239 :initialize 'custom-initialize-default
240 :set '(lambda (variable value)
241 (error "Customizing `site-run-file' does not work")))
b7444d31 242
42a3e6fa
RS
243(defcustom mail-host-address nil
244 "*Name of this machine, for purposes of naming users."
245 :type '(choice (const nil) string)
246 :group 'mail)
c13fbb62 247
680ebfa6
RS
248(defcustom user-mail-address (if command-line-processed
249 (concat (user-login-name) "@"
250 (or mail-host-address
251 (system-name)))
252 ;; Empty string means "not set yet".
253 "")
452e9090
RS
254 "*Full mailing address of this user.
255This is initialized based on `mail-host-address',
42a3e6fa
RS
256after your init file is read, in case it sets `mail-host-address'."
257 :type 'string
258 :group 'mail)
c10d1f06 259
42a3e6fa 260(defcustom auto-save-list-file-prefix
73f13e5a
GM
261 (cond ((eq system-type 'ms-dos)
262 ;; MS-DOS cannot have initial dot, and allows only 8.3 names
4b33deaa 263 "~/_emacs.d/auto-save.list/_s")
73f13e5a
GM
264 (t
265 "~/.emacs.d/auto-save-list/.saves-"))
cdee38c3
KH
266 "Prefix for generating `auto-save-list-file-name'.
267This is used after reading your `.emacs' file to initialize
268`auto-save-list-file-name', by appending Emacs's pid and the system name,
269if you have not already set `auto-save-list-file-name' yourself.
73f13e5a 270Directories in the prefix will be created if necessary.
cdee38c3 271Set this to nil if you want to prevent `auto-save-list-file-name'
42a3e6fa 272from being initialized."
3671f444
KH
273 :type '(choice (const :tag "Don't record a session's auto save list" nil)
274 string)
42a3e6fa 275 :group 'auto-save)
2e05d063 276
e2c60824
KS
277(defvar emacs-quick-startup nil)
278
dc58296d
RS
279(defvar emacs-basic-display nil)
280
a726e0d1
JB
281(defvar init-file-debug nil)
282
52320897
RS
283(defvar init-file-had-error nil)
284
95eada65
RS
285(defvar normal-top-level-add-subdirs-inode-list nil)
286
178b4542
JL
287(defvar no-blinking-cursor nil)
288
0a480f3d
RS
289(defvar default-frame-background-mode)
290
b693e375
RS
291(defvar pure-space-overflow nil
292 "Non-nil if building Emacs overflowed pure space.")
293
859e15c1 294(defun normal-top-level-add-subdirs-to-load-path ()
0412d833
RS
295 "Add all subdirectories of current directory to `load-path'.
296More precisely, this uses only the subdirectories whose names
f734a13e
DL
297start with letters or digits; it excludes any subdirectory named `RCS'
298or `CVS', and any subdirectory that contains a file named `.nosearch'."
f1180544 299 (let (dirs
95eada65 300 attrs
859e15c1
KH
301 (pending (list default-directory)))
302 ;; This loop does a breadth-first tree walk on DIR's subtree,
303 ;; putting each subdir into DIRS as its contents are examined.
304 (while pending
4e0a3971 305 (push (pop pending) dirs)
722a451d
EZ
306 (let* ((this-dir (car dirs))
307 (contents (directory-files this-dir))
308 (default-directory this-dir)
fcaf7de9
SM
309 (canonicalized (if (fboundp 'untranslated-canonical-name)
310 (untranslated-canonical-name this-dir))))
722a451d
EZ
311 ;; The Windows version doesn't report meaningful inode
312 ;; numbers, so use the canonicalized absolute file name of the
313 ;; directory instead.
314 (setq attrs (or canonicalized
315 (nthcdr 10 (file-attributes this-dir))))
95eada65 316 (unless (member attrs normal-top-level-add-subdirs-inode-list)
4e0a3971
SM
317 (push attrs normal-top-level-add-subdirs-inode-list)
318 (dolist (file contents)
c4a40544 319 ;; The lower-case variants of RCS and CVS are for DOS/Windows.
4e0a3971
SM
320 (unless (member file '("." ".." "RCS" "CVS" "rcs" "cvs"))
321 (when (and (string-match "\\`[[:alnum:]]" file)
9d1fb179
RS
322 ;; Avoid doing a `stat' when it isn't necessary
323 ;; because that can cause trouble when an NFS server
324 ;; is down.
4e0a3971
SM
325 (not (string-match "\\.elc?\\'" file))
326 (file-directory-p file))
327 (let ((expanded (expand-file-name file)))
95eada65
RS
328 (unless (file-exists-p (expand-file-name ".nosearch"
329 expanded))
4e0a3971 330 (setq pending (nconc pending (list expanded)))))))))))
bb15e81a 331 (normal-top-level-add-to-load-path (cdr (nreverse dirs)))))
859e15c1 332
537b6e4e
RS
333;; This function is called from a subdirs.el file.
334;; It assumes that default-directory is the directory
335;; in which the subdirs.el file exists,
336;; and it adds to load-path the subdirs of that directory
337;; as specified in DIRS. Normally the elements of DIRS are relative.
e87a7309 338(defun normal-top-level-add-to-load-path (dirs)
cd1c10f6
RS
339 (let ((tail load-path)
340 (thisdir (directory-file-name default-directory)))
341 (while (and tail
138e541f
GM
342 ;;Don't go all the way to the nil terminator.
343 (cdr tail)
cd1c10f6
RS
344 (not (equal thisdir (car tail)))
345 (not (and (memq system-type '(ms-dos windows-nt))
346 (equal (downcase thisdir) (downcase (car tail))))))
347 (setq tail (cdr tail)))
138e541f
GM
348 ;;Splice the new section in.
349 (when tail
350 (setcdr tail (append (mapcar 'expand-file-name dirs) (cdr tail))))))
e87a7309 351
a726e0d1
JB
352(defun normal-top-level ()
353 (if command-line-processed
354 (message "Back to top level.")
355 (setq command-line-processed t)
8d4c2221
RS
356 ;; Give *Messages* the same default-directory as *scratch*,
357 ;; just to keep things predictable.
358 (let ((dir default-directory))
fcaf7de9 359 (with-current-buffer "*Messages*"
8d4c2221 360 (setq default-directory dir)))
9715399e
MR
361 ;; `user-full-name' is now known; reset its standard-value here.
362 (put 'user-full-name 'standard-value
363 (list (default-value 'user-full-name)))
80d71556
KH
364 ;; For root, preserve owner and group when editing files.
365 (if (equal (user-uid) 0)
366 (setq backup-by-copying-when-mismatch t))
e87a7309
RS
367 ;; Look in each dir in load-path for a subdirs.el file.
368 ;; If we find one, load it, which will add the appropriate subdirs
369 ;; of that dir into load-path,
357438eb
KH
370 ;; Look for a leim-list.el file too. Loading it will register
371 ;; available input methods.
b6666b5f
SM
372 (let ((tail load-path) dir)
373 (while tail
374 (setq dir (car tail))
375 (let ((default-directory dir))
376 (load (expand-file-name "subdirs.el") t t t))
377 (let ((default-directory dir))
378 (load (expand-file-name "leim-list.el") t t t))
379 ;; We don't use a dolist loop and we put this "setq-cdr" command at
380 ;; the end, because the subdirs.el files may add elements to the end
381 ;; of load-path and we want to take it into account.
382 (setq tail (cdr tail))))
fcaf7de9
SM
383 (unless (eq system-type 'vax-vms)
384 ;; If the PWD environment variable isn't accurate, delete it.
385 (let ((pwd (getenv "PWD")))
386 (and (stringp pwd)
387 ;; Use FOO/., so that if FOO is a symlink, file-attributes
388 ;; describes the directory linked to, not FOO itself.
389 (or (equal (file-attributes
390 (concat (file-name-as-directory pwd) "."))
391 (file-attributes
392 (concat (file-name-as-directory default-directory)
393 ".")))
394 (setq process-environment
395 (delete (concat "PWD=" pwd)
396 process-environment))))))
492878e4 397 (setq default-directory (abbreviate-file-name default-directory))
6f2c86fa
KH
398 (let ((menubar-bindings-done nil))
399 (unwind-protect
400 (command-line)
401 ;; Do this again, in case .emacs defined more abbreviations.
402 (setq default-directory (abbreviate-file-name default-directory))
b3c7c12c
RS
403 ;; Specify the file for recording all the auto save files of this session.
404 ;; This is used by recover-session.
cdee38c3
KH
405 (or auto-save-list-file-name
406 (and auto-save-list-file-prefix
407 (setq auto-save-list-file-name
1f7f78f1
RS
408 ;; Under MS-DOS our PID is almost always reused between
409 ;; Emacs invocations. We need something more unique.
4b33deaa
EZ
410 (cond ((eq system-type 'ms-dos)
411 ;; We are going to access the auto-save
412 ;; directory, so make sure it exists.
413 (make-directory
414 (file-name-directory auto-save-list-file-prefix)
415 t)
f1180544 416 (concat
4b33deaa
EZ
417 (make-temp-name
418 (expand-file-name
419 auto-save-list-file-prefix))
420 "~"))
421 (t
422 (expand-file-name
423 (format "%s%d-%s~"
424 auto-save-list-file-prefix
425 (emacs-pid)
426 (system-name))))))))
deebb0e9
RS
427 (unless inhibit-startup-hooks
428 (run-hooks 'emacs-startup-hook)
429 (and term-setup-hook
430 (run-hooks 'term-setup-hook)))
6a1e7d67
GM
431
432 ;; Don't do this if we failed to create the initial frame,
433 ;; for instance due to a dense colormap.
538ef02a
GM
434 (when (or frame-initial-frame
435 ;; If frame-initial-frame has no meaning, do this anyway.
436 (not (and window-system
437 (not noninteractive)
438 (not (eq window-system 'pc)))))
6a1e7d67
GM
439 ;; Modify the initial frame based on what .emacs puts into
440 ;; ...-frame-alist.
441 (if (fboundp 'frame-notice-user-settings)
442 (frame-notice-user-settings))
443 (if (fboundp 'frame-set-background-mode)
444 ;; Set the faces for the initial background mode even if
445 ;; frame-notice-user-settings didn't (such as on a tty).
446 ;; frame-set-background-mode is idempotent, so it won't
447 ;; cause any harm if it's already been done.
61b91ad1 448 (let ((frame (selected-frame))
6a1e7d67
GM
449 term)
450 (when (and (null window-system)
61b91ad1
JL
451 ;; Don't override default set by files in lisp/term.
452 (null default-frame-background-mode)
6a1e7d67
GM
453 (let ((bg (frame-parameter frame 'background-color)))
454 (or (null bg)
61b91ad1
JL
455 (member bg '(unspecified "unspecified-bg"
456 "unspecified-fg")))))
457
6a1e7d67 458 (setq term (getenv "TERM"))
818cd248
EZ
459 ;; Some files in lisp/term do a better job with the
460 ;; background mode, but we leave this here anyway, in
461 ;; case they remove those files.
6a1e7d67
GM
462 (if (string-match "^\\(xterm\\|rxvt\\|dtterm\\|eterm\\)"
463 term)
61b91ad1 464 (setq default-frame-background-mode 'light)))
6a1e7d67 465 (frame-set-background-mode (selected-frame)))))
13ab33c4 466
6f2c86fa
KH
467 ;; Now we know the user's default font, so add it to the menu.
468 (if (fboundp 'font-menu-add-default)
469 (font-menu-add-default))
470 (and window-setup-hook
471 (run-hooks 'window-setup-hook))
472 (or menubar-bindings-done
66c24e1e
EZ
473 (if (display-popup-menus-p)
474 (precompute-menubar-bindings)))))))
6f2c86fa
KH
475
476;; Precompute the keyboard equivalents in the menu bar items.
477(defun precompute-menubar-bindings ()
365636dc
RS
478 (let ((submap (lookup-key global-map [menu-bar])))
479 (while submap
480 (and (consp (car submap))
481 (symbolp (car (car submap)))
482 (stringp (car-safe (cdr (car submap))))
483 (keymapp (cdr (cdr (car submap))))
a18042d7
RS
484 (progn
485 (x-popup-menu nil (cdr (cdr (car submap))))
486 (if purify-flag
487 (garbage-collect))))
365636dc 488 (setq submap (cdr submap))))
5b61c6a7 489 (setq define-key-rebound-commands t))
a726e0d1 490
c381f482
EZ
491;; Command-line options supported by tty's:
492(defconst tty-long-option-alist
8957d2bf
EZ
493 '(("--name" . "-name")
494 ("--title" . "-T")
495 ("--reverse-video" . "-reverse")
c381f482 496 ("--foreground-color" . "-fg")
8957d2bf
EZ
497 ("--background-color" . "-bg")
498 ("--color" . "-color")))
c381f482 499
b66b6aeb
GM
500(defconst tool-bar-images-pixel-height 24
501 "Height in pixels of images in the tool bar.")
502
3a55d3d0
JR
503(defvar tool-bar-originally-present nil
504 "Non-nil if tool-bars are present before user and site init files are read.")
505
bca8c7be 506;; Handle the X-like command-line arguments "-fg", "-bg", "-name", etc.
c381f482 507(defun tty-handle-args (args)
bca8c7be 508 (let (rest)
c381f482
EZ
509 (message "%s" args)
510 (while (and args
511 (not (equal (car args) "--")))
bca8c7be
MS
512 (let* ((argi (pop args))
513 (orig-argi argi)
514 argval completion)
c381f482
EZ
515 ;; Check for long options with attached arguments
516 ;; and separate out the attached option argument into argval.
bca8c7be
MS
517 (when (string-match "^\\(--[^=]*\\)=" argi)
518 (setq argval (substring argi (match-end 0))
519 argi (match-string 1 argi)))
520 (when (string-match "^--" argi)
521 (setq completion (try-completion argi tty-long-option-alist))
c381f482
EZ
522 (if (eq completion t)
523 ;; Exact match for long option.
bca8c7be 524 (setq argi (cdr (assoc argi tty-long-option-alist)))
c381f482
EZ
525 (if (stringp completion)
526 (let ((elt (assoc completion tty-long-option-alist)))
527 ;; Check for abbreviated long option.
528 (or elt
bca8c7be
MS
529 (error "Option `%s' is ambiguous" argi))
530 (setq argi (cdr elt)))
c381f482 531 ;; Check for a short option.
bca8c7be
MS
532 (setq argval nil
533 argi orig-argi))))
534 (cond ((member argi '("-fg" "-foreground"))
535 (push (cons 'foreground-color (or argval (pop args)))
536 default-frame-alist))
537 ((member argi '("-bg" "-background"))
538 (push (cons 'background-color (or argval (pop args)))
539 default-frame-alist))
540 ((member argi '("-T" "-name"))
541 (unless argval (setq argval (pop args)))
542 (push (cons 'title
543 (if (stringp argval)
544 argval
545 (let ((case-fold-search t)
546 i)
547 (setq argval (invocation-name))
548
549 ;; Change any . or * characters in name to
550 ;; hyphens, so as to emulate behavior on X.
551 (while
552 (setq i (string-match "[.*]" argval))
553 (aset argval i ?-))
554 argval)))
555 default-frame-alist))
556 ((member argi '("-r" "-rv" "-reverse"))
557 (push '(reverse . t)
558 default-frame-alist))
559 ((equal argi "-color")
560 (unless argval (setq argval 8)) ; default --color means 8 ANSI colors
561 (push (cons 'tty-color-mode
562 (cond
563 ((numberp argval) argval)
564 ((string-match "-?[0-9]+" argval)
565 (string-to-number argval))
566 (t (intern argval))))
567 default-frame-alist))
568 (t
569 (push argi rest)))))
570 (nreverse rest)))
c381f482 571
a726e0d1 572(defun command-line ()
09a1077c
RS
573 (setq command-line-default-directory default-directory)
574
849eedba 575 ;; Choose a reasonable location for temporary files.
a3194d03 576 (custom-reevaluate-setting 'temporary-file-directory)
51db08eb 577 (custom-reevaluate-setting 'small-temporary-file-directory)
a3194d03 578 (custom-reevaluate-setting 'auto-save-file-name-transforms)
849eedba 579
74f2ab06 580 ;; See if we should import version-control from the environment variable.
a726e0d1
JB
581 (let ((vc (getenv "VERSION_CONTROL")))
582 (cond ((eq vc nil)) ;don't do anything if not set
bca8c7be 583 ((member vc '("t" "numbered"))
a726e0d1 584 (setq version-control t))
bca8c7be 585 ((member vc '("nil" "existing"))
a726e0d1 586 (setq version-control nil))
bca8c7be 587 ((member vc '("never" "simple"))
a726e0d1
JB
588 (setq version-control 'never))))
589
79058860
JB
590 ;;! This has been commented out; I currently find the behavior when
591 ;;! split-window-keep-point is nil disturbing, but if I can get used
592 ;;! to it, then it would be better to eliminate the option.
593 ;;! ;; Choose a good default value for split-window-keep-point.
594 ;;! (setq split-window-keep-point (> baud-rate 2400))
f35fe3c6 595
d4308a4d
EZ
596 ;; Set the default strings to display in mode line for
597 ;; end-of-line formats that aren't native to this platform.
598 (cond
599 ((memq system-type '(ms-dos windows-nt emx))
bca8c7be
MS
600 (setq eol-mnemonic-unix "(Unix)"
601 eol-mnemonic-mac "(Mac)"))
bde61f8b
EZ
602 ;; Both Mac and Unix EOLs are now "native" on Mac OS so keep the
603 ;; abbreviated strings `/' and `:' set in coding.c for them.
604 ((eq system-type 'macos)
605 (setq eol-mnemonic-dos "(DOS)"))
bca8c7be
MS
606 (t ; this is for Unix/GNU/Linux systems
607 (setq eol-mnemonic-dos "(DOS)"
608 eol-mnemonic-mac "(Mac)")))
d4308a4d 609
a726e0d1 610 ;; Read window system's init file if using a window system.
1ed14cfd
RS
611 (condition-case error
612 (if (and window-system (not noninteractive))
613 (load (concat term-file-prefix
614 (symbol-name window-system)
615 "-win")
616 ;; Every window system should have a startup file;
617 ;; barf if we can't find it.
618 nil t))
619 ;; If we can't read it, print the error message and exit.
620 (error
2677ad61
RS
621 (princ
622 (if (eq (car error) 'error)
623 (apply 'concat (cdr error))
624 (if (memq 'file-error (get (car error) 'error-conditions))
625 (format "%s: %s"
bca8c7be
MS
626 (nth 1 error)
627 (mapconcat (lambda (obj) (prin1-to-string obj t))
628 (cdr (cdr error)) ", "))
2677ad61 629 (format "%s: %s"
bca8c7be
MS
630 (get (car error) 'error-message)
631 (mapconcat (lambda (obj) (prin1-to-string obj t))
632 (cdr error) ", "))))
2677ad61 633 'external-debugging-output)
27f5188c 634 (terpri 'external-debugging-output)
2677ad61 635 (setq window-system nil)
1ed14cfd 636 (kill-emacs)))
a726e0d1 637
c381f482 638 ;; Windowed displays do this inside their *-win.el.
bca8c7be 639 (unless (or (display-graphic-p) noninteractive)
c381f482
EZ
640 (setq command-line-args (tty-handle-args command-line-args)))
641
640a9cdd
JR
642 (set-locale-environment nil)
643
c16eb7b0
RS
644 ;; Convert the arguments to Emacs internal representation.
645 (let ((args (cdr command-line-args)))
646 (while args
647 (setcar args
648 (decode-coding-string (car args) locale-coding-system t))
bca8c7be 649 (pop args)))
c16eb7b0 650
03e3c30a
JB
651 (let ((done nil)
652 (args (cdr command-line-args)))
653
a726e0d1
JB
654 ;; Figure out which user's init file to load,
655 ;; either from the environment or from the options.
656 (setq init-file-user (if noninteractive nil (user-login-name)))
657 ;; If user has not done su, use current $HOME to find .emacs.
bca8c7be
MS
658 (and init-file-user
659 (equal init-file-user (user-real-login-name))
a726e0d1 660 (setq init-file-user ""))
03e3c30a
JB
661
662 ;; Process the command-line args, and delete the arguments
663 ;; processed. This is consistent with the way main in emacs.c
664 ;; does things.
a726e0d1 665 (while (and (not done) args)
9ab281f0
JB
666 (let* ((longopts '(("--no-init-file") ("--no-site-file") ("--debug-init")
667 ("--user") ("--iconic") ("--icon-type") ("--quick")
668 ("--no-blinking-cursor") ("--basic-display")))
bca8c7be
MS
669 (argi (pop args))
670 (orig-argi argi)
671 argval)
452e9090 672 ;; Handle --OPTION=VALUE format.
bca8c7be 673 (when (string-match "^\\(--[^=]*\\)=" argi)
1b207153 674 (setq argval (substring argi (match-end 0))
bca8c7be 675 argi (match-string 1 argi)))
1b207153
CW
676 (unless (equal argi "--")
677 (let ((completion (try-completion argi longopts)))
678 (if (eq completion t)
679 (setq argi (substring argi 1))
680 (if (stringp completion)
681 (let ((elt (assoc completion longopts)))
682 (or elt
683 (error "Option `%s' is ambiguous" argi))
684 (setq argi (substring (car elt) 1)))
bca8c7be
MS
685 (setq argval nil
686 argi orig-argi)))))
a726e0d1 687 (cond
dc58296d 688 ((member argi '("-Q" "-quick"))
e2c60824
KS
689 (setq init-file-user nil
690 site-run-file nil
dc58296d
RS
691 emacs-quick-startup t))
692 ((member argi '("-D" "-basic-display"))
693 (setq no-blinking-cursor t
694 emacs-basic-display t)
e2c60824 695 (push '(vertical-scroll-bars . nil) initial-frame-alist))
4e0a3971
SM
696 ((member argi '("-q" "-no-init-file"))
697 (setq init-file-user nil))
698 ((member argi '("-u" "-user"))
bca8c7be 699 (setq init-file-user (or argval (pop args))
4e0a3971 700 argval nil))
bca8c7be 701 ((equal argi "-no-site-file")
4e0a3971 702 (setq site-run-file nil))
bca8c7be 703 ((equal argi "-debug-init")
4e0a3971 704 (setq init-file-debug t))
bca8c7be 705 ((equal argi "-iconic")
4e0a3971 706 (push '(visibility . icon) initial-frame-alist))
bca8c7be 707 ((member argi '("-icon-type" "-i" "-itype"))
4e0a3971 708 (push '(icon-type . t) default-frame-alist))
178b4542
JL
709 ((member argi '("-nbc" "-no-blinking-cursor"))
710 (setq no-blinking-cursor t))
4e0a3971 711 ;; Push the popped arg back on the list of arguments.
bca8c7be
MS
712 (t
713 (push argi args)
714 (setq done t)))
096b7031
KH
715 ;; Was argval set but not used?
716 (and argval
717 (error "Option `%s' doesn't allow an argument" argi))))
718
03e3c30a 719 ;; Re-attach the program name to the front of the arg list.
bca8c7be
MS
720 (and command-line-args
721 (setcdr command-line-args args)))
a726e0d1 722
ed0fb1f1 723 ;; Under X Window, this creates the X frame and deletes the terminal frame.
14f16b9c
GM
724 (when (fboundp 'frame-initialize)
725 (frame-initialize))
726
ed0fb1f1 727 ;; Turn off blinking cursor if so specified in X resources. This is here
b08cb5a6 728 ;; only because all other settings of no-blinking-cursor are here.
ed0fb1f1
JD
729 (unless (or noninteractive
730 emacs-basic-display
731 (and (memq window-system '(x w32 mac))
732 (not (member (x-get-resource "cursorBlink" "CursorBlink")
733 '("off" "false")))))
734 (setq no-blinking-cursor t))
735
1fe0333f 736 ;; If frame was created with a menu bar, set menu-bar-mode on.
bca8c7be 737 (unless (or noninteractive
dc58296d 738 emacs-basic-display
bca8c7be
MS
739 (and (memq window-system '(x w32))
740 (<= (frame-parameter nil 'menu-bar-lines) 0)))
8ab9589d 741 (menu-bar-mode 1))
c722566c 742
7d1eb6a4 743 ;; If frame was created with a tool bar, switch tool-bar-mode on.
bca8c7be 744 (unless (or noninteractive
dc58296d 745 emacs-basic-display
bca8c7be
MS
746 (not (display-graphic-p))
747 (<= (frame-parameter nil 'tool-bar-lines) 0))
b66b6aeb 748 (tool-bar-mode 1))
7d1eb6a4 749
3413f928 750 ;; Can't do this init in defcustom because the relevant variables
a3194d03
SM
751 ;; are not set.
752 (custom-reevaluate-setting 'blink-cursor-mode)
753 (custom-reevaluate-setting 'normal-erase-is-backspace)
dc86f0a9 754 (custom-reevaluate-setting 'tooltip-mode)
3b73087e 755
1592c1ef
EZ
756 ;; Register default TTY colors for the case the terminal hasn't a
757 ;; terminal init file.
bca8c7be
MS
758 (unless (memq window-system '(x w32))
759 ;; We do this regardles of whether the terminal supports colors
760 ;; or not, since they can switch that support on or off in
761 ;; mid-session by setting the tty-color-mode frame parameter.
762 (tty-register-default-colors))
1592c1ef 763
3a55d3d0
JR
764 ;; Record whether the tool-bar is present before the user and site
765 ;; init files are processed. frame-notice-user-settings uses this
766 ;; to determine if the tool-bar has been disabled by the init files,
767 ;; and the frame needs to be resized.
768 (when (fboundp 'frame-notice-user-settings)
769 (let ((tool-bar-lines (or (assq 'tool-bar-lines initial-frame-alist)
770 (assq 'tool-bar-lines default-frame-alist))))
771 (setq tool-bar-originally-present
bca8c7be
MS
772 (and tool-bar-lines
773 (cdr tool-bar-lines)
774 (not (eq 0 (cdr tool-bar-lines)))))))
3a55d3d0 775
752ef254
GM
776 (let ((old-scalable-fonts-allowed scalable-fonts-allowed)
777 (old-font-list-limit font-list-limit)
778 (old-face-ignored-fonts face-ignored-fonts))
779
780 (run-hooks 'before-init-hook)
781
782 ;; Run the site-start library if it exists. The point of this file is
783 ;; that it is run before .emacs. There is no point in doing this after
784 ;; .emacs; that is useless.
f1180544 785 (if site-run-file
752ef254
GM
786 (load site-run-file t t))
787
788 ;; Sites should not disable this. Only individuals should disable
789 ;; the startup message.
790 (setq inhibit-startup-message nil)
791
f963ea40
RS
792 ;; Warn for invalid user name.
793 (and init-file-user
794 (not (file-directory-p (expand-file-name (concat "~" init-file-user))))
795 (display-warning 'initialization
796 (format "User %s has no home directory"
797 init-file-user)
798 :error))
799
752ef254
GM
800 ;; Load that user's init file, or the default one, or none.
801 (let (debug-on-error-from-init-file
802 debug-on-error-should-be-set
803 (debug-on-error-initial
804 (if (eq init-file-debug t) 'startup init-file-debug))
805 (orig-enable-multibyte default-enable-multibyte-characters))
806 (let ((debug-on-error debug-on-error-initial)
807 ;; This function actually reads the init files.
808 (inner
809 (function
810 (lambda ()
811 (if init-file-user
812 (let ((user-init-file-1
4e0a3971 813 (cond
752ef254
GM
814 ((eq system-type 'ms-dos)
815 (concat "~" init-file-user "/_emacs"))
816 ((eq system-type 'windows-nt)
fe7ecaf2 817 ;; Prefer .emacs on Windows.
752ef254
GM
818 (if (directory-files "~" nil "^\\.emacs\\(\\.elc?\\)?$")
819 "~/.emacs"
fe7ecaf2
JR
820 ;; Also support _emacs for compatibility.
821 (if (directory-files "~" nil "^_emacs\\(\\.elc?\\)?$")
822 "~/_emacs"
823 ;; But default to .emacs if _emacs does not exist.
824 "~/.emacs")))
f1180544 825 ((eq system-type 'vax-vms)
752ef254 826 "sys$login:.emacs")
4e0a3971 827 (t
752ef254
GM
828 (concat "~" init-file-user "/.emacs")))))
829 ;; This tells `load' to store the file name found
830 ;; into user-init-file.
831 (setq user-init-file t)
832 (load user-init-file-1 t t)
f1180544 833
a04d5983
RS
834 (when (eq user-init-file t)
835 ;; If we did not find ~/.emacs, try
836 ;; ~/.emacs.d/.emacs.
837 (let ((otherfile
838 (expand-file-name
839 (file-name-nondirectory user-init-file-1)
840 (file-name-as-directory
841 (expand-file-name
842 ".emacs.d"
843 (file-name-directory user-init-file-1))))))
844 (load otherfile t t)
845
846 ;; If we did not find the user's init file,
847 ;; set user-init-file conclusively.
848 ;; Don't let it be set from default.el.
849 (when (eq user-init-file t)
850 (setq user-init-file user-init-file-1))))
f1180544 851
752ef254
GM
852 ;; If we loaded a compiled file, set
853 ;; `user-init-file' to the source version if that
854 ;; exists.
855 (when (and user-init-file
856 (equal (file-name-extension user-init-file)
857 "elc"))
858 (let* ((source (file-name-sans-extension user-init-file))
859 (alt (concat source ".el")))
860 (setq source (cond ((file-exists-p alt) alt)
861 ((file-exists-p source) source)
862 (t nil)))
863 (when source
864 (when (file-newer-than-file-p source user-init-file)
865 (message "Warning: %s is newer than %s"
866 source user-init-file)
867 (sit-for 1))
868 (setq user-init-file source))))
f1180544 869
bca8c7be
MS
870 (unless inhibit-default-init
871 (let ((inhibit-startup-message nil))
872 ;; Users are supposed to be told their rights.
873 ;; (Plus how to get help and how to undo.)
874 ;; Don't you dare turn this off for anyone
875 ;; except yourself.
876 (load "default" t t)))))))))
752ef254
GM
877 (if init-file-debug
878 ;; Do this without a condition-case if the user wants to debug.
879 (funcall inner)
880 (condition-case error
881 (progn
882 (funcall inner)
883 (setq init-file-had-error nil))
884 (error
885 (let ((message-log-max nil))
886 (save-excursion
887 (set-buffer (get-buffer-create "*Messages*"))
888 (insert "\n\n"
889 (format "An error has occurred while loading `%s':\n\n"
890 user-init-file)
891 (format "%s%s%s"
892 (get (car error) 'error-message)
893 (if (cdr error) ": " "")
f5b6cffd 894 (mapconcat (lambda (s) (prin1-to-string s t)) (cdr error) ", "))
752ef254 895 "\n\n"
f5b6cffd
KS
896 "To ensure normal operation, you should investigate and remove the\n"
897 "cause of the error in your initialization file. Start Emacs with\n"
898 "the `--debug-init' option to view a complete error backtrace.\n\n"))
752ef254
GM
899 (message "Error in init file: %s%s%s"
900 (get (car error) 'error-message)
901 (if (cdr error) ": " "")
902 (mapconcat 'prin1-to-string (cdr error) ", "))
f5b6cffd
KS
903 (let ((pop-up-windows nil))
904 (pop-to-buffer "*Messages*"))
752ef254 905 (setq init-file-had-error t)))))
ac3186fd
RS
906
907 ;; If the user has a file of abbrevs, read it.
908 (if (file-exists-p abbrev-file-name)
909 (quietly-read-abbrev-file abbrev-file-name))
910
70b199c3
RS
911 ;; If the abbrevs came entirely from the init file or the
912 ;; abbrevs file, they do not need saving.
913 (setq abbrevs-changed nil)
914
752ef254
GM
915 ;; If we can tell that the init file altered debug-on-error,
916 ;; arrange to preserve the value that it set up.
917 (or (eq debug-on-error debug-on-error-initial)
918 (setq debug-on-error-should-be-set t
919 debug-on-error-from-init-file debug-on-error)))
920 (if debug-on-error-should-be-set
921 (setq debug-on-error debug-on-error-from-init-file))
922 (unless (or default-enable-multibyte-characters
923 (eq orig-enable-multibyte default-enable-multibyte-characters))
924 ;; Init file changed to unibyte. Reset existing multibyte
925 ;; buffers (probably *scratch*, *Messages*, *Minibuff-0*).
926 ;; Arguably this should only be done if they're free of
927 ;; multibyte characters.
928 (mapcar (lambda (buffer)
929 (with-current-buffer buffer
930 (if enable-multibyte-characters
931 (set-buffer-multibyte nil))))
932 (buffer-list))
933 ;; Also re-set the language environment in case it was
934 ;; originally done before unibyte was set and is sensitive to
935 ;; unibyte (display table, terminal coding system &c).
936 (set-language-environment current-language-environment)))
f1180544 937
752ef254 938 ;; Do this here in case the init file sets mail-host-address.
5b88a2c5 939 (if (equal user-mail-address "")
752ef254
GM
940 (setq user-mail-address (concat (user-login-name) "@"
941 (or mail-host-address
942 (system-name)))))
943
944 ;; If parameter have been changed in the init file which influence
945 ;; face realization, clear the face cache so that new faces will
946 ;; be realized.
947 (unless (and (eq scalable-fonts-allowed old-scalable-fonts-allowed)
948 (eq font-list-limit old-font-list-limit)
949 (eq face-ignored-fonts old-face-ignored-fonts))
950 (clear-face-cache)))
f1180544 951
e3bd99f5
RM
952 (run-hooks 'after-init-hook)
953
1fc67c11 954 ;; Decode all default-directory.
cea927ed
KH
955 (if (and default-enable-multibyte-characters locale-coding-system)
956 (save-excursion
957 (dolist (elt (buffer-list))
958 (set-buffer elt)
959 (if default-directory
960 (setq default-directory
961 (decode-coding-string default-directory
962 locale-coding-system t))))
963 (setq command-line-default-directory
964 (decode-coding-string command-line-default-directory
965 locale-coding-system t))))
966
a726e0d1
JB
967 ;; If *scratch* exists and init file didn't change its mode, initialize it.
968 (if (get-buffer "*scratch*")
694210c4 969 (with-current-buffer "*scratch*"
a726e0d1
JB
970 (if (eq major-mode 'fundamental-mode)
971 (funcall initial-major-mode))))
f1180544 972
a726e0d1
JB
973 ;; Load library for our terminal type.
974 ;; User init file can set term-file-prefix to nil to prevent this.
bca8c7be
MS
975 (unless (or noninteractive
976 window-system
977 (null term-file-prefix))
c7dc8ae1
SM
978 (let* ((TERM (getenv "TERM"))
979 (term TERM)
bca8c7be
MS
980 hyphend)
981 (while (and term
982 (not (load (concat term-file-prefix term) t t)))
983 ;; Strip off last hyphen and what follows, then try again
984 (setq term
c7dc8ae1 985 (if (setq hyphend (string-match "[-_][^-_]+\\'" term))
bca8c7be 986 (substring term 0 hyphend)
4f0c9ba7 987 nil)))
c7dc8ae1
SM
988 (setq term TERM)
989 ;; The terminal file has been loaded, now call the terminal specific
990 ;; initialization function.
991 (while term
992 (let ((term-init-func (intern-soft (concat "terminal-init-" term))))
993 (if (not (fboundp term-init-func))
994 ;; Strip off last hyphen and what follows, then try again
995 (setq term
996 (if (setq hyphend (string-match "[-_][^-_]+\\'" term))
997 (substring term 0 hyphend)
998 nil))
999 (setq term nil)
4f0c9ba7 1000 (funcall term-init-func))))))
a726e0d1 1001
5777a167
RS
1002 ;; Update the out-of-memory error message based on user's key bindings
1003 ;; for save-some-buffers.
1004 (setq memory-signal-data
1005 (list 'error
1006 (substitute-command-keys "Memory exhausted--use \\[save-some-buffers] then exit and restart Emacs")))
1007
03e3c30a 1008 ;; Process the remaining args.
a726e0d1
JB
1009 (command-line-1 (cdr command-line-args))
1010
1011 ;; If -batch, terminate after processing the command options.
ca57f55d
JD
1012 (if noninteractive (kill-emacs t))
1013
1014 ;; Run emacs-session-restore (session management) if started by
1015 ;; the session manager and we have a session manager connection.
bca8c7be
MS
1016 (if (and (boundp 'x-session-previous-id)
1017 (stringp x-session-previous-id))
a99df87d
RS
1018 (with-no-warnings
1019 (emacs-session-restore x-session-previous-id))))
a726e0d1 1020
46cfd295 1021(defcustom initial-scratch-message (purecopy "\
3b79c219
GM
1022;; This buffer is for notes you don't want to save, and for Lisp evaluation.
1023;; If you want to create a file, visit that file with C-x C-f,
1024;; then enter the text in that file's own buffer.
9fe3219e 1025
46cfd295 1026")
9fe3219e
RS
1027 "Initial message displayed in *scratch* buffer at startup.
1028If this is nil, no message will be displayed."
fa071a47
RS
1029 :type '(choice (text :tag "Message")
1030 (const :tag "none" nil))
1031 :group 'initialization)
9fe3219e 1032
ce9ded5d
GM
1033\f
1034;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1035;;; Fancy splash screen
1036;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1037
1038(defvar fancy-splash-text
26ff68aa 1039 '((:face variable-pitch
926aa0ee 1040 "You can do basic editing with the menu bar and scroll bar \
926aa0ee 1041using the mouse.\n\n"
26ff68aa 1042 :face (variable-pitch :weight bold)
ce9ded5d 1043 "Important Help menu items:\n"
959f1226
TTN
1044 :face variable-pitch
1045 (lambda ()
1046 (let* ((en "TUTORIAL")
1047 (tut (or (get-language-info current-language-environment
1048 'tutorial)
1049 en))
1050 (title (with-temp-buffer
1051 (insert-file-contents
1052 (expand-file-name tut data-directory)
1053 nil 0 256)
1054 (search-forward ".")
1055 (buffer-substring (point-min) (1- (point))))))
1056 ;; If there is a specific tutorial for the current language
1057 ;; environment and it is not English, append its title.
1058 (concat
1059 "Emacs Tutorial\tLearn how to use Emacs efficiently"
1060 (if (string= en tut)
1061 ""
1062 (concat " (" title ")"))
1063 "\n")))
1064 :face variable-pitch "\
1fc02b3c 1065Emacs FAQ\tFrequently asked questions and answers
5777a167 1066Read the Emacs Manual\tView the Emacs manual using Info
1fc02b3c 1067\(Non)Warranty\tGNU Emacs comes with "
26ff68aa 1068 :face (variable-pitch :slant oblique)
ce9ded5d 1069 "ABSOLUTELY NO WARRANTY\n"
26ff68aa 1070 :face variable-pitch
d3c5bad2 1071 "\
d7618b60 1072Copying Conditions\tConditions for redistributing and changing Emacs
9ab281f0 1073Getting New Versions\tHow to obtain the latest version of Emacs
682b60ae 1074More Manuals / Ordering Manuals Buying printed manuals from the FSF\n")
d7618b60
GM
1075 (:face variable-pitch
1076 "You can do basic editing with the menu bar and scroll bar \
1077using the mouse.\n\n"
1078 :face (variable-pitch :weight bold)
1079 "Useful File menu items:\n"
1080 :face variable-pitch "\
1081Exit Emacs\t(Or type Control-x followed by Control-c)
dc58296d 1082Recover Crashed Session\tRecover files you were editing before a crash
d7618b60
GM
1083
1084
1085
3f334882 1086
d7618b60
GM
1087"
1088 ))
ce9ded5d
GM
1089 "A list of texts to show in the middle part of splash screens.
1090Each element in the list should be a list of strings or pairs
1091`:face FACE', like `fancy-splash-insert' accepts them.")
1092
1093
fb275c02 1094(defgroup fancy-splash-screen ()
a01bb1db 1095 "Fancy splash screen when Emacs starts."
fb275c02 1096 :version "21.1"
a01bb1db
GM
1097 :group 'initialization)
1098
1099
1ef0ffc6 1100(defcustom fancy-splash-delay 7
49939379 1101 "*Delay in seconds between splash screens."
a01bb1db 1102 :group 'fancy-splash-screen
ce9ded5d
GM
1103 :type 'integer)
1104
1105
1ef0ffc6 1106(defcustom fancy-splash-max-time 30
e9da51a1 1107 "*Show splash screens for at most this number of seconds.
1ef0ffc6 1108Values less than twice `fancy-splash-delay' are ignored."
e9da51a1
GM
1109 :group 'fancy-splash-screen
1110 :type 'integer)
1111
1112
8ad8561b
GM
1113(defcustom fancy-splash-image nil
1114 "*The image to show in the splash screens, or nil for defaults."
a01bb1db 1115 :group 'fancy-splash-screen
8ad8561b
GM
1116 :type '(choice (const :tag "Default" nil)
1117 (file :tag "File")))
ce9ded5d
GM
1118
1119
f645586f
GM
1120;; These are temporary storage areas for the splash screen display.
1121
1122(defvar fancy-current-text nil)
1123(defvar fancy-splash-help-echo nil)
e9da51a1 1124(defvar fancy-splash-stop-time nil)
eae91b60 1125(defvar fancy-splash-outer-buffer nil)
f645586f 1126
ce9ded5d
GM
1127(defun fancy-splash-insert (&rest args)
1128 "Insert text into the current buffer, with faces.
959f1226
TTN
1129Arguments from ARGS should be either strings, functions called
1130with no args that return a string, or pairs `:face FACE',
ce9ded5d 1131where FACE is a valid face specification, as it can be used with
a8a64bf4 1132`put-text-property'."
ce9ded5d
GM
1133 (let ((current-face nil))
1134 (while args
1135 (if (eq (car args) :face)
1136 (setq args (cdr args) current-face (car args))
959f1226
TTN
1137 (insert (propertize (let ((it (car args)))
1138 (if (functionp it)
1139 (funcall it)
1140 it))
f645586f
GM
1141 'face current-face
1142 'help-echo fancy-splash-help-echo)))
ce9ded5d
GM
1143 (setq args (cdr args)))))
1144
1145
1146(defun fancy-splash-head ()
1147 "Insert the head part of the splash screen into the current buffer."
51e8cfdd
GM
1148 (let* ((image-file (cond ((stringp fancy-splash-image)
1149 fancy-splash-image)
1150 ((and (display-color-p)
1151 (image-type-available-p 'xpm))
1152 (if (and (fboundp 'x-display-planes)
1153 (= (funcall 'x-display-planes) 8))
1154 "splash8.xpm"
1155 "splash.xpm"))
1156 (t "splash.pbm")))
1157 (img (create-image image-file))
ce9ded5d
GM
1158 (image-width (and img (car (image-size img))))
1159 (window-width (window-width (selected-window))))
1160 (when img
1161 (when (> window-width image-width)
f645586f 1162 ;; Center the image in the window.
e2c60824
KS
1163 (insert (propertize " " 'display
1164 `(space :align-to (+ center (-0.5 . ,img)))))
f645586f 1165
e7f3afa9
MB
1166 ;; Change the color of the XPM version of the splash image
1167 ;; so that it is visible with a dark frame background.
1168 (when (and (memq 'xpm img)
1169 (eq (frame-parameter nil 'background-mode) 'dark))
1170 (setq img (append img '(:color-symbols (("#000000" . "gray30"))))))
1171
f645586f
GM
1172 ;; Insert the image with a help-echo and a keymap.
1173 (let ((map (make-sparse-keymap))
a622451f 1174 (help-echo "mouse-2: browse http://www.gnu.org/"))
f645586f
GM
1175 (define-key map [mouse-2]
1176 (lambda ()
1177 (interactive)
a622451f 1178 (browse-url "http://www.gnu.org/")
f645586f
GM
1179 (throw 'exit nil)))
1180 (define-key map [down-mouse-2] 'ignore)
1181 (define-key map [up-mouse-2] 'ignore)
1182 (insert-image img (propertize "xxx" 'help-echo help-echo
1183 'keymap map)))
ce9ded5d 1184 (insert "\n"))))
9d5cf87c
RS
1185 (fancy-splash-insert
1186 :face '(variable-pitch :foreground "red")
1187 (if (eq system-type 'gnu/linux)
1188 "GNU Emacs is one component of the GNU/Linux operating system."
b831c087 1189 "GNU Emacs is one component of the GNU operating system."))
eae91b60
RS
1190 (insert "\n")
1191 (unless (equal (buffer-name fancy-splash-outer-buffer) "*scratch*")
1192 (fancy-splash-insert :face 'variable-pitch
1193 (substitute-command-keys
1194 "Type \\[recenter] to begin editing your file.\n"))))
ce9ded5d
GM
1195
1196
1197(defun fancy-splash-tail ()
1198 "Insert the tail part of the splash screen into the current buffer."
95fadcca
GM
1199 (let ((fg (if (eq (frame-parameter nil 'background-mode) 'dark)
1200 "cyan" "darkblue")))
1201 (fancy-splash-insert :face `(variable-pitch :foreground ,fg)
1202 "\nThis is "
1203 (emacs-version)
1204 "\n"
1205 :face '(variable-pitch :height 0.5)
dc58296d 1206 "Copyright (C) 2005 Free Software Foundation, Inc.")
ed638cc9
RS
1207 (and auto-save-list-file-prefix
1208 ;; Don't signal an error if the
1209 ;; directory for auto-save-list files
1210 ;; does not yet exist.
1211 (file-directory-p (file-name-directory
1212 auto-save-list-file-prefix))
1213 (directory-files
1214 (file-name-directory auto-save-list-file-prefix)
1215 nil
1216 (concat "\\`"
1217 (regexp-quote (file-name-nondirectory
1218 auto-save-list-file-prefix)))
1219 t)
1220 (fancy-splash-insert :face '(variable-pitch :foreground "red")
1221 "\n\nIf an Emacs session crashed recently, "
1222 "type M-x recover-session RET\nto recover"
1223 " the files you were editing."))))
ce9ded5d 1224
f645586f
GM
1225(defun fancy-splash-screens-1 (buffer)
1226 "Timer function displaying a splash screen."
e9da51a1
GM
1227 (when (> (float-time) fancy-splash-stop-time)
1228 (throw 'stop-splashing nil))
f645586f
GM
1229 (unless fancy-current-text
1230 (setq fancy-current-text fancy-splash-text))
1231 (let ((text (car fancy-current-text)))
1232 (set-buffer buffer)
1233 (erase-buffer)
b693e375
RS
1234 (if pure-space-overflow
1235 (insert "Warning Warning Pure space overflow Warning Warning\n"))
f645586f
GM
1236 (fancy-splash-head)
1237 (apply #'fancy-splash-insert text)
1238 (fancy-splash-tail)
1239 (unless (current-message)
1240 (message fancy-splash-help-echo))
1241 (set-buffer-modified-p nil)
dbeb499b 1242 (goto-char (point-min))
f645586f
GM
1243 (force-mode-line-update)
1244 (setq fancy-current-text (cdr fancy-current-text))))
1245
1246
1247(defun fancy-splash-default-action ()
732950b1
JB
1248 "Stop displaying the splash screen buffer.
1249This is an internal function used to turn off the splash screen after
1250the user caused an input event by hitting a key or clicking with the
1251mouse."
f645586f 1252 (interactive)
d54f452e
KS
1253 (if (and (consp last-command-event)
1254 (eq (posn-window (event-start last-command-event))
1255 (selected-window)))
1256 ;; This is a mouse-down event in the spash screen window.
1257 ;; Ignore it and consume the corresponding mouse-up event.
1258 (read-event)
1259 (push last-command-event unread-command-events))
f645586f
GM
1260 (throw 'exit nil))
1261
1262
ce9ded5d 1263(defun fancy-splash-screens ()
f645586f 1264 "Display fancy splash screens when Emacs starts."
5b61c6a7 1265 (setq fancy-splash-help-echo (startup-echo-area-message))
848c7757 1266 (let ((old-hourglass display-hourglass)
eae91b60
RS
1267 (fancy-splash-outer-buffer (current-buffer))
1268 splash-buffer
ff4ec1f7 1269 (old-minor-mode-map-alist minor-mode-map-alist)
6b20fb8e 1270 (frame (fancy-splash-frame))
5b61c6a7 1271 timer)
6b20fb8e
RS
1272 (save-selected-window
1273 (select-frame frame)
1274 (switch-to-buffer "GNU Emacs")
1275 (setq tab-width 20)
1276 (setq splash-buffer (current-buffer))
1277 (catch 'stop-splashing
1278 (unwind-protect
1279 (let ((map (make-sparse-keymap)))
1280 (use-local-map map)
1281 (define-key map [switch-frame] 'ignore)
1282 (define-key map [t] 'fancy-splash-default-action)
1283 (define-key map [mouse-movement] 'ignore)
1284 (define-key map [mode-line t] 'ignore)
1285 (setq cursor-type nil
1286 display-hourglass nil
1287 minor-mode-map-alist nil
1288 buffer-undo-list t
f1180544 1289 mode-line-format (propertize "---- %b %-"
6b20fb8e
RS
1290 'face '(:weight bold))
1291 fancy-splash-stop-time (+ (float-time)
1ef0ffc6 1292 fancy-splash-max-time)
6b20fb8e
RS
1293 timer (run-with-timer 0 fancy-splash-delay
1294 #'fancy-splash-screens-1
1295 splash-buffer))
1296 (recursive-edit))
e9da51a1 1297 (cancel-timer timer)
ff4ec1f7
GM
1298 (setq display-hourglass old-hourglass
1299 minor-mode-map-alist old-minor-mode-map-alist)
6b20fb8e
RS
1300 (kill-buffer splash-buffer))))))
1301
1302(defun fancy-splash-frame ()
1303 "Return the frame to use for the fancy splash screen.
1304Returning non-nil does not mean we should necessarily
1305use the fancy splash screen, but if we do use it,
1306we put it on this frame."
1307 (let (chosen-frame)
3a321ddb 1308 (dolist (frame (append (frame-list) (list (selected-frame))))
6b20fb8e
RS
1309 (if (and (frame-visible-p frame)
1310 (not (window-minibuffer-p (frame-selected-window frame))))
1311 (setq chosen-frame frame)))
1312 chosen-frame))
f645586f 1313
285991dc
GM
1314(defun use-fancy-splash-screens-p ()
1315 "Return t if fancy splash screens should be used."
9df076f2
GM
1316 (when (and (display-graphic-p)
1317 (or (and (display-color-p)
285991dc 1318 (image-type-available-p 'xpm))
9df076f2 1319 (image-type-available-p 'pbm)))
16d2fae9
JPW
1320 (let ((frame (fancy-splash-frame)))
1321 (when frame
1322 (let* ((img (create-image (or fancy-splash-image
1323 (if (and (display-color-p)
1324 (image-type-available-p 'xpm))
1325 "splash.xpm" "splash.pbm"))))
1326 (image-height (and img (cdr (image-size img))))
1327 (window-height (1- (window-height (frame-selected-window frame)))))
1328 (> window-height (+ image-height 19)))))))
285991dc
GM
1329
1330
c61453ea
PJ
1331(defun normal-splash-screen ()
1332 "Display splash screen when Emacs starts."
82e736c1
JPW
1333 (let ((prev-buffer (current-buffer)))
1334 (unwind-protect
1335 (with-current-buffer (get-buffer-create "GNU Emacs")
1336 (let ((tab-width 8)
f1180544 1337 (mode-line-format (propertize "---- %b %-"
82e736c1
JPW
1338 'face '(:weight bold))))
1339
b693e375
RS
1340 (if pure-space-overflow
1341 (insert "Warning Warning Pure space overflow Warning Warning\n"))
1342
82e736c1
JPW
1343 ;; The convention for this piece of code is that
1344 ;; each piece of output starts with one or two newlines
1345 ;; and does not end with any newlines.
1346 (insert "Welcome to GNU Emacs")
9d5cf87c
RS
1347 (insert
1348 (if (eq system-type 'gnu/linux)
1349 ", one component of the GNU/Linux operating system.\n"
1350 ", a part of the GNU operating system.\n"))
82e736c1
JPW
1351
1352 (unless (equal (buffer-name prev-buffer) "*scratch*")
1353 (insert (substitute-command-keys
1354 "\nType \\[recenter] to begin editing your file.\n")))
1355
1356 (if (display-mouse-p)
1357 ;; The user can use the mouse to activate menus
1358 ;; so give help in terms of menu items.
1359 (progn
1360 (insert "\
c61453ea
PJ
1361You can do basic editing with the menu bar and scroll bar using the mouse.
1362
1363Useful File menu items:
1364Exit Emacs (or type Control-x followed by Control-c)
93bb512f 1365Recover Crashed Session Recover files you were editing before a crash
c61453ea
PJ
1366
1367Important Help menu items:
9ab281f0 1368Emacs Tutorial Learn how to use Emacs efficiently
c61453ea 1369Emacs FAQ Frequently asked questions and answers
5777a167 1370Read the Emacs Manual View the Emacs manual using Info
c61453ea 1371\(Non)Warranty GNU Emacs comes with ABSOLUTELY NO WARRANTY
9ab281f0
JB
1372Copying Conditions Conditions for redistributing and changing Emacs
1373Getting New Versions How to obtain the latest version of Emacs
1374More Manuals / Ordering Manuals How to order printed manuals from the FSF
c61453ea 1375")
82e736c1
JPW
1376 (insert "\n\n" (emacs-version)
1377 "
9ab281f0 1378Copyright (C) 2005 Free Software Foundation, Inc."))
c61453ea 1379
82e736c1
JPW
1380 ;; No mouse menus, so give help using kbd commands.
1381
1382 ;; If keys have their default meanings,
1383 ;; use precomputed string to save lots of time.
1384 (if (and (eq (key-binding "\C-h") 'help-command)
1385 (eq (key-binding "\C-xu") 'advertised-undo)
1386 (eq (key-binding "\C-x\C-c") 'save-buffers-kill-emacs)
1387 (eq (key-binding "\C-ht") 'help-with-tutorial)
1388 (eq (key-binding "\C-hi") 'info)
1389 (eq (key-binding "\C-hr") 'info-emacs-manual)
1390 (eq (key-binding "\C-h\C-n") 'view-emacs-news))
1391 (insert "
c61453ea 1392Get help C-h (Hold down CTRL and press h)
5777a167
RS
1393Emacs manual C-h r
1394Emacs tutorial C-h t Undo changes C-x u
1395Buy manuals C-h C-m Exit Emacs C-x C-c
1396Browse manuals C-h i")
1397
82e736c1
JPW
1398 (insert (substitute-command-keys
1399 (format "\n
c61453ea 1400Get help %s
5777a167 1401Emacs manual \\[info-emacs-manual]
82e736c1
JPW
1402Emacs tutorial \\[help-with-tutorial]\tUndo changes\t\\[advertised-undo]
1403Buy manuals \\[view-order-manuals]\tExit Emacs\t\\[save-buffers-kill-emacs]
5777a167 1404Browse manuals \\[info]"
82e736c1
JPW
1405 (let ((where (where-is-internal
1406 'help-command nil t)))
1407 (if where
1408 (key-description where)
1409 "M-x help"))))))
1410
1411 ;; Say how to use the menu bar with the keyboard.
1412 (if (and (eq (key-binding "\M-`") 'tmm-menubar)
1413 (eq (key-binding [f10]) 'tmm-menubar))
1414 (insert "
c61453ea 1415Activate menubar F10 or ESC ` or M-`")
82e736c1 1416 (insert (substitute-command-keys "
c61453ea
PJ
1417Activate menubar \\[tmm-menubar]")))
1418
82e736c1
JPW
1419 ;; Many users seem to have problems with these.
1420 (insert "
c61453ea
PJ
1421\(`C-' means use the CTRL key. `M-' means use the Meta (or Alt) key.
1422If you have no Meta key, you may instead type ESC followed by the character.)")
1423
82e736c1
JPW
1424 (insert "\n\n" (emacs-version)
1425 "
9ab281f0 1426Copyright (C) 2005 Free Software Foundation, Inc.")
c61453ea 1427
82e736c1
JPW
1428 (if (and (eq (key-binding "\C-h\C-c") 'describe-copying)
1429 (eq (key-binding "\C-h\C-d") 'describe-distribution)
1430 (eq (key-binding "\C-h\C-w") 'describe-no-warranty))
f1180544 1431 (insert
82e736c1 1432 "\n
c61453ea
PJ
1433GNU Emacs comes with ABSOLUTELY NO WARRANTY; type C-h C-w for full details.
1434Emacs is Free Software--Free as in Freedom--so you can redistribute copies
1435of Emacs and modify it; type C-h C-c to see the conditions.
1436Type C-h C-d for information on getting the latest version.")
82e736c1
JPW
1437 (insert (substitute-command-keys
1438 "\n
c61453ea
PJ
1439GNU Emacs comes with ABSOLUTELY NO WARRANTY; type \\[describe-no-warranty] for full details.
1440Emacs is Free Software--Free as in Freedom--so you can redistribute copies
1441of Emacs and modify it; type \\[describe-copying] to see the conditions.
1442Type \\[describe-distribution] for information on getting the latest version."))))
1443
82e736c1
JPW
1444 ;; The rest of the startup screen is the same on all
1445 ;; kinds of terminals.
1446
1447 ;; Give information on recovering, if there was a crash.
1448 (and auto-save-list-file-prefix
1449 ;; Don't signal an error if the
1450 ;; directory for auto-save-list files
1451 ;; does not yet exist.
1452 (file-directory-p (file-name-directory
1453 auto-save-list-file-prefix))
1454 (directory-files
1455 (file-name-directory auto-save-list-file-prefix)
1456 nil
1457 (concat "\\`"
1458 (regexp-quote (file-name-nondirectory
1459 auto-save-list-file-prefix)))
1460 t)
1461 (insert "\n\nIf an Emacs session crashed recently, "
1462 "type M-x recover-session RET\nto recover"
1463 " the files you were editing."))
1464
1465 ;; Display the input that we set up in the buffer.
1466 (set-buffer-modified-p nil)
1467 (goto-char (point-min))
1468 (save-window-excursion
1469 (switch-to-buffer (current-buffer))
1470 (sit-for 120))))
1471 ;; Unwind ... ensure splash buffer is killed
1472 (kill-buffer "GNU Emacs"))))
1473
c61453ea 1474
f645586f
GM
1475(defun startup-echo-area-message ()
1476 (if (eq (key-binding "\C-h\C-p") 'describe-project)
1477 "For information about the GNU Project and its goals, type C-h C-p."
1478 (substitute-command-keys
1479 "For information about the GNU Project and its goals, type \
1480\\[describe-project].")))
ce9ded5d
GM
1481
1482
49939379 1483(defun display-startup-echo-area-message ()
15fa6db0 1484 (let ((resize-mini-windows t))
8a26c165 1485 (message "%s" (startup-echo-area-message))))
f645586f 1486
49939379 1487
c61453ea
PJ
1488(defun display-splash-screen ()
1489 "Display splash screen according to display.
1490Fancy splash screens are used on graphic displays,
1491normal otherwise."
1492 (interactive)
9df076f2 1493 (if (use-fancy-splash-screens-p)
c61453ea
PJ
1494 (fancy-splash-screens)
1495 (normal-splash-screen)))
1496
1497
a726e0d1 1498(defun command-line-1 (command-line-args-left)
52320897 1499 (or noninteractive (input-pending-p) init-file-had-error
ed638cc9
RS
1500 ;; t if the init file says to inhibit the echo area startup message.
1501 (and inhibit-startup-echo-area-message
1502 user-init-file
1503 (or (and (get 'inhibit-startup-echo-area-message 'saved-value)
1504 (equal inhibit-startup-echo-area-message
bca8c7be 1505 (if (equal init-file-user "")
ed638cc9
RS
1506 (user-login-name)
1507 init-file-user)))
1508 ;; Wasn't set with custom; see if .emacs has a setq.
1509 (let ((buffer (get-buffer-create " *temp*")))
1510 (prog1
1511 (condition-case nil
1512 (save-excursion
1513 (set-buffer buffer)
1514 (insert-file-contents user-init-file)
1515 (re-search-forward
1516 (concat
1517 "([ \t\n]*setq[ \t\n]+"
1518 "inhibit-startup-echo-area-message[ \t\n]+"
1519 (regexp-quote
1520 (prin1-to-string
bca8c7be 1521 (if (equal init-file-user "")
ed638cc9
RS
1522 (user-login-name)
1523 init-file-user)))
1524 "[ \t\n]*)")
1525 nil t))
1526 (error nil))
1527 (kill-buffer buffer)))))
11dd83c8
GM
1528 ;; display-splash-screen at the end of command-line-1 calls
1529 ;; use-fancy-splash-screens-p. This can cause image.el to be
1530 ;; loaded, putting "Loading image... done" in the echo area.
1531 ;; This hides startup-echo-area-message. So
1532 ;; use-fancy-splash-screens-p is called here simply to get the
1533 ;; loading of image.el (if needed) out of the way before
1534 ;; display-startup-echo-area-message runs.
79f9f704 1535 (progn
79f9f704
GM
1536 (use-fancy-splash-screens-p)
1537 (display-startup-echo-area-message)))
ed638cc9
RS
1538
1539 ;; Delay 2 seconds after an init file error message
1540 ;; was displayed, so user can read it.
bca8c7be
MS
1541 (when init-file-had-error
1542 (sit-for 2))
1543
1544 (when command-line-args-left
1545 ;; We have command args; process them.
1546 (let ((dir command-line-default-directory)
1547 (file-count 0)
1548 first-file-buffer
1549 tem
b9687971
TTN
1550 ;; This approach loses for "-batch -L DIR --eval "(require foo)",
1551 ;; if foo is intended to be found in DIR.
1552 ;;
1553 ;; ;; The directories listed in --directory/-L options will *appear*
1554 ;; ;; at the front of `load-path' in the order they appear on the
1555 ;; ;; command-line. We cannot do this by *placing* them at the front
1556 ;; ;; in the order they appear, so we need this variable to hold them,
1557 ;; ;; temporarily.
1558 ;; extra-load-path
1559 ;;
1560 ;; To DTRT we keep track of the splice point and modify `load-path'
1561 ;; straight away upon any --directory/-L option.
1562 splice
bca8c7be
MS
1563 just-files ;; t if this follows the magic -- option.
1564 ;; This includes our standard options' long versions
1565 ;; and long versions of what's on command-switch-alist.
1566 (longopts
1567 (append '(("--funcall") ("--load") ("--insert") ("--kill")
1568 ("--directory") ("--eval") ("--execute") ("--no-splash")
1569 ("--find-file") ("--visit") ("--file"))
1570 (mapcar (lambda (elt)
1571 (list (concat "-" (car elt))))
1572 command-switch-alist)))
1573 (line 0)
1574 (column 0))
1575
1576 ;; Add the long X options to longopts.
1577 (dolist (tem command-line-x-option-alist)
1578 (if (string-match "^--" (car tem))
1579 (push (list (car tem)) longopts)))
1580
1581 ;; Loop, processing options.
1582 (while command-line-args-left
1583 (let* ((argi (car command-line-args-left))
1584 (orig-argi argi)
1585 argval completion)
1586 (setq command-line-args-left (cdr command-line-args-left))
1587
1588 ;; Do preliminary decoding of the option.
1589 (if just-files
1590 ;; After --, don't look for options; treat all args as files.
1591 (setq argi "")
1592 ;; Convert long options to ordinary options
1593 ;; and separate out an attached option argument into argval.
1594 (when (string-match "^\\(--[^=]*\\)=" argi)
1595 (setq argval (substring argi (match-end 0))
1596 argi (match-string 1 argi)))
1597 (if (equal argi "--")
1598 (setq completion nil)
1599 (setq completion (try-completion argi longopts)))
1600 (if (eq completion t)
1601 (setq argi (substring argi 1))
1602 (if (stringp completion)
1603 (let ((elt (assoc completion longopts)))
1604 (or elt
1605 (error "Option `%s' is ambiguous" argi))
1606 (setq argi (substring (car elt) 1)))
1607 (setq argval nil
1608 argi orig-argi))))
1609
1610 ;; Execute the option.
1611 (cond ((setq tem (assoc argi command-switch-alist))
1612 (if argval
1613 (let ((command-line-args-left
1614 (cons argval command-line-args-left)))
1615 (funcall (cdr tem) argi))
1616 (funcall (cdr tem) argi)))
1617
1618 ((equal argi "-no-splash")
1619 (setq inhibit-startup-message t))
1620
1621 ((member argi '("-f" ; what the manual claims
1622 "-funcall"
1623 "-e")) ; what the source used to say
1624 (setq tem (intern (or argval (pop command-line-args-left))))
f39864ec 1625 (if (commandp tem)
bca8c7be
MS
1626 (command-execute tem)
1627 (funcall tem)))
1628
1629 ((member argi '("-eval" "-execute"))
1630 (eval (read (or argval (pop command-line-args-left)))))
bca8c7be
MS
1631
1632 ((member argi '("-L" "-directory"))
b9687971
TTN
1633 (setq tem (expand-file-name
1634 (command-line-normalize-file-name
1635 (or argval (pop command-line-args-left)))))
1636 (cond (splice (setcdr splice (cons tem (cdr splice)))
1637 (setq splice (cdr splice)))
1638 (t (setq load-path (cons tem load-path)
1639 splice load-path))))
bca8c7be
MS
1640
1641 ((member argi '("-l" "-load"))
1642 (let* ((file (command-line-normalize-file-name
1643 (or argval (pop command-line-args-left))))
1644 ;; Take file from default dir if it exists there;
1645 ;; otherwise let `load' search for it.
1646 (file-ex (expand-file-name file)))
1647 (when (file-exists-p file-ex)
1648 (setq file file-ex))
1649 (load file nil t)))
1650
56b3b16b
RS
1651 ;; This is used to handle -script. It's not clear
1652 ;; we need to document it.
0f0cef08
RS
1653 ((member argi '("-scriptload"))
1654 (let* ((file (command-line-normalize-file-name
1655 (or argval (pop command-line-args-left))))
1656 ;; Take file from default dir.
1657 (file-ex (expand-file-name file)))
1658 (load file-ex nil t t)))
1659
bca8c7be
MS
1660 ((equal argi "-insert")
1661 (setq tem (or argval (pop command-line-args-left)))
1662 (or (stringp tem)
1663 (error "File name omitted from `-insert' option"))
1664 (insert-file-contents (command-line-normalize-file-name tem)))
1665
1666 ((equal argi "-kill")
1667 (kill-emacs t))
1668
1669 ((string-match "^\\+[0-9]+\\'" argi)
027a4b6b 1670 (setq line (string-to-number argi)))
bca8c7be
MS
1671
1672 ((string-match "^\\+\\([0-9]+\\):\\([0-9]+\\)\\'" argi)
027a4b6b
JB
1673 (setq line (string-to-number (match-string 1 argi))
1674 column (string-to-number (match-string 2 argi))))
bca8c7be
MS
1675
1676 ((setq tem (assoc argi command-line-x-option-alist))
1677 ;; Ignore X-windows options and their args if not using X.
1678 (setq command-line-args-left
1679 (nthcdr (nth 1 tem) command-line-args-left)))
1680
1681 ((member argi '("-find-file" "-file" "-visit"))
1682 ;; An explicit option to specify visiting a file.
1683 (setq tem (or argval (pop command-line-args-left)))
1684 (unless (stringp tem)
1685 (error "File name omitted from `%s' option" argi))
1686 (setq file-count (1+ file-count))
1687 (let ((file (expand-file-name
1688 (command-line-normalize-file-name tem) dir)))
1689 (if (= file-count 1)
1690 (setq first-file-buffer (find-file file))
1691 (find-file-other-window file)))
1692 (or (zerop line)
1693 (goto-line line))
1694 (setq line 0)
1695 (unless (< column 1)
1696 (move-to-column (1- column)))
1697 (setq column 0))
1698
1699 ((equal argi "--")
1700 (setq just-files t))
1701 (t
1702 ;; We have almost exhausted our options. See if the
1703 ;; user has made any other command-line options available
1704 (let ((hooks command-line-functions) ;; lrs 7/31/89
1705 (did-hook nil))
1706 (while (and hooks
1707 (not (setq did-hook (funcall (car hooks)))))
1708 (setq hooks (cdr hooks)))
1709 (if (not did-hook)
1710 ;; Presume that the argument is a file name.
1711 (progn
1712 (if (string-match "\\`-" argi)
1713 (error "Unknown option `%s'" argi))
1714 (setq file-count (1+ file-count))
1715 (let ((file
1716 (expand-file-name
1717 (command-line-normalize-file-name orig-argi)
1718 dir)))
1719 (if (= file-count 1)
1720 (setq first-file-buffer (find-file file))
1721 (find-file-other-window file)))
1722 (or (zerop line)
1723 (goto-line line))
1724 (setq line 0)
1725 (unless (< column 1)
1726 (move-to-column (1- column)))
1727 (setq column 0))))))))
1728
bca8c7be
MS
1729 ;; If 3 or more files visited, and not all visible,
1730 ;; show user what they all are. But leave the last one current.
1731 (and (> file-count 2)
1732 (not noninteractive)
1733 (not inhibit-startup-buffer-menu)
1734 (or (get-buffer-window first-file-buffer)
1735 (list-buffers)))))
eae91b60
RS
1736
1737 ;; Maybe display a startup screen.
e2c60824
KS
1738 (unless (or inhibit-startup-message
1739 noninteractive
3c24b4e4 1740 emacs-quick-startup)
eae91b60
RS
1741 ;; Display a startup screen, after some preparations.
1742
1743 ;; If there are no switches to process, we might as well
1744 ;; run this hook now, and there may be some need to do it
1745 ;; before doing any output.
deebb0e9 1746 (run-hooks 'emacs-startup-hook)
eae91b60
RS
1747 (and term-setup-hook
1748 (run-hooks 'term-setup-hook))
deebb0e9 1749 (setq inhibit-startup-hooks t)
eae91b60
RS
1750
1751 ;; It's important to notice the user settings before we
1752 ;; display the startup message; otherwise, the settings
1753 ;; won't take effect until the user gives the first
1754 ;; keystroke, and that's distracting.
1755 (when (fboundp 'frame-notice-user-settings)
1756 (frame-notice-user-settings))
1757
1758 ;; If there are no switches to process, we might as well
1759 ;; run this hook now, and there may be some need to do it
1760 ;; before doing any output.
1761 (when window-setup-hook
1762 (run-hooks 'window-setup-hook)
1763 ;; Don't let the hook be run twice.
1764 (setq window-setup-hook nil))
1765
1766 ;; Do this now to avoid an annoying delay if the user
1767 ;; clicks the menu bar during the sit-for.
1768 (when (display-popup-menus-p)
1769 (precompute-menubar-bindings))
d759a2f5
RS
1770 (with-no-warnings
1771 (setq menubar-bindings-done t))
ed638cc9 1772
eae91b60
RS
1773 ;; If *scratch* is selected and it is empty, insert an
1774 ;; initial message saying not to create a file there.
1775 (when (and initial-scratch-message
bca8c7be 1776 (equal (buffer-name) "*scratch*")
ed638cc9 1777 (= 0 (buffer-size)))
eae91b60
RS
1778 (insert initial-scratch-message)
1779 (set-buffer-modified-p nil))
ed638cc9 1780
eae91b60
RS
1781 ;; If user typed input during all that work,
1782 ;; abort the startup screen. Otherwise, display it now.
c61453ea
PJ
1783 (unless (input-pending-p)
1784 (display-splash-screen))))
c88ab9ce 1785
49939379 1786
47c7adae
RS
1787(defun command-line-normalize-file-name (file)
1788 "Collapse multiple slashes to one, to handle non-Emacs file names."
6b9e794f
RS
1789 (save-match-data
1790 ;; Use arg 1 so that we don't collapse // at the start of the file name.
1791 ;; That is significant on some systems.
1792 ;; However, /// at the beginning is supposed to mean just /, not //.
1793 (if (string-match "^///+" file)
1794 (setq file (replace-match "/" t t file)))
1795 (while (string-match "//+" file 1)
1796 (setq file (replace-match "/" t t file)))
1797 file))
47c7adae 1798
a3194d03 1799;; arch-tag: 7e294698-244d-4758-984b-4047f887a5db
c88ab9ce 1800;;; startup.el ends here