X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/7cf202bd653a13fb04081e963c3165bd7fb895d8..1eedd2f11f54db9ccc9a9b6cae639f65750b8baf:/lisp/paths.el diff --git a/lisp/paths.el b/lisp/paths.el index f4516d37a6..f248eac924 100644 --- a/lisp/paths.el +++ b/lisp/paths.el @@ -1,6 +1,7 @@ -;;; 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, 2002, 2003, +;; 2004, 2005 Free Software Foundation, Inc. ;; Maintainer: FSF ;; Keywords: internal @@ -18,8 +19,9 @@ ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License -;; along with GNU Emacs; see the file COPYING. If not, write to -;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. +;; along with GNU Emacs; see the file COPYING. If not, write to the +;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, +;; Boston, MA 02110-1301, USA. ;;; Commentary: @@ -31,40 +33,94 @@ ;;; 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-existent 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 +comparison." + (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).") - -(defvar news-path +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-directory (if (file-exists-p "/usr/spool/news/") "/usr/spool/news/" "/var/spool/news/") "The root directory below which all news files are stored.") +(defvaralias 'news-path 'news-directory) (defvar news-inews-program (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" @@ -72,27 +128,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.") +(defcustom rmail-file-name "~/RMAIL" + "*Name of user's primary mail file." + :type 'string + :group 'rmail + :version "21.1") -(defvar rmail-file-name "~/RMAIL" - "Name of user's primary mail file.") - -(defconst rmail-spool-directory +(defvar 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/") @@ -103,22 +152,24 @@ Will use `gnus-startup-file'-SERVER instead if exists.") "/var/mail/") ;; Many GNU/Linux systems use this name. ((file-exists-p "/var/spool/mail") - "/var/spool/mail") + "/var/spool/mail/") ((memq system-type '(dgux hpux usg-unix-v unisoft-unix rtu irix)) "/usr/mail/") (t "/usr/spool/mail/")) "Name of directory used by system mailer for delivering new mail. Its name should end with a slash.") -(defconst sendmail-program +(defcustom 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.") + "Program used to send messages." + :group 'mail + :type 'file) -(defconst remote-shell-program +(defcustom remote-shell-program (cond ;; Some systems use rsh for the remote shell; others use that name for the ;; restricted shell and use remsh for the remote shell. Let's try to guess @@ -138,17 +189,21 @@ 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)." + :group 'environment + :type 'file) -(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\"))) +(defvar 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 +(defvar abbrev-file-name (if (eq system-type 'vax-vms) "~/abbrev.def" - "~/.abbrev_defs") + (convert-standard-filename "~/.abbrev_defs")) "*Default name of file to read abbrevs from.") +;;; arch-tag: bae27ffb-9944-4c87-b569-30d4635a99e1 ;;; paths.el ends here