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