* anti.texi (Antinews): Correct the list of removed platforms.
[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,
ae940284 4;; 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
93926b07 5;; Free Software Foundation, Inc.
eea8d4ef 6
630cc463 7;; Maintainer: FSF
d7b4d18f 8;; Keywords: internal
630cc463 9
a726e0d1
JB
10;; This file is part of GNU Emacs.
11
eb3fa2cf 12;; GNU Emacs is free software: you can redistribute it and/or modify
a726e0d1 13;; it under the terms of the GNU General Public License as published by
eb3fa2cf
GM
14;; the Free Software Foundation, either version 3 of the License, or
15;; (at your option) any later version.
a726e0d1
JB
16
17;; GNU Emacs is distributed in the hope that it will be useful,
18;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20;; GNU General Public License for more details.
21
22;; You should have received a copy of the GNU General Public License
eb3fa2cf 23;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
a726e0d1 24
630cc463 25;;; Commentary:
a726e0d1 26
6b61353c
KH
27;; This file parses the command line and gets Emacs running. Options
28;; on the command line are handled in precedence order. For priorities
29;; see the structure standard_args in the emacs.c file.
a726e0d1 30
630cc463
ER
31;;; Code:
32
a726e0d1
JB
33(setq top-level '(normal-top-level))
34
42a3e6fa 35(defvar command-line-processed nil
2879a13b 36 "Non-nil once command line has been processed.")
a726e0d1 37
42a3e6fa 38(defgroup initialization nil
ca3685a3 39 "Emacs start-up procedure."
26cdce23
JL
40 :group 'environment)
41
42(defcustom initial-buffer-choice nil
43 "Buffer to show after starting Emacs.
490a1ad6 44If the value is nil and `inhibit-startup-screen' is nil, show the
26cdce23
JL
45startup screen. If the value is string, visit the specified file or
46directory using `find-file'. If t, open the `*scratch*' buffer."
47 :type '(choice
490a1ad6 48 (const :tag "Startup screen" nil)
26cdce23 49 (directory :tag "Directory" :value "~/")
85b84319 50 (file :tag "File" :value "~/.emacs")
26cdce23
JL
51 (const :tag "Lisp scratch buffer" t))
52 :version "23.1"
53 :group 'initialization)
42a3e6fa 54
490a1ad6 55(defcustom inhibit-startup-screen nil
249d9683 56 "Non-nil inhibits the startup screen.
249d9683 57
eeaa563e
JB
58This is for use in your personal init file (but NOT site-start.el),
59once you are familiar with the contents of the startup screen."
42a3e6fa
RS
60 :type 'boolean
61 :group 'initialization)
a726e0d1 62
490a1ad6
JL
63(defvaralias 'inhibit-splash-screen 'inhibit-startup-screen)
64(defvaralias 'inhibit-startup-message 'inhibit-startup-screen)
1b207153 65
22a58255 66(defvar startup-screen-inhibit-startup-screen nil)
1b207153 67
42a3e6fa 68(defcustom inhibit-startup-echo-area-message nil
ea6c930a 69 "Non-nil inhibits the initial startup echo area message.
42a3e6fa
RS
70Setting this variable takes effect
71only if you do it with the customization buffer
94487c4e 72or if your `.emacs' file contains a line of this form:
54a003f7 73 (setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\")
e5575c06
RS
74If your `.emacs' file is byte-compiled, use the following form instead:
75 (eval '(setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\"))
1d7da582 76Thus, someone else using a copy of your `.emacs' file will see
42a3e6fa
RS
77the startup message unless he personally acts to inhibit it."
78 :type '(choice (const :tag "Don't inhibit")
79 (string :tag "Enter your user name, to inhibit"))
80 :group 'initialization)
1d7da582 81
42a3e6fa 82(defcustom inhibit-default-init nil
ea6c930a 83 "Non-nil inhibits loading the `default' library."
42a3e6fa
RS
84 :type 'boolean
85 :group 'initialization)
a726e0d1 86
802a980a 87(defcustom inhibit-startup-buffer-menu nil
ea6c930a 88 "Non-nil inhibits display of buffer list when more than 2 files are loaded."
802a980a
GM
89 :type 'boolean
90 :group 'initialization)
91
d7fa5aa2 92(defvar command-switch-alist nil
a726e0d1
JB
93 "Alist of command-line switches.
94Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
6b61353c
KH
95HANDLER-FUNCTION receives the switch string as its sole argument;
96the remaining command-line args are in the variable `command-line-args-left'.")
a726e0d1 97
860befc8
RS
98(defvar command-line-args-left nil
99 "List of command-line args not yet processed.")
100
aa5310e4
DK
101(defvaralias 'argv 'command-line-args-left
102 "List of command-line args not yet processed.
103This is a convenience alias, so that one can write \(pop argv\)
104inside of --eval command line arguments in order to access
105following arguments.")
106
a726e0d1
JB
107(defvar command-line-functions nil ;; lrs 7/31/89
108 "List of functions to process unrecognized command-line arguments.
109Each function should access the dynamically bound variables
b4484ea8 110`argi' (the current argument) and `command-line-args-left' (the remaining
a726e0d1 111arguments). The function should return non-nil only if it recognizes and
b4484ea8
RS
112processes `argi'. If it does so, it may consume successive arguments by
113altering `command-line-args-left' to remove them.")
a726e0d1 114
09a1077c
RS
115(defvar command-line-default-directory nil
116 "Default directory to use for command line arguments.
117This is normally copied from `default-directory' when Emacs starts.")
118
b3afdeb8
RS
119;;; This is here, rather than in x-win.el, so that we can ignore these
120;;; options when we are not using X.
46cfd295 121(defconst command-line-x-option-alist
b3afdeb8
RS
122 '(("-bw" 1 x-handle-numeric-switch border-width)
123 ("-d" 1 x-handle-display)
124 ("-display" 1 x-handle-display)
5676ab57 125 ("-name" 1 x-handle-name-switch)
2c3fef40
RS
126 ("-title" 1 x-handle-switch title)
127 ("-T" 1 x-handle-switch title)
b3afdeb8
RS
128 ("-r" 0 x-handle-switch reverse t)
129 ("-rv" 0 x-handle-switch reverse t)
130 ("-reverse" 0 x-handle-switch reverse t)
131 ("-reverse-video" 0 x-handle-switch reverse t)
132 ("-fn" 1 x-handle-switch font)
133 ("-font" 1 x-handle-switch font)
188b6a5e
EZ
134 ("-fs" 0 x-handle-initial-switch fullscreen fullboth)
135 ("-fw" 0 x-handle-initial-switch fullscreen fullwidth)
136 ("-fh" 0 x-handle-initial-switch fullscreen fullheight)
b3afdeb8 137 ("-ib" 1 x-handle-numeric-switch internal-border-width)
1f7f78f1 138 ("-g" 1 x-handle-geometry)
9ff6bda1 139 ("-lsp" 1 x-handle-numeric-switch line-spacing)
1f7f78f1 140 ("-geometry" 1 x-handle-geometry)
b3afdeb8
RS
141 ("-fg" 1 x-handle-switch foreground-color)
142 ("-foreground" 1 x-handle-switch foreground-color)
143 ("-bg" 1 x-handle-switch background-color)
144 ("-background" 1 x-handle-switch background-color)
145 ("-ms" 1 x-handle-switch mouse-color)
c755acf3 146 ("-nbi" 0 x-handle-switch icon-type nil)
b3afdeb8
RS
147 ("-iconic" 0 x-handle-iconic)
148 ("-xrm" 1 x-handle-xrm-switch)
149 ("-cr" 1 x-handle-switch cursor-color)
150 ("-vb" 0 x-handle-switch vertical-scroll-bars t)
151 ("-hb" 0 x-handle-switch horizontal-scroll-bars t)
152 ("-bd" 1 x-handle-switch)
153 ("--border-width" 1 x-handle-numeric-switch border-width)
154 ("--display" 1 x-handle-display)
5676ab57 155 ("--name" 1 x-handle-name-switch)
7775acb8 156 ("--title" 1 x-handle-switch title)
b3afdeb8
RS
157 ("--reverse-video" 0 x-handle-switch reverse t)
158 ("--font" 1 x-handle-switch font)
188b6a5e
EZ
159 ("--fullscreen" 0 x-handle-initial-switch fullscreen fullboth)
160 ("--fullwidth" 0 x-handle-initial-switch fullscreen fullwidth)
161 ("--fullheight" 0 x-handle-initial-switch fullscreen fullheight)
b3afdeb8 162 ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
1f7f78f1 163 ("--geometry" 1 x-handle-geometry)
b3afdeb8
RS
164 ("--foreground-color" 1 x-handle-switch foreground-color)
165 ("--background-color" 1 x-handle-switch background-color)
166 ("--mouse-color" 1 x-handle-switch mouse-color)
bb1f0f78 167 ("--no-bitmap-icon" 0 x-handle-no-bitmap-icon)
b3afdeb8
RS
168 ("--iconic" 0 x-handle-iconic)
169 ("--xrm" 1 x-handle-xrm-switch)
170 ("--cursor-color" 1 x-handle-switch cursor-color)
171 ("--vertical-scroll-bars" 0 x-handle-switch vertical-scroll-bars t)
9ff6bda1 172 ("--line-spacing" 1 x-handle-numeric-switch line-spacing)
7f944e8e 173 ("--border-color" 1 x-handle-switch border-color)
c434f203
JD
174 ("--smid" 1 x-handle-smid)
175 ("--parent-id" 1 x-handle-parent-id))
b3afdeb8
RS
176 "Alist of X Windows options.
177Each element has the form
178 (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
179where NAME is the option name string, NUMARGS is the number of arguments
180that the option accepts, HANDLER is a function to call to handle the option.
181FRAME-PARAM (optional) is the frame parameter this option specifies,
182and VALUE is the value which is given to that frame parameter
183\(most options use the argument for this, so VALUE is not present).")
184
edfda783
AR
185(defconst command-line-ns-option-alist
186 '(("-NSAutoLaunch" 1 ns-ignore-1-arg)
187 ("-NXAutoLaunch" 1 ns-ignore-1-arg)
55e8d9a5 188 ("-macosx" 0 ignore)
edfda783
AR
189 ("-NSHost" 1 ns-ignore-1-arg)
190 ("-_NSMachLaunch" 1 ns-ignore-1-arg)
191 ("-MachLaunch" 1 ns-ignore-1-arg)
192 ("-NXOpen" 1 ns-ignore-1-arg)
193 ("-NSOpen" 1 ns-handle-nxopen)
194 ("-NXOpenTemp" 1 ns-ignore-1-arg)
195 ("-NSOpenTemp" 1 ns-handle-nxopentemp)
196 ("-GSFilePath" 1 ns-handle-nxopen)
197 ;;("-bw" . x-handle-numeric-switch)
198 ;;("-d" . x-handle-display)
199 ;;("-display" . x-handle-display)
200 ("-name" 1 ns-handle-name-switch)
201 ("-title" 1 ns-handle-switch title)
202 ("-T" 1 ns-handle-switch title)
203 ("-r" 0 ns-handle-switch reverse t)
204 ("-rv" 0 ns-handle-switch reverse t)
205 ("-reverse" 0 ns-handle-switch reverse t)
206 ("-fn" 1 ns-handle-switch font)
207 ("-font" 1 ns-handle-switch font)
208 ("-ib" 1 ns-handle-numeric-switch internal-border-width)
209 ;;("-g" . x-handle-geometry)
210 ;;("-geometry" . x-handle-geometry)
211 ("-fg" 1 ns-handle-switch foreground-color)
212 ("-foreground" 1 ns-handle-switch foreground-color)
213 ("-bg" 1 ns-handle-switch background-color)
214 ("-background" 1 ns-handle-switch background-color)
215; ("-ms" 1 ns-handle-switch mouse-color)
216 ("-itype" 0 ns-handle-switch icon-type t)
217 ("-i" 0 ns-handle-switch icon-type t)
218 ("-iconic" 0 ns-handle-iconic icon-type t)
219 ;;("-xrm" . x-handle-xrm-switch)
220 ("-cr" 1 ns-handle-switch cursor-color)
221 ("-vb" 0 ns-handle-switch vertical-scroll-bars t)
222 ("-hb" 0 ns-handle-switch horizontal-scroll-bars t)
eeaa563e
JB
223 ("-bd" 1 ns-handle-switch)
224 ;; ("--border-width" 1 ns-handle-numeric-switch border-width)
edfda783
AR
225 ;; ("--display" 1 ns-handle-display)
226 ("--name" 1 ns-handle-name-switch)
227 ("--title" 1 ns-handle-switch title)
228 ("--reverse-video" 0 ns-handle-switch reverse t)
229 ("--font" 1 ns-handle-switch font)
230 ("--internal-border" 1 ns-handle-numeric-switch internal-border-width)
231 ;; ("--geometry" 1 ns-handle-geometry)
232 ("--foreground-color" 1 ns-handle-switch foreground-color)
233 ("--background-color" 1 ns-handle-switch background-color)
234 ("--mouse-color" 1 ns-handle-switch mouse-color)
235 ("--icon-type" 0 ns-handle-switch icon-type t)
236 ("--iconic" 0 ns-handle-iconic)
237 ;; ("--xrm" 1 ns-handle-xrm-switch)
238 ("--cursor-color" 1 ns-handle-switch cursor-color)
239 ("--vertical-scroll-bars" 0 ns-handle-switch vertical-scroll-bars t)
240 ("--border-color" 1 ns-handle-switch border-width))
241 "Alist of NS options.
242Each element has the form
243 (NAME NUMARGS HANDLER FRAME-PARAM VALUE)
244where NAME is the option name string, NUMARGS is the number of arguments
245that the option accepts, HANDLER is a function to call to handle the option.
246FRAME-PARAM (optional) is the frame parameter this option specifies,
247and VALUE is the value which is given to that frame parameter
248\(most options use the argument for this, so VALUE is not present).")
249
250
e3bd99f5 251(defvar before-init-hook nil
db3f571a 252 "Normal hook run after handling urgent options but before loading init files.")
3fc958a4 253
e3bd99f5 254(defvar after-init-hook nil
db3f571a
KH
255 "Normal hook run after loading the init files, `~/.emacs' and `default.el'.
256There is no `condition-case' around the running of these functions;
257therefore, if you set `debug-on-error' non-nil in `.emacs',
258an error in one of these functions will invoke the debugger.")
259
260(defvar emacs-startup-hook nil
261 "Normal hook run after loading init files and handling the command line.")
e3bd99f5 262
a726e0d1 263(defvar term-setup-hook nil
db3f571a
KH
264 "Normal hook run after loading terminal-specific Lisp code.
265It also follows `emacs-startup-hook'. This hook exists for users to set,
a726e0d1
JB
266so as to override the definitions made by the terminal-specific file.
267Emacs never sets this variable itself.")
268
deebb0e9
RS
269(defvar inhibit-startup-hooks nil
270 "Non-nil means don't run `term-setup-hook' and `emacs-startup-hook'.
271This is because we already did so.")
272
a726e0d1 273(defvar keyboard-type nil
b4484ea8 274 "The brand of keyboard you are using.
9ab281f0
JB
275This variable is used to define the proper function and keypad
276keys for use under X. It is used in a fashion analogous to the
277environment variable TERM.")
a726e0d1
JB
278
279(defvar window-setup-hook nil
b4484ea8
RS
280 "Normal hook run to initialize window system display.
281Emacs runs this hook after processing the command line arguments and loading
282the user's init file.")
a726e0d1 283
42a3e6fa 284(defcustom initial-major-mode 'lisp-interaction-mode
ab863ac2 285 "Major mode command symbol to use for the initial `*scratch*' buffer."
ce2f921e 286 :type 'function
42a3e6fa 287 :group 'initialization)
a726e0d1 288
ecbff273 289(defvar init-file-user nil
a726e0d1 290 "Identity of user whose `.emacs' file is or was read.
d7fa5aa2
RS
291The value is nil if `-q' or `--no-init-file' was specified,
292meaning do not load any init file.
293
d3a81eee
EZ
294Otherwise, the value may be an empty string, meaning
295use the init file for the user who originally logged in,
296or it may be a string containing a user's name meaning
297use that person's init file.
a726e0d1 298
2bdfaa42
KH
299In either of the latter cases, `(concat \"~\" init-file-user \"/\")'
300evaluates to the name of the directory where the `.emacs' file was
13fce4e6
RS
301looked for.
302
303Setting `init-file-user' does not prevent Emacs from loading
ecbff273 304`site-start.el'. The only way to do that is to use `--no-site-file'.")
a726e0d1 305
42a3e6fa 306(defcustom site-run-file "site-start"
b7444d31
RS
307 "File containing site-wide run-time initializations.
308This file is loaded at run-time before `~/.emacs'. It contains inits
309that need to be in place for the entire site, but which, due to their
fcaf7de9 310higher incidence of change, don't make sense to load into Emacs's
b7444d31 311dumped image. Thus, the run-time load order is: 1. file described in
13fce4e6
RS
312this variable, if non-nil; 2. `~/.emacs'; 3. `default.el'.
313
314Don't use the `site-start.el' file for things some users may not like.
315Put them in `default.el' instead, so that users can more easily
316override them. Users can prevent loading `default.el' with the `-q'
317option or by setting `inhibit-default-init' in their own init files,
318but inhibiting `site-start.el' requires `--no-site-file', which
842a1eac
RS
319is less convenient.
320
321This variable is defined for customization so as to make
322it visible in the relevant context. However, actually customizing it
323is not allowed, since it would not work anyway. The only way to set
9ab281f0 324this variable usefully is to set it while building and dumping Emacs."
93812130 325 :type '(choice (const :tag "none" nil) string)
842a1eac
RS
326 :group 'initialization
327 :initialize 'custom-initialize-default
328 :set '(lambda (variable value)
329 (error "Customizing `site-run-file' does not work")))
b7444d31 330
42a3e6fa 331(defcustom mail-host-address nil
ea6c930a 332 "Name of this machine, for purposes of naming users."
42a3e6fa
RS
333 :type '(choice (const nil) string)
334 :group 'mail)
c13fbb62 335
680ebfa6 336(defcustom user-mail-address (if command-line-processed
cee0c996
EZ
337 (or (getenv "EMAIL")
338 (concat (user-login-name) "@"
339 (or mail-host-address
340 (system-name))))
680ebfa6
RS
341 ;; Empty string means "not set yet".
342 "")
ea6c930a 343 "Full mailing address of this user.
cee0c996 344This is initialized with environment variable `EMAIL' or, as a
eeaa563e 345fallback, using `mail-host-address'. This is done after your
cee0c996 346init file is read, in case it sets `mail-host-address'."
42a3e6fa
RS
347 :type 'string
348 :group 'mail)
c10d1f06 349
42a3e6fa 350(defcustom auto-save-list-file-prefix
73f13e5a
GM
351 (cond ((eq system-type 'ms-dos)
352 ;; MS-DOS cannot have initial dot, and allows only 8.3 names
945a0a0c 353 (concat user-emacs-directory "auto-save.list/_s"))
73f13e5a 354 (t
945a0a0c 355 (concat user-emacs-directory "auto-save-list/.saves-")))
cdee38c3
KH
356 "Prefix for generating `auto-save-list-file-name'.
357This is used after reading your `.emacs' file to initialize
358`auto-save-list-file-name', by appending Emacs's pid and the system name,
359if you have not already set `auto-save-list-file-name' yourself.
73f13e5a 360Directories in the prefix will be created if necessary.
cdee38c3 361Set this to nil if you want to prevent `auto-save-list-file-name'
42a3e6fa 362from being initialized."
3671f444
KH
363 :type '(choice (const :tag "Don't record a session's auto save list" nil)
364 string)
42a3e6fa 365 :group 'auto-save)
2e05d063 366
6b61353c
KH
367(defvar emacs-quick-startup nil)
368
dc58296d
RS
369(defvar emacs-basic-display nil)
370
a726e0d1
JB
371(defvar init-file-debug nil)
372
5b309ebf
RS
373(defvar init-file-had-error nil
374 "Non-nil if there was an error loading the user's init file.")
52320897 375
95eada65
RS
376(defvar normal-top-level-add-subdirs-inode-list nil)
377
178b4542
JL
378(defvar no-blinking-cursor nil)
379
0a480f3d
RS
380(defvar default-frame-background-mode)
381
b693e375
RS
382(defvar pure-space-overflow nil
383 "Non-nil if building Emacs overflowed pure space.")
384
22a58255
CY
385(defvar pure-space-overflow-message "\
386Warning Warning!!! Pure space overflow !!!Warning Warning
387\(See the node Pure Storage in the Lisp manual for details.)\n")
388
5f5ba825 389(defvar tutorial-directory nil
f51a80af
GM
390 "Directory containing the Emacs TUTORIAL files.")
391
5f5ba825
GM
392;; Get correct value in a dumped, installed Emacs.
393(eval-at-startup
394 (setq tutorial-directory (file-name-as-directory
395 (expand-file-name "tutorials" data-directory))))
396
859e15c1 397(defun normal-top-level-add-subdirs-to-load-path ()
0412d833
RS
398 "Add all subdirectories of current directory to `load-path'.
399More precisely, this uses only the subdirectories whose names
f734a13e
DL
400start with letters or digits; it excludes any subdirectory named `RCS'
401or `CVS', and any subdirectory that contains a file named `.nosearch'."
f1180544 402 (let (dirs
95eada65 403 attrs
859e15c1
KH
404 (pending (list default-directory)))
405 ;; This loop does a breadth-first tree walk on DIR's subtree,
406 ;; putting each subdir into DIRS as its contents are examined.
407 (while pending
4e0a3971 408 (push (pop pending) dirs)
722a451d
EZ
409 (let* ((this-dir (car dirs))
410 (contents (directory-files this-dir))
411 (default-directory this-dir)
fcaf7de9
SM
412 (canonicalized (if (fboundp 'untranslated-canonical-name)
413 (untranslated-canonical-name this-dir))))
722a451d
EZ
414 ;; The Windows version doesn't report meaningful inode
415 ;; numbers, so use the canonicalized absolute file name of the
416 ;; directory instead.
417 (setq attrs (or canonicalized
418 (nthcdr 10 (file-attributes this-dir))))
95eada65 419 (unless (member attrs normal-top-level-add-subdirs-inode-list)
4e0a3971
SM
420 (push attrs normal-top-level-add-subdirs-inode-list)
421 (dolist (file contents)
c4a40544 422 ;; The lower-case variants of RCS and CVS are for DOS/Windows.
4e0a3971
SM
423 (unless (member file '("." ".." "RCS" "CVS" "rcs" "cvs"))
424 (when (and (string-match "\\`[[:alnum:]]" file)
9d1fb179
RS
425 ;; Avoid doing a `stat' when it isn't necessary
426 ;; because that can cause trouble when an NFS server
427 ;; is down.
4e0a3971
SM
428 (not (string-match "\\.elc?\\'" file))
429 (file-directory-p file))
430 (let ((expanded (expand-file-name file)))
95eada65
RS
431 (unless (file-exists-p (expand-file-name ".nosearch"
432 expanded))
4e0a3971 433 (setq pending (nconc pending (list expanded)))))))))))
bb15e81a 434 (normal-top-level-add-to-load-path (cdr (nreverse dirs)))))
859e15c1 435
537b6e4e
RS
436;; This function is called from a subdirs.el file.
437;; It assumes that default-directory is the directory
438;; in which the subdirs.el file exists,
439;; and it adds to load-path the subdirs of that directory
440;; as specified in DIRS. Normally the elements of DIRS are relative.
e87a7309 441(defun normal-top-level-add-to-load-path (dirs)
cd1c10f6
RS
442 (let ((tail load-path)
443 (thisdir (directory-file-name default-directory)))
444 (while (and tail
138e541f
GM
445 ;;Don't go all the way to the nil terminator.
446 (cdr tail)
cd1c10f6
RS
447 (not (equal thisdir (car tail)))
448 (not (and (memq system-type '(ms-dos windows-nt))
449 (equal (downcase thisdir) (downcase (car tail))))))
450 (setq tail (cdr tail)))
138e541f
GM
451 ;;Splice the new section in.
452 (when tail
453 (setcdr tail (append (mapcar 'expand-file-name dirs) (cdr tail))))))
e87a7309 454
a726e0d1
JB
455(defun normal-top-level ()
456 (if command-line-processed
457 (message "Back to top level.")
458 (setq command-line-processed t)
8d4c2221 459 (let ((dir default-directory))
fcaf7de9 460 (with-current-buffer "*Messages*"
a1562258
SM
461 ;; Make it easy to do like "tail -f".
462 (set (make-local-variable 'window-point-insertion-type) t)
463 ;; Give *Messages* the same default-directory as *scratch*,
464 ;; just to keep things predictable.
8d4c2221 465 (setq default-directory dir)))
9715399e
MR
466 ;; `user-full-name' is now known; reset its standard-value here.
467 (put 'user-full-name 'standard-value
468 (list (default-value 'user-full-name)))
80d71556
KH
469 ;; For root, preserve owner and group when editing files.
470 (if (equal (user-uid) 0)
471 (setq backup-by-copying-when-mismatch t))
e87a7309
RS
472 ;; Look in each dir in load-path for a subdirs.el file.
473 ;; If we find one, load it, which will add the appropriate subdirs
474 ;; of that dir into load-path,
357438eb
KH
475 ;; Look for a leim-list.el file too. Loading it will register
476 ;; available input methods.
b6666b5f
SM
477 (let ((tail load-path) dir)
478 (while tail
479 (setq dir (car tail))
480 (let ((default-directory dir))
481 (load (expand-file-name "subdirs.el") t t t))
482 (let ((default-directory dir))
483 (load (expand-file-name "leim-list.el") t t t))
484 ;; We don't use a dolist loop and we put this "setq-cdr" command at
485 ;; the end, because the subdirs.el files may add elements to the end
486 ;; of load-path and we want to take it into account.
487 (setq tail (cdr tail))))
7c2fb837
DN
488 ;; If the PWD environment variable isn't accurate, delete it.
489 (let ((pwd (getenv "PWD")))
490 (and (stringp pwd)
491 ;; Use FOO/., so that if FOO is a symlink, file-attributes
492 ;; describes the directory linked to, not FOO itself.
493 (or (equal (file-attributes
494 (concat (file-name-as-directory pwd) "."))
495 (file-attributes
496 (concat (file-name-as-directory default-directory)
497 ".")))
498 (setq process-environment
499 (delete (concat "PWD=" pwd)
500 process-environment)))))
492878e4 501 (setq default-directory (abbreviate-file-name default-directory))
4a0c0061
CY
502 (let ((menubar-bindings-done nil)
503 (old-face-font-rescale-alist face-font-rescale-alist))
6f2c86fa
KH
504 (unwind-protect
505 (command-line)
506 ;; Do this again, in case .emacs defined more abbreviations.
507 (setq default-directory (abbreviate-file-name default-directory))
b3c7c12c
RS
508 ;; Specify the file for recording all the auto save files of this session.
509 ;; This is used by recover-session.
cdee38c3
KH
510 (or auto-save-list-file-name
511 (and auto-save-list-file-prefix
512 (setq auto-save-list-file-name
1f7f78f1
RS
513 ;; Under MS-DOS our PID is almost always reused between
514 ;; Emacs invocations. We need something more unique.
4b33deaa
EZ
515 (cond ((eq system-type 'ms-dos)
516 ;; We are going to access the auto-save
517 ;; directory, so make sure it exists.
518 (make-directory
519 (file-name-directory auto-save-list-file-prefix)
520 t)
f1180544 521 (concat
4b33deaa
EZ
522 (make-temp-name
523 (expand-file-name
524 auto-save-list-file-prefix))
525 "~"))
526 (t
527 (expand-file-name
528 (format "%s%d-%s~"
529 auto-save-list-file-prefix
530 (emacs-pid)
531 (system-name))))))))
deebb0e9
RS
532 (unless inhibit-startup-hooks
533 (run-hooks 'emacs-startup-hook)
534 (and term-setup-hook
535 (run-hooks 'term-setup-hook)))
6a1e7d67
GM
536
537 ;; Don't do this if we failed to create the initial frame,
538 ;; for instance due to a dense colormap.
538ef02a
GM
539 (when (or frame-initial-frame
540 ;; If frame-initial-frame has no meaning, do this anyway.
2246281f 541 (not (and initial-window-system
538ef02a 542 (not noninteractive)
2246281f 543 (not (eq initial-window-system 'pc)))))
4a0c0061
CY
544
545 ;; FIXME: The user's init file may change
546 ;; face-font-rescale-alist. However, the default face
547 ;; already has an assigned font object, which does not take
548 ;; face-font-rescale-alist into account. For such
549 ;; situations, we ought to have a way to find all font
550 ;; objects and regenerate them; currently we do not. As a
551 ;; workaround, we specifically reset te default face's :font
552 ;; attribute here. See bug#1785.
553 (unless (eq face-font-rescale-alist
554 old-face-font-rescale-alist)
555 (set-face-attribute 'default nil :font (font-spec)))
556
6a1e7d67
GM
557 ;; Modify the initial frame based on what .emacs puts into
558 ;; ...-frame-alist.
559 (if (fboundp 'frame-notice-user-settings)
560 (frame-notice-user-settings))
2666355c
KL
561 ;; Set the faces for the initial background mode even if
562 ;; frame-notice-user-settings didn't (such as on a tty).
563 ;; frame-set-background-mode is idempotent, so it won't
564 ;; cause any harm if it's already been done.
6a1e7d67 565 (if (fboundp 'frame-set-background-mode)
2666355c 566 (frame-set-background-mode (selected-frame))))
13ab33c4 567
6f2c86fa
KH
568 ;; Now we know the user's default font, so add it to the menu.
569 (if (fboundp 'font-menu-add-default)
570 (font-menu-add-default))
571 (and window-setup-hook
572 (run-hooks 'window-setup-hook))
573 (or menubar-bindings-done
66c24e1e 574 (if (display-popup-menus-p)
fdb88463
SM
575 (precompute-menubar-bindings)))))
576 ;; Subprocesses of Emacs do not have direct access to the terminal, so
577 ;; unless told otherwise they should only assume a dumb terminal.
578 ;; We are careful to do it late (after term-setup-hook), although the
579 ;; new multi-tty code does not use $TERM any more there anyway.
4bbfda32
SM
580 (setenv "TERM" "dumb")
581 ;; Remove DISPLAY from the process-environment as well. This allows
582 ;; `callproc.c' to give it a useful adaptive default which is either
583 ;; the value of the `display' frame-parameter or the DISPLAY value
584 ;; from initial-environment.
585 (let ((display (frame-parameter nil 'display)))
586 ;; Be careful which DISPLAY to remove from process-environment: follow
587 ;; the logic of `callproc.c'.
588 (if (stringp display) (setq display (concat "DISPLAY=" display))
589 (dolist (varval initial-environment)
590 (if (string-match "\\`DISPLAY=" varval)
591 (setq display varval))))
592 (when display
4bbfda32 593 (delete display process-environment)))))
6f2c86fa
KH
594
595;; Precompute the keyboard equivalents in the menu bar items.
596(defun precompute-menubar-bindings ()
365636dc
RS
597 (let ((submap (lookup-key global-map [menu-bar])))
598 (while submap
599 (and (consp (car submap))
600 (symbolp (car (car submap)))
601 (stringp (car-safe (cdr (car submap))))
602 (keymapp (cdr (cdr (car submap))))
a18042d7
RS
603 (progn
604 (x-popup-menu nil (cdr (cdr (car submap))))
605 (if purify-flag
606 (garbage-collect))))
365636dc 607 (setq submap (cdr submap))))
5b61c6a7 608 (setq define-key-rebound-commands t))
a726e0d1 609
c381f482
EZ
610;; Command-line options supported by tty's:
611(defconst tty-long-option-alist
8957d2bf
EZ
612 '(("--name" . "-name")
613 ("--title" . "-T")
614 ("--reverse-video" . "-reverse")
c381f482 615 ("--foreground-color" . "-fg")
8957d2bf
EZ
616 ("--background-color" . "-bg")
617 ("--color" . "-color")))
c381f482 618
b66b6aeb 619(defconst tool-bar-images-pixel-height 24
eeaa563e 620 "Height in pixels of images in the tool-bar.")
b66b6aeb 621
3a55d3d0
JR
622(defvar tool-bar-originally-present nil
623 "Non-nil if tool-bars are present before user and site init files are read.")
624
e9cda827
KL
625(defvar handle-args-function-alist '((nil . tty-handle-args))
626 "Functions for processing window-system dependent command-line arguments.
627Window system startup files should add their own function to this
628alist, which should parse the command line arguments. Those
629pertaining to the window system should be processed and removed
630from the returned command line.")
631
632(defvar window-system-initialization-alist '((nil . ignore))
633 "Alist of window-system initialization functions.
634Window-system startup files should add their own initialization
635function to this list. The function should take no arguments,
636and initialize the window system environment to prepare for
2bb819d5 637opening the first frame (e.g. open a connection to an X server).")
e9cda827 638
bca8c7be 639;; Handle the X-like command-line arguments "-fg", "-bg", "-name", etc.
c381f482 640(defun tty-handle-args (args)
bca8c7be 641 (let (rest)
ae8bf5ab 642 (message "%S" args)
c381f482
EZ
643 (while (and args
644 (not (equal (car args) "--")))
bca8c7be
MS
645 (let* ((argi (pop args))
646 (orig-argi argi)
647 argval completion)
c381f482
EZ
648 ;; Check for long options with attached arguments
649 ;; and separate out the attached option argument into argval.
bca8c7be
MS
650 (when (string-match "^\\(--[^=]*\\)=" argi)
651 (setq argval (substring argi (match-end 0))
652 argi (match-string 1 argi)))
653 (when (string-match "^--" argi)
654 (setq completion (try-completion argi tty-long-option-alist))
c381f482
EZ
655 (if (eq completion t)
656 ;; Exact match for long option.
bca8c7be 657 (setq argi (cdr (assoc argi tty-long-option-alist)))
c381f482
EZ
658 (if (stringp completion)
659 (let ((elt (assoc completion tty-long-option-alist)))
660 ;; Check for abbreviated long option.
661 (or elt
bca8c7be
MS
662 (error "Option `%s' is ambiguous" argi))
663 (setq argi (cdr elt)))
c381f482 664 ;; Check for a short option.
bca8c7be
MS
665 (setq argval nil
666 argi orig-argi))))
667 (cond ((member argi '("-fg" "-foreground"))
668 (push (cons 'foreground-color (or argval (pop args)))
669 default-frame-alist))
670 ((member argi '("-bg" "-background"))
671 (push (cons 'background-color (or argval (pop args)))
672 default-frame-alist))
673 ((member argi '("-T" "-name"))
674 (unless argval (setq argval (pop args)))
675 (push (cons 'title
676 (if (stringp argval)
677 argval
678 (let ((case-fold-search t)
679 i)
680 (setq argval (invocation-name))
681
682 ;; Change any . or * characters in name to
683 ;; hyphens, so as to emulate behavior on X.
684 (while
685 (setq i (string-match "[.*]" argval))
686 (aset argval i ?-))
687 argval)))
688 default-frame-alist))
689 ((member argi '("-r" "-rv" "-reverse"))
690 (push '(reverse . t)
691 default-frame-alist))
692 ((equal argi "-color")
693 (unless argval (setq argval 8)) ; default --color means 8 ANSI colors
694 (push (cons 'tty-color-mode
695 (cond
696 ((numberp argval) argval)
697 ((string-match "-?[0-9]+" argval)
698 (string-to-number argval))
699 (t (intern argval))))
700 default-frame-alist))
701 (t
702 (push argi rest)))))
703 (nreverse rest)))
c381f482 704
aa360da1
GM
705(declare-function x-get-resource "frame.c"
706 (attribute class &optional component subclass))
707(declare-function tool-bar-mode "tool-bar" (&optional arg))
d2b2930a 708(declare-function tool-bar-setup "tool-bar")
aa360da1 709
4ff029f6 710(defvar server-name)
35f372ca 711(defvar server-process)
4ff029f6 712
a726e0d1 713(defun command-line ()
5c9fad41 714 (setq before-init-time (current-time)
981c5d1d 715 after-init-time nil
238cbdf8 716 command-line-default-directory default-directory)
09a1077c 717
849eedba 718 ;; Choose a reasonable location for temporary files.
a3194d03 719 (custom-reevaluate-setting 'temporary-file-directory)
51db08eb 720 (custom-reevaluate-setting 'small-temporary-file-directory)
a3194d03 721 (custom-reevaluate-setting 'auto-save-file-name-transforms)
849eedba 722
74f2ab06 723 ;; See if we should import version-control from the environment variable.
a726e0d1
JB
724 (let ((vc (getenv "VERSION_CONTROL")))
725 (cond ((eq vc nil)) ;don't do anything if not set
bca8c7be 726 ((member vc '("t" "numbered"))
a726e0d1 727 (setq version-control t))
bca8c7be 728 ((member vc '("nil" "existing"))
a726e0d1 729 (setq version-control nil))
bca8c7be 730 ((member vc '("never" "simple"))
a726e0d1
JB
731 (setq version-control 'never))))
732
79058860
JB
733 ;;! This has been commented out; I currently find the behavior when
734 ;;! split-window-keep-point is nil disturbing, but if I can get used
735 ;;! to it, then it would be better to eliminate the option.
736 ;;! ;; Choose a good default value for split-window-keep-point.
737 ;;! (setq split-window-keep-point (> baud-rate 2400))
f35fe3c6 738
d4308a4d
EZ
739 ;; Set the default strings to display in mode line for
740 ;; end-of-line formats that aren't native to this platform.
741 (cond
742 ((memq system-type '(ms-dos windows-nt emx))
bca8c7be
MS
743 (setq eol-mnemonic-unix "(Unix)"
744 eol-mnemonic-mac "(Mac)"))
bde61f8b
EZ
745 ;; Both Mac and Unix EOLs are now "native" on Mac OS so keep the
746 ;; abbreviated strings `/' and `:' set in coding.c for them.
747 ((eq system-type 'macos)
748 (setq eol-mnemonic-dos "(DOS)"))
bca8c7be
MS
749 (t ; this is for Unix/GNU/Linux systems
750 (setq eol-mnemonic-dos "(DOS)"
751 eol-mnemonic-mac "(Mac)")))
d4308a4d 752
a5b5acaf
EZ
753 ;; Make sure window system's init file was loaded in loadup.el if
754 ;; using a window system.
1ed14cfd 755 (condition-case error
e9cda827
KL
756 (unless noninteractive
757 (if (and initial-window-system
758 (not (featurep
a5b5acaf
EZ
759 (intern
760 (concat (symbol-name initial-window-system) "-win")))))
e9cda827
KL
761 (error "Unsupported window system `%s'" initial-window-system))
762 ;; Process window-system specific command line parameters.
763 (setq command-line-args
a5b5acaf
EZ
764 (funcall
765 (or (cdr (assq initial-window-system handle-args-function-alist))
766 (error "Unsupported window system `%s'" initial-window-system))
767 command-line-args))
e9cda827 768 ;; Initialize the window system. (Open connection, etc.)
a5b5acaf
EZ
769 (funcall
770 (or (cdr (assq initial-window-system window-system-initialization-alist))
771 (error "Unsupported window system `%s'" initial-window-system))))
e9cda827 772 ;; If there was an error, print the error message and exit.
1ed14cfd 773 (error
2677ad61
RS
774 (princ
775 (if (eq (car error) 'error)
776 (apply 'concat (cdr error))
777 (if (memq 'file-error (get (car error) 'error-conditions))
778 (format "%s: %s"
bca8c7be
MS
779 (nth 1 error)
780 (mapconcat (lambda (obj) (prin1-to-string obj t))
781 (cdr (cdr error)) ", "))
2677ad61 782 (format "%s: %s"
bca8c7be
MS
783 (get (car error) 'error-message)
784 (mapconcat (lambda (obj) (prin1-to-string obj t))
785 (cdr error) ", "))))
2677ad61 786 'external-debugging-output)
27f5188c 787 (terpri 'external-debugging-output)
2246281f 788 (setq initial-window-system nil)
1ed14cfd 789 (kill-emacs)))
a726e0d1 790
640a9cdd
JR
791 (set-locale-environment nil)
792
735895f1
EZ
793 ;; Convert preloaded file names in load-history to absolute.
794 (let ((simple-file-name
3b61abfe
EZ
795 ;; Look for simple.el or simple.elc and use their directory
796 ;; as the place where all Lisp files live.
735895f1
EZ
797 (locate-file "simple" load-path (get-load-suffixes)))
798 lisp-dir)
799 ;; Don't abort if simple.el cannot be found, but print a warning.
800 (if (null simple-file-name)
801 (progn
802 (princ "Warning: Could not find simple.el nor simple.elc"
803 'external-debugging-output)
804 (terpri 'external-debugging-output))
805 (setq lisp-dir (file-truename (file-name-directory simple-file-name)))
806 (setq load-history
807 (mapcar (lambda (elt)
808 (if (and (stringp (car elt))
809 (not (file-name-absolute-p (car elt))))
810 (cons (concat lisp-dir
811 (car elt))
812 (cdr elt))
813 elt))
814 load-history))))
4b816985 815
c16eb7b0
RS
816 ;; Convert the arguments to Emacs internal representation.
817 (let ((args (cdr command-line-args)))
818 (while args
819 (setcar args
820 (decode-coding-string (car args) locale-coding-system t))
bca8c7be 821 (pop args)))
c16eb7b0 822
03e3c30a
JB
823 (let ((done nil)
824 (args (cdr command-line-args)))
825
a726e0d1
JB
826 ;; Figure out which user's init file to load,
827 ;; either from the environment or from the options.
828 (setq init-file-user (if noninteractive nil (user-login-name)))
829 ;; If user has not done su, use current $HOME to find .emacs.
bca8c7be
MS
830 (and init-file-user
831 (equal init-file-user (user-real-login-name))
a726e0d1 832 (setq init-file-user ""))
03e3c30a
JB
833
834 ;; Process the command-line args, and delete the arguments
835 ;; processed. This is consistent with the way main in emacs.c
836 ;; does things.
a726e0d1 837 (while (and (not done) args)
9ab281f0
JB
838 (let* ((longopts '(("--no-init-file") ("--no-site-file") ("--debug-init")
839 ("--user") ("--iconic") ("--icon-type") ("--quick")
840 ("--no-blinking-cursor") ("--basic-display")))
bca8c7be
MS
841 (argi (pop args))
842 (orig-argi argi)
843 argval)
452e9090 844 ;; Handle --OPTION=VALUE format.
7b704afe 845 (when (string-match "\\`\\(--[^=]*\\)=" argi)
1b207153 846 (setq argval (substring argi (match-end 0))
bca8c7be 847 argi (match-string 1 argi)))
7b704afe 848 (when (string-match "\\`--." orig-argi)
1b207153
CW
849 (let ((completion (try-completion argi longopts)))
850 (if (eq completion t)
851 (setq argi (substring argi 1))
852 (if (stringp completion)
853 (let ((elt (assoc completion longopts)))
854 (or elt
855 (error "Option `%s' is ambiguous" argi))
856 (setq argi (substring (car elt) 1)))
bca8c7be
MS
857 (setq argval nil
858 argi orig-argi)))))
a726e0d1 859 (cond
dc58296d 860 ((member argi '("-Q" "-quick"))
6b61353c
KH
861 (setq init-file-user nil
862 site-run-file nil
dc58296d
RS
863 emacs-quick-startup t))
864 ((member argi '("-D" "-basic-display"))
865 (setq no-blinking-cursor t
866 emacs-basic-display t)
6b61353c 867 (push '(vertical-scroll-bars . nil) initial-frame-alist))
4e0a3971
SM
868 ((member argi '("-q" "-no-init-file"))
869 (setq init-file-user nil))
870 ((member argi '("-u" "-user"))
bca8c7be 871 (setq init-file-user (or argval (pop args))
4e0a3971 872 argval nil))
bca8c7be 873 ((equal argi "-no-site-file")
4e0a3971 874 (setq site-run-file nil))
bca8c7be 875 ((equal argi "-debug-init")
4e0a3971 876 (setq init-file-debug t))
bca8c7be 877 ((equal argi "-iconic")
4e0a3971 878 (push '(visibility . icon) initial-frame-alist))
bca8c7be 879 ((member argi '("-icon-type" "-i" "-itype"))
4e0a3971 880 (push '(icon-type . t) default-frame-alist))
178b4542
JL
881 ((member argi '("-nbc" "-no-blinking-cursor"))
882 (setq no-blinking-cursor t))
4e0a3971 883 ;; Push the popped arg back on the list of arguments.
bca8c7be
MS
884 (t
885 (push argi args)
886 (setq done t)))
096b7031
KH
887 ;; Was argval set but not used?
888 (and argval
889 (error "Option `%s' doesn't allow an argument" argi))))
890
03e3c30a 891 ;; Re-attach the program name to the front of the arg list.
bca8c7be
MS
892 (and command-line-args
893 (setcdr command-line-args args)))
a726e0d1 894
ce98f555
RS
895 (run-hooks 'before-init-hook)
896
7581ba40
RF
897 ;; Under X Window, this creates the X frame and deletes the terminal frame.
898 (unless (daemonp)
9ba6e7d4 899 (frame-initialize))
14f16b9c 900
ed0fb1f1 901 ;; Turn off blinking cursor if so specified in X resources. This is here
b08cb5a6 902 ;; only because all other settings of no-blinking-cursor are here.
ed0fb1f1
JD
903 (unless (or noninteractive
904 emacs-basic-display
9e2a2647 905 (and (memq window-system '(x w32 ns))
ed0fb1f1
JD
906 (not (member (x-get-resource "cursorBlink" "CursorBlink")
907 '("off" "false")))))
908 (setq no-blinking-cursor t))
909
32f1cc7b
DN
910 ;; If frame was created with a menu bar, set menu-bar-mode on.
911 (unless (or noninteractive
912 emacs-basic-display
913 (and (memq initial-window-system '(x w32))
914 (<= (frame-parameter nil 'menu-bar-lines) 0)))
8ab9589d 915 (menu-bar-mode 1))
c722566c 916
d2b2930a
CY
917 (unless (or noninteractive (not (fboundp 'tool-bar-mode)))
918 ;; Set up the tool-bar. Do this even in tty frames, so that there
919 ;; is a tool-bar if Emacs later opens a graphical frame.
920 (if (or emacs-basic-display
921 (and (numberp (frame-parameter nil 'tool-bar-lines))
922 (<= (frame-parameter nil 'tool-bar-lines) 0)))
923 ;; On a graphical display with the toolbar disabled via X
924 ;; resources, set up the toolbar without enabling it.
925 (tool-bar-setup)
926 ;; Otherwise, enable tool-bar-mode.
927 (tool-bar-mode 1)))
7d1eb6a4 928
3413f928 929 ;; Can't do this init in defcustom because the relevant variables
a3194d03
SM
930 ;; are not set.
931 (custom-reevaluate-setting 'blink-cursor-mode)
dc86f0a9 932 (custom-reevaluate-setting 'tooltip-mode)
c442c26d 933 (custom-reevaluate-setting 'global-font-lock-mode)
97a7dbee
YM
934 (custom-reevaluate-setting 'mouse-wheel-down-event)
935 (custom-reevaluate-setting 'mouse-wheel-up-event)
db441dba 936 (custom-reevaluate-setting 'file-name-shadow-mode)
a496452f 937 (custom-reevaluate-setting 'send-mail-function)
1e2d7573 938 (custom-reevaluate-setting 'focus-follows-mouse)
2cc11fd4 939 (custom-reevaluate-setting 'global-auto-composition-mode)
a2b84f35 940 (custom-reevaluate-setting 'transient-mark-mode)
6f8a4190 941 (custom-reevaluate-setting 'auto-encryption-mode)
3b73087e 942
30a2fded
KL
943 (normal-erase-is-backspace-setup-frame)
944
1592c1ef 945 ;; Register default TTY colors for the case the terminal hasn't a
79c3172f
KL
946 ;; terminal init file. We do this regardles of whether the terminal
947 ;; supports colors or not and regardless the current display type,
948 ;; since users can connect to color-capable terminals and also
949 ;; switch color support on or off in mid-session by setting the
950 ;; tty-color-mode frame parameter.
a5b5acaf
EZ
951 ;; Exception: the `pc' ``window system'' has only 16 fixed colors,
952 ;; and they are already set at this point by a suitable function in
953 ;; window-system-initialization-alist.
954 (or (eq initial-window-system 'pc)
955 (tty-register-default-colors))
1592c1ef 956
3a55d3d0
JR
957 ;; Record whether the tool-bar is present before the user and site
958 ;; init files are processed. frame-notice-user-settings uses this
959 ;; to determine if the tool-bar has been disabled by the init files,
960 ;; and the frame needs to be resized.
961 (when (fboundp 'frame-notice-user-settings)
962 (let ((tool-bar-lines (or (assq 'tool-bar-lines initial-frame-alist)
963 (assq 'tool-bar-lines default-frame-alist))))
964 (setq tool-bar-originally-present
bca8c7be
MS
965 (and tool-bar-lines
966 (cdr tool-bar-lines)
967 (not (eq 0 (cdr tool-bar-lines)))))))
3a55d3d0 968
752ef254
GM
969 (let ((old-scalable-fonts-allowed scalable-fonts-allowed)
970 (old-font-list-limit font-list-limit)
971 (old-face-ignored-fonts face-ignored-fonts))
972
752ef254
GM
973 ;; Run the site-start library if it exists. The point of this file is
974 ;; that it is run before .emacs. There is no point in doing this after
975 ;; .emacs; that is useless.
5f144784
GM
976 ;; Note that user-init-file is nil at this point. Code that might
977 ;; be loaded from site-run-file and wants to test if -q was given
978 ;; should check init-file-user instead, since that is already set.
979 ;; See cus-edit.el for an example.
f1180544 980 (if site-run-file
752ef254
GM
981 (load site-run-file t t))
982
983 ;; Sites should not disable this. Only individuals should disable
1cff9ad1
JL
984 ;; the startup screen.
985 (setq inhibit-startup-screen nil)
752ef254 986
f963ea40 987 ;; Warn for invalid user name.
ce98f555
RS
988 (when init-file-user
989 (if (string-match "[~/:\n]" init-file-user)
990 (display-warning 'initialization
991 (format "Invalid user name %s"
992 init-file-user)
993 :error)
1df1e49e 994 (if (file-directory-p (expand-file-name
5463218c
EZ
995 ;; We don't support ~USER on MS-Windows
996 ;; and MS-DOS except for the current
997 ;; user, and always load .emacs from
998 ;; the current user's home directory
999 ;; (see below). So always check "~",
1000 ;; even if invoked with "-u USER", or
1001 ;; if $USER or $LOGNAME are set to
1002 ;; something different.
1003 (if (memq system-type '(windows-nt ms-dos))
1df1e49e
EZ
1004 "~"
1005 (concat "~" init-file-user))))
ce98f555
RS
1006 nil
1007 (display-warning 'initialization
1008 (format "User %s has no home directory"
1009 init-file-user)
1010 :error))))
f963ea40 1011
752ef254
GM
1012 ;; Load that user's init file, or the default one, or none.
1013 (let (debug-on-error-from-init-file
1014 debug-on-error-should-be-set
1015 (debug-on-error-initial
1016 (if (eq init-file-debug t) 'startup init-file-debug))
1017 (orig-enable-multibyte default-enable-multibyte-characters))
1018 (let ((debug-on-error debug-on-error-initial)
1019 ;; This function actually reads the init files.
1020 (inner
1021 (function
1022 (lambda ()
1023 (if init-file-user
1024 (let ((user-init-file-1
4e0a3971 1025 (cond
752ef254
GM
1026 ((eq system-type 'ms-dos)
1027 (concat "~" init-file-user "/_emacs"))
1028 ((eq system-type 'windows-nt)
fe7ecaf2 1029 ;; Prefer .emacs on Windows.
752ef254
GM
1030 (if (directory-files "~" nil "^\\.emacs\\(\\.elc?\\)?$")
1031 "~/.emacs"
fe7ecaf2
JR
1032 ;; Also support _emacs for compatibility.
1033 (if (directory-files "~" nil "^_emacs\\(\\.elc?\\)?$")
1034 "~/_emacs"
1035 ;; But default to .emacs if _emacs does not exist.
1036 "~/.emacs")))
4e0a3971 1037 (t
752ef254
GM
1038 (concat "~" init-file-user "/.emacs")))))
1039 ;; This tells `load' to store the file name found
1040 ;; into user-init-file.
1041 (setq user-init-file t)
1042 (load user-init-file-1 t t)
f1180544 1043
a04d5983
RS
1044 (when (eq user-init-file t)
1045 ;; If we did not find ~/.emacs, try
c3ab3701 1046 ;; ~/.emacs.d/init.el.
a04d5983
RS
1047 (let ((otherfile
1048 (expand-file-name
c3ab3701 1049 "init"
a04d5983 1050 (file-name-as-directory
c3ab3701 1051 (concat "~" init-file-user "/.emacs.d")))))
a04d5983
RS
1052 (load otherfile t t)
1053
1054 ;; If we did not find the user's init file,
1055 ;; set user-init-file conclusively.
1056 ;; Don't let it be set from default.el.
1057 (when (eq user-init-file t)
1058 (setq user-init-file user-init-file-1))))
f1180544 1059
752ef254
GM
1060 ;; If we loaded a compiled file, set
1061 ;; `user-init-file' to the source version if that
1062 ;; exists.
1063 (when (and user-init-file
1064 (equal (file-name-extension user-init-file)
1065 "elc"))
1066 (let* ((source (file-name-sans-extension user-init-file))
1067 (alt (concat source ".el")))
1068 (setq source (cond ((file-exists-p alt) alt)
1069 ((file-exists-p source) source)
1070 (t nil)))
1071 (when source
1072 (when (file-newer-than-file-p source user-init-file)
1073 (message "Warning: %s is newer than %s"
1074 source user-init-file)
1075 (sit-for 1))
1076 (setq user-init-file source))))
f1180544 1077
bca8c7be 1078 (unless inhibit-default-init
1cff9ad1 1079 (let ((inhibit-startup-screen nil))
bca8c7be
MS
1080 ;; Users are supposed to be told their rights.
1081 ;; (Plus how to get help and how to undo.)
1082 ;; Don't you dare turn this off for anyone
1083 ;; except yourself.
1084 (load "default" t t)))))))))
752ef254
GM
1085 (if init-file-debug
1086 ;; Do this without a condition-case if the user wants to debug.
1087 (funcall inner)
1088 (condition-case error
1089 (progn
1090 (funcall inner)
1091 (setq init-file-had-error nil))
1092 (error
f2602864
CY
1093 (display-warning
1094 'initialization
1095 (format "An error occurred while loading `%s':\n\n%s%s%s\n\n\
1096To ensure normal operation, you should investigate and remove the
1097cause of the error in your initialization file. Start Emacs with
1098the `--debug-init' option to view a complete error backtrace."
1099 user-init-file
1100 (get (car error) 'error-message)
1101 (if (cdr error) ": " "")
1102 (mapconcat (lambda (s) (prin1-to-string s t)) (cdr error) ", "))
1103 :warning)
1104 (setq init-file-had-error t))))
1105
1106 (if (and deactivate-mark transient-mark-mode)
9c8b2150
RS
1107 (with-current-buffer (window-buffer)
1108 (deactivate-mark)))
1109
d5bd2558
GM
1110 ;; If the user has a file of abbrevs, read it (unless -batch).
1111 (when (and (not noninteractive)
1112 (file-exists-p abbrev-file-name)
2863a9be 1113 (file-readable-p abbrev-file-name))
ac3186fd
RS
1114 (quietly-read-abbrev-file abbrev-file-name))
1115
70b199c3
RS
1116 ;; If the abbrevs came entirely from the init file or the
1117 ;; abbrevs file, they do not need saving.
1118 (setq abbrevs-changed nil)
1119
752ef254
GM
1120 ;; If we can tell that the init file altered debug-on-error,
1121 ;; arrange to preserve the value that it set up.
1122 (or (eq debug-on-error debug-on-error-initial)
1123 (setq debug-on-error-should-be-set t
1124 debug-on-error-from-init-file debug-on-error)))
1125 (if debug-on-error-should-be-set
1126 (setq debug-on-error debug-on-error-from-init-file))
1127 (unless (or default-enable-multibyte-characters
1128 (eq orig-enable-multibyte default-enable-multibyte-characters))
1129 ;; Init file changed to unibyte. Reset existing multibyte
1130 ;; buffers (probably *scratch*, *Messages*, *Minibuff-0*).
1131 ;; Arguably this should only be done if they're free of
1132 ;; multibyte characters.
e18c18e8
JB
1133 (mapc (lambda (buffer)
1134 (with-current-buffer buffer
1135 (if enable-multibyte-characters
1136 (set-buffer-multibyte nil))))
1137 (buffer-list))
752ef254
GM
1138 ;; Also re-set the language environment in case it was
1139 ;; originally done before unibyte was set and is sensitive to
1140 ;; unibyte (display table, terminal coding system &c).
1141 (set-language-environment current-language-environment)))
f1180544 1142
752ef254 1143 ;; Do this here in case the init file sets mail-host-address.
5b88a2c5 1144 (if (equal user-mail-address "")
cee0c996
EZ
1145 (setq user-mail-address (or (getenv "EMAIL")
1146 (concat (user-login-name) "@"
1147 (or mail-host-address
1148 (system-name))))))
752ef254 1149
d60b49ac
DN
1150 ;; Originally face attributes were specified via
1151 ;; `font-lock-face-attributes'. Users then changed the default
1152 ;; face attributes by setting that variable. However, we try and
1153 ;; be back-compatible and respect its value if set except for
1154 ;; faces where M-x customize has been used to save changes for the
1155 ;; face.
1156 (when (boundp 'font-lock-face-attributes)
1157 (let ((face-attributes font-lock-face-attributes))
1158 (while face-attributes
1159 (let* ((face-attribute (pop face-attributes))
1160 (face (car face-attribute)))
1161 ;; Rustle up a `defface' SPEC from a
1162 ;; `font-lock-face-attributes' entry.
1163 (unless (get face 'saved-face)
1164 (let ((foreground (nth 1 face-attribute))
1165 (background (nth 2 face-attribute))
1166 (bold-p (nth 3 face-attribute))
1167 (italic-p (nth 4 face-attribute))
1168 (underline-p (nth 5 face-attribute))
1169 face-spec)
1170 (when foreground
1171 (setq face-spec (cons ':foreground (cons foreground face-spec))))
1172 (when background
1173 (setq face-spec (cons ':background (cons background face-spec))))
1174 (when bold-p
1175 (setq face-spec (append '(:weight bold) face-spec)))
1176 (when italic-p
1177 (setq face-spec (append '(:slant italic) face-spec)))
1178 (when underline-p
1179 (setq face-spec (append '(:underline t) face-spec)))
1180 (face-spec-set face (list (list t face-spec)) nil)))))))
1181
752ef254
GM
1182 ;; If parameter have been changed in the init file which influence
1183 ;; face realization, clear the face cache so that new faces will
1184 ;; be realized.
1185 (unless (and (eq scalable-fonts-allowed old-scalable-fonts-allowed)
1186 (eq font-list-limit old-font-list-limit)
1187 (eq face-ignored-fonts old-face-ignored-fonts))
1188 (clear-face-cache)))
f1180544 1189
5ab0e67e 1190 (setq after-init-time (current-time))
e3bd99f5
RM
1191 (run-hooks 'after-init-hook)
1192
1fc67c11 1193 ;; Decode all default-directory.
cea927ed
KH
1194 (if (and default-enable-multibyte-characters locale-coding-system)
1195 (save-excursion
1196 (dolist (elt (buffer-list))
1197 (set-buffer elt)
1198 (if default-directory
1199 (setq default-directory
1200 (decode-coding-string default-directory
1201 locale-coding-system t))))
1202 (setq command-line-default-directory
1203 (decode-coding-string command-line-default-directory
1204 locale-coding-system t))))
1205
a726e0d1
JB
1206 ;; If *scratch* exists and init file didn't change its mode, initialize it.
1207 (if (get-buffer "*scratch*")
694210c4 1208 (with-current-buffer "*scratch*"
a726e0d1 1209 (if (eq major-mode 'fundamental-mode)
26cdce23 1210 (funcall initial-major-mode))))
f1180544 1211
a726e0d1
JB
1212 ;; Load library for our terminal type.
1213 ;; User init file can set term-file-prefix to nil to prevent this.
bca8c7be 1214 (unless (or noninteractive
cd85984a
KL
1215 initial-window-system)
1216 (tty-run-terminal-initialization (selected-frame)))
a726e0d1 1217
5777a167
RS
1218 ;; Update the out-of-memory error message based on user's key bindings
1219 ;; for save-some-buffers.
1220 (setq memory-signal-data
1221 (list 'error
1222 (substitute-command-keys "Memory exhausted--use \\[save-some-buffers] then exit and restart Emacs")))
1223
03e3c30a 1224 ;; Process the remaining args.
a726e0d1
JB
1225 (command-line-1 (cdr command-line-args))
1226
1227 ;; If -batch, terminate after processing the command options.
ca57f55d
JD
1228 (if noninteractive (kill-emacs t))
1229
7581ba40
RF
1230 ;; In daemon mode, start the server to allow clients to connect.
1231 ;; This is done after loading the user's init file and after
1232 ;; processing all command line arguments to allow e.g. `server-name'
1233 ;; to be changed before the server starts.
4ff029f6
DN
1234 (let ((dn (daemonp)))
1235 (when dn
1236 (when (stringp dn) (setq server-name dn))
1237 (server-start)
35f372ca
JB
1238 (if server-process
1239 (daemon-initialized)
fd95644b
DN
1240 (if (stringp dn)
1241 (message
1242 "Unable to start daemon: Emacs server named %S already running"
1243 server-name)
1244 (message "Unable to start the daemon.\nAnother instance of Emacs is running the server, either as daemon or interactively.\nYou can use emacsclient to connect to that Emacs process."))
35f372ca 1245 (kill-emacs 1))))
7581ba40 1246
ca57f55d
JD
1247 ;; Run emacs-session-restore (session management) if started by
1248 ;; the session manager and we have a session manager connection.
bca8c7be
MS
1249 (if (and (boundp 'x-session-previous-id)
1250 (stringp x-session-previous-id))
a99df87d
RS
1251 (with-no-warnings
1252 (emacs-session-restore x-session-previous-id))))
a726e0d1 1253
46cfd295 1254(defcustom initial-scratch-message (purecopy "\
3b79c219
GM
1255;; This buffer is for notes you don't want to save, and for Lisp evaluation.
1256;; If you want to create a file, visit that file with C-x C-f,
1257;; then enter the text in that file's own buffer.
9fe3219e 1258
46cfd295 1259")
9fe3219e 1260 "Initial message displayed in *scratch* buffer at startup.
9bc6f805 1261If this is nil, no message will be displayed."
fa071a47
RS
1262 :type '(choice (text :tag "Message")
1263 (const :tag "none" nil))
1264 :group 'initialization)
9fe3219e 1265
ce9ded5d
GM
1266\f
1267;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1268;;; Fancy splash screen
1269;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
1270
fad930b6 1271(defvar fancy-startup-text
422abbfd 1272 '((:face (variable-pitch (:foreground "red"))
22a58255 1273 "Welcome to "
6e0cfad3
JL
1274 :link ("GNU Emacs"
1275 (lambda (button) (browse-url "http://www.gnu.org/software/emacs/"))
1276 "Browse http://www.gnu.org/software/emacs/")
22a58255
CY
1277 ", one component of the "
1278 :link
1279 (lambda ()
1280 (if (eq system-type 'gnu/linux)
6e0cfad3
JL
1281 '("GNU/Linux"
1282 (lambda (button) (browse-url "http://www.gnu.org/gnu/linux-and-gnu.html"))
1283 "Browse http://www.gnu.org/gnu/linux-and-gnu.html")
92b2e7a3 1284 '("GNU" (lambda (button) (describe-gnu-project))
6e0cfad3 1285 "Display info on the GNU project")))
bb398779 1286 " operating system.\n\n"
ca267291 1287 :face variable-pitch
fad930b6 1288 :link ("Emacs Tutorial" (lambda (button) (help-with-tutorial)))
22a58255 1289 "\tLearn basic keystroke commands"
fad930b6
RS
1290 (lambda ()
1291 (let* ((en "TUTORIAL")
1292 (tut (or (get-language-info current-language-environment
1293 'tutorial)
1294 en))
1295 (title (with-temp-buffer
1296 (insert-file-contents
1297 (expand-file-name tut tutorial-directory)
1298 nil 0 256)
1299 (search-forward ".")
1300 (buffer-substring (point-min) (1- (point))))))
1301 ;; If there is a specific tutorial for the current language
1302 ;; environment and it is not English, append its title.
1303 (if (string= en tut)
1304 ""
1305 (concat " (" title ")"))))
1306 "\n"
fad930b6 1307 :link ("Emacs Guided Tour"
6e0cfad3
JL
1308 (lambda (button) (browse-url "http://www.gnu.org/software/emacs/tour/"))
1309 "Browse http://www.gnu.org/software/emacs/tour/")
bb398779 1310 "\tOverview of Emacs features at gnu.org\n"
490a1ad6
JL
1311 :link ("View Emacs Manual" (lambda (button) (info-emacs-manual)))
1312 "\tView the Emacs manual using Info\n"
fad930b6
RS
1313 :link ("Absence of Warranty" (lambda (button) (describe-no-warranty)))
1314 "\tGNU Emacs comes with "
422abbfd 1315 :face (variable-pitch (:slant oblique))
fad930b6
RS
1316 "ABSOLUTELY NO WARRANTY\n"
1317 :face variable-pitch
1318 :link ("Copying Conditions" (lambda (button) (describe-copying)))
1319 "\tConditions for redistributing and changing Emacs\n"
22a58255
CY
1320 :link ("Ordering Manuals" (lambda (button) (view-order-manuals)))
1321 "\tPurchasing printed copies of manuals\n"
fad930b6 1322 "\n"))
ce9ded5d
GM
1323 "A list of texts to show in the middle part of splash screens.
1324Each element in the list should be a list of strings or pairs
1325`:face FACE', like `fancy-splash-insert' accepts them.")
1326
1d865f15 1327(defvar fancy-about-text
422abbfd 1328 '((:face (variable-pitch (:foreground "red"))
22a58255 1329 "This is "
6e0cfad3
JL
1330 :link ("GNU Emacs"
1331 (lambda (button) (browse-url "http://www.gnu.org/software/emacs/"))
1332 "Browse http://www.gnu.org/software/emacs/")
22a58255
CY
1333 ", one component of the "
1334 :link
1335 (lambda ()
1336 (if (eq system-type 'gnu/linux)
6e0cfad3
JL
1337 '("GNU/Linux"
1338 (lambda (button) (browse-url "http://www.gnu.org/gnu/linux-and-gnu.html"))
1339 "Browse http://www.gnu.org/gnu/linux-and-gnu.html")
92b2e7a3 1340 '("GNU" (lambda (button) (describe-gnu-project))
6e0cfad3 1341 "Display info on the GNU project.")))
22a58255 1342 " operating system.\n"
34acda03 1343 :face (lambda ()
422abbfd
RS
1344 (list 'variable-pitch
1345 (list :foreground
1346 (if (eq (frame-parameter nil 'background-mode) 'dark)
1347 "cyan" "darkblue"))))
22a58255
CY
1348 "\n"
1349 (lambda () (emacs-version))
1350 "\n"
245a7698 1351 :face (variable-pitch (:height 0.8))
22a58255
CY
1352 (lambda () emacs-copyright)
1353 "\n\n"
1354 :face variable-pitch
490a1ad6
JL
1355 :link ("Authors"
1356 (lambda (button)
1357 (view-file (expand-file-name "AUTHORS" data-directory))
1358 (goto-char (point-min))))
1359 "\tMany people have contributed code included in GNU Emacs\n"
1360 :link ("Contributing"
1361 (lambda (button)
1362 (view-file (expand-file-name "CONTRIBUTE" data-directory))
1363 (goto-char (point-min))))
1364 "\tHow to contribute improvements to Emacs\n"
1365 "\n"
92b2e7a3 1366 :link ("GNU and Freedom" (lambda (button) (describe-gnu-project)))
fad930b6
RS
1367 "\tWhy we developed GNU Emacs, and the GNU operating system\n"
1368 :link ("Absence of Warranty" (lambda (button) (describe-no-warranty)))
1369 "\tGNU Emacs comes with "
422abbfd 1370 :face (variable-pitch (:slant oblique))
fad930b6
RS
1371 "ABSOLUTELY NO WARRANTY\n"
1372 :face variable-pitch
1373 :link ("Copying Conditions" (lambda (button) (describe-copying)))
1374 "\tConditions for redistributing and changing Emacs\n"
1375 :link ("Getting New Versions" (lambda (button) (describe-distribution)))
1376 "\tHow to obtain the latest version of Emacs\n"
1cff9ad1
JL
1377 :link ("Ordering Manuals" (lambda (button) (view-order-manuals)))
1378 "\tBuying printed manuals from the FSF\n"
fad930b6
RS
1379 "\n"
1380 :link ("Emacs Tutorial" (lambda (button) (help-with-tutorial)))
1381 "\tLearn basic Emacs keystroke commands"
1382 (lambda ()
1383 (let* ((en "TUTORIAL")
1384 (tut (or (get-language-info current-language-environment
1385 'tutorial)
1386 en))
1387 (title (with-temp-buffer
1388 (insert-file-contents
1389 (expand-file-name tut tutorial-directory)
1390 nil 0 256)
1391 (search-forward ".")
1392 (buffer-substring (point-min) (1- (point))))))
1393 ;; If there is a specific tutorial for the current language
1394 ;; environment and it is not English, append its title.
1395 (if (string= en tut)
1396 ""
1397 (concat " (" title ")"))))
1398 "\n"
1399 :link ("Emacs Guided Tour"
6e0cfad3
JL
1400 (lambda (button) (browse-url "http://www.gnu.org/software/emacs/tour/"))
1401 "Browse http://www.gnu.org/software/emacs/tour/")
fad930b6
RS
1402 "\tSee an overview of the many facilities of GNU Emacs"
1403 ))
1d865f15
JL
1404 "A list of texts to show in the middle part of the About screen.
1405Each element in the list should be a list of strings or pairs
1406`:face FACE', like `fancy-splash-insert' accepts them.")
1407
ce9ded5d 1408
fb275c02 1409(defgroup fancy-splash-screen ()
a01bb1db 1410 "Fancy splash screen when Emacs starts."
fb275c02 1411 :version "21.1"
a01bb1db
GM
1412 :group 'initialization)
1413
8ad8561b 1414(defcustom fancy-splash-image nil
ea6c930a 1415 "The image to show in the splash screens, or nil for defaults."
a01bb1db 1416 :group 'fancy-splash-screen
8ad8561b
GM
1417 :type '(choice (const :tag "Default" nil)
1418 (file :tag "File")))
ce9ded5d
GM
1419
1420
aeb6faec 1421(defvar splash-screen-keymap
26cdce23
JL
1422 (let ((map (make-sparse-keymap)))
1423 (suppress-keymap map)
1424 (set-keymap-parent map button-buffer-map)
aeb6faec
JL
1425 (define-key map "\C-?" 'scroll-down)
1426 (define-key map " " 'scroll-up)
1427 (define-key map "q" 'exit-splash-screen)
26cdce23
JL
1428 map)
1429 "Keymap for splash screen buffer.")
1430
f645586f
GM
1431;; These are temporary storage areas for the splash screen display.
1432
ce9ded5d
GM
1433(defun fancy-splash-insert (&rest args)
1434 "Insert text into the current buffer, with faces.
22a58255
CY
1435Arguments from ARGS should be either strings; functions called
1436with no args that return a string; pairs `:face FACE', where FACE
1437is a face specification usable with `put-text-property'; or pairs
1438`:link LINK' where LINK is a list of arguments to pass to
6e0cfad3
JL
1439`insert-button', of the form (LABEL ACTION [HELP-ECHO]), which
1440specifies the button's label, `action' property and help-echo string.
1441FACE and LINK can also be functions, which are evaluated to obtain
1442a face or button specification."
ce9ded5d
GM
1443 (let ((current-face nil))
1444 (while args
26cdce23 1445 (cond ((eq (car args) :face)
22a58255
CY
1446 (setq args (cdr args) current-face (car args))
1447 (if (functionp current-face)
1448 (setq current-face (funcall current-face))))
26cdce23
JL
1449 ((eq (car args) :link)
1450 (setq args (cdr args))
1451 (let ((spec (car args)))
22a58255
CY
1452 (if (functionp spec)
1453 (setq spec (funcall spec)))
26cdce23
JL
1454 (insert-button (car spec)
1455 'face (list 'link current-face)
1456 'action (cadr spec)
6e0cfad3
JL
1457 'help-echo (concat "mouse-2, RET: "
1458 (or (nth 2 spec)
1459 "Follow this link"))
26cdce23
JL
1460 'follow-link t)))
1461 (t (insert (propertize (let ((it (car args)))
1462 (if (functionp it)
1463 (funcall it)
1464 it))
1465 'face current-face
d4a629de 1466 'help-echo (startup-echo-area-message)))))
ce9ded5d
GM
1467 (setq args (cdr args)))))
1468
aa360da1 1469(declare-function image-size "image.c" (spec &optional pixels frame))
ce9ded5d
GM
1470
1471(defun fancy-splash-head ()
1472 "Insert the head part of the splash screen into the current buffer."
51e8cfdd
GM
1473 (let* ((image-file (cond ((stringp fancy-splash-image)
1474 fancy-splash-image)
68548459 1475 ((display-color-p)
555b0992
JB
1476 (cond ((<= (display-planes) 8)
1477 (if (image-type-available-p 'xpm)
1478 "splash.xpm"
1479 "splash.pbm"))
1480 ((image-type-available-p 'svg)
68548459
JB
1481 "splash.svg")
1482 ((image-type-available-p 'png)
1483 "splash.png")
1484 ((image-type-available-p 'xpm)
555b0992
JB
1485 "splash.xpm")
1486 (t "splash.pbm")))
68548459 1487 (t "splash.pbm")))
51e8cfdd 1488 (img (create-image image-file))
ce9ded5d
GM
1489 (image-width (and img (car (image-size img))))
1490 (window-width (window-width (selected-window))))
1491 (when img
1492 (when (> window-width image-width)
f645586f 1493 ;; Center the image in the window.
6b61353c
KH
1494 (insert (propertize " " 'display
1495 `(space :align-to (+ center (-0.5 . ,img)))))
f645586f 1496
e7f3afa9
MB
1497 ;; Change the color of the XPM version of the splash image
1498 ;; so that it is visible with a dark frame background.
1499 (when (and (memq 'xpm img)
1500 (eq (frame-parameter nil 'background-mode) 'dark))
1501 (setq img (append img '(:color-symbols (("#000000" . "gray30"))))))
1502
aeb6faec
JL
1503 ;; Insert the image with a help-echo and a link.
1504 (make-button (prog1 (point) (insert-image img)) (point)
1505 'face 'default
6e0cfad3 1506 'help-echo "mouse-2, RET: Browse http://www.gnu.org/"
aeb6faec
JL
1507 'action (lambda (button) (browse-url "http://www.gnu.org/"))
1508 'follow-link t)
22a58255
CY
1509 (insert "\n\n")))))
1510
1cff9ad1 1511(defun fancy-startup-tail (&optional concise)
ce9ded5d 1512 "Insert the tail part of the splash screen into the current buffer."
95fadcca
GM
1513 (let ((fg (if (eq (frame-parameter nil 'background-mode) 'dark)
1514 "cyan" "darkblue")))
1cff9ad1
JL
1515 (unless concise
1516 (fancy-splash-insert
1517 :face 'variable-pitch
1518 "\nTo start... "
1519 :link '("Open a File"
6e0cfad3
JL
1520 (lambda (button) (call-interactively 'find-file))
1521 "Specify a new file's name, to edit the file")
1cff9ad1
JL
1522 " "
1523 :link '("Open Home Directory"
6e0cfad3
JL
1524 (lambda (button) (dired "~"))
1525 "Open your home directory, to operate on its files")
1cff9ad1
JL
1526 " "
1527 :link '("Customize Startup"
6e0cfad3
JL
1528 (lambda (button) (customize-group 'initialization))
1529 "Change initialization settings including this screen")
1cff9ad1 1530 "\n"))
bb398779
JL
1531 (fancy-splash-insert
1532 :face 'variable-pitch "To quit a partially entered command, type "
1533 :face 'default "Control-g"
1534 :face 'variable-pitch ".\n")
422abbfd 1535 (fancy-splash-insert :face `(variable-pitch (:foreground ,fg))
95fadcca
GM
1536 "\nThis is "
1537 (emacs-version)
1538 "\n"
245a7698 1539 :face '(variable-pitch (:height 0.8))
22a58255
CY
1540 emacs-copyright
1541 "\n")
ed638cc9
RS
1542 (and auto-save-list-file-prefix
1543 ;; Don't signal an error if the
1544 ;; directory for auto-save-list files
1545 ;; does not yet exist.
1546 (file-directory-p (file-name-directory
1547 auto-save-list-file-prefix))
1548 (directory-files
1549 (file-name-directory auto-save-list-file-prefix)
1550 nil
1551 (concat "\\`"
1552 (regexp-quote (file-name-nondirectory
1553 auto-save-list-file-prefix)))
1554 t)
422abbfd 1555 (fancy-splash-insert :face '(variable-pitch (:foreground "red"))
1d865f15 1556 "\nIf an Emacs session crashed recently, "
5b309ebf
RS
1557 "type "
1558 :face '(fixed-pitch :foreground "red")
1559 "Meta-x recover-session RET"
422abbfd 1560 :face '(variable-pitch (:foreground "red"))
5b309ebf 1561 "\nto recover"
22a58255
CY
1562 " the files you were editing."))
1563
1cff9ad1
JL
1564 (when concise
1565 (fancy-splash-insert
3d9d55e6 1566 :face 'variable-pitch "\n"
09723615
JL
1567 :link '("Dismiss this startup screen"
1568 (lambda (button)
1569 (when startup-screen-inhibit-startup-screen
1570 (customize-set-variable 'inhibit-startup-screen t)
1571 (customize-mark-to-save 'inhibit-startup-screen)
1572 (custom-save-all))
1573 (let ((w (get-buffer-window "*GNU Emacs*")))
1574 (and w (not (one-window-p)) (delete-window w)))
1575 (kill-buffer "*GNU Emacs*")))
1cff9ad1
JL
1576 " ")
1577 (when (or user-init-file custom-file)
1578 (let ((checked (create-image "\300\300\141\143\067\076\034\030"
22a58255 1579 'xbm t :width 8 :height 8 :background "grey75"
1cff9ad1
JL
1580 :foreground "black" :relief -2 :ascent 'center))
1581 (unchecked (create-image (make-string 8 0)
1582 'xbm t :width 8 :height 8 :background "grey75"
1583 :foreground "black" :relief -2 :ascent 'center)))
1584 (insert-button
1585 " " :on-glyph checked :off-glyph unchecked 'checked nil
1586 'display unchecked 'follow-link t
1587 'action (lambda (button)
1588 (if (overlay-get button 'checked)
1589 (progn (overlay-put button 'checked nil)
1590 (overlay-put button 'display (overlay-get button :off-glyph))
1591 (setq startup-screen-inhibit-startup-screen nil))
1592 (overlay-put button 'checked t)
1593 (overlay-put button 'display (overlay-get button :on-glyph))
1594 (setq startup-screen-inhibit-startup-screen t)))))
422abbfd 1595 (fancy-splash-insert :face '(variable-pitch (:height 0.9))
09723615 1596 " Never show it again.")))))
f645586f 1597
aeb6faec 1598(defun exit-splash-screen ()
26cdce23 1599 "Stop displaying the splash screen buffer."
f645586f 1600 (interactive)
1d865f15
JL
1601 (quit-window t))
1602
1cff9ad1 1603(defun fancy-startup-screen (&optional concise)
22a58255 1604 "Display fancy startup screen.
1cff9ad1
JL
1605If CONCISE is non-nil, display a concise version of the
1606splash screen in another window."
3d9d55e6 1607 (let ((splash-buffer (get-buffer-create "*GNU Emacs*")))
09723615 1608 (with-current-buffer splash-buffer
3d9d55e6
CY
1609 (let ((inhibit-read-only t))
1610 (erase-buffer)
4222d0a4 1611 (setq default-directory command-line-default-directory)
3d9d55e6
CY
1612 (make-local-variable 'startup-screen-inhibit-startup-screen)
1613 (if pure-space-overflow
1614 (insert pure-space-overflow-message))
1615 (unless concise
1616 (fancy-splash-head))
1617 (dolist (text fancy-startup-text)
1618 (apply #'fancy-splash-insert text)
1619 (insert "\n"))
1620 (skip-chars-backward "\n")
1621 (delete-region (point) (point-max))
1622 (insert "\n")
1623 (fancy-startup-tail concise))
1624 (use-local-map splash-screen-keymap)
1625 (setq tab-width 22
1626 buffer-read-only t)
1627 (set-buffer-modified-p nil)
1628 (if (and view-read-only (not view-mode))
1629 (view-mode-enter nil 'kill-buffer))
09723615
JL
1630 (goto-char (point-min))
1631 (forward-line (if concise 2 4)))
3d9d55e6
CY
1632 (if concise
1633 (progn
1634 (display-buffer splash-buffer)
1635 ;; If the splash screen is in a split window, fit it.
1636 (let ((window (get-buffer-window splash-buffer t)))
1637 (or (null window)
1638 (eq window (selected-window))
1639 (eq window (next-window window))
1640 (fit-window-to-buffer window))))
1641 (switch-to-buffer splash-buffer))))
22a58255
CY
1642
1643(defun fancy-about-screen ()
1644 "Display fancy About screen."
1645 (let ((frame (fancy-splash-frame)))
1646 (save-selected-window
1647 (select-frame frame)
1648 (switch-to-buffer "*About GNU Emacs*")
1649 (setq buffer-undo-list t
1650 mode-line-format (propertize "---- %b %-"
1651 'face 'mode-line-buffer-id))
1652 (let ((inhibit-read-only t))
1653 (erase-buffer)
1654 (if pure-space-overflow
1655 (insert pure-space-overflow-message))
1656 (fancy-splash-head)
1657 (dolist (text fancy-about-text)
1658 (apply #'fancy-splash-insert text)
1659 (insert "\n"))
22a58255
CY
1660 (set-buffer-modified-p nil)
1661 (goto-char (point-min))
1662 (force-mode-line-update))
aeb6faec 1663 (use-local-map splash-screen-keymap)
cb3fe757 1664 (setq tab-width 22)
22a58255 1665 (message "%s" (startup-echo-area-message))
08326816 1666 (setq buffer-read-only t)
09723615
JL
1667 (goto-char (point-min))
1668 (forward-line 3))))
6b20fb8e
RS
1669
1670(defun fancy-splash-frame ()
1671 "Return the frame to use for the fancy splash screen.
1672Returning non-nil does not mean we should necessarily
1673use the fancy splash screen, but if we do use it,
1674we put it on this frame."
1675 (let (chosen-frame)
3a321ddb 1676 (dolist (frame (append (frame-list) (list (selected-frame))))
6b20fb8e
RS
1677 (if (and (frame-visible-p frame)
1678 (not (window-minibuffer-p (frame-selected-window frame))))
1679 (setq chosen-frame frame)))
1680 chosen-frame))
f645586f 1681
285991dc
GM
1682(defun use-fancy-splash-screens-p ()
1683 "Return t if fancy splash screens should be used."
6b61353c
KH
1684 (when (and (display-graphic-p)
1685 (or (and (display-color-p)
285991dc 1686 (image-type-available-p 'xpm))
6b61353c 1687 (image-type-available-p 'pbm)))
16d2fae9
JPW
1688 (let ((frame (fancy-splash-frame)))
1689 (when frame
1690 (let* ((img (create-image (or fancy-splash-image
1691 (if (and (display-color-p)
1692 (image-type-available-p 'xpm))
1693 "splash.xpm" "splash.pbm"))))
a68ccb40
RS
1694 (image-height (and img (cdr (image-size img nil frame))))
1695 ;; We test frame-height so that, if the frame is split
1696 ;; by displaying a warning, that doesn't cause the normal
1697 ;; splash screen to be used.
1698 (frame-height (1- (frame-height frame))))
1699 (> frame-height (+ image-height 19)))))))
285991dc
GM
1700
1701
79b1c79c 1702(defun normal-splash-screen (&optional startup concise)
1d865f15
JL
1703 "Display non-graphic splash screen.
1704If optional argument STARTUP is non-nil, display the startup screen
79b1c79c
JL
1705after Emacs starts. If STARTUP is nil, display the About screen.
1706If CONCISE is non-nil, display a concise version of the
1707splash screen in another window."
1708 (let ((splash-buffer (get-buffer-create "*About GNU Emacs*")))
1709 (with-current-buffer splash-buffer
1d865f15
JL
1710 (setq buffer-read-only nil)
1711 (erase-buffer)
4222d0a4 1712 (setq default-directory command-line-default-directory)
1d865f15
JL
1713 (set (make-local-variable 'tab-width) 8)
1714 (if (not startup)
1715 (set (make-local-variable 'mode-line-format)
1716 (propertize "---- %b %-" 'face 'mode-line-buffer-id)))
1717
1718 (if pure-space-overflow
22a58255 1719 (insert pure-space-overflow-message))
260a5020 1720
1d865f15
JL
1721 ;; The convention for this piece of code is that
1722 ;; each piece of output starts with one or two newlines
1723 ;; and does not end with any newlines.
22a58255 1724 (insert (if startup "Welcome to GNU Emacs" "This is GNU Emacs"))
1d865f15
JL
1725 (insert
1726 (if (eq system-type 'gnu/linux)
1727 ", one component of the GNU/Linux operating system.\n"
1728 ", a part of the GNU operating system.\n"))
1729
1730 (if startup
1731 (if (display-mouse-p)
1732 ;; The user can use the mouse to activate menus
1733 ;; so give help in terms of menu items.
fad930b6 1734 (normal-mouse-startup-screen)
c61453ea 1735
e349ae3b 1736 ;; No mouse menus, so give help using kbd commands.
fad930b6 1737 (normal-no-mouse-startup-screen))
e349ae3b 1738
fad930b6 1739 (normal-about-screen))
1d865f15
JL
1740
1741 ;; The rest of the startup screen is the same on all
1742 ;; kinds of terminals.
1743
1744 ;; Give information on recovering, if there was a crash.
1745 (and startup
1746 auto-save-list-file-prefix
1747 ;; Don't signal an error if the
1748 ;; directory for auto-save-list files
1749 ;; does not yet exist.
1750 (file-directory-p (file-name-directory
1751 auto-save-list-file-prefix))
1752 (directory-files
1753 (file-name-directory auto-save-list-file-prefix)
1754 nil
1755 (concat "\\`"
1756 (regexp-quote (file-name-nondirectory
1757 auto-save-list-file-prefix)))
1758 t)
1759 (insert "\n\nIf an Emacs session crashed recently, "
1760 "type Meta-x recover-session RET\nto recover"
1761 " the files you were editing.\n"))
26cdce23 1762
1d865f15 1763 (use-local-map splash-screen-keymap)
e349ae3b 1764
1d865f15
JL
1765 ;; Display the input that we set up in the buffer.
1766 (set-buffer-modified-p nil)
1767 (setq buffer-read-only t)
1768 (if (and view-read-only (not view-mode))
1769 (view-mode-enter nil 'kill-buffer))
1d865f15 1770 (if startup (rename-buffer "*GNU Emacs*" t))
79b1c79c
JL
1771 (goto-char (point-min)))
1772 (if concise
1773 (display-buffer splash-buffer)
1774 (switch-to-buffer splash-buffer))))
82e736c1 1775
fad930b6
RS
1776(defun normal-mouse-startup-screen ()
1777 ;; The user can use the mouse to activate menus
1778 ;; so give help in terms of menu items.
1779 (insert "\
09723615 1780To follow a link, click Mouse-1 on it, or move to it and type RET.
26cdce23
JL
1781To quit a partially entered command, type Control-g.\n")
1782
fad930b6
RS
1783 (insert "\nImportant Help menu items:\n")
1784 (insert-button "Emacs Tutorial"
1785 'action (lambda (button) (help-with-tutorial))
1786 'follow-link t)
1787 (insert "\t\tLearn basic Emacs keystroke commands\n")
1788 (insert-button "Read the Emacs Manual"
1789 'action (lambda (button) (info-emacs-manual))
1790 'follow-link t)
1791 (insert "\tView the Emacs manual using Info\n")
1792 (insert-button "\(Non)Warranty"
1793 'action (lambda (button) (describe-no-warranty))
1794 'follow-link t)
1795 (insert "\t\tGNU Emacs comes with ABSOLUTELY NO WARRANTY\n")
1796 (insert-button "Copying Conditions"
1797 'action (lambda (button) (describe-copying))
1798 'follow-link t)
1799 (insert "\tConditions for redistributing and changing Emacs\n")
1800 (insert-button "More Manuals / Ordering Manuals"
1801 'action (lambda (button) (view-order-manuals))
1802 'follow-link t)
1803 (insert " How to order printed manuals from the FSF\n")
1804
1805 (insert "\nUseful tasks:\n")
1806 (insert-button "Visit New File"
1807 'action (lambda (button) (call-interactively 'find-file))
1808 'follow-link t)
1809 (insert "\t\tSpecify a new file's name, to edit the file\n")
1810 (insert-button "Open Home Directory"
1811 'action (lambda (button) (dired "~"))
1812 'follow-link t)
1813 (insert "\tOpen your home directory, to operate on its files\n")
1814 (insert-button "Customize Startup"
1815 'action (lambda (button) (customize-group 'initialization))
1816 'follow-link t)
1817 (insert "\tChange initialization settings including this screen\n")
1818
1819 (insert "\n" (emacs-version)
1820 "\n" emacs-copyright))
1821
1822;; No mouse menus, so give help using kbd commands.
1823(defun normal-no-mouse-startup-screen ()
1824
1825 ;; If keys have their default meanings,
1826 ;; use precomputed string to save lots of time.
97b2518e
SM
1827 (let ((c-h-accessible
1828 ;; If normal-erase-is-backspace is used on a tty, there's
1829 ;; no way to invoke C-h and you have to use F1 instead.
1830 (or (not (char-table-p keyboard-translate-table))
1831 (eq (aref keyboard-translate-table ?\C-h) ?\C-h))))
1832 (if (and (eq (key-binding "\C-h") 'help-command)
1833 (eq (key-binding "\C-xu") 'advertised-undo)
1834 (eq (key-binding "\C-x\C-c") 'save-buffers-kill-terminal)
1835 (eq (key-binding "\C-ht") 'help-with-tutorial)
1836 (eq (key-binding "\C-hi") 'info)
1837 (eq (key-binding "\C-hr") 'info-emacs-manual)
1838 (eq (key-binding "\C-h\C-n") 'view-emacs-news))
1839 (let ((help (if c-h-accessible "C-h" "<f1>")))
1840 (insert "
1841Get help\t " help " (Hold down CTRL and press h)
cd6ab24f 1842")
97b2518e
SM
1843 (insert-button "Emacs manual"
1844 'action (lambda (button) (info-emacs-manual))
1845 'follow-link t)
1846 (insert " " help " r\t")
1847 (insert-button "Browse manuals"
1848 'action (lambda (button) (Info-directory))
1849 'follow-link t)
1850 (insert "\t " help " i
cd6ab24f 1851")
97b2518e
SM
1852 (insert-button "Emacs tutorial"
1853 'action (lambda (button) (help-with-tutorial))
1854 'follow-link t)
1855 (insert " " help " t\tUndo changes\t C-x u
cd6ab24f 1856")
97b2518e
SM
1857 (insert-button "Buy manuals"
1858 'action (lambda (button) (view-order-manuals))
1859 'follow-link t)
1860 (insert "\t " help " C-m\tExit Emacs\t C-x C-c"))
5777a167 1861
97b2518e 1862 (insert (format "
fad930b6 1863Get help\t %s
cd6ab24f 1864"
97b2518e
SM
1865 (let ((where (where-is-internal 'help-command nil t)))
1866 (if where
1867 (key-description where)
1868 "M-x help"))))
1869 (insert-button "Emacs manual"
1870 'action (lambda (button) (info-emacs-manual))
1871 'follow-link t)
1872 (insert (substitute-command-keys"\t \\[info-emacs-manual]\t"))
1873 (insert-button "Browse manuals"
1874 'action (lambda (button) (Info-directory))
1875 'follow-link t)
1876 (insert (substitute-command-keys "\t \\[info]
cd6ab24f 1877"))
97b2518e
SM
1878 (insert-button "Emacs tutorial"
1879 'action (lambda (button) (help-with-tutorial))
1880 'follow-link t)
1881 (insert (substitute-command-keys
1882 "\t \\[help-with-tutorial]\tUndo changes\t \\[advertised-undo]
cd6ab24f 1883"))
97b2518e
SM
1884 (insert-button "Buy manuals"
1885 'action (lambda (button) (view-order-manuals))
1886 'follow-link t)
1887 (insert (substitute-command-keys
1888 "\t \\[view-order-manuals]\tExit Emacs\t \\[save-buffers-kill-terminal]"))))
fad930b6
RS
1889
1890 ;; Say how to use the menu bar with the keyboard.
1891 (insert "\n")
1892 (insert-button "Activate menubar"
1893 'action (lambda (button) (tmm-menubar))
1894 'follow-link t)
1895 (if (and (eq (key-binding "\M-`") 'tmm-menubar)
1896 (eq (key-binding [f10]) 'tmm-menubar))
1897 (insert " F10 or ESC ` or M-`")
1898 (insert (substitute-command-keys " \\[tmm-menubar]")))
1899
1900 ;; Many users seem to have problems with these.
1901 (insert "
c61453ea
PJ
1902\(`C-' means use the CTRL key. `M-' means use the Meta (or Alt) key.
1903If you have no Meta key, you may instead type ESC followed by the character.)")
1904
fad930b6
RS
1905 ;; Insert links to useful tasks
1906 (insert "\nUseful tasks:\n")
1907
1908 (insert-button "Visit New File"
1909 'action (lambda (button) (call-interactively 'find-file))
1910 'follow-link t)
1911 (insert "\t\t\t")
1912 (insert-button "Open Home Directory"
1913 'action (lambda (button) (dired "~"))
1914 'follow-link t)
1915 (insert "\n")
1916
1917 (insert-button "Customize Startup"
1918 'action (lambda (button) (customize-group 'initialization))
1919 'follow-link t)
1920 (insert "\t\t")
1921 (insert-button "Open *scratch* buffer"
1922 'action (lambda (button) (switch-to-buffer
1923 (get-buffer-create "*scratch*")))
1924 'follow-link t)
1925 (insert "\n")
1926 (insert "\n" (emacs-version) "\n" emacs-copyright "\n")
1927
1928 (if (and (eq (key-binding "\C-h\C-c") 'describe-copying)
1929 (eq (key-binding "\C-h\C-d") 'describe-distribution)
1930 (eq (key-binding "\C-h\C-w") 'describe-no-warranty))
1931 (progn
1932 (insert
490a1ad6 1933 "
cd6ab24f 1934GNU Emacs comes with ABSOLUTELY NO WARRANTY; type C-h C-w for ")
fad930b6
RS
1935 (insert-button "full details"
1936 'action (lambda (button) (describe-no-warranty))
1937 'follow-link t)
1938 (insert ".
c61453ea 1939Emacs is Free Software--Free as in Freedom--so you can redistribute copies
cd6ab24f 1940of Emacs and modify it; type C-h C-c to see ")
fad930b6
RS
1941 (insert-button "the conditions"
1942 'action (lambda (button) (describe-copying))
1943 'follow-link t)
1944 (insert ".
cd6ab24f 1945Type C-h C-d for information on ")
fad930b6
RS
1946 (insert-button "getting the latest version"
1947 'action (lambda (button) (describe-distribution))
1948 'follow-link t)
1949 (insert "."))
1950 (insert (substitute-command-keys
490a1ad6 1951 "
cd6ab24f 1952GNU Emacs comes with ABSOLUTELY NO WARRANTY; type \\[describe-no-warranty] for "))
fad930b6
RS
1953 (insert-button "full details"
1954 'action (lambda (button) (describe-no-warranty))
1955 'follow-link t)
1956 (insert (substitute-command-keys ".
c61453ea 1957Emacs is Free Software--Free as in Freedom--so you can redistribute copies
cd6ab24f 1958of Emacs and modify it; type \\[describe-copying] to see "))
fad930b6
RS
1959 (insert-button "the conditions"
1960 'action (lambda (button) (describe-copying))
1961 'follow-link t)
1962 (insert (substitute-command-keys".
cd6ab24f 1963Type \\[describe-distribution] for information on "))
fad930b6
RS
1964 (insert-button "getting the latest version"
1965 'action (lambda (button) (describe-distribution))
1966 'follow-link t)
1967 (insert ".")))
1968
1969(defun normal-about-screen ()
1970 (insert "\n" (emacs-version) "\n" emacs-copyright "\n\n")
1971
1972 (insert "To follow a link, click Mouse-1 on it, or move to it and type RET.\n\n")
1973
490a1ad6
JL
1974 (insert-button "Authors"
1975 'action
1976 (lambda (button)
1977 (view-file (expand-file-name "AUTHORS" data-directory))
1978 (goto-char (point-min)))
1979 'follow-link t)
1980 (insert "\t\tMany people have contributed code included in GNU Emacs\n")
1981
1982 (insert-button "Contributing"
1983 'action
1984 (lambda (button)
1985 (view-file (expand-file-name "CONTRIBUTE" data-directory))
1986 (goto-char (point-min)))
1987 'follow-link t)
1988 (insert "\tHow to contribute improvements to Emacs\n\n")
1989
fad930b6 1990 (insert-button "GNU and Freedom"
92b2e7a3 1991 'action (lambda (button) (describe-gnu-project))
fad930b6
RS
1992 'follow-link t)
1993 (insert "\t\tWhy we developed GNU Emacs and the GNU system\n")
1994
1995 (insert-button "Absence of Warranty"
1996 'action (lambda (button) (describe-no-warranty))
1997 'follow-link t)
1998 (insert "\tGNU Emacs comes with ABSOLUTELY NO WARRANTY\n")
1999
2000 (insert-button "Copying Conditions"
2001 'action (lambda (button) (describe-copying))
2002 'follow-link t)
2003 (insert "\tConditions for redistributing and changing Emacs\n")
2004
2005 (insert-button "Getting New Versions"
2006 'action (lambda (button) (describe-distribution))
2007 'follow-link t)
2008 (insert "\tHow to get the latest version of GNU Emacs\n")
2009
2010 (insert-button "More Manuals / Ordering Manuals"
2011 'action (lambda (button) (view-order-manuals))
2012 'follow-link t)
2013 (insert "\tBuying printed manuals from the FSF\n"))
c61453ea 2014
f645586f 2015(defun startup-echo-area-message ()
2eb92184
CY
2016 (cond ((daemonp)
2017 "Starting Emacs daemon.")
2018 ((eq (key-binding "\C-h\C-a") 'about-emacs)
2019 "For information about GNU Emacs and the GNU system, type C-h C-a.")
2020 (t
2021 (substitute-command-keys
2022 "For information about GNU Emacs and the GNU system, type \
2023\\[about-emacs]."))))
ce9ded5d 2024
49939379 2025(defun display-startup-echo-area-message ()
15fa6db0 2026 (let ((resize-mini-windows t))
f1be5774
KL
2027 (or noninteractive ;(input-pending-p) init-file-had-error
2028 ;; t if the init file says to inhibit the echo area startup message.
2029 (and inhibit-startup-echo-area-message
2030 user-init-file
2031 (or (and (get 'inhibit-startup-echo-area-message 'saved-value)
2032 (equal inhibit-startup-echo-area-message
2033 (if (equal init-file-user "")
2034 (user-login-name)
2035 init-file-user)))
2036 ;; Wasn't set with custom; see if .emacs has a setq.
2037 (let ((buffer (get-buffer-create " *temp*")))
2038 (prog1
2039 (condition-case nil
2040 (save-excursion
2041 (set-buffer buffer)
2042 (insert-file-contents user-init-file)
2043 (re-search-forward
2044 (concat
2045 "([ \t\n]*setq[ \t\n]+"
2046 "inhibit-startup-echo-area-message[ \t\n]+"
2047 (regexp-quote
2048 (prin1-to-string
2049 (if (equal init-file-user "")
2050 (user-login-name)
2051 init-file-user)))
2052 "[ \t\n]*)")
2053 nil t))
2054 (error nil))
2055 (kill-buffer buffer)))))
1d865f15 2056 (message "%s" (startup-echo-area-message)))))
f645586f 2057
1cff9ad1 2058(defun display-startup-screen (&optional concise)
22a58255
CY
2059 "Display startup screen according to display.
2060A fancy display is used on graphic displays, normal otherwise.
49939379 2061
22a58255
CY
2062If CONCISE is non-nil, display a concise version of the startup
2063screen."
526039df 2064 ;; Prevent recursive calls from server-process-filter.
1cff9ad1 2065 (if (not (get-buffer "*GNU Emacs*"))
526039df 2066 (if (use-fancy-splash-screens-p)
22a58255 2067 (fancy-startup-screen concise)
79b1c79c 2068 (normal-splash-screen t concise))))
22a58255
CY
2069
2070(defun display-about-screen ()
2071 "Display the *About GNU Emacs* buffer.
2072A fancy display is used on graphic displays, normal otherwise."
2073 (interactive)
6b61353c 2074 (if (use-fancy-splash-screens-p)
1cff9ad1
JL
2075 (fancy-about-screen)
2076 (normal-splash-screen nil)))
c61453ea 2077
22a58255 2078(defalias 'about-emacs 'display-about-screen)
1cff9ad1 2079(defalias 'display-splash-screen 'display-startup-screen)
c61453ea 2080
a726e0d1 2081(defun command-line-1 (command-line-args-left)
f1be5774 2082 (display-startup-echo-area-message)
cb58ea33
RS
2083 (when (and pure-space-overflow
2084 (not noninteractive))
2085 (display-warning
2086 'initialization
f2602864
CY
2087 "Building Emacs overflowed pure space.\
2088 (See the node Pure Storage in the Lisp manual for details.)"
cb58ea33
RS
2089 :warning))
2090
22a58255
CY
2091 (let ((file-count 0)
2092 first-file-buffer)
2093 (when command-line-args-left
2094 ;; We have command args; process them.
2095 (let ((dir command-line-default-directory)
2096 tem
2097 ;; This approach loses for "-batch -L DIR --eval "(require foo)",
2098 ;; if foo is intended to be found in DIR.
2099 ;;
2100 ;; ;; The directories listed in --directory/-L options will *appear*
2101 ;; ;; at the front of `load-path' in the order they appear on the
2102 ;; ;; command-line. We cannot do this by *placing* them at the front
2103 ;; ;; in the order they appear, so we need this variable to hold them,
2104 ;; ;; temporarily.
2105 ;; extra-load-path
2106 ;;
2107 ;; To DTRT we keep track of the splice point and modify `load-path'
2108 ;; straight away upon any --directory/-L option.
2109 splice
2110 just-files ;; t if this follows the magic -- option.
2111 ;; This includes our standard options' long versions
2112 ;; and long versions of what's on command-switch-alist.
2113 (longopts
2114 (append '(("--funcall") ("--load") ("--insert") ("--kill")
2115 ("--directory") ("--eval") ("--execute") ("--no-splash")
2116 ("--find-file") ("--visit") ("--file") ("--no-desktop"))
2117 (mapcar (lambda (elt)
2118 (list (concat "-" (car elt))))
2119 command-switch-alist)))
2120 (line 0)
2121 (column 0))
2122
2123 ;; Add the long X options to longopts.
2124 (dolist (tem command-line-x-option-alist)
2125 (if (string-match "^--" (car tem))
2126 (push (list (car tem)) longopts)))
2127
122e9f8f
AR
2128 ;; Add the long NS options to longopts.
2129 (dolist (tem command-line-ns-option-alist)
2130 (if (string-match "^--" (car tem))
2131 (push (list (car tem)) longopts)))
edfda783 2132
22a58255
CY
2133 ;; Loop, processing options.
2134 (while command-line-args-left
2135 (let* ((argi (car command-line-args-left))
2136 (orig-argi argi)
2137 argval completion)
2138 (setq command-line-args-left (cdr command-line-args-left))
2139
2140 ;; Do preliminary decoding of the option.
2141 (if just-files
2142 ;; After --, don't look for options; treat all args as files.
2143 (setq argi "")
2144 ;; Convert long options to ordinary options
2145 ;; and separate out an attached option argument into argval.
7b704afe 2146 (when (string-match "\\`\\(--[^=]*\\)=" argi)
22a58255
CY
2147 (setq argval (substring argi (match-end 0))
2148 argi (match-string 1 argi)))
7b704afe
AS
2149 (when (string-match "\\`--." orig-argi)
2150 (setq completion (try-completion argi longopts))
2151 (if (eq completion t)
2152 (setq argi (substring argi 1))
2153 (if (stringp completion)
2154 (let ((elt (assoc completion longopts)))
2155 (or elt
2156 (error "Option `%s' is ambiguous" argi))
2157 (setq argi (substring (car elt) 1)))
2158 (setq argval nil
2159 argi orig-argi)))))
22a58255
CY
2160
2161 ;; Execute the option.
2162 (cond ((setq tem (assoc argi command-switch-alist))
2163 (if argval
2164 (let ((command-line-args-left
2165 (cons argval command-line-args-left)))
2166 (funcall (cdr tem) argi))
2167 (funcall (cdr tem) argi)))
2168
2169 ((equal argi "-no-splash")
1cff9ad1 2170 (setq inhibit-startup-screen t))
22a58255
CY
2171
2172 ((member argi '("-f" ; what the manual claims
2173 "-funcall"
2174 "-e")) ; what the source used to say
1cff9ad1 2175 (setq inhibit-startup-screen t)
22a58255
CY
2176 (setq tem (intern (or argval (pop command-line-args-left))))
2177 (if (commandp tem)
2178 (command-execute tem)
2179 (funcall tem)))
2180
2181 ((member argi '("-eval" "-execute"))
1cff9ad1 2182 (setq inhibit-startup-screen t)
22a58255
CY
2183 (eval (read (or argval (pop command-line-args-left)))))
2184
2185 ((member argi '("-L" "-directory"))
2186 (setq tem (expand-file-name
2187 (command-line-normalize-file-name
2188 (or argval (pop command-line-args-left)))))
2189 (cond (splice (setcdr splice (cons tem (cdr splice)))
2190 (setq splice (cdr splice)))
2191 (t (setq load-path (cons tem load-path)
2192 splice load-path))))
2193
2194 ((member argi '("-l" "-load"))
2195 (let* ((file (command-line-normalize-file-name
2196 (or argval (pop command-line-args-left))))
2197 ;; Take file from default dir if it exists there;
2198 ;; otherwise let `load' search for it.
2199 (file-ex (expand-file-name file)))
2200 (when (file-exists-p file-ex)
2201 (setq file file-ex))
2202 (load file nil t)))
2203
2204 ;; This is used to handle -script. It's not clear
f71d844b 2205 ;; we need to document it (it is totally internal).
1d1100d7 2206 ((member argi '("-scriptload"))
22a58255
CY
2207 (let* ((file (command-line-normalize-file-name
2208 (or argval (pop command-line-args-left))))
2209 ;; Take file from default dir.
2210 (file-ex (expand-file-name file)))
2211 (load file-ex nil t t)))
2212
2213 ((equal argi "-insert")
1cff9ad1 2214 (setq inhibit-startup-screen t)
22a58255
CY
2215 (setq tem (or argval (pop command-line-args-left)))
2216 (or (stringp tem)
2217 (error "File name omitted from `-insert' option"))
2218 (insert-file-contents (command-line-normalize-file-name tem)))
2219
2220 ((equal argi "-kill")
2221 (kill-emacs t))
2222
2223 ;; This is for when they use --no-desktop with -q, or
2224 ;; don't load Desktop in their .emacs. If desktop.el
2225 ;; _is_ loaded, it will handle this switch, and we
2226 ;; won't see it by the time we get here.
2227 ((equal argi "-no-desktop")
2228 (message "\"--no-desktop\" ignored because the Desktop package is not loaded"))
2229
2230 ((string-match "^\\+[0-9]+\\'" argi)
2231 (setq line (string-to-number argi)))
2232
2233 ((string-match "^\\+\\([0-9]+\\):\\([0-9]+\\)\\'" argi)
2234 (setq line (string-to-number (match-string 1 argi))
2235 column (string-to-number (match-string 2 argi))))
2236
2237 ((setq tem (assoc argi command-line-x-option-alist))
2238 ;; Ignore X-windows options and their args if not using X.
2239 (setq command-line-args-left
2240 (nthcdr (nth 1 tem) command-line-args-left)))
2241
3000e3f4
DN
2242 ((setq tem (assoc argi command-line-ns-option-alist))
2243 ;; Ignore NS-windows options and their args if not using NS.
2244 (setq command-line-args-left
2245 (nthcdr (nth 1 tem) command-line-args-left)))
edfda783 2246
22a58255 2247 ((member argi '("-find-file" "-file" "-visit"))
1cff9ad1 2248 (setq inhibit-startup-screen t)
22a58255
CY
2249 ;; An explicit option to specify visiting a file.
2250 (setq tem (or argval (pop command-line-args-left)))
2251 (unless (stringp tem)
2252 (error "File name omitted from `%s' option" argi))
2253 (setq file-count (1+ file-count))
2254 (let ((file (expand-file-name
2255 (command-line-normalize-file-name tem) dir)))
2256 (if (= file-count 1)
2257 (setq first-file-buffer (find-file file))
2258 (find-file-other-window file)))
2259 (or (zerop line)
2260 (goto-line line))
2261 (setq line 0)
2262 (unless (< column 1)
2263 (move-to-column (1- column)))
2264 (setq column 0))
2265
2266 ((equal argi "--")
2267 (setq just-files t))
2268 (t
2269 ;; We have almost exhausted our options. See if the
2270 ;; user has made any other command-line options available
2271 (let ((hooks command-line-functions)
2272 (did-hook nil))
2273 (while (and hooks
2274 (not (setq did-hook (funcall (car hooks)))))
2275 (setq hooks (cdr hooks)))
2276 (if (not did-hook)
2277 ;; Presume that the argument is a file name.
2278 (progn
2279 (if (string-match "\\`-" argi)
2280 (error "Unknown option `%s'" argi))
1cff9ad1
JL
2281 (unless initial-window-system
2282 (setq inhibit-startup-screen t))
22a58255
CY
2283 (setq file-count (1+ file-count))
2284 (let ((file
2285 (expand-file-name
2286 (command-line-normalize-file-name orig-argi)
2287 dir)))
3d9d55e6
CY
2288 (cond ((= file-count 1)
2289 (setq first-file-buffer (find-file file)))
2290 (inhibit-startup-screen
2291 (find-file-other-window file))
2292 (t (find-file file))))
22a58255
CY
2293 (or (zerop line)
2294 (goto-line line))
2295 (setq line 0)
2296 (unless (< column 1)
2297 (move-to-column (1- column)))
2298 (setq column 0))))))
2299 ;; In unusual circumstances, the execution of Lisp code due
2300 ;; to command-line options can cause the last visible frame
2301 ;; to be deleted. In this case, kill emacs to avoid an
2302 ;; abort later.
2303 (unless (frame-live-p (selected-frame)) (kill-emacs nil))))))
2304
2305 (when initial-buffer-choice
2306 (cond ((eq initial-buffer-choice t)
2307 (switch-to-buffer (get-buffer-create "*scratch*")))
2308 ((stringp initial-buffer-choice)
2309 (find-file initial-buffer-choice))))
2310
8d86c6da
JL
2311 ;; If *scratch* exists and is empty, insert initial-scratch-message.
2312 (and initial-scratch-message
2313 (get-buffer "*scratch*")
2314 (with-current-buffer "*scratch*"
2315 (when (zerop (buffer-size))
2316 (insert initial-scratch-message)
2317 (set-buffer-modified-p nil))))
2318
1cff9ad1 2319 (if (or inhibit-startup-screen
22a58255
CY
2320 initial-buffer-choice
2321 noninteractive
2322 emacs-quick-startup)
2323
2324 ;; Not displaying a startup screen. If 3 or more files
2325 ;; visited, and not all visible, show user what they all are.
2326 (and (> file-count 2)
2327 (not noninteractive)
2328 (not inhibit-startup-buffer-menu)
2329 (or (get-buffer-window first-file-buffer)
2330 (list-buffers)))
2331
2332 ;; Display a startup screen, after some preparations.
2333
2334 ;; If there are no switches to process, we might as well
2335 ;; run this hook now, and there may be some need to do it
2336 ;; before doing any output.
2337 (run-hooks 'emacs-startup-hook)
2338 (and term-setup-hook
2339 (run-hooks 'term-setup-hook))
2340 (setq inhibit-startup-hooks t)
2341
2342 ;; It's important to notice the user settings before we
2343 ;; display the startup message; otherwise, the settings
2344 ;; won't take effect until the user gives the first
2345 ;; keystroke, and that's distracting.
2346 (when (fboundp 'frame-notice-user-settings)
2347 (frame-notice-user-settings))
2348
2349 ;; If there are no switches to process, we might as well
2350 ;; run this hook now, and there may be some need to do it
2351 ;; before doing any output.
2352 (when window-setup-hook
2353 (run-hooks 'window-setup-hook)
2354 ;; Don't let the hook be run twice.
2355 (setq window-setup-hook nil))
2356
04ef2618
CY
2357 ;; ;; Do this now to avoid an annoying delay if the user
2358 ;; ;; clicks the menu bar during the sit-for.
2359 ;; (when (display-popup-menus-p)
2360 ;; (precompute-menubar-bindings))
2361 ;; (with-no-warnings
2362 ;; (setq menubar-bindings-done t))
22a58255 2363
1cff9ad1
JL
2364 (if (> file-count 0)
2365 (display-startup-screen t)
2366 (display-startup-screen nil)))))
49939379 2367
47c7adae
RS
2368(defun command-line-normalize-file-name (file)
2369 "Collapse multiple slashes to one, to handle non-Emacs file names."
6b9e794f
RS
2370 (save-match-data
2371 ;; Use arg 1 so that we don't collapse // at the start of the file name.
2372 ;; That is significant on some systems.
2373 ;; However, /// at the beginning is supposed to mean just /, not //.
2374 (if (string-match "^///+" file)
2375 (setq file (replace-match "/" t t file)))
2376 (while (string-match "//+" file 1)
2377 (setq file (replace-match "/" t t file)))
2378 file))
47c7adae 2379
a3194d03 2380;; arch-tag: 7e294698-244d-4758-984b-4047f887a5db
c88ab9ce 2381;;; startup.el ends here