* test/lisp/net/tramp-tests.el (tramp-test17-dired-with-wildcards): New test.
[emacs.git] / lisp / loadup.el
blobaf42cd9711106785d873ac4e7acfcd595ba67f0a
1 ;;; loadup.el --- load up standardly loaded Lisp files for Emacs
3 ;; Copyright (C) 1985-1986, 1992, 1994, 2001-2017 Free Software
4 ;; Foundation, Inc.
6 ;; Maintainer: emacs-devel@gnu.org
7 ;; Keywords: internal
8 ;; Package: emacs
10 ;; This file is part of GNU Emacs.
12 ;; GNU Emacs is free software: you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation, either version 3 of the License, or
15 ;; (at your option) any later version.
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.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;;; Commentary:
27 ;; This is loaded into a bare Emacs to make a dumpable one.
29 ;; If you add a file to be loaded here, keep the following points in mind:
31 ;; i) If the file is no-byte-compile, explicitly load the .el version.
32 ;; Such files should (where possible) obey the doc-string conventions
33 ;; expected by make-docfile. They should also be added to the
34 ;; uncompiled[] list in make-docfile.c.
36 ;; ii) If the file is dumped with Emacs (on any platform), put the
37 ;; load statement at the start of a line (leading whitespace is ok).
39 ;; iii) If the file is _not_ dumped with Emacs, make sure the load
40 ;; statement is _not_ at the start of a line. See pcase for an example.
42 ;; These rules are so that src/Makefile can construct lisp.mk automatically.
43 ;; This ensures both that the Lisp files are compiled (if necessary)
44 ;; before the emacs executable is dumped, and that they are passed to
45 ;; make-docfile. (Any that are not processed for DOC will not have
46 ;; doc strings in the dumped Emacs.)
48 ;;; Code:
50 ;; This is used in xdisp.c to determine when bidi reordering is safe.
51 ;; (It starts non-nil in temacs, but we set it non-nil here anyway, in
52 ;; case someone loads loadup one more time.) We reset it after
53 ;; successfully loading charprop.el, which defines the Unicode tables
54 ;; bidi.c needs for its job.
55 (setq redisplay--inhibit-bidi t)
57 ;; Add subdirectories to the load-path for files that might get
58 ;; autoloaded when bootstrapping.
59 ;; This is because PATH_DUMPLOADSEARCH is just "../lisp".
60 (if (or (equal (member "bootstrap" command-line-args) '("bootstrap"))
61 ;; FIXME this is irritatingly fragile.
62 (and (stringp (nth 4 command-line-args))
63 (string-match "^unidata-gen\\(\\.elc?\\)?$"
64 (nth 4 command-line-args)))
65 (member (nth 7 command-line-args) '("unidata-gen-file"
66 "unidata-gen-charprop"))
67 (if (fboundp 'dump-emacs)
68 (string-match "src/bootstrap-emacs" (nth 0 command-line-args))
69 t))
70 (let ((dir (car load-path)))
71 ;; We'll probably overflow the pure space.
72 (setq purify-flag nil)
73 ;; Value of max-lisp-eval-depth when compiling initially.
74 ;; During bootstrapping the byte-compiler is run interpreted when
75 ;; compiling itself, which uses a lot more stack than usual.
76 (setq max-lisp-eval-depth 2200)
77 (setq load-path (list (expand-file-name "." dir)
78 (expand-file-name "emacs-lisp" dir)
79 (expand-file-name "language" dir)
80 (expand-file-name "international" dir)
81 (expand-file-name "textmodes" dir)
82 (expand-file-name "vc" dir)))))
84 (if (eq t purify-flag)
85 ;; Hash consing saved around 11% of pure space in my tests.
86 (setq purify-flag (make-hash-table :test 'equal :size 80000)))
88 (message "Using load-path %s" load-path)
90 ;; This is a poor man's `last', since we haven't loaded subr.el yet.
91 (if (and (fboundp 'dump-emacs)
92 (or (equal (member "bootstrap" command-line-args) '("bootstrap"))
93 (equal (member "dump" command-line-args) '("dump"))))
94 (progn
95 ;; To reduce the size of dumped Emacs, we avoid making huge char-tables.
96 (setq inhibit-load-charset-map t)
97 ;; --eval gets handled too late.
98 (defvar load--prefer-newer load-prefer-newer)
99 (setq load-prefer-newer t)))
101 ;; We don't want to have any undo records in the dumped Emacs.
102 (set-buffer "*scratch*")
103 (setq buffer-undo-list t)
105 (load "emacs-lisp/byte-run")
106 (load "emacs-lisp/backquote")
107 (load "subr")
109 ;; Do it after subr, since both after-load-functions and add-hook are
110 ;; implemented in subr.el.
111 (add-hook 'after-load-functions (lambda (f) (garbage-collect)))
113 (load "version")
115 (load "widget")
116 (load "custom")
117 (load "emacs-lisp/map-ynp")
118 (load "international/mule")
119 (load "international/mule-conf")
120 (load "env")
121 (load "format")
122 (load "bindings")
123 (load "window") ; Needed here for `replace-buffer-in-windows'.
124 ;; We are now capable of resizing the mini-windows, so give the
125 ;; variable its advertised default value (it starts as nil, see
126 ;; xdisp.c).
127 (setq resize-mini-windows 'grow-only)
128 (setq load-source-file-function 'load-with-code-conversion)
129 (load "files")
131 ;; Load-time macro-expansion can only take effect after setting
132 ;; load-source-file-function because of where it is called in lread.c.
133 (load "emacs-lisp/macroexp")
134 (if (byte-code-function-p (symbol-function 'macroexpand-all))
136 ;; Since loaddefs is not yet loaded, macroexp's uses of pcase will simply
137 ;; fail until pcase is explicitly loaded. This also means that we have to
138 ;; disable eager macro-expansion while loading pcase.
139 (let ((macroexp--pending-eager-loads '(skip))) (load "emacs-lisp/pcase"))
140 ;; Re-load macroexp so as to eagerly macro-expand its uses of pcase.
141 (let ((max-lisp-eval-depth (* 2 max-lisp-eval-depth)))
142 (load "emacs-lisp/macroexp")))
144 (load "cus-face")
145 (load "faces") ; after here, `defface' may be used.
147 (load "button")
149 ;; We don't want to store loaddefs.el in the repository because it is
150 ;; a generated file; but it is required in order to compile the lisp files.
151 ;; When bootstrapping, we cannot generate loaddefs.el until an
152 ;; emacs binary has been built. We therefore compromise and keep
153 ;; ldefs-boot.el in the repository. This does not need to be updated
154 ;; as often as the real loaddefs.el would. Bootstrap should always
155 ;; work with ldefs-boot.el. Therefore, whenever a new autoload cookie
156 ;; gets added that is necessary during bootstrapping, ldefs-boot.el
157 ;; should be updated by overwriting it with an up-to-date copy of
158 ;; loaddefs.el that is not corrupted by local changes.
159 ;; admin/update_autogen can be used to update ldefs-boot.el periodically.
160 (condition-case nil (load "loaddefs.el")
161 ;; In case loaddefs hasn't been generated yet.
162 (file-error (load "ldefs-boot.el")))
164 (let ((new (make-hash-table :test 'equal)))
165 ;; Now that loaddefs has populated definition-prefixes, purify its contents.
166 (maphash (lambda (k v) (puthash (purecopy k) (purecopy v) new))
167 definition-prefixes)
168 (setq definition-prefixes new))
170 (load "emacs-lisp/nadvice")
171 (load "emacs-lisp/cl-preloaded")
172 (load "minibuffer") ;After loaddefs, for define-minor-mode.
173 (load "obarray") ;abbrev.el is implemented in terms of obarrays.
174 (load "abbrev") ;lisp-mode.el and simple.el use define-abbrev-table.
175 (load "simple")
177 (load "help")
179 (load "jka-cmpr-hook")
180 (load "epa-hook")
181 ;; Any Emacs Lisp source file (*.el) loaded here after can contain
182 ;; multilingual text.
183 (load "international/mule-cmds")
184 (load "case-table")
185 ;; This file doesn't exist when building a development version of Emacs
186 ;; from the repository. It is generated just after temacs is built.
187 (load "international/charprop.el" t)
188 (if (featurep 'charprop)
189 (setq redisplay--inhibit-bidi nil))
190 (load "international/characters")
191 (load "composite")
193 ;; Load language-specific files.
194 (load "language/chinese")
195 (load "language/cyrillic")
196 (load "language/indian")
197 (load "language/sinhala")
198 (load "language/english")
199 (load "language/ethiopic")
200 (load "language/european")
201 (load "language/czech")
202 (load "language/slovak")
203 (load "language/romanian")
204 (load "language/greek")
205 (load "language/hebrew")
206 (load "international/cp51932")
207 (load "international/eucjp-ms")
208 (load "language/japanese")
209 (load "language/korean")
210 (load "language/lao")
211 (load "language/tai-viet")
212 (load "language/thai")
213 (load "language/tibetan")
214 (load "language/vietnamese")
215 (load "language/misc-lang")
216 (load "language/utf-8-lang")
217 (load "language/georgian")
218 (load "language/khmer")
219 (load "language/burmese")
220 (load "language/cham")
222 (load "indent")
223 (load "emacs-lisp/cl-generic")
224 (load "frame")
225 (load "startup")
226 (load "term/tty-colors")
227 (load "font-core")
228 ;; facemenu must be loaded before font-lock, because `facemenu-keymap'
229 ;; needs to be defined when font-lock is loaded.
230 (load "facemenu")
231 (load "emacs-lisp/syntax")
232 (load "font-lock")
233 (load "jit-lock")
235 (load "mouse")
236 (if (boundp 'x-toolkit-scroll-bars)
237 (load "scroll-bar"))
238 (load "select")
239 (load "emacs-lisp/timer")
240 (load "isearch")
241 (load "rfn-eshadow")
243 (load "menu-bar")
244 (load "emacs-lisp/lisp")
245 (load "textmodes/page")
246 (load "register")
247 (load "textmodes/paragraphs")
248 (load "progmodes/prog-mode")
249 (load "emacs-lisp/lisp-mode")
250 (load "progmodes/elisp-mode")
251 (load "textmodes/text-mode")
252 (load "textmodes/fill")
253 (load "newcomment")
255 (load "replace")
256 (load "emacs-lisp/tabulated-list")
257 (load "buff-menu")
259 (if (fboundp 'x-create-frame)
260 (progn
261 (load "fringe")
262 ;; Needed by `imagemagick-register-types'
263 (load "emacs-lisp/regexp-opt")
264 (load "image")
265 (load "international/fontset")
266 (load "dnd")
267 (load "tool-bar")))
269 (if (featurep 'dynamic-setting)
270 (load "dynamic-setting"))
272 (if (featurep 'x)
273 (progn
274 (load "x-dnd")
275 (load "term/common-win")
276 (load "term/x-win")))
278 (if (or (eq system-type 'windows-nt)
279 (featurep 'w32))
280 (progn
281 (load "term/common-win")
282 (load "w32-vars")
283 (load "term/w32-win")
284 (load "disp-table")
285 (when (eq system-type 'windows-nt)
286 (load "w32-fns")
287 (load "ls-lisp")
288 (load "dos-w32"))))
289 (if (eq system-type 'ms-dos)
290 (progn
291 (load "dos-w32")
292 (load "dos-fns")
293 (load "dos-vars")
294 ;; Don't load term/common-win: it isn't appropriate for the `pc'
295 ;; ``window system'', which generally behaves like a terminal.
296 (load "term/internal")
297 (load "term/pc-win")
298 (load "ls-lisp")
299 (load "disp-table"))) ; needed to setup ibm-pc char set, see internal.el
300 (if (featurep 'ns)
301 (progn
302 (load "term/common-win")
303 ;; Don't load ucs-normalize.el unless uni-*.el files were
304 ;; already produced, because it needs uni-*.el files that might
305 ;; not be built early enough during bootstrap.
306 (when (featurep 'charprop)
307 (load "international/mule-util")
308 (load "international/ucs-normalize")
309 (load "term/ns-win"))))
310 (if (fboundp 'x-create-frame)
311 ;; Do it after loading term/foo-win.el since the value of the
312 ;; mouse-wheel-*-event vars depends on those files being loaded or not.
313 (load "mwheel"))
314 ;; Preload some constants and floating point functions.
315 (load "emacs-lisp/float-sup")
317 (load "vc/vc-hooks")
318 (load "vc/ediff-hook")
319 (load "uniquify")
320 (load "electric")
321 (load "emacs-lisp/eldoc")
322 (load "cus-start") ;Late to reduce customize-rogue (needs loaddefs.el anyway)
323 (if (not (eq system-type 'ms-dos))
324 (load "tooltip"))
326 ;; This file doesn't exist when building a development version of Emacs
327 ;; from the repository. It is generated just after temacs is built.
328 (load "leim/leim-list.el" t)
330 ;; If you want additional libraries to be preloaded and their
331 ;; doc strings kept in the DOC file rather than in core,
332 ;; you may load them with a "site-load.el" file.
333 ;; But you must also cause them to be scanned when the DOC file
334 ;; is generated.
335 (let ((lp load-path))
336 (load "site-load" t)
337 ;; We reset load-path after dumping.
338 ;; For a permanent change in load-path, use configure's
339 ;; --enable-locallisppath option.
340 ;; See http://debbugs.gnu.org/16107 for more details.
341 (or (equal lp load-path)
342 (message "Warning: Change in load-path due to site-load will be \
343 lost after dumping")))
345 ;; Make sure default-directory is unibyte when dumping. This is
346 ;; because we cannot decode and encode it correctly (since the locale
347 ;; environment is not, and should not be, set up). default-directory
348 ;; is used every time we call expand-file-name, which we do in every
349 ;; file primitive. So the only workable solution to support building
350 ;; in non-ASCII directories is to manipulate unibyte strings in the
351 ;; current locale's encoding.
352 (if (and (member (car (last command-line-args)) '("dump" "bootstrap"))
353 (fboundp 'dump-emacs)
354 (multibyte-string-p default-directory))
355 (error "default-directory must be unibyte when dumping Emacs!"))
357 ;; Determine which build number to use
358 ;; based on the executables that now exist.
359 (if (and (equal (last command-line-args) '("dump"))
360 (fboundp 'dump-emacs)
361 (not (eq system-type 'ms-dos)))
362 (let* ((base (concat "emacs-" emacs-version "."))
363 (exelen (if (eq system-type 'windows-nt) -4))
364 (files (file-name-all-completions base default-directory))
365 (versions (mapcar (function
366 (lambda (name)
367 (string-to-number
368 (substring name (length base) exelen))))
369 files)))
370 (setq emacs-repository-version (condition-case nil (emacs-repository-get-version)
371 (error nil)))
372 ;; A constant, so we shouldn't change it with `setq'.
373 (defconst emacs-build-number
374 (if versions (1+ (apply 'max versions)) 1))))
377 (message "Finding pointers to doc strings...")
378 (if (and (fboundp 'dump-emacs)
379 (equal (last command-line-args) '("dump")))
380 (Snarf-documentation "DOC")
381 (condition-case nil
382 (Snarf-documentation "DOC")
383 (error nil)))
384 (message "Finding pointers to doc strings...done")
386 ;; Note: You can cause additional libraries to be preloaded
387 ;; by writing a site-init.el that loads them.
388 ;; See also "site-load" above
389 (let ((lp load-path))
390 (load "site-init" t)
391 (or (equal lp load-path)
392 (message "Warning: Change in load-path due to site-init will be \
393 lost after dumping")))
395 (setq current-load-list nil)
396 ;; Avoid storing references to build directory in the binary.
397 (setq custom-current-group-alist nil)
399 ;; We keep the load-history data in PURE space.
400 ;; Make sure that the spine of the list is not in pure space because it can
401 ;; be destructively mutated in lread.c:build_load_history.
402 (setq load-history (mapcar 'purecopy load-history))
404 (set-buffer-modified-p nil)
406 (remove-hook 'after-load-functions (lambda (f) (garbage-collect)))
408 (if (boundp 'load--prefer-newer)
409 (progn
410 (setq load-prefer-newer load--prefer-newer)
411 (put 'load-prefer-newer 'standard-value load--prefer-newer)
412 (makunbound 'load--prefer-newer)))
414 (setq inhibit-load-charset-map nil)
415 (clear-charset-maps)
416 (garbage-collect)
418 ;; At this point, we're ready to resume undo recording for scratch.
419 (buffer-enable-undo "*scratch*")
421 (when (hash-table-p purify-flag)
422 (let ((strings 0)
423 (vectors 0)
424 (bytecodes 0)
425 (conses 0)
426 (others 0))
427 (maphash (lambda (k v)
428 (cond
429 ((stringp k) (setq strings (1+ strings)))
430 ((vectorp k) (setq vectors (1+ vectors)))
431 ((consp k) (setq conses (1+ conses)))
432 ((byte-code-function-p v) (setq bytecodes (1+ bytecodes)))
433 (t (setq others (1+ others)))))
434 purify-flag)
435 (message "Pure-hashed: %d strings, %d vectors, %d conses, %d bytecodes, %d others"
436 strings vectors conses bytecodes others)))
438 ;; Avoid error if user loads some more libraries now and make sure the
439 ;; hash-consing hash table is GC'd.
440 (setq purify-flag nil)
442 (if (null (garbage-collect))
443 (setq pure-space-overflow t))
445 ;; Make sure we will attempt bidi reordering henceforth.
446 (setq redisplay--inhibit-bidi nil)
448 (if (and (fboundp 'dump-emacs)
449 (member (car (last command-line-args)) '("dump" "bootstrap")))
450 (progn
451 ;; Prevent build-time PATH getting stored in the binary.
452 ;; Mainly cosmetic, but helpful for Guix. (Bug#20330)
453 ;; Do this here, rather than earlier, so that the above code
454 ;; can invoke Git commands and the like.
455 (setq exec-path nil)
456 (message "Dumping under the name emacs")
457 (condition-case ()
458 (delete-file "emacs")
459 (file-error nil))
460 ;; We used to dump under the name xemacs, but that occasionally
461 ;; confused people installing Emacs (they'd install the file
462 ;; under the name `xemacs'), and it's inconsistent with every
463 ;; other GNU program's build process.
464 (dump-emacs "emacs" "temacs")
465 (message "%d pure bytes used" pure-bytes-used)
466 ;; Recompute NAME now, so that it isn't set when we dump.
467 (if (not (or (eq system-type 'ms-dos)
468 ;; Don't bother adding another name if we're just
469 ;; building bootstrap-emacs.
470 (equal (last command-line-args) '("bootstrap"))))
471 (let ((name (format "emacs-%s.%d" emacs-version emacs-build-number))
472 (exe (if (eq system-type 'windows-nt) ".exe" "")))
473 (while (string-match "[^-+_.a-zA-Z0-9]+" name)
474 (setq name (concat (downcase (substring name 0 (match-beginning 0)))
476 (substring name (match-end 0)))))
477 (setq name (concat name exe))
478 (message "Adding name %s" name)
479 ;; When this runs on Windows, invocation-directory is not
480 ;; necessarily the current directory.
481 (add-name-to-file (expand-file-name (concat "emacs" exe)
482 invocation-directory)
483 (expand-file-name name invocation-directory)
484 t)))
485 (kill-emacs)))
487 ;; For machines with CANNOT_DUMP defined in config.h,
488 ;; this file must be loaded each time Emacs is run.
489 ;; So run the startup code now. First, remove `-l loadup' from args.
491 (if (and (member (nth 1 command-line-args) '("-l" "--load"))
492 (equal (nth 2 command-line-args) "loadup"))
493 (setcdr command-line-args (nthcdr 3 command-line-args)))
495 (eval top-level)
498 ;; Local Variables:
499 ;; no-byte-compile: t
500 ;; no-update-autoloads: t
501 ;; End:
503 ;;; loadup.el ends here