1 ;;; cus-start.el --- define customization properties of builtins
3 ;; Copyright (C) 1997, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
5 ;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
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)
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.
27 ;; This file adds customize support for built-in variables.
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.
37 (let ((all '(;; abbrev.c
38 (abbrev-all-caps abbrev-mode boolean
)
39 (pre-abbrev-expand-hook abbrev-mode hook
)
41 (gc-cons-threshold alloc integer
)
42 (undo-limit undo integer
)
43 (undo-strong-limit undo integer
)
44 (garbage-collection-messages alloc boolean
)
46 (mode-line-format modeline sexp
) ;Hard to do right.
47 (default-major-mode internal function
)
48 (enable-multibyte-characters mule boolean
)
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
)
55 (selective-display-ellipses display boolean
)
56 (indicate-empty-lines display boolean
"21.1")
57 (scroll-up-aggressively windows boolean
"21.1")
58 (scroll-down-aggressively windows boolean
"21.1")
60 (mark-even-if-inactive editing-basics boolean
)
62 (shell-file-name execute file
)
64 (repeat (choice (const :tag
"default" nil
)
65 (file :format
"%v"))))
67 (inhibit-eol-conversion mule boolean
)
68 (eol-mnemonic-undecided mule string
)
69 (eol-mnemonic-unix mule string
)
70 (eol-mnemonic-dos mule string
)
71 (eol-mnemonic-mac mule string
)
72 (file-coding-system-alist
75 :key-type
(regexp :tag
"File regexp")
77 :value
(undecided . undecided
)
78 (cons :tag
"Encoding/decoding pair"
79 :value
(undecided . undecided
)
80 (coding-system :tag
"Decoding")
81 (coding-system :tag
"Encoding"))
82 (coding-system :tag
"Single coding system"
84 (function :value ignore
))))
85 (selection-coding-system mule coding-system
)
87 (completion-ignored-extensions dired
88 (repeat (string :format
"%v")))
90 (baud-rate display integer
)
91 (inverse-video display boolean
)
92 (visible-bell display boolean
)
93 (no-redraw-on-reenter display boolean
)
95 (user-full-name mail string
)
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"
103 (symbol :format
"%v"))
104 (const :tag
"always" t
)))
105 (debug-on-error debug
106 (choice (const :tag
"off")
107 (repeat :menu-tag
"When"
109 (symbol :format
"%v"))
110 (const :tag
"always" t
)))
111 (debug-ignored-errors debug
(repeat (choice symbol regexp
)))
113 (choice (const :tag
"off")
114 (repeat :menu-tag
"When"
116 (symbol :format
"%v"))
117 (const :tag
"always" t
)))
119 (insert-default-directory minibuffer boolean
)
121 (use-dialog-box menu boolean
"21.1")
123 (default-frame-alist frames
124 (repeat (cons :format
"%v"
125 (symbol :tag
"Parameter")
126 (sexp :tag
"Value"))))
127 (mouse-highlight mouse
(choice (const :tag
"disabled" nil
)
128 (const :tag
"always shown" t
)
129 (other :tag
"hidden by keypress" 1)))
131 (indent-tabs-mode fill boolean
)
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")))
137 (echo-keystrokes minibuffer number
)
138 (polling-period keyboard integer
)
139 (double-click-time mouse
(restricted-sexp
140 :match-alternatives
(integerp 'nil
't
)))
141 (double-click-fuzz mouse integer
)
142 (inhibit-local-menu-bar-menus menu boolean
)
143 (help-char keyboard character
)
144 (help-event-list keyboard
(repeat (sexp :format
"%v")))
145 (menu-prompting menu boolean
)
146 (suggest-key-bindings keyboard
(choice (const :tag
"off" nil
)
147 (integer :tag
"time" 2)
150 ;; This is not good news because it will use the wrong
151 ;; version-specific directories when you upgrade. We need
152 ;; customization of the front of the list, maintaining the standard
153 ;; value intact at the back.
154 ;;; (load-path environment
155 ;;; (repeat (choice :tag "[Current dir?]"
156 ;;; :format "%[Current dir?%] %v"
157 ;;; (const :tag " current dir" nil)
158 ;;; (directory :format "%v"))))
160 (completion-auto-help minibuffer boolean
)
161 (enable-recursive-minibuffers minibuffer boolean
)
162 (history-length minibuffer
163 (choice (const :tag
"Infinite" t
)
165 (minibuffer-prompt-properties
169 (const :tag
"Read-Only"
170 :doc
"Prevent prompt from being modified"
174 (const :tag
"Inviolable"
175 :doc
"Prevent point from ever entering prompt"
178 (point-entered minibuffer-avoid-prompt
)))
180 :tag
"Other Properties"
183 (symbol :tag
"Property")
184 (sexp :tag
"Value"))))
186 (minibuffer-auto-raise minibuffer boolean
)
187 ;; options property set at end
188 (read-buffer-function minibuffer
190 (function-item iswitchb-read-buffer
)
193 (dos-unsupported-char-glyph display integer
)
195 (delete-exited-processes processes-basics boolean
)
197 (parse-sexp-ignore-comments editing-basics boolean
)
198 (words-include-escapes editing-basics boolean
)
200 (temp-buffer-show-function windows
(choice (const nil
) function
))
201 (display-buffer-function windows
(choice (const nil
) function
))
202 (pop-up-frames frames boolean
)
203 (pop-up-frame-function frames function
)
204 (special-display-buffer-names
206 (repeat (choice :tag
"Buffer"
208 (string :format
"%v")
209 (cons :tag
"With attributes"
212 (string :format
"%v")
213 (repeat :tag
"Attributes"
215 (symbol :tag
"Parameter")
216 (sexp :tag
"Value")))))))
217 (special-display-regexps
219 (repeat (choice :tag
"Buffer"
221 (regexp :format
"%v")
222 (cons :tag
"With attributes"
225 (regexp :format
"%v")
226 (repeat :tag
"Attributes"
228 (symbol :tag
"Parameter")
229 (sexp :tag
"Value")))))))
230 (special-display-function frames function
)
231 (same-window-buffer-names windows
(repeat (string :format
"%v")))
232 (same-window-regexps windows
(repeat (regexp :format
"%v")))
233 (pop-up-windows windows boolean
)
234 (even-window-heights windows boolean
)
235 (next-screen-context-lines windows integer
)
236 (split-height-threshold windows integer
)
237 (window-min-height windows integer
)
238 (window-min-width windows integer
)
239 (scroll-preserve-screen-position windows boolean
)
240 (display-buffer-reuse-frames windows boolean
"21.1")
242 (scroll-step windows integer
)
243 (scroll-conservatively windows integer
)
244 (scroll-margin windows integer
)
245 (hscroll-margin windows integer
"21.3")
246 (hscroll-step windows number
"21.3")
247 (truncate-partial-width-windows display boolean
)
248 (mode-line-inverse-video modeline boolean
)
249 (mode-line-in-non-selected-windows modeline boolean
"21.3")
250 (line-number-display-limit display
252 (const :tag
"No limit" nil
)))
253 (highlight-nonselected-windows display boolean
)
254 (message-log-max debug
(choice (const :tag
"Disable" nil
)
255 (integer :menu-tag
"lines"
257 (other :tag
"Unlimited" t
)))
258 (unibyte-display-via-language-environment mule boolean
)
260 (scalable-fonts-allowed display boolean
)
262 (x-bitmap-file-path installation
263 (repeat (directory :format
"%v")))
265 (mouse-autoselect-window display boolean
"21.3")
266 (x-use-underline-position-properties display boolean
"21.3")
267 (x-stretch-cursor display boolean
"21.1")))
268 this symbol group type native-p version
269 ;; This function turns a value
270 ;; into an expression which produces that value.
271 (quoter (lambda (sexp)
272 (if (or (memq sexp
'(t nil
))
275 (memq (car sexp
) '(lambda)))
277 ;; (and (fboundp 'characterp)
278 ;; (characterp sexp))
281 (list 'quote sexp
)))))
289 ;; Don't complain about missing variables which are
290 ;; irrelevant to this platform.
291 native-p
(save-match-data
293 ((string-match "\\`dos-" (symbol-name symbol
))
294 (eq system-type
'ms-dos
))
295 ((string-match "\\`w32-" (symbol-name symbol
))
296 (eq system-type
'windows-nt
))
297 ((string-match "\\`x-" (symbol-name symbol
))
298 (fboundp 'x-create-frame
))
300 (if (not (boundp symbol
))
301 ;; If variables are removed from C code, give an error here!
303 (message "Note, built-in variable `%S' not bound" symbol
))
304 ;; Save the standard value, unless we already did.
305 (or (get symbol
'standard-value
)
306 (put symbol
'standard-value
307 (list (funcall quoter
(default-value symbol
)))))
308 ;; If this is NOT while dumping Emacs,
309 ;; set up the rest of the customization info.
311 ;; Add it to the right group.
312 (custom-add-to-group group symbol
'custom-variable
)
314 (put symbol
'custom-type type
)
315 (put symbol
'custom-version version
)))))
317 (custom-add-to-group 'iswitchb
'read-buffer-function
'custom-variable
)
318 (put 'selection-coding-system
'custom-set
319 (lambda (symbol value
)
320 (set-selection-coding-system value
)
323 ;; Record cus-start as loaded
324 ;; if we have set up all the info that we can set up.
325 ;; Don't record cus-start as loaded
326 ;; if we have set up only the standard values.
328 (provide 'cus-start
))
330 ;;; cus-start.el ends here