(encode_coding_iso_2022): If coding requires safe
[bpt/emacs.git] / lisp / cus-start.el
CommitLineData
1cd7adc6 1;;; cus-start.el --- define customization properties of builtins
1444b0c0 2;;
e369c773 3;; Copyright (C) 1997, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
1444b0c0
PA
4;;
5;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
6;; Keywords: internal
7
c2383d2d
RS
8;; This file is part of GNU Emacs.
9
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.
14
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.
19
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.
24
1444b0c0
PA
25;;; Commentary:
26;;
4883633e 27;; This file adds customize support for built-in variables.
1444b0c0 28
4883633e
RS
29;; While dumping Emacs, this file is loaded, but it only records
30;; the standard values; it does not do the rest of the job.
31;; Later on, if the user makes a customization buffer,
32;; this file is loaded again with (require 'cus-start);
33;; then it does the whole job.
1444b0c0 34
4883633e 35;;; Code:
1444b0c0
PA
36
37(let ((all '(;; abbrev.c
38 (abbrev-all-caps abbrev-mode boolean)
39 (pre-abbrev-expand-hook abbrev-mode hook)
40 ;; alloc.c
41 (gc-cons-threshold alloc integer)
42 (undo-limit undo integer)
43 (undo-strong-limit undo integer)
44 (garbage-collection-messages alloc boolean)
45 ;; buffer.c
46 (mode-line-format modeline sexp) ;Hard to do right.
47 (default-major-mode internal function)
924ef223 48 (enable-multibyte-characters mule boolean)
1444b0c0
PA
49 (case-fold-search matching boolean)
50 (fill-column fill integer)
51 (left-margin fill integer)
52 (tab-width editing-basics integer)
53 (ctl-arrow display boolean)
54 (truncate-lines display boolean)
1444b0c0
PA
55 (selective-display-ellipses display boolean)
56 (transient-mark-mode editing-basics boolean)
37328bcd
DL
57 (indicate-empty-lines display boolean "21.1")
58 (scroll-up-aggressively windows boolean "21.1")
59 (scroll-down-aggressively windows boolean "21.1")
1444b0c0
PA
60 ;; callint.c
61 (mark-even-if-inactive editing-basics boolean)
62 ;; callproc.c
63 (shell-file-name execute file)
64 (exec-path execute
65 (repeat (choice (const :tag "default" nil)
66 (file :format "%v"))))
5fc9eb7c
DL
67 ;; coding.c
68 (inhibit-eol-conversion mule boolean)
de0d1fc5
EZ
69 (eol-mnemonic-undecided mule string)
70 (eol-mnemonic-unix mule string)
71 (eol-mnemonic-dos mule string)
72 (eol-mnemonic-mac mule string)
13eb63ff
DL
73 (file-coding-system-alist
74 mule
75 (alist
76 :key-type (regexp :tag "File regexp")
77 :value-type (choice
78 :value (undecided . undecided)
79 (cons :tag "Encoding/decoding pair"
80 :value (undecided . undecided)
81 (coding-system :tag "Decoding")
82 (coding-system :tag "Encoding"))
83 (coding-system :tag "Single coding system"
84 :value undecided)
85 (function :value ignore))))
1444b0c0
PA
86 ;; dired.c
87 (completion-ignored-extensions dired
88 (repeat (string :format "%v")))
0849a37e 89 ;; dispnew.c
1444b0c0
PA
90 (baud-rate display integer)
91 (inverse-video display boolean)
92 (visible-bell display boolean)
93 (no-redraw-on-reenter display boolean)
94 ;; editfns.c
95 (user-full-name mail string)
96 ;; eval.c
97 (max-specpdl-size limits integer)
98 (max-lisp-eval-depth limits integer)
99 (stack-trace-on-error debug
100 (choice (const :tag "off")
101 (repeat :menu-tag "When"
102 :value (nil)
103 (symbol :format "%v"))
104 (const :tag "always" t)))
105 (debug-on-error debug
106 (choice (const :tag "off")
107 (repeat :menu-tag "When"
108 :value (nil)
109 (symbol :format "%v"))
110 (const :tag "always" t)))
111 (debug-ignored-errors debug (repeat (choice symbol regexp)))
507c9247
RS
112 (debug-on-quit debug
113 (choice (const :tag "off")
114 (repeat :menu-tag "When"
115 :value (nil)
116 (symbol :format "%v"))
117 (const :tag "always" t)))
1444b0c0
PA
118 ;; fileio.c
119 (insert-default-directory minibuffer boolean)
78976e0a 120 ;; fns.c
37328bcd 121 (use-dialog-box menu boolean "21.1")
1444b0c0
PA
122 ;; frame.c
123 (default-frame-alist frames
124 (repeat (cons :format "%v"
125 (symbol :tag "Parameter")
126 (sexp :tag "Value"))))
140fb7ff
KS
127 (mouse-highlight mouse (choice (const :tag "disabled" nil)
128 (const :tag "always shown" t)
129 (other :tag "hidden by keypress" 1)))
1444b0c0
PA
130 ;; indent.c
131 (indent-tabs-mode fill boolean)
132 ;; keyboard.c
133 (meta-prefix-char keyboard character)
134 (auto-save-interval auto-save integer)
135 (auto-save-timeout auto-save (choice (const :tag "off" nil)
136 (integer :format "%v")))
ac1b1728 137 (echo-keystrokes minibuffer number)
1444b0c0 138 (polling-period keyboard integer)
4db2b1c7
RS
139 (double-click-time mouse (restricted-sexp
140 :match-alternatives (integerp 'nil 't)))
1444b0c0
PA
141 (inhibit-local-menu-bar-menus menu boolean)
142 (help-char keyboard character)
143 (help-event-list keyboard (repeat (sexp :format "%v")))
144 (menu-prompting menu boolean)
1444b0c0
PA
145 (suggest-key-bindings keyboard (choice (const :tag "off" nil)
146 (integer :tag "time" 2)
79221864 147 (other :tag "on")))
5f537e54 148
37328bcd
DL
149;; This is not good news because it will use the wrong
150;; version-specific directories when you upgrade. We need
151;; customization of the front of the list, maintaining the standard
152;; value intact at the back.
153;;; (load-path environment
154;;; (repeat (choice :tag "[Current dir?]"
155;;; :format "%[Current dir?%] %v"
156;;; (const :tag " current dir" nil)
157;;; (directory :format "%v"))))
1444b0c0
PA
158 ;; minibuf.c
159 (completion-auto-help minibuffer boolean)
160 (enable-recursive-minibuffers minibuffer boolean)
408f56b2
RS
161 (history-length minibuffer
162 (choice (const :tag "Infinite" t)
163 integer))
8f62f2b8
MB
164 (minibuffer-prompt-properties
165 minibuffer
166 (list
167 (checklist :inline t
168 (const :tag "Read-Only"
169 :doc "Prevent prompt from being modified"
170 :format "%t%n%h"
171 :inline t
172 (read-only t))
173 (const :tag "Inviolable"
174 :doc "Prevent point from ever entering prompt"
175 :format "%t%n%h"
176 :inline t
177 (point-entered minibuffer-avoid-prompt)))
178 (repeat :inline t
179 :tag "Other Properties"
180 (list :inline t
181 :format "%v"
182 (symbol :tag "Property")
ecf5279a
DL
183 (sexp :tag "Value"))))
184 "21.1")
1444b0c0 185 (minibuffer-auto-raise minibuffer boolean)
ecf5279a 186 ;; options property set at end
a8a1b05d
DL
187 (read-buffer-function minibuffer
188 (choice (const nil)
189 (function-item iswitchb-read-buffer)
190 function))
b78fba02
EZ
191 ;; msdos.c
192 (dos-unsupported-char-glyph display integer)
1444b0c0 193 ;; process.c
4883633e 194 (delete-exited-processes processes-basics boolean)
1444b0c0
PA
195 ;; syntax.c
196 (parse-sexp-ignore-comments editing-basics boolean)
197 (words-include-escapes editing-basics boolean)
198 ;; window.c
4cb464b7
DL
199 (temp-buffer-show-function windows (choice (const nil) function))
200 (display-buffer-function windows (choice (const nil) function))
1444b0c0
PA
201 (pop-up-frames frames boolean)
202 (pop-up-frame-function frames function)
203 (special-display-buffer-names
204 frames
205 (repeat (choice :tag "Buffer"
206 :value ""
207 (string :format "%v")
208 (cons :tag "With attributes"
209 :format "%v"
210 :value ("" . nil)
211 (string :format "%v")
212 (repeat :tag "Attributes"
213 (cons :format "%v"
214 (symbol :tag "Parameter")
215 (sexp :tag "Value")))))))
216 (special-display-regexps
217 frames
218 (repeat (choice :tag "Buffer"
219 :value ""
220 (regexp :format "%v")
221 (cons :tag "With attributes"
222 :format "%v"
223 :value ("" . nil)
224 (regexp :format "%v")
225 (repeat :tag "Attributes"
226 (cons :format "%v"
227 (symbol :tag "Parameter")
228 (sexp :tag "Value")))))))
229 (special-display-function frames function)
230 (same-window-buffer-names windows (repeat (string :format "%v")))
231 (same-window-regexps windows (repeat (regexp :format "%v")))
232 (pop-up-windows windows boolean)
d2946490 233 (even-window-heights windows boolean)
74f54b54 234 (next-screen-context-lines windows integer)
1444b0c0
PA
235 (split-height-threshold windows integer)
236 (window-min-height windows integer)
237 (window-min-width windows integer)
bcc67965 238 (scroll-preserve-screen-position windows boolean)
13eb63ff 239 (display-buffer-reuse-frames windows boolean "21.1")
1444b0c0
PA
240 ;; xdisp.c
241 (scroll-step windows integer)
ccbb360e
RS
242 (scroll-conservatively windows integer)
243 (scroll-margin windows integer)
1886439b
EZ
244 (automatic-hscroll-margin windows integer "21.3")
245 (automatic-hscroll-step windows number "21.3")
1444b0c0 246 (truncate-partial-width-windows display boolean)
67ee1125 247 (mode-line-inverse-video modeline boolean)
ec544bdd 248 (mode-line-in-non-selected-windows modeline boolean "21.3")
37328bcd
DL
249 (line-number-display-limit display
250 (choice integer
251 (const :tag "No limit" nil)))
1444b0c0
PA
252 (highlight-nonselected-windows display boolean)
253 (message-log-max debug (choice (const :tag "Disable" nil)
254 (integer :menu-tag "lines"
255 :format "%v")
79221864 256 (other :tag "Unlimited" t)))
daba3e25 257 (unibyte-display-via-language-environment mule boolean)
1444b0c0
PA
258 ;; xfns.c
259 (x-bitmap-file-path installation
0849a37e
DL
260 (repeat (directory :format "%v")))
261 ;; xterm.c
9c94a2e9 262 (x-autoselect-window display boolean "21.3")
e369c773 263 (x-use-underline-position-properties display boolean "21.3")
37328bcd
DL
264 (x-stretch-cursor display boolean "21.1")))
265 this symbol group type native-p version
4883633e
RS
266 ;; This function turns a value
267 ;; into an expression which produces that value.
268 (quoter (lambda (sexp)
269 (if (or (memq sexp '(t nil))
017266f8 270 (keywordp sexp)
4883633e
RS
271 (and (listp sexp)
272 (memq (car sexp) '(lambda)))
273 (stringp sexp)
37328bcd
DL
274;; (and (fboundp 'characterp)
275;; (characterp sexp))
276 (numberp sexp))
4883633e
RS
277 sexp
278 (list 'quote sexp)))))
1444b0c0
PA
279 (while all
280 (setq this (car all)
281 all (cdr all)
282 symbol (nth 0 this)
283 group (nth 1 this)
00377857 284 type (nth 2 this)
37328bcd 285 version (nth 3 this)
00377857
EZ
286 ;; Don't complain about missing variables which are
287 ;; irrelevant to this platform.
288 native-p (save-match-data
289 (cond
290 ((string-match "\\`dos-" (symbol-name symbol))
291 (eq system-type 'ms-dos))
292 ((string-match "\\`w32-" (symbol-name symbol))
293 (eq system-type 'windows-nt))
197a09bf
EZ
294 ((string-match "\\`x-" (symbol-name symbol))
295 (fboundp 'x-create-frame))
00377857 296 (t t))))
1444b0c0
PA
297 (if (not (boundp symbol))
298 ;; If variables are removed from C code, give an error here!
00377857
EZ
299 (and native-p
300 (message "Note, built-in variable `%S' not bound" symbol))
4883633e
RS
301 ;; Save the standard value, unless we already did.
302 (or (get symbol 'standard-value)
303 (put symbol 'standard-value
304 (list (funcall quoter (default-value symbol)))))
305 ;; If this is NOT while dumping Emacs,
306 ;; set up the rest of the customization info.
307 (unless purify-flag
308 ;; Add it to the right group.
309 (custom-add-to-group group symbol 'custom-variable)
310 ;; Set the type.
37328bcd
DL
311 (put symbol 'custom-type type)
312 (put symbol 'custom-version version)))))
4883633e 313
ecf5279a
DL
314(custom-add-to-group 'iswitchb 'read-buffer-function 'custom-variable)
315
4883633e
RS
316;; Record cus-start as loaded
317;; if we have set up all the info that we can set up.
318;; Don't record cus-start as loaded
319;; if we have set up only the standard values.
320(unless purify-flag
321 (provide 'cus-start))
1444b0c0 322
1cd7adc6 323;;; cus-start.el ends here