*** empty log message ***
[bpt/emacs.git] / lisp / startup.el
index 4ef0466..9aceed4 100644 (file)
@@ -1,6 +1,6 @@
 ;;; startup.el --- process Emacs shell arguments
 
-;; Copyright (C) 1985, 1986, 1992, 1994, 1995 Free Software Foundation, Inc.
+;; Copyright (C) 1985, 86, 92, 94, 95, 1996 Free Software Foundation, Inc.
 
 ;; Maintainer: FSF
 ;; Keywords: internal
 
 (defvar command-line-processed nil "t once command line has been processed")
 
-(defconst inhibit-startup-message nil
+(defvar inhibit-startup-message nil
   "*Non-nil inhibits the initial startup message.
 This is for use in your personal init file, once you are familiar
 with the contents of the startup message.")
 
-(defconst inhibit-startup-echo-area-message nil
+(defvar inhibit-startup-echo-area-message nil
   "*Non-nil inhibits the initial startup echo area message.
 Inhibition takes effect only if your `.emacs' file contains
 a line of this form:
@@ -133,10 +133,10 @@ If your `.emacs' file is byte-compiled, use the following form instead:
 Thus, someone else using a copy of your `.emacs' file will see
 the startup message unless he personally acts to inhibit it.")
 
-(defconst inhibit-default-init nil
+(defvar inhibit-default-init nil
   "*Non-nil inhibits loading the `default' library.")
 
-(defconst command-switch-alist nil
+(defvar command-switch-alist nil
   "Alist of command-line switches.
 Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
 HANDLER-FUNCTION receives switch name as sole arg;
@@ -163,9 +163,9 @@ This is normally copied from `default-directory' when Emacs starts.")
   '(("-bw" 1 x-handle-numeric-switch border-width)
     ("-d" 1 x-handle-display)
     ("-display" 1 x-handle-display)
-    ("-name" 1 x-handle-name-rn-switch)
-    ("-rn" 1 x-handle-name-rn-switch)
-    ("-T" 1 x-handle-switch name)
+    ("-name" 1 x-handle-name-switch)
+    ("-title" 1 x-handle-switch title)
+    ("-T" 1 x-handle-switch title)
     ("-r" 0 x-handle-switch reverse t)
     ("-rv" 0 x-handle-switch reverse t)
     ("-reverse" 0 x-handle-switch reverse t)
@@ -190,8 +190,8 @@ This is normally copied from `default-directory' when Emacs starts.")
     ("-bd" 1 x-handle-switch)
     ("--border-width" 1 x-handle-numeric-switch border-width)
     ("--display" 1 x-handle-display)
-    ("--name" 1 x-handle-name-rn-switch)
-    ("--title" 1 x-handle-name-rn-switch)
+    ("--name" 1 x-handle-name-switch)
+    ("--title" 1 x-handle-switch title)
     ("--reverse-video" 0 x-handle-switch reverse t)
     ("--font" 1 x-handle-switch font)
     ("--internal-border" 1 x-handle-numeric-switch internal-border-width)
@@ -215,18 +215,20 @@ and VALUE is the value which is given to that frame parameter
 \(most options use the argument for this, so VALUE is not present).")
 
 (defvar before-init-hook nil
-  "Functions to call after handling urgent options but before init files.
-The frame system uses this to open frames to display messages while
-Emacs loads the user's initialization file.")
+  "Normal hook run after handling urgent options but before loading init files.")
 
 (defvar after-init-hook nil
-  "Functions to call after loading the init file (`~/.emacs').
-The call is not protected by a condition-case, so you can set `debug-on-error'
-in `.emacs', and put all the actual code on `after-init-hook'.")
+  "Normal hook run after loading the init files, `~/.emacs' and `default.el'.
+There is no `condition-case' around the running of these functions;
+therefore, if you set `debug-on-error' non-nil in `.emacs',
+an error in one of these functions will invoke the debugger.")
+
+(defvar emacs-startup-hook nil
+  "Normal hook run after loading init files and handling the command line.")
 
 (defvar term-setup-hook nil
-  "Functions to be called after loading terminal-specific Lisp code.
-See `run-hooks'.  This variable exists for users to set,
+  "Normal hook run after loading terminal-specific Lisp code.
+It also follows `emacs-startup-hook'.  This hook exists for users to set,
 so as to override the definitions made by the terminal-specific file.
 Emacs never sets this variable itself.")
 
@@ -241,14 +243,17 @@ fashion analogous to the environment value TERM.")
 Emacs runs this hook after processing the command line arguments and loading
 the user's init file.")
 
-(defconst initial-major-mode 'lisp-interaction-mode
+(defvar initial-major-mode 'lisp-interaction-mode
   "Major mode command symbol to use for the initial *scratch* buffer.")
 
 (defvar init-file-user nil
   "Identity of user whose `.emacs' file is or was read.
-The value is nil if no init file is being used; otherwise, it may be either
-the null string, meaning that the init file was taken from the user that
-originally logged in, or it may be a string containing a user's name.
+The value is nil if `-q' or `--no-init-file' was specified,
+meaning do not load any init file.
+
+Otherwise, the value may be the null string, meaning use the init file
+for the user that originally logged in, or it may be a
+string containing a user's name meaning use that person's init file.
 
 In either of the latter cases, `(concat \"~\" init-file-user \"/\")'
 evaluates to the name of the directory where the `.emacs' file was
@@ -302,7 +307,7 @@ from being initialized.")
 
 ;; This function is called from the subdirs.el file.
 (defun normal-top-level-add-to-load-path (dirs)
-  (let ((tail (member default-directory load-path)))
+  (let ((tail (member (directory-file-name default-directory) load-path)))
     (setcdr tail (append (mapcar 'expand-file-name dirs) (cdr tail)))))
 
 (defun normal-top-level ()
@@ -376,7 +381,7 @@ from being initialized.")
        (and window-setup-hook
             (run-hooks 'window-setup-hook))
        (or menubar-bindings-done
-           (if (or (eq window-system 'x) (eq window-system 'win32))
+           (if (memq window-system '(x w32))
                (precompute-menubar-bindings)))))))
 
 ;; Precompute the keyboard equivalents in the menu bar items.
@@ -481,15 +486,16 @@ from being initialized.")
                 (string-match "=" argi))
            (setq argval (substring argi (match-end 0))
                  argi (substring argi 0 (match-beginning 0))))
-       (let ((completion (try-completion argi longopts)))
-         (if (eq completion t)
-             (setq argi (substring argi 1))
-           (if (stringp completion)
-               (let ((elt (assoc completion longopts)))
-                 (or elt
-                     (error "Option `%s' is ambiguous" argi))
-                 (setq argi (substring (car elt) 1)))
-             (setq argval nil))))
+       (or (equal argi "--")
+           (let ((completion (try-completion argi longopts)))
+             (if (eq completion t)
+                 (setq argi (substring argi 1))
+               (if (stringp completion)
+                   (let ((elt (assoc completion longopts)))
+                     (or elt
+                         (error "Option `%s' is ambiguous" argi))
+                     (setq argi (substring (car elt) 1)))
+                 (setq argval nil)))))
        (cond
         ((or (string-equal argi "-q")
              (string-equal argi "-no-init-file"))
@@ -533,7 +539,7 @@ from being initialized.")
   (if (fboundp 'frame-initialize)
       (frame-initialize))
   ;; If frame was created with a menu bar, set menu-bar-mode on.
-  (if (or (not (or (eq window-system 'x) (eq window-system 'win32)))
+  (if (or (not (memq window-system '(x w32)))
          (> (cdr (assq 'menu-bar-lines (frame-parameters))) 0))
       (menu-bar-mode t))
 
@@ -566,7 +572,9 @@ from being initialized.")
                           ((eq system-type 'ms-dos)
                            (concat "~" init-file-user "/_emacs"))
                           ((eq system-type 'windows-nt)
-                           "~/_emacs")
+                           (if (file-exists-p "~/.emacs") 
+                               "~/.emacs"
+                             "~/_emacs"))
                           ((eq system-type 'vax-vms) 
                            "sys$login:.emacs")
                           (t 
@@ -683,7 +691,7 @@ from being initialized.")
             (setq window-setup-hook nil)
             ;; Do this now to avoid an annoying delay if the user
             ;; clicks the menu bar during the sit-for.
-            (if (or (eq window-system 'x) (eq window-system 'win32))
+            (if (memq window-system '(x w32))
                 (precompute-menubar-bindings))
             (setq menubar-bindings-done t)
             (unwind-protect
@@ -691,27 +699,29 @@ from being initialized.")
                   ;; The convention for this piece of code is that
                   ;; each piece of output starts with one or two newlines
                   ;; and does not end with any newlines.
-                  (insert (emacs-version)
-                          "
-Copyright (C) 1996 Free Software Foundation, Inc.")
+                  (insert "Welcome to GNU Emacs")
+                  (if (eq system-type 'gnu/linux)
+                      (insert ", one component of a Linux-based GNU system."))
+                  (insert "\n")
                   ;; If keys have their default meanings,
                   ;; use precomputed string to save lots of time.
                   (if (and (eq (key-binding "\C-h") 'help-command)
                            (eq (key-binding "\C-xu") 'advertised-undo)
                            (eq (key-binding "\C-x\C-c") 'save-buffers-kill-emacs)
                            (eq (key-binding "\C-ht") 'help-with-tutorial)
-                           (eq (key-binding "\C-hi") 'info))
-                      (insert "\n
-Type C-h for help; C-x u to undo changes.  (`C-' means use CTRL key.)
-To kill the Emacs job, type C-x C-c.
-Type C-h t for a tutorial on using Emacs.
-Type C-h i to enter Info, which you can use to read GNU documentation.")
+                           (eq (key-binding "\C-hi") 'info)
+                           (eq (key-binding "\C-h\C-n") 'view-emacs-news))
+                      (insert "
+Get help          C-h  (Hold down CTRL and press h)
+Undo changes      C-x u       Exit Emacs               C-x C-c
+Get a tutorial    C-h t       Use Info to read docs    C-h i")
                     (insert (substitute-command-keys
                              (format "\n
-Type %s for help; \\[advertised-undo] to undo changes.  (`C-' means use CTRL key.)
-To kill the Emacs job, type \\[save-buffers-kill-emacs].
-Type \\[help-with-tutorial] for a tutorial on using Emacs.
-Type \\[info] to enter Info, which you can use to read GNU documentation."
+Get help          %s
+Undo changes      \\[advertised-undo]
+Exit Emacs        \\[save-buffers-kill-emacs]
+Get a tutorial    \\[help-with-tutorial]
+Use Info to read docs  \\[info]"
                                      (let ((where (where-is-internal
                                                    'help-command nil t)))
                                        (if where
@@ -720,27 +730,37 @@ Type \\[info] to enter Info, which you can use to read GNU documentation."
                   ;; Say how to use the menu bar
                   ;; if that is not with the mouse.
                   (if (not (assq 'display (frame-parameters)))
-                      (if (eq (key-binding "\M-`") 'tmm-menubar)
-                          (insert "\n\nType F10, ESC ` or Meta-` to use the menu bar.")
-                        (insert (substitute-command-keys
-                                 "\n\nType \\[tmm-menubar] to use the menu bar."))))
+                      (if (and (eq (key-binding "\M-`") 'tmm-menubar)
+                               (eq (key-binding [f10]) 'tmm-menubar))
+                          (insert "
+Activate menubar   F10  or  ESC `  or   M-`")
+                        (insert (substitute-command-keys "
+Activate menubar     \\[tmm-menubar]"))))
 
                   ;; Windows and MSDOS (currently) do not count as
                   ;; window systems, but do have mouse support.
                   (if window-system
-                      (insert "\n
-C-mouse-3 (third mouse button, with Control) gets a mode-specific menu."))
-                  (if (directory-files (file-name-directory auto-save-list-file-prefix)
-                                       nil
-                                       (concat "\\`"
-                                               (regexp-quote
-                                                (file-name-nondirectory
-                                                 auto-save-list-file-prefix)))
-                                       t)
-                      (insert "\n\nIf an Emacs session crashed recently,\n"
-                              "type M-x recover-session RET to recover"
-                              " the files you were editing."))
-
+                      (insert "
+Mode-specific menu   C-mouse-3 (third button, with CTRL)"))
+                  ;; Many users seem to have problems with these.
+                  (insert "
+\(`C-' means use the CTRL key.  `M-' means use the Meta (or Alt) key.
+If you have no Meta key, you may instead type ESC followed by the character.)")
+                  (and auto-save-list-file-prefix
+                       (directory-files
+                        (file-name-directory auto-save-list-file-prefix)
+                        nil
+                        (concat "\\`"
+                                (regexp-quote (file-name-nondirectory
+                                               auto-save-list-file-prefix)))
+                        t)
+                       (insert "\n\nIf an Emacs session crashed recently, "
+                               "type M-x recover-session RET\nto recover"
+                               " the files you were editing."))
+
+                  (insert "\n\n" (emacs-version)
+                          "
+Copyright (C) 1996 Free Software Foundation, Inc.")
                   (if (and (eq (key-binding "\C-h\C-c") 'describe-copying)
                            (eq (key-binding "\C-h\C-d") 'describe-distribution)
                            (eq (key-binding "\C-h\C-w") 'describe-no-warranty))
@@ -754,6 +774,7 @@ Type C-h C-d for information on getting the latest version.")
 GNU Emacs comes with ABSOLUTELY NO WARRANTY; type \\[describe-no-warranty] for full details.
 You may give out copies of Emacs; type \\[describe-copying] to see the conditions.
 Type \\[describe-distribution] for information on getting the latest version.")))
+                  (goto-char (point-min))
 
                   (set-buffer-modified-p nil)
                   (sit-for 120))
@@ -770,46 +791,56 @@ Type \\[describe-distribution] for information on getting the latest version."))
     (let ((dir command-line-default-directory)
          (file-count 0)
          first-file-buffer
+         tem
+         just-files  ;; t if this follows the magic -- option.
+         ;; This includes our standard options' long versions
+         ;; and long versions of what's on command-switch-alist.
+         (longopts
+          (append '(("--funcall") ("--load") ("--insert") ("--kill")
+                    ("--directory") ("--eval") ("--find-file") ("--visit"))
+                  (mapcar '(lambda (elt)
+                             (list (concat "-" (car elt))))
+                          command-switch-alist)))
          (line 0))
-      (while command-line-args-left
+
+      ;; Add the long X options to longopts.
+      (setq tem command-line-x-option-alist)
+      (while tem
+       (if (string-match "^--" (car (car tem)))
+           (setq longopts (cons (list (car (car tem))) longopts)))
+       (setq tem (cdr tem)))
+
+      ;; Loop, processing options.
+      (while (and command-line-args-left)
        (let* ((argi (car command-line-args-left))
               (orig-argi argi)
-              ;; This includes our standard options' long versions
-              ;; and long versions of what's on command-switch-alist.
-              (longopts
-               (append '(("--funcall") ("--load") ("--insert") ("--kill")
-                         ("--directory") ("--eval"))
-                       (mapcar '(lambda (elt)
-                                  (list (concat "-" (car elt))))
-                               command-switch-alist)))
-              tem argval completion
+              argval completion
               ;; List of directories specified in -L/--directory,
               ;; in reverse of the order specified.
               extra-load-path
               (initial-load-path load-path))
          (setq command-line-args-left (cdr command-line-args-left))
 
-         ;; Add the long X options to longopts.
-         (setq tem command-line-x-option-alist)
-         (while tem
-           (if (string-match "^--" (car (car tem)))
-               (setq longopts (cons (list (car (car tem))) longopts)))
-           (setq tem (cdr tem)))
-
-         ;; Convert long options to ordinary options
-         ;; and separate out an attached option argument into argval.
-         (if (string-match "^--[^=]*=" argi)
-             (setq argval (substring argi (match-end 0))
-                   argi (substring argi 0 (1- (match-end 0)))))
-         (setq completion (try-completion argi longopts))
-         (if (eq completion t)
-             (setq argi (substring argi 1))
-           (if (stringp completion)
-               (let ((elt (assoc completion longopts)))
-                 (or elt
-                     (error "Option `%s' is ambiguous" argi))
-                 (setq argi (substring (car elt) 1)))
-             (setq argval nil argi orig-argi)))
+         ;; Do preliminary decoding of the option.
+         (if just-files
+             ;; After --, don't look for options; treat all args as files.
+             (setq argi "")
+           ;; Convert long options to ordinary options
+           ;; and separate out an attached option argument into argval.
+           (if (string-match "^--[^=]*=" argi)
+               (setq argval (substring argi (match-end 0))
+                     argi (substring argi 0 (1- (match-end 0)))))
+           (if (equal argi "--")
+               (setq completion nil)
+             (setq completion (try-completion argi longopts)))
+           (if (eq completion t)
+               (setq argi (substring argi 1))
+             (if (stringp completion)
+                 (let ((elt (assoc completion longopts)))
+                   (or elt
+                       (error "Option `%s' is ambiguous" argi))
+                   (setq argi (substring (car elt) 1)))
+               (setq argval nil argi orig-argi))))
 
          ;; Execute the option.
          (cond ((setq tem (assoc argi command-switch-alist))
@@ -874,6 +905,22 @@ Type \\[describe-distribution] for information on getting the latest version."))
                 ;; Ignore X-windows options and their args if not using X.
                 (setq command-line-args-left
                       (nthcdr (nth 1 tem) command-line-args-left)))
+               ((or (string-equal argi "-find-file")
+                    (string-equal argi "-visit"))
+                ;; An explicit option to specify visiting a file.
+                (setq file-count (1+ file-count))
+                (let ((file
+                       (expand-file-name
+                        (command-line-normalize-file-name orig-argi)
+                        dir)))
+                  (if (= file-count 1)
+                      (setq first-file-buffer (find-file file))
+                    (find-file-other-window file)))
+                (or (zerop line)
+                    (goto-line line))
+                (setq line 0))
+               ((equal argi "--")
+                (setq just-files t))
                (t
                 ;; We have almost exhausted our options. See if the
                 ;; user has made any other command-line options available
@@ -888,12 +935,13 @@ Type \\[describe-distribution] for information on getting the latest version."))
                         (if (string-match "\\`-" argi)
                             (error "Unknown option `%s'" argi))
                         (setq file-count (1+ file-count))
-                        (setq argi (command-line-normalize-file-name argi))
-                        (cond ((= file-count 1)
-                               (setq first-file-buffer
-                                     (find-file (expand-file-name argi dir))))
-                              (t
-                               (find-file-other-window (expand-file-name argi dir))))
+                        (let ((file
+                               (expand-file-name
+                                (command-line-normalize-file-name orig-argi)
+                                dir)))
+                          (if (= file-count 1)
+                              (setq first-file-buffer (find-file file))
+                            (find-file-other-window file)))
                         (or (zerop line)
                             (goto-line line))
                         (setq line 0))))))))
@@ -906,8 +954,14 @@ Type \\[describe-distribution] for information on getting the latest version."))
 
 (defun command-line-normalize-file-name (file)
   "Collapse multiple slashes to one, to handle non-Emacs file names."
-  (while (string-match "//+" file)
-    (setq file (replace-match "/" t t file)))
-  file)
+  (save-match-data
+    ;; Use arg 1 so that we don't collapse // at the start of the file name.
+    ;; That is significant on some systems.
+    ;; However, /// at the beginning is supposed to mean just /, not //.
+    (if (string-match "^///+" file)
+       (setq file (replace-match "/" t t file)))
+    (while (string-match "//+" file 1)
+      (setq file (replace-match "/" t t file)))
+    file))
 
 ;;; startup.el ends here