(buffer-syntactic-context): Don't quote nil and t in docstrings.
[emacs.git] / lisp / paths.el
blobf0d5a8d5cd9cd856531a081e14ee6601e223bcbb
1 ;;; paths.el --- define pathnames for use by various Emacs commands -*- no-byte-compile: t -*-
3 ;; Copyright (C) 1986, 1988, 1994, 1999, 2000 Free Software Foundation, Inc.
5 ;; Maintainer: FSF
6 ;; Keywords: internal
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 ;; Boston, MA 02111-1307, USA.
25 ;;; Commentary:
27 ;; These are default settings for names of certain files and directories
28 ;; that Emacs needs to refer to from time to time.
30 ;; If these settings are not right, override them with `setq'
31 ;; in site-init.el. Do not change this file.
33 ;;; Code:
35 ;; Docstrings in this file should, where reasonable, follow the
36 ;; conventions described in bindings.el, so that they get put in the
37 ;; DOC file rather than in memory.
39 (defun prune-directory-list (dirs &optional keep reject)
40 "Returns a copy of DIRS with all non-existant directories removed.
41 The optional argument KEEP is a list of directories to retain even if
42 they don't exist, and REJECT is a list of directories to remove from
43 DIRS, even if they exist; REJECT takes precedence over KEEP.
45 Note that membership in REJECT and KEEP is checked using simple string
46 comparision."
47 (apply #'nconc
48 (mapcar (lambda (dir)
49 (and (not (member dir reject))
50 (or (member dir keep) (file-directory-p dir))
51 (list dir)))
52 dirs)))
54 (defvar Info-default-directory-list
55 (let* ((config-dir
56 (file-name-as-directory configure-info-directory))
57 (config
58 (list config-dir))
59 (unpruned-prefixes
60 ;; Directory trees that may not exist at installation time, and
61 ;; so shouldn't be pruned based on existance.
62 '("/usr/local/"))
63 (prefixes
64 ;; Directory trees in which to look for info subdirectories
65 (prune-directory-list '("/usr/local/" "/usr/" "/opt/" "/")
66 unpruned-prefixes))
67 (suffixes
68 ;; Subdirectories in each directory tree that may contain info
69 ;; directories.
70 '("" "share/" "gnu/" "gnu/lib/" "gnu/lib/emacs/"
71 "emacs/" "lib/" "lib/emacs/"))
72 (standard-info-dirs
73 (apply #'nconc
74 (mapcar (lambda (pfx)
75 (let ((dirs
76 (mapcar (lambda (sfx)
77 (concat pfx sfx "info/"))
78 suffixes)))
79 (if (member pfx unpruned-prefixes)
80 dirs
81 (prune-directory-list dirs config))))
82 prefixes))))
83 ;; If $(prefix)/info is not one of the standard info directories,
84 ;; they are probably installing an experimental version of Emacs,
85 ;; so make sure that experimental version's Info files override
86 ;; the ones in standard directories.
87 (if (member config-dir standard-info-dirs)
88 (nconc standard-info-dirs config)
89 (cons config-dir standard-info-dirs)))
90 "Default list of directories to search for Info documentation files.
91 They are searched in the order they are given in the list.
92 Therefore, the directory of Info files that come with Emacs
93 normally should come last (so that local files override standard ones),
94 unless Emacs is installed into a non-standard directory. In the latter
95 case, the directory of Info files that come with Emacs should be
96 first in this list.
98 Once Info is started, the list of directories to search
99 comes from the variable `Info-directory-list'.
100 This variable `Info-default-directory-list' is used as the default
101 for initializing `Info-directory-list' when Info is started, unless
102 the environment variable INFOPATH is set.")
104 (defvar news-path
105 (if (file-exists-p "/usr/spool/news/")
106 "/usr/spool/news/"
107 "/var/spool/news/")
108 "The root directory below which all news files are stored.")
110 (defvar news-inews-program
111 (cond ((file-exists-p "/usr/bin/inews") "/usr/bin/inews")
112 ((file-exists-p "/usr/local/inews") "/usr/local/inews")
113 ((file-exists-p "/usr/local/bin/inews") "/usr/local/bin/inews")
114 ((file-exists-p "/usr/contrib/lib/news/inews") "/usr/contrib/lib/news/inews")
115 ((file-exists-p "/usr/lib/news/inews") "/usr/lib/news/inews")
116 (t "inews"))
117 "Program to post news.")
119 ;; set this to your local server
120 (defvar gnus-default-nntp-server "" "\
121 The name of the host running an NNTP server.
122 The null string means use the local host as the server site.")
124 (defvar gnus-nntp-service "nntp"
125 "NNTP service name, usually \"nntp\" or 119).
126 Go to a local news spool if its value is nil, in which case `gnus-nntp-server'
127 should be set to `(system-name)'.")
129 (defvar gnus-local-organization nil "\
130 *The name of your organization, as a string.
131 The `ORGANIZATION' environment variable is used instead if defined.")
133 (defcustom rmail-file-name "~/RMAIL"
134 "*Name of user's primary mail file."
135 :type 'string
136 :group 'rmail
137 :version "21.1")
139 (defconst rmail-spool-directory
140 (cond ((string-match "^[^-]+-[^-]+-sco3.2v4" system-configuration)
141 "/usr/spool/mail/")
142 ;; On The Bull DPX/2 /usr/spool/mail is used although
143 ;; it is usg-unix-v.
144 ((string-match "^m68k-bull-sysv3" system-configuration)
145 "/usr/spool/mail/")
146 ;; SVR4 and recent BSD are said to use this.
147 ;; Rather than trying to know precisely which systems use it,
148 ;; let's assume this dir is never used for anything else.
149 ((file-exists-p "/var/mail")
150 "/var/mail/")
151 ;; Many GNU/Linux systems use this name.
152 ((file-exists-p "/var/spool/mail")
153 "/var/spool/mail/")
154 ((memq system-type '(dgux hpux usg-unix-v unisoft-unix rtu irix))
155 "/usr/mail/")
156 (t "/usr/spool/mail/"))
157 "Name of directory used by system mailer for delivering new mail.
158 Its name should end with a slash.")
160 (defconst sendmail-program
161 (cond
162 ((file-exists-p "/usr/sbin/sendmail") "/usr/sbin/sendmail")
163 ((file-exists-p "/usr/lib/sendmail") "/usr/lib/sendmail")
164 ((file-exists-p "/usr/ucblib/sendmail") "/usr/ucblib/sendmail")
165 (t "fakemail")) ;In ../etc, to interface to /bin/mail.
166 "Program used to send messages.")
168 (defconst remote-shell-program
169 (cond
170 ;; Some systems use rsh for the remote shell; others use that name for the
171 ;; restricted shell and use remsh for the remote shell. Let's try to guess
172 ;; based on what we actually find out there. The restricted shell is
173 ;; almost certainly in /bin or /usr/bin, so it's probably safe to assume
174 ;; that an rsh found elsewhere is the remote shell program. The converse
175 ;; is not true: /usr/bin/rsh could be either one, so check that last.
176 ((file-exists-p "/usr/ucb/remsh") "/usr/ucb/remsh")
177 ((file-exists-p "/usr/bsd/remsh") "/usr/bsd/remsh")
178 ((file-exists-p "/bin/remsh") "/bin/remsh")
179 ((file-exists-p "/usr/bin/remsh") "/usr/bin/remsh")
180 ((file-exists-p "/usr/local/bin/remsh") "/usr/local/bin/remsh")
181 ((file-exists-p "/usr/ucb/rsh") "/usr/ucb/rsh")
182 ((file-exists-p "/usr/bsd/rsh") "/usr/bsd/rsh")
183 ((file-exists-p "/usr/local/bin/rsh") "/usr/local/bin/rsh")
184 ((file-exists-p "/usr/bin/rcmd") "/usr/bin/rcmd")
185 ((file-exists-p "/bin/rcmd") "/bin/rcmd")
186 ((file-exists-p "/bin/rsh") "/bin/rsh")
187 ((file-exists-p "/usr/bin/rsh") "/usr/bin/rsh")
188 (t "rsh"))
189 "File name for remote-shell program (often rsh or remsh).")
191 (defconst term-file-prefix (if (eq system-type 'vax-vms) "[.term]" "term/") "\
192 If non-nil, Emacs startup does (load (concat term-file-prefix (getenv \"TERM\")))
193 You may set this variable to nil in your `.emacs' file if you do not wish
194 the terminal-initialization file to be loaded.")
196 (defconst abbrev-file-name
197 (if (eq system-type 'vax-vms)
198 "~/abbrev.def"
199 (convert-standard-filename "~/.abbrev_defs"))
200 "*Default name of file to read abbrevs from.")
202 ;;; paths.el ends here