X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/b578f267af27af50e3c091f8c9c9eee939b69978..bd9b2b20ef76bf76087f73c1b7977c908d920829:/lisp/paths.el diff --git a/lisp/paths.el b/lisp/paths.el index 842dab1534..f0d5a8d5cd 100644 --- a/lisp/paths.el +++ b/lisp/paths.el @@ -1,6 +1,6 @@ -;;; paths.el --- define pathnames for use by various Emacs commands. +;;; paths.el --- define pathnames for use by various Emacs commands -*- no-byte-compile: t -*- -;; Copyright (C) 1986, 1988, 1994 Free Software Foundation, Inc. +;; Copyright (C) 1986, 1988, 1994, 1999, 2000 Free Software Foundation, Inc. ;; Maintainer: FSF ;; Keywords: internal @@ -32,22 +32,74 @@ ;;; Code: +;; Docstrings in this file should, where reasonable, follow the +;; conventions described in bindings.el, so that they get put in the +;; DOC file rather than in memory. + +(defun prune-directory-list (dirs &optional keep reject) + "Returns a copy of DIRS with all non-existant directories removed. +The optional argument KEEP is a list of directories to retain even if +they don't exist, and REJECT is a list of directories to remove from +DIRS, even if they exist; REJECT takes precedence over KEEP. + +Note that membership in REJECT and KEEP is checked using simple string +comparision." + (apply #'nconc + (mapcar (lambda (dir) + (and (not (member dir reject)) + (or (member dir keep) (file-directory-p dir)) + (list dir))) + dirs))) + (defvar Info-default-directory-list - (let ((start (list "/usr/local/lib/info/" - ;; This comes second so that, if it is the same - ;; as configure-info-directory (which is usually true) - ;; and Emacs has been installed (also usually true) - ;; then the list will end with two copies of this; - ;; which means that the last dir file Info-insert-dir - ;; finds will be the one in this directory. - "/usr/local/info/")) - (configdir (file-name-as-directory configure-info-directory))) - (setq start (nconc start (list configdir))) - start) - "List of directories to search for Info documentation files. -They are searched in the order they are given in this list. + (let* ((config-dir + (file-name-as-directory configure-info-directory)) + (config + (list config-dir)) + (unpruned-prefixes + ;; Directory trees that may not exist at installation time, and + ;; so shouldn't be pruned based on existance. + '("/usr/local/")) + (prefixes + ;; Directory trees in which to look for info subdirectories + (prune-directory-list '("/usr/local/" "/usr/" "/opt/" "/") + unpruned-prefixes)) + (suffixes + ;; Subdirectories in each directory tree that may contain info + ;; directories. + '("" "share/" "gnu/" "gnu/lib/" "gnu/lib/emacs/" + "emacs/" "lib/" "lib/emacs/")) + (standard-info-dirs + (apply #'nconc + (mapcar (lambda (pfx) + (let ((dirs + (mapcar (lambda (sfx) + (concat pfx sfx "info/")) + suffixes))) + (if (member pfx unpruned-prefixes) + dirs + (prune-directory-list dirs config)))) + prefixes)))) + ;; If $(prefix)/info is not one of the standard info directories, + ;; they are probably installing an experimental version of Emacs, + ;; so make sure that experimental version's Info files override + ;; the ones in standard directories. + (if (member config-dir standard-info-dirs) + (nconc standard-info-dirs config) + (cons config-dir standard-info-dirs))) + "Default list of directories to search for Info documentation files. +They are searched in the order they are given in the list. Therefore, the directory of Info files that come with Emacs -normally should come last (so that local files override standard ones).") +normally should come last (so that local files override standard ones), +unless Emacs is installed into a non-standard directory. In the latter +case, the directory of Info files that come with Emacs should be +first in this list. + +Once Info is started, the list of directories to search +comes from the variable `Info-directory-list'. +This variable `Info-default-directory-list' is used as the default +for initializing `Info-directory-list' when Info is started, unless +the environment variable INFOPATH is set.") (defvar news-path (if (file-exists-p "/usr/spool/news/") @@ -59,13 +111,14 @@ normally should come last (so that local files override standard ones).") (cond ((file-exists-p "/usr/bin/inews") "/usr/bin/inews") ((file-exists-p "/usr/local/inews") "/usr/local/inews") ((file-exists-p "/usr/local/bin/inews") "/usr/local/bin/inews") + ((file-exists-p "/usr/contrib/lib/news/inews") "/usr/contrib/lib/news/inews") ((file-exists-p "/usr/lib/news/inews") "/usr/lib/news/inews") (t "inews")) "Program to post news.") -(defvar gnus-default-nntp-server "" - ;; set this to your local server - "The name of the host running an NNTP server. +;; set this to your local server +(defvar gnus-default-nntp-server "" "\ +The name of the host running an NNTP server. The null string means use the local host as the server site.") (defvar gnus-nntp-service "nntp" @@ -73,27 +126,20 @@ The null string means use the local host as the server site.") Go to a local news spool if its value is nil, in which case `gnus-nntp-server' should be set to `(system-name)'.") -(defvar gnus-local-domain nil - "*Your domain name without a host name: for example, \"ai.mit.edu\". -The DOMAINNAME environment variable is used instead if defined. -If the function `system-name' returns a fully qualified domain name, -there is no need to set this variable.") - -(defvar gnus-local-organization nil - "*The name of your organization, as a string. +(defvar gnus-local-organization nil "\ +*The name of your organization, as a string. The `ORGANIZATION' environment variable is used instead if defined.") -(defvar gnus-startup-file "~/.newsrc" - "The file listing groups to which user is subscribed. -Will use `gnus-startup-file'-SERVER instead if exists.") - -(defvar rmail-file-name "~/RMAIL" - "Name of user's primary mail file.") +(defcustom rmail-file-name "~/RMAIL" + "*Name of user's primary mail file." + :type 'string + :group 'rmail + :version "21.1") (defconst rmail-spool-directory (cond ((string-match "^[^-]+-[^-]+-sco3.2v4" system-configuration) "/usr/spool/mail/") - ;; On The Bull DPX/2 /usr/spool/mail is used although + ;; On The Bull DPX/2 /usr/spool/mail is used although ;; it is usg-unix-v. ((string-match "^m68k-bull-sysv3" system-configuration) "/usr/spool/mail/") @@ -113,8 +159,8 @@ Its name should end with a slash.") (defconst sendmail-program (cond - ((file-exists-p "/usr/lib/sendmail") "/usr/lib/sendmail") ((file-exists-p "/usr/sbin/sendmail") "/usr/sbin/sendmail") + ((file-exists-p "/usr/lib/sendmail") "/usr/lib/sendmail") ((file-exists-p "/usr/ucblib/sendmail") "/usr/ucblib/sendmail") (t "fakemail")) ;In ../etc, to interface to /bin/mail. "Program used to send messages.") @@ -139,14 +185,15 @@ Its name should end with a slash.") ((file-exists-p "/bin/rcmd") "/bin/rcmd") ((file-exists-p "/bin/rsh") "/bin/rsh") ((file-exists-p "/usr/bin/rsh") "/usr/bin/rsh") - (t "rsh"))) + (t "rsh")) + "File name for remote-shell program (often rsh or remsh).") -(defconst term-file-prefix (if (eq system-type 'vax-vms) "[.term]" "term/") - "If non-nil, Emacs startup does (load (concat term-file-prefix (getenv \"TERM\"))) +(defconst term-file-prefix (if (eq system-type 'vax-vms) "[.term]" "term/") "\ +If non-nil, Emacs startup does (load (concat term-file-prefix (getenv \"TERM\"))) You may set this variable to nil in your `.emacs' file if you do not wish the terminal-initialization file to be loaded.") -(defconst abbrev-file-name +(defconst abbrev-file-name (if (eq system-type 'vax-vms) "~/abbrev.def" (convert-standard-filename "~/.abbrev_defs"))