1 ;;; startup.el --- process XEmacs shell arguments
3 ;; Copyright (C) 1985-1986, 1990, 1992-1997 Free Software Foundation, Inc.
4 ;; Copyright (c) 1993, 1994 Sun Microsystems, Inc.
5 ;; Copyright (C) 1995 Board of Trustees, University of Illinois
7 ;; Maintainer: XEmacs Development Team
8 ;; Keywords: internal, dumped
10 ;; This file is part of XEmacs.
12 ;; XEmacs is free software; you can redistribute it and/or modify it
13 ;; under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation; either version 2, or (at your option)
17 ;; XEmacs is distributed in the hope that it will be useful, but
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 ;; General Public License for more details.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with XEmacs; see the file COPYING. If not, write to the
24 ;; Free Software Foundation, 59 Temple Place - Suite 330,
25 ;; Boston, MA 02111-1307, USA.
27 ;;; Synched up with: FSF 19.34.
31 ;; This file is dumped with XEmacs.
33 ;; -batch, -t, and -nw are processed by main() in emacs.c and are
34 ;; never seen by lisp code.
36 ;; -version and -help are special-cased as well: they imply -batch,
37 ;; but are left on the list for lisp code to process.
41 (setq top-level '(normal-top-level))
43 (defvar command-line-processed nil "t once command line has been processed")
45 (defconst startup-message-timeout 12000) ; More or less disable the timeout
46 (defconst splash-frame-timeout 7) ; interval between splash frame elements
48 (defconst inhibit-startup-message nil
49 "*Non-nil inhibits the initial startup message.
50 This is for use in your personal init file, once you are familiar
51 with the contents of the startup message.")
53 ;; #### FSFmacs randomness
54 ;;(defconst inhibit-startup-echo-area-message nil
55 ;; "*Non-nil inhibits the initial startup echo area message.
56 ;;Inhibition takes effect only if your `.emacs' file contains
57 ;;a line of this form:
58 ;; (setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\")
59 ;;If your `.emacs' file is byte-compiled, use the following form instead:
60 ;; (eval '(setq inhibit-startup-echo-area-message \"YOUR-USER-NAME\"))
61 ;;Thus, someone else using a copy of your `.emacs' file will see
62 ;;the startup message unless he personally acts to inhibit it.")
64 (defconst inhibit-default-init nil
65 "*Non-nil inhibits loading the `default' library.")
67 (defvar command-line-args-left nil
68 "List of command-line args not yet processed.") ; bound by `command-line'
70 (defvar command-line-default-directory nil
71 "Default directory to use for command line arguments.
72 This is normally copied from `default-directory' when XEmacs starts.")
74 (defvar before-init-hook nil
75 "Functions to call after handling urgent options but before init files.
76 The frame system uses this to open frames to display messages while
77 XEmacs loads the user's initialization file.")
79 (defvar after-init-hook nil
80 "*Functions to call after loading the init file.
81 The call is not protected by a condition-case, so you can set `debug-on-error'
82 in the init file, and put all the actual code on `after-init-hook'.")
84 (defvar term-setup-hook nil
85 "*Functions to be called after loading terminal-specific Lisp code.
86 See `run-hooks'. This variable exists for users to set, so as to
87 override the definitions made by the terminal-specific file. XEmacs
88 never sets this variable itself.")
90 (defvar keyboard-type nil
91 "The brand of keyboard you are using.
92 This variable is used to define the proper function and keypad keys
93 for use under X. It is used in a fashion analogous to the environment
96 (defvar window-setup-hook nil
97 "Normal hook run to initialize window system display.
98 XEmacs runs this hook after processing the command line arguments and loading
99 the user's init file.")
101 (defconst initial-major-mode 'lisp-interaction-mode
102 "Major mode command symbol to use for the initial *scratch* buffer.")
104 (defvar emacs-roots nil
105 "List of plausible roots of the XEmacs hierarchy.")
107 (defvar user-init-directory-base ".xemacs"
108 "Base of directory where user-installed init files may go.")
110 (defvar user-init-directory
111 (file-name-as-directory
112 (paths-construct-path (list "~" user-init-directory-base)))
113 "Directory where user-installed init files may go.")
115 (defvar user-init-file-base "init.el"
116 "Default name of the user init file if uncompiled.
117 This should be used for migration purposes only.")
119 (defvar user-init-file-base-list '("init.elc" "init.el")
120 "List of allowed init files in the user's init directory.
121 The first one found takes precedence.")
123 (defvar user-home-init-file-base-list
124 (append '(".emacs.elc" ".emacs.el" ".emacs")
125 (and (eq system-type 'windows-nt)
126 '("_emacs.elc" "_emacs.el" "_emacs")))
127 "List of allowed init files in the user's home directory.
128 The first one found takes precedence.")
130 (defvar load-home-init-file nil
131 "Non-nil if XEmacs should load the init file from the home directory.
132 Otherwise, XEmacs will offer migration to the init directory.")
134 (defvar load-user-init-file-p t
135 "Non-nil if XEmacs should load the user's init file.")
137 ;; #### called `site-run-file' in FSFmacs
139 (defvar site-start-file "site-start"
140 "File containing site-wide run-time initializations.
141 This file is loaded at run-time before `.emacs'. It
142 contains inits that need to be in place for the entire site, but
143 which, due to their higher incidence of change, don't make sense to
144 load into XEmacs' dumped image. Thus, the run-time load order is:
146 1. file described in this variable, if non-nil;
148 3. `/path/to/xemacs/lisp/default.el'.
150 Don't use the `site-start.el' file for things some users may not like.
151 Put them in `default.el' instead, so that users can more easily
152 override them. Users can prevent loading `default.el' with the `-q'
153 option or by setting `inhibit-default-init' in their own init files,
154 but inhibiting `site-start.el' requires `--no-site-file', which
155 is less convenient.")
157 ;;(defconst iso-8859-1-locale-regexp "8859[-_]?1"
158 ;; "Regexp that specifies when to enable the ISO 8859-1 character set.
159 ;;We do that if this regexp matches the locale name
160 ;;specified by the LC_ALL, LC_CTYPE and LANG environment variables.")
162 (defcustom mail-host-address nil
163 "*Name of this machine, for purposes of naming users."
167 (defcustom user-mail-address nil
168 "*Full mailing address of this user.
169 This is initialized based on `mail-host-address',
170 after your init file is read, in case it sets `mail-host-address'."
174 (defvar init-file-debug nil)
176 (defvar init-file-had-error nil)
178 (defvar init-file-loaded nil
179 "True after the user's init file has been loaded (or suppressed with -q).
180 This will be true when `after-init-hook' is run and at all times
181 after, and will not be true at any time before.")
183 (defvar initial-frame-unmapped-p nil)
187 (defvar command-switch-alist
188 '(("-help" . command-line-do-help)
189 ("-version". command-line-do-version)
190 ("-V" . command-line-do-version)
191 ("-funcall". command-line-do-funcall)
192 ("-f" . command-line-do-funcall)
193 ("-e" . command-line-do-funcall-1)
194 ("-eval" . command-line-do-eval)
195 ("-load" . command-line-do-load)
196 ("-l" . command-line-do-load)
197 ("-insert" . command-line-do-insert)
198 ("-i" . command-line-do-insert)
199 ("-kill" . command-line-do-kill)
200 ;; Options like +35 are handled specially.
201 ;; Window-system, site, or package-specific code might add to this.
202 ;; X11 handles its options by letting Xt remove args from this list.
204 "Alist of command-line switches.
205 Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
206 HANDLER-FUNCTION receives switch name as sole arg;
207 remaining command-line args are in the variable `command-line-args-left'.")
210 ;;; Note: these doc strings are semi-magical.
212 (defun command-line-do-help (arg)
213 "Print the XEmacs usage message and exit."
214 (let ((standard-output 'external-debugging-output))
215 (princ (concat "\n" (emacs-version) "\n\n"))
218 (concat "When creating a window on an X display, "
220 " accepts all standard X Toolkit
221 command line options plus the following:
222 -iconname <title> Use title as the icon name.
223 -mc <color> Use color as the mouse color.
224 -cr <color> Use color as the text-cursor foregound color.
225 -private Install a private colormap.
229 (princ " following options are accepted:
230 -sd Show dump ID. Ignored when configured without --pdump.
231 -nd Don't load the dump file. Roughly like old temacs.
232 Ignored when configured without --pdump.
233 -t <device> Use TTY <device> instead of the terminal for input
234 and output. This implies the -nw option.
235 -nw Inhibit the use of any window-system-specific
236 display code: use the current tty.
237 -batch Execute noninteractively (messages go to stderr).
238 -debug-init Enter the debugger if an error in the init file occurs.
239 -unmapped Do not map the initial frame.
240 -no-site-file Do not load the site-specific init file (site-start.el).
241 -no-init-file Do not load the user-specific init file.
242 -no-early-packages Do not process early packages.
243 -no-autoloads Do not load global symbol files (auto-autoloads) at
244 startup. Also implies `-vanilla'.
245 -vanilla Equivalent to -q -no-site-file -no-early-packages.
246 -q Same as -no-init-file.
247 -user-init-file <file> Use <file> as init file.
248 -user-init-directory <directory> Use <directory> as init directory.
249 -user <user> Load user's init file instead of your own.
250 -u <user> Same as -user.\n")
251 (let ((l command-switch-alist)
252 (insert (lambda (&rest x)
257 (incf len (length (car x)))
260 (terpri) (setq len 0))
265 (let ((name (car (car l)))
269 ((and (symbolp fn) (get fn 'undocumented)) nil)
271 (setq doc (documentation fn))
272 (if (member doc '(nil "")) (setq doc "(undocumented)"))
273 (cond ((string-match "\n\\(<.*>\\)\n?\\'" doc)
274 ;; Doc of the form "The frobber switch\n<arg1> <arg2>"
275 (setq arg (substring doc (match-beginning 1) (match-end 1))
276 doc (substring doc 0 (match-beginning 0))))
277 ((string-match "\n+\\'" doc)
278 (setq doc (substring doc 0 (match-beginning 0)))))
279 (if (and (setq cons (rassq fn command-switch-alist))
280 (not (eq cons (car l))))
281 (setq doc (format "Same as %s." (car cons))))
283 (funcall insert name " " arg)
284 (funcall insert name))
289 +N <file> Start displaying <file> at line N.
291 Anything else is considered a file name, and is placed into a buffer for
294 " (emacs-name) " has an online tutorial and manuals. Type ^Ht (Control-h t) after
295 starting XEmacs to run the tutorial. Type ^Hi to enter the manual browser.
296 Type ^H^H^H (Control-h Control-h Control-h) to get more help options.\n")
300 (defun command-line-do-funcall (arg)
301 "Invoke the named lisp function with no arguments.
303 (funcall (intern (pop command-line-args-left))))
304 (fset 'command-line-do-funcall-1 'command-line-do-funcall)
305 (put 'command-line-do-funcall-1 'undocumented t)
307 (defun command-line-do-eval (arg)
308 "Evaluate the lisp form. Quote it carefully.
310 (eval (read (pop command-line-args-left))))
312 (defun command-line-do-load (arg)
313 "Load the named file of Lisp code into XEmacs.
315 (let ((file (pop command-line-args-left)))
316 ;; Take file from default dir if it exists there;
317 ;; otherwise let `load' search for it.
318 (if (file-exists-p (expand-file-name file))
319 (setq file (expand-file-name file)))
322 (defun command-line-do-insert (arg)
323 "Insert file into the current buffer.
325 (insert-file-contents (pop command-line-args-left)))
327 (defun command-line-do-kill (arg)
331 (defun command-line-do-version (arg)
332 "Print version info and exit."
333 (princ (concat (emacs-version) "\n"))
337 ;;; Processing the command line and loading various init files
339 (defun early-error-handler (&rest debugger-args)
340 "You should probably not be using this."
341 ;; Used as the debugger during XEmacs initialization; if an error occurs,
342 ;; print some diagnostics, and kill XEmacs.
344 ;; output the contents of the warning buffer, since it won't be seen
346 ;; #### kludge! The call to Feval forces the pending warnings to
347 ;; get output. There definitely needs to be a better way.
348 (let ((buffer (eval (get-buffer-create "*Warnings*"))))
349 (princ (buffer-substring (point-min buffer) (point-max buffer) buffer)
350 'external-debugging-output))
352 (let ((string "Initialization error")
353 (error (nth 1 debugger-args))
355 (stream 'external-debugging-output))
357 (princ string stream)
358 (princ (concat "\n" string ": ") stream)
360 (display-error error stream)
361 (error (princ "<<< error printing error message >>>" stream)))
363 (if (memq (car-safe error) '(void-function void-variable))
365 This probably means that XEmacs is picking up an old version of
366 the lisp library, or that some .elc files are not up-to-date.\n"
368 (when (not suppress-early-error-handler-backtrace)
369 (let ((print-length 1000)
371 (print-escape-newlines t)
372 (print-readably nil))
373 (when (getenv "EMACSLOADPATH")
374 (princ (format "\n$EMACSLOADPATH is %s" (getenv "EMACSLOADPATH"))
376 (princ (format "\nexec-directory is %S" exec-directory) stream)
377 (princ (format "\ndata-directory is %S" data-directory) stream)
378 (princ (format "\ndata-directory-list is %S" data-directory-list) stream)
379 (princ (format "\ndoc-directory is %S" doc-directory) stream)
380 (princ (format "\nload-path is %S" load-path) stream)
381 (princ "\n\n" stream)))
382 (when (not suppress-early-error-handler-backtrace)
383 (backtrace stream t)))
384 (if (fboundp 'mswindows-message-box)
385 (mswindows-message-box "Initialization error"))
388 (defun normal-top-level ()
389 (if command-line-processed
390 (message "Back to top level.")
391 (setq command-line-processed t)
392 ;; Canonicalize HOME (PWD is canonicalized by init_buffer in buffer.c)
393 (let ((value (user-home-directory)))
395 (< (length value) (length default-directory))
396 (equal (file-attributes default-directory)
397 (file-attributes value)))
398 (setq default-directory (file-name-as-directory value))))
399 (setq default-directory (abbreviate-file-name default-directory))
400 (initialize-xemacs-paths)
402 (startup-set-invocation-environment)
404 (let ((debug-paths (or debug-paths
405 (and (getenv "EMACSDEBUGPATHS")
408 (setq emacs-roots (paths-find-emacs-roots invocation-directory
412 (princ (format "emacs-roots:\n%S\n" emacs-roots)
413 'external-debugging-output))
415 (if (null emacs-roots)
416 (startup-find-roots-warning))
417 (startup-setup-paths emacs-roots
419 inhibit-early-packages
422 (startup-setup-paths-warning))
424 (when (and (not inhibit-autoloads)
426 (load (expand-file-name (file-name-sans-extension autoload-file-name)
427 lisp-directory) nil t)
428 (if (featurep 'utf-2000)
429 (load (expand-file-name
430 (file-name-sans-extension autoload-file-name)
431 (expand-file-name "utf-2000" lisp-directory))
434 (if (not inhibit-autoloads)
436 (if (not inhibit-early-packages)
437 (packages-load-package-auto-autoloads early-package-load-path))
438 (packages-load-package-auto-autoloads late-package-load-path)
439 (packages-load-package-auto-autoloads last-package-load-path)))
443 ;; Do this again, in case the init file defined more abbreviations.
444 (setq default-directory (abbreviate-file-name default-directory))
445 ;; Specify the file for recording all the auto save files of
446 ;; this session. This is used by recover-session.
447 (if auto-save-list-file-prefix
448 (setq auto-save-list-file-name
451 auto-save-list-file-prefix
454 (run-hooks 'emacs-startup-hook)
456 (run-hooks 'term-setup-hook))
457 (setq term-setup-hook nil)
458 ;; ;; Modify the initial frame based on what the init file puts into
459 ;; ;; ...-frame-alist.
460 (frame-notice-user-settings)
461 ;; ;;####FSFmacs junk
462 ;; ;; Now we know the user's default font, so add it to the menu.
463 ;; (if (fboundp 'font-menu-add-default)
464 ;; (font-menu-add-default))
465 (when window-setup-hook
466 (run-hooks 'window-setup-hook))
467 (setq window-setup-hook nil))
469 (if load-user-init-file-p
470 (maybe-migrate-user-init-file))
471 ;; FSF calls precompute-menubar-bindings. We don't mix menubars
475 (defun command-line-early (args)
476 ;; This processes those switches which need to be processed before
477 ;; starting up the window system.
479 (setq command-line-default-directory default-directory)
481 ;; See if we should import version-control from the environment variable.
482 (let ((vc (getenv "VERSION_CONTROL")))
483 (cond ((eq vc nil)) ;don't do anything if not set
484 ((or (string= vc "t")
485 (string= vc "numbered"))
486 (setq version-control t))
487 ((or (string= vc "nil")
488 (string= vc "existing"))
489 (setq version-control nil))
490 ((or (string= vc "never")
491 (string= vc "simple"))
492 (setq version-control 'never))))
496 ;; ;; Use the first of these three envvars that has a nonempty value.
497 ;; (or (let ((string (getenv "LC_ALL")))
498 ;; (and (not (equal string "")) string))
499 ;; (let ((string (getenv "LC_CTYPE")))
500 ;; (and (not (equal string "")) string))
501 ;; (let ((string (getenv "LANG")))
502 ;; (and (not (equal string "")) string)))))
504 ;; (string-match iso-8859-1-locale-regexp ctype)))
506 ;; (standard-display-european t)
507 ;; (require 'iso-syntax)))
509 (setq load-user-init-file-p (not (noninteractive)))
511 ;; Allow (at least) these arguments anywhere in the command line
515 (setq arg (pop args))
517 ((or (string= arg "-q")
518 (string= arg "-no-init-file"))
519 (setq load-user-init-file-p nil))
520 ((string= arg "-no-site-file")
521 (setq site-start-file nil))
522 ((or (string= arg "-no-early-packages")
523 (string= arg "--no-early-packages"))
524 (setq inhibit-early-packages t))
525 ((or (string= arg "-vanilla")
526 (string= arg "--vanilla")
527 ;; Some work on this one already done in emacs.c.
528 (string= arg "-no-autoloads")
529 (string= arg "--no-autoloads"))
530 (setq load-user-init-file-p nil
531 site-start-file nil))
532 ((string= arg "-user-init-file")
533 (setq user-init-file (pop args)))
534 ((string= arg "-user-init-directory")
535 (setq user-init-directory (file-name-as-directory (pop args))))
536 ((or (string= arg "-u")
537 (string= arg "-user"))
538 (let* ((user (pop args))
539 (home-user (concat "~" user)))
540 (setq user-init-directory (file-name-as-directory
541 (paths-construct-path
542 (list home-user user-init-directory-base))))
544 (find-user-init-file user-init-directory home-user))
546 (make-custom-file-name user-init-file))))
547 ((string= arg "-debug-init")
548 (setq init-file-debug t))
549 ((string= arg "-unmapped")
550 (setq initial-frame-unmapped-p t))
551 ((or (string= arg "-debug-paths")
552 (string= arg "--debug-paths"))
554 ((or (string= arg "--") (string= arg "-"))
556 (push (pop args) new-args)))
557 (t (push arg new-args))))
559 (setq init-file-user (and load-user-init-file-p ""))
561 (nreverse new-args)))
563 (defconst initial-scratch-message "\
564 ;; This buffer is for notes you don't want to save, and for Lisp evaluation.
565 ;; If you want to create a file, first visit that file with C-x C-f,
566 ;; then enter the text in that file's own buffer.
569 "Initial message displayed in *scratch* buffer at startup.
570 If this is nil, no message will be displayed.")
572 (defun command-line ()
573 (let ((command-line-args-left (cdr command-line-args)))
575 (let ((debugger 'early-error-handler)
578 ;; Process magic command-line switches like -q and -u. Do this
579 ;; before creating the first frame because some of these switches
580 ;; may affect that. I think it's ok to do this before establishing
581 ;; the X connection, and maybe someday things like -nw can be
582 ;; handled here instead of down in C.
583 (setq command-line-args-left (command-line-early command-line-args-left))
585 (when (eq system-type 'windows-nt)
586 (init-mswindows-at-startup))
588 ;; Setup the toolbar icon directory
589 (when (featurep 'toolbar)
590 (init-toolbar-location))
592 ;; Run the window system's init function. tty is considered to be
593 ;; a type of window system for this purpose. This creates the
594 ;; initial (non stdio) device.
595 (when (and initial-window-system (not noninteractive))
596 (funcall (intern (concat "init-"
597 (symbol-name initial-window-system)
600 ;; When not in batch mode, this creates the first visible frame,
601 ;; and deletes the stdio device.
604 ;; Reinitialize faces if necessary. This function changes face if
605 ;; it is created during auto-autoloads loading. Otherwise, it
607 (startup-initialize-custom-faces)
610 ;; We have normality, I repeat, we have normality. Anything you still
611 ;; can't cope with is therefore your own problem. (And we don't need
612 ;; to kill XEmacs for it.)
618 (with-current-buffer (get-buffer "*scratch*")
620 ;; (insert initial-scratch-message)
621 (set-buffer-modified-p nil)
622 (when (eq major-mode 'fundamental-mode)
623 (funcall initial-major-mode)))
625 ;; Load library for our terminal type.
626 ;; User init file can set term-file-prefix to nil to prevent this.
627 ;; Note that for any TTY's opened subsequently, the TTY init
628 ;; code will run this.
629 (when (and (eq 'tty (console-type))
630 (not (noninteractive)))
631 (load-terminal-library))
633 ;; Process the remaining args.
636 ;; it was turned on by default so that the warnings don't get displayed
637 ;; until after the splash screen.
638 (setq inhibit-warning-display nil)
639 ;; If -batch, terminate after processing the command options.
640 (when (noninteractive) (kill-emacs t))))
642 (defun load-terminal-library ()
643 (when term-file-prefix
644 (let ((term (getenv "TERM"))
647 (not (load (concat term-file-prefix term) t t)))
648 ;; Strip off last hyphen and what follows, then try again
649 (if (setq hyphend (string-match "[-_][^-_]+\\'" term))
650 (setq term (substring term 0 hyphend))
653 (defun find-user-init-directory-init-file (&optional init-directory)
654 "Determine the user's init file if in the init directory."
655 (let ((init-directory (or init-directory user-init-directory)))
657 (dolist (file user-init-file-base-list)
658 (let ((expanded (expand-file-name file init-directory)))
659 (when (file-readable-p expanded)
660 (throw 'found expanded)))))))
662 (defun find-user-home-directory-init-file (&optional home-directory)
663 "Determine the user's init file if in the home directory."
664 (let ((home-directory (or home-directory "~")))
666 (dolist (file user-home-init-file-base-list)
667 (let ((expanded (expand-file-name file home-directory)))
668 (when (file-readable-p expanded)
669 (throw 'found expanded))))
672 (defun find-user-init-file (&optional init-directory home-directory)
673 "Determine the user's init file."
674 (if load-home-init-file
675 (find-user-home-directory-init-file home-directory)
676 (or (find-user-init-directory-init-file init-directory)
677 (find-user-home-directory-init-file home-directory))))
679 (defun maybe-migrate-user-init-file ()
680 "Ask user if she wants to migrate the init file(s) to new location."
681 (if (and (not load-home-init-file)
682 (not (find-user-init-directory-init-file user-init-directory))
683 (stringp user-init-file)
684 (file-readable-p user-init-file))
685 (if (with-output-to-temp-buffer (help-buffer-name nil)
687 (princ "XEmacs recommends that the initialization code in
689 (princ user-init-file)
691 be migrated to the ")
692 (princ user-init-directory)
693 (princ " directory. XEmacs can
694 perform the migration automatically.
696 After the migration, init.el/init.elc holds user-written
697 initialization code. Moreover the customize settings will be in
700 You can undo the migration at any time with
701 M-x maybe-unmigrate-user-init-file.
703 If you choose not to do this now, XEmacs will not ask you this
704 question in the future. However, you can still make XEmacs
705 perform the migration at any time with M-x migrate-user-init-file.")
706 (show-temp-buffer-in-current-frame standard-output)
707 (yes-or-no-p-minibuf (concat "Migrate init file to "
711 (migrate-user-init-file)
712 (maybe-create-compatibility-dot-emacs))
713 (customize-save-variable 'load-home-init-file t))))
715 (defun maybe-create-compatibility-dot-emacs ()
716 "Ask user if she wants to create a .emacs compatibility file."
717 (if (with-output-to-temp-buffer (help-buffer-name nil)
719 (princ "The initialization code has now been migrated to the ")
720 (princ user-init-directory)
723 For backwards compatibility with, for example, older versions of XEmacs,
724 XEmacs can create a special old-style .emacs file in your home
725 directory which will load the relocated initialization code.")
726 (show-temp-buffer-in-current-frame standard-output)
727 (yes-or-no-p-minibuf "Create compatibility .emacs? ")))
728 (create-compatibility-dot-emacs)))
730 (defun migrate-user-init-file ()
731 "Migrate the init file from the home directory."
733 (if (not (file-exists-p user-init-directory))
735 (message "Creating %s directory..." user-init-directory)
736 (make-directory user-init-directory)))
737 (message "Migrating custom file...")
738 (customize-set-value 'load-home-init-file nil)
739 (custom-migrate-custom-file (make-custom-file-name user-init-file
741 (message "Moving init file...")
742 (let ((new-user-init-file (expand-file-name user-init-file-base
743 user-init-directory)))
744 (rename-file user-init-file new-user-init-file)
745 (setq user-init-file new-user-init-file))
746 (message "Migration done."))
748 (defun create-compatibility-dot-emacs ()
749 "Create .emacs compatibility file for migrated setup."
750 (message "Creating .emacs compatibility file.")
751 (with-temp-file (expand-file-name ".emacs" "~")
752 (insert ";;; XEmacs backwards compatibility file\n")
753 (insert "(setq user-init-file\n")
754 (insert " (expand-file-name \"init.el\"\n")
755 (insert " (expand-file-name \".xemacs\" \"~\")))\n")
756 (insert "(setq custom-file\n")
757 (insert " (expand-file-name \"custom.el\"\n")
758 (insert " (expand-file-name \".xemacs\" \"~\")))\n")
760 (insert "(load-file user-init-file)\n")
761 (insert "(load-file custom-file)"))
762 (message "Created .emacs compatibility file."))
764 (defun maybe-unmigrate-user-init-file ()
765 "Possibly unmigrate the user's init and custom files."
767 (let ((dot-emacs-file-name (expand-file-name ".emacs" "~")))
768 (if (and (not load-home-init-file)
769 (or (not (file-exists-p dot-emacs-file-name))
770 (yes-or-no-p-minibuf (concat "Overwrite " dot-emacs-file-name
772 (unmigrate-user-init-file dot-emacs-file-name))))
774 (defun unmigrate-user-init-file (&optional target-file-name)
775 "Unmigrate the user's init and custom files."
777 (let ((target-file-name
778 (or target-file-name (expand-file-name ".emacs" "~"))))
779 (rename-file user-init-file target-file-name 'ok-if-already-exists)
780 (setq user-init-file target-file-name)
781 (let ((old-custom-file custom-file))
782 (custom-migrate-custom-file target-file-name)
783 (customize-save-variable 'load-home-init-file t)
784 (delete-file old-custom-file))))
786 (defun load-user-init-file ()
787 "This function actually reads the init file."
788 (if (not user-init-file)
790 (find-user-init-file user-init-directory)))
791 (if (not custom-file)
792 (setq custom-file (make-custom-file-name user-init-file)))
793 (if (and user-init-file
794 (file-readable-p user-init-file))
795 (load user-init-file t t t))
797 (or (not user-init-file)
798 (not (string= custom-file user-init-file)))
799 (file-readable-p custom-file))
800 (load custom-file t t t))
801 (unless inhibit-default-init
802 (let ((inhibit-startup-message nil))
803 ;; Users are supposed to be told their rights.
804 ;; (Plus how to get help and how to undo.)
805 ;; Don't you dare turn this off for anyone except yourself.
806 (load "default" t t))))
808 ;;; Load user's init file and default ones.
809 (defun load-init-file ()
810 (run-hooks 'before-init-hook)
812 ;; Run the site-start library if it exists. The point of this file is
813 ;; that it is run before .emacs. There is no point in doing this after
814 ;; .emacs; that is useless.
815 (when site-start-file
816 (load site-start-file t t))
818 ;; Sites should not disable this. Only individuals should disable
819 ;; the startup message.
820 (setq inhibit-startup-message nil)
822 (let (debug-on-error-from-init-file
823 debug-on-error-should-be-set
824 (debug-on-error-initial
825 (if (eq init-file-debug t) 'startup init-file-debug)))
826 (let ((debug-on-error debug-on-error-initial))
827 (if (and load-user-init-file-p init-file-debug)
829 ;; Do this without a condition-case if the user wants to debug.
830 (load-user-init-file))
831 (condition-case error
833 (if load-user-init-file-p
834 (load-user-init-file))
835 (setq init-file-had-error nil))
837 (message "Error in init file: %s" (error-message-string error))
838 (display-warning 'initialization
840 An error has occurred while loading %s:
844 To ensure normal operation, you should investigate the cause of the error
845 in your initialization file and remove it. Use the `-debug-init' option
846 to XEmacs to view a complete error backtrace."
847 user-init-file (error-message-string error))
849 (setq init-file-had-error t))))
850 ;; If we can tell that the init file altered debug-on-error,
851 ;; arrange to preserve the value that it set up.
852 (or (eq debug-on-error debug-on-error-initial)
853 (setq debug-on-error-should-be-set t
854 debug-on-error-from-init-file debug-on-error)))
855 (when debug-on-error-should-be-set
856 (setq debug-on-error debug-on-error-from-init-file)))
858 (setq init-file-loaded t)
860 ;; Do this here in case the init file sets mail-host-address.
861 ;; Don't do this here unless noninteractive, it is frequently wrong. -sb
862 ;; (or user-mail-address
864 (setq user-mail-address (concat (user-login-name) "@"
865 (or mail-host-address
868 (run-hooks 'after-init-hook)
871 (defun load-options-file (filename)
872 "Load the file of saved options (from the Options menu) called FILENAME.
873 Currently this does nothing but call `load', but it might be redefined
874 in the future to support automatically converting older options files to
875 a new format, when variables have changed, etc."
878 (defun command-line-1 ()
880 ((null command-line-args-left)
881 (unless noninteractive
882 ;; If there are no switches to process, run the term-setup-hook
883 ;; before displaying the copyright notice; there may be some need
884 ;; to do it before doing any output. If we're not going to
885 ;; display a copyright notice (because other options are present)
886 ;; then this is run after those options are processed.
887 (run-hooks 'term-setup-hook)
888 ;; Don't let the hook be run twice.
889 (setq term-setup-hook nil)
891 ;; Don't clobber a non-scratch buffer if init file
893 (when (string= (buffer-name) "*scratch*")
894 (unless (or inhibit-startup-message
896 (let (tmout circ-tmout)
898 ;; Guts of with-timeout
900 (setq tmout (add-timeout startup-message-timeout
906 (setq circ-tmout (display-splash-frame))
907 (or nil;; (pos-visible-in-window-p (point-min))
908 (goto-char (point-min)))
910 (setq unread-command-event (next-command-event)))
911 (when tmout (disable-timeout tmout))
912 (when circ-tmout (disable-timeout circ-tmout)))))
913 (with-current-buffer (get-buffer "*scratch*")
914 ;; In case the XEmacs server has already selected
915 ;; another buffer, erase the one our message is in.
917 (when (stringp initial-scratch-message)
918 (insert initial-scratch-message))
919 (set-buffer-modified-p nil)))))
922 ;; Command-line-options exist
923 (let ((dir command-line-default-directory)
928 (while command-line-args-left
929 (setq arg (pop command-line-args-left))
933 ((setq tem (when (eq (aref arg 0) ?-)
934 (or (assoc arg command-switch-alist)
935 (assoc (substring arg 1)
936 command-switch-alist))))
937 (funcall (cdr tem) arg))
938 ((string-match "\\`\\+[0-9]+\\'" arg)
939 (setq line (string-to-int arg)))
940 ;; "- file" means don't treat "file" as a switch
941 ;; ("+0 file" has the same effect; "-" added
942 ;; for unixoidiality).
943 ;; This is worthless; the `unixoid' way is "./file". -jwz
944 ((or (string= arg "-") (string= arg "--"))
945 (setq end-of-options t))
952 (setq arg (expand-file-name arg dir))
956 (noninteractive (find-file arg))
957 (t (find-file-other-window arg)))
960 (setq line nil))))))))
962 (defvar startup-presentation-hack-keymap
963 (let ((map (make-sparse-keymap)))
964 (set-keymap-name map 'startup-presentation-hack-keymap)
965 (define-key map '[button1] 'startup-presentation-hack)
966 (define-key map '[button2] 'startup-presentation-hack)
968 "Putting yesterday in the future tomorrow.")
970 (defun startup-presentation-hack ()
972 (let ((e last-command-event))
973 (and (button-press-event-p e)
974 (setq e (extent-at (event-point e)
976 'startup-presentation-hack))
977 (setq e (extent-property e 'startup-presentation-hack))
979 (apply (car e) (cdr e))
980 (while (keymapp (indirect-function e))
982 (overriding-local-map (indirect-function e)))
983 (setq e (read-key-sequence
984 (let ((p (keymap-prompt map t)))
987 (format "%s %s " map p)
991 (prin1-to-string map))))))
992 (if (and (button-release-event-p (elt e 0))
993 (null (key-binding e)))
994 (setq e map) ; try again
995 (setq e (key-binding e)))))
996 (call-interactively e)))))
998 (defun startup-presentation-hack-help (e)
999 (setq e (extent-property e 'startup-presentation-hack))
1001 (format "Evaluate %S" e)
1004 (defun splash-frame-present-hack (e v)
1005 ;; (set-extent-property e 'mouse-face 'highlight)
1006 ;; (set-extent-property e 'keymap
1007 ;; startup-presentation-hack-keymap)
1008 ;; (set-extent-property e 'startup-presentation-hack v)
1009 ;; (set-extent-property e 'help-echo
1010 ;; 'startup-presentation-hack-help)
1013 (defun splash-hack-version-string ()
1016 (goto-char (point-min))
1017 (re-search-forward "^XEmacs" nil t)
1018 (narrow-to-region (point-at-bol) (point-at-eol))
1019 (goto-char (point-min))
1020 (when (re-search-forward " \\[Lucid\\]" nil t)
1021 (delete-region (match-beginning 0) (match-end 0)))
1022 (when (re-search-forward "[^(][^)]*-[^)]*-" nil t)
1023 (delete-region (1+ (match-beginning 0)) (match-end 0))
1025 (goto-char (point-max))
1026 (search-backward " " nil t)
1027 (when (search-forward "." nil t)
1028 (delete-region (1- (point)) (point-max))))))
1030 (defun splash-frame-present (l)
1033 ((eq (car-safe l) 'face)
1034 ;; (face name string)
1036 (splash-frame-present (elt l 2))
1037 (if (fboundp 'set-extent-face)
1038 (set-extent-face (make-extent p (point))
1040 ((eq (car-safe l) 'key)
1041 (let* ((c (elt l 1))
1043 (k (where-is-internal c nil t)))
1044 (insert (if k (key-description k)
1045 (format "M-x %s" c)))
1046 (if (fboundp 'set-extent-face)
1047 (let ((e (make-extent p (point))))
1048 (set-extent-face e 'bold)
1049 (splash-frame-present-hack e c)))))
1050 ((eq (car-safe l) 'funcall)
1051 ;; (funcall (fun . args) string)
1053 (splash-frame-present (elt l 2))
1054 (if (fboundp 'set-extent-face)
1055 (splash-frame-present-hack (make-extent p (point))
1058 (mapcar 'splash-frame-present l))
1062 (defun startup-center-spaces (glyph)
1063 ;; Return the number of spaces to insert in order to center
1064 ;; the given glyph (may be a string or a pixmap).
1065 ;; Assume spaces are as wide as avg-pixwidth.
1066 ;; Won't be quite right for proportional fonts, but it's the best we can do.
1067 ;; Maybe the new redisplay will export something a glyph-width function.
1068 ;;; #### Yes, there is a glyph-width function but it isn't quite what
1069 ;;; #### this was expecting. Or is it?
1070 ;; (An alternate way to get avg-pixwidth would be to use x-font-properties
1071 ;; and calculate RESOLUTION_X * AVERAGE_WIDTH / 722.7, but it's no better.)
1073 ;; This function is used in about.el too.
1074 (let* ((avg-pixwidth (round (/ (frame-pixel-width) (frame-width))))
1075 (fill-area-width (* avg-pixwidth (- fill-column left-margin)))
1076 (glyph-pixwidth (cond ((stringp glyph)
1077 (* avg-pixwidth (length glyph)))
1078 ;; #### the pixmap option should be removed
1080 ;; (pixmap-width glyph))
1082 (glyph-width glyph))
1084 (error "startup-center-spaces: bad arg")))))
1086 (round (/ (/ (- fill-area-width glyph-pixwidth) 2) avg-pixwidth)))))
1088 (defun splash-frame-body ()
1089 `[((face (blue bold underline)
1090 "\nDistribution, copying license, warranty:\n\n")
1091 "Please visit the XEmacs website at http://www.xemacs.org !\n\n"
1092 ,@(if (featurep 'sparcworks)
1094 Sun provides support for the WorkShop/XEmacs integration package only.
1095 All other XEmacs packages are provided to you \"AS IS\".\n"
1096 ,@(let ((lang (or (getenv "LC_ALL") (getenv "LC_MESSAGES")
1099 (not (featurep 'mule)) ;; Already got mule?
1100 ;; No Mule support on tty's yet
1101 (not (eq 'tty (console-type)))
1102 lang ;; Non-English locale?
1103 (not (string= lang "C"))
1104 (not (string-match "^en" lang))
1105 ;; Comes with Sun WorkShop
1106 (locate-file "xemacs-mule" exec-path))
1108 This version of XEmacs has been built with support for Latin-1 languages only.
1109 To handle other languages you need to run a Multi-lingual (`Mule') version of
1110 XEmacs, by either running the command `xemacs-mule', or by using the X resource
1111 `ESERVE*defaultXEmacsPath: xemacs-mule' when starting XEmacs from Sun WorkShop.
1113 ((key describe-no-warranty)
1114 ": "(face (red bold) "XEmacs comes with ABSOLUTELY NO WARRANTY\n"))
1115 ((key describe-copying)
1116 ": conditions to give out copies of XEmacs\n")
1117 ((key describe-distribution)
1118 ": how to get the latest version\n")
1121 Copyright (C) 1985-2001 Free Software Foundation, Inc.
1122 Copyright (C) 1990-1994 Lucid, Inc.
1123 Copyright (C) 1993-1997 Sun Microsystems, Inc. All Rights Reserved.
1124 Copyright (C) 1994-1996 Board of Trustees, University of Illinois
1125 Copyright (C) 1995-2001 Ben Wing
1126 Copyright (C) 1996-2002 MORIOKA Tomohiko
1129 ((face (blue bold underline) "\nInformation, on-line help:\n\n")
1130 "XEmacs comes with plenty of documentation...\n\n"
1131 ,@(if (string-match "beta" emacs-version)
1132 `((key describe-beta)
1133 ": " (face (red bold)
1134 "This is an Experimental version of XEmacs.\n"))
1136 ((key xemacs-local-faq)
1137 ": read the XEmacs FAQ (a " (face underline "capital") " F!)\n")
1138 ((key help-with-tutorial)
1139 ": read the XEmacs tutorial (also available through the "
1140 (face bold "Help") " menu)\n")
1142 ": get help on using XEmacs (also available through the "
1143 (face bold "Help") " menu)\n")
1144 ((key info) ": read the on-line documentation\n\n")
1145 ((key describe-project) ": read about the GNU project\n")
1146 ((key about-xemacs) ": see who's developing XEmacs\n"))
1148 ((face (blue bold underline) "\nUseful stuff:\n\n")
1149 "Things that you should know rather quickly...\n\n"
1150 ((key find-file) ": visit a file\n")
1151 ((key save-buffer) ": save changes\n")
1152 ((key advertised-undo) ": undo changes\n")
1153 ((key save-buffers-kill-emacs) ": exit XEmacs\n"))
1156 ;; I really hate global variables, oh well.
1157 ;(defvar xemacs-startup-logo-function nil
1158 ; "If non-nil, function called to provide the startup logo.
1159 ;This function should return an initialized glyph if it is used.")
1161 ;; This will hopefully go away when gettext is functional.
1162 (defconst splash-frame-static-body
1163 `(,(emacs-version) "\n\n"
1164 (face italic "`C-' means the control key,`M-' means the meta key\n\n")))
1167 (defun circulate-splash-frame-elements (client-data)
1168 (with-current-buffer (aref client-data 2)
1169 (let ((buffer-read-only nil)
1170 (elements (aref client-data 3))
1171 (indice (aref client-data 0)))
1172 (goto-char (aref client-data 1))
1173 (delete-region (point) (point-max))
1174 (splash-frame-present (aref elements indice))
1175 (set-buffer-modified-p nil)
1177 (if (= indice (- (length elements) 1))
1182 ;; #### This function now returns the (possibly nil) timeout circulating the
1183 ;; splash-frame elements
1184 (defun display-splash-frame ()
1185 (let ((logo xemacs-logo)
1186 (buffer-read-only nil)
1187 (cramped-p (eq 'tty (console-type))))
1188 (unless cramped-p (insert "\n"))
1189 (indent-to (startup-center-spaces logo))
1190 (set-extent-begin-glyph (make-extent (point) (point)) logo)
1191 ;;(splash-frame-present-hack (make-extent p (point)) 'about-xemacs))
1193 (splash-frame-present splash-frame-static-body)
1194 (splash-hack-version-string)
1195 (goto-char (point-max))
1196 (let* ((after-change-functions nil) ; no font-lock, thank you
1197 (elements (splash-frame-body))
1198 (client-data `[ 1 ,(point) ,(current-buffer) ,elements ])
1200 (if (listp elements) ;; A single element to display
1201 (splash-frame-present (splash-frame-body))
1202 ;; several elements to rotate
1203 (splash-frame-present (aref elements 0))
1204 (setq tmout (add-timeout splash-frame-timeout
1205 'circulate-splash-frame-elements
1206 client-data splash-frame-timeout)))
1207 (set-buffer-modified-p nil)
1210 ;; (let ((present-file
1212 ;; (splash-frame-present
1214 ;; (list 'find-file-other-window
1215 ;; (expand-file-name f data-directory))
1217 ;; (insert "For customization examples, see the files ")
1218 ;; (funcall present-file "sample.emacs")
1220 ;; (funcall present-file "sample.Xdefaults")
1221 ;; (insert (format "\nin the directory %s." data-directory)))
1223 (defun startup-set-invocation-environment ()
1224 ;; XEmacs -- Steven Baur says invocation directory is nil if you
1225 ;; try to use XEmacs as a login shell.
1226 (or invocation-directory (setq invocation-directory default-directory))
1227 (setq invocation-directory
1228 ;; don't let /tmp_mnt/... get into the load-path or exec-path.
1229 (abbreviate-file-name invocation-directory)))
1231 (defun startup-setup-paths (roots user-init-directory
1233 inhibit-early-packages inhibit-site-lisp
1235 "Setup all the various paths.
1236 ROOTS is a list of plausible roots of the XEmacs directory hierarchy.
1237 If INHIBIT-PACKAGES is non-NIL, don't do packages.
1238 If INHIBIT-SITE-LISP is non-NIL, don't do site-lisp.
1239 If DEBUG-PATHS is non-NIL, print paths as they are detected.
1240 It's idempotent, so call this as often as you like!"
1242 (apply #'(lambda (early late last)
1243 (setq early-packages (and (not inhibit-early-packages)
1245 (setq late-packages late)
1246 (setq last-packages last))
1247 (packages-find-packages
1249 (packages-compute-package-locations user-init-directory)))
1251 (setq early-package-load-path (packages-find-package-load-path early-packages))
1252 (setq late-package-load-path (packages-find-package-load-path late-packages))
1253 (setq last-package-load-path (packages-find-package-load-path last-packages))
1257 (princ (format "configure-package-path:\n%S\n" configure-package-path)
1258 'external-debugging-output)
1259 (princ (format "early-packages and early-package-load-path:\n%S\n%S\n"
1260 early-packages early-package-load-path)
1261 'external-debugging-output)
1262 (princ (format "late-packages and late-package-load-path:\n%S\n%S\n"
1263 late-packages late-package-load-path)
1264 'external-debugging-output)
1265 (princ (format "last-packages and last-package-load-path:\n%S\n%S\n"
1266 last-packages last-package-load-path)
1267 'external-debugging-output)))
1269 (setq lisp-directory (paths-find-lisp-directory roots))
1272 (princ (format "lisp-directory:\n%S\n" lisp-directory)
1273 'external-debugging-output))
1275 (if (featurep 'mule)
1277 (setq mule-lisp-directory
1278 (paths-find-mule-lisp-directory roots
1281 (princ (format "mule-lisp-directory:\n%S\n"
1282 mule-lisp-directory)
1283 'external-debugging-output)))
1284 (setq mule-lisp-directory '()))
1286 (if (featurep 'utf-2000)
1288 (setq utf-2000-lisp-directory
1289 (paths-find-utf-2000-lisp-directory roots
1292 (princ (format "utf-2000-lisp-directory:\n%S\n"
1293 utf-2000-lisp-directory)
1294 'external-debugging-output)))
1295 (setq utf-2000-lisp-directory '()))
1297 (setq site-directory (and (null inhibit-site-lisp)
1298 (paths-find-site-lisp-directory roots)))
1300 (if (and debug-paths (null inhibit-site-lisp))
1301 (princ (format "site-directory:\n%S\n" site-directory)
1302 'external-debugging-output))
1304 (setq load-path (paths-construct-load-path roots
1305 early-package-load-path
1306 late-package-load-path
1307 last-package-load-path
1311 utf-2000-lisp-directory))
1313 (setq Info-directory-list
1314 (paths-construct-info-path roots
1315 early-packages late-packages last-packages))
1319 (princ (format "Info-directory-list:\n%S\n" Info-directory-list)
1320 'external-debugging-output))
1322 (setq exec-directory (paths-find-exec-directory roots))
1325 (princ (format "exec-directory:\n%s\n" exec-directory)
1326 'external-debugging-output))
1329 (paths-construct-exec-path roots exec-directory
1330 early-packages late-packages last-packages))
1333 (princ (format "exec-path:\n%S\n" exec-path)
1334 'external-debugging-output))
1336 (setq doc-directory (paths-find-doc-directory roots))
1339 (princ (format "doc-directory:\n%S\n" doc-directory)
1340 'external-debugging-output))
1342 (setq data-directory (paths-find-data-directory roots))
1345 (princ (format "data-directory:\n%S\n" data-directory)
1346 'external-debugging-output))
1348 (setq data-directory-list (paths-construct-data-directory-list data-directory
1353 (princ (format "data-directory-list:\n%S\n" data-directory-list)
1354 'external-debugging-output)))
1356 (defun startup-find-roots-warning ()
1358 (set-buffer (get-buffer-create " *warning-tmp*"))
1360 (buffer-disable-undo (current-buffer))
1362 (insert "Couldn't find an obvious default for the root of the\n"
1363 "XEmacs hierarchy.")
1365 (princ "\nWARNING:\n" 'external-debugging-output)
1366 (princ (buffer-string) 'external-debugging-output)))
1368 (defun startup-setup-paths-warning ()
1369 (let ((warnings '()))
1371 ((null (and lisp-directory exec-directory data-directory doc-directory
1374 (set-buffer (get-buffer-create " *warning-tmp*"))
1376 (buffer-disable-undo (current-buffer))
1377 (if (null lisp-directory) (push "lisp-directory" warnings))
1378 (if (and (featurep 'mule)
1379 (null mule-lisp-directory))
1380 (push "mule-lisp-directory" warnings))
1381 (if (and (featurep 'utf-2000)
1382 (null utf-2000-lisp-directory))
1383 (push "utf-2000-lisp-directory" warnings))
1384 (if (null exec-directory) (push "exec-directory" warnings))
1385 (if (null data-directory) (push "data-directory" warnings))
1386 (if (null doc-directory) (push "doc-directory" warnings))
1387 (if (null load-path) (push "load-path" warnings))
1389 (insert "Couldn't find obvious defaults for:\n")
1391 (insert (car warnings) "\n")
1392 (setq warnings (cdr warnings)))
1393 (insert "Perhaps some directories don't exist, "
1394 "or the XEmacs executable,\n" (concat invocation-directory
1396 "\nis in a strange place?")
1398 (princ "\nWARNING:\n" 'external-debugging-output)
1399 (princ (buffer-string) 'external-debugging-output)
1403 ;;; startup.el ends here