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
58 (choice (const :tag "off" nil) number)
60 (scroll-down-aggressively windows
61 (choice (const :tag "off" nil) number)
64 (mark-even-if-inactive editing-basics boolean)
66 (shell-file-name execute file)
68 (repeat (choice (const :tag "default" nil)
69 (file :format "%v"))))
71 (inhibit-eol-conversion mule boolean)
72 (eol-mnemonic-undecided mule string)
73 (eol-mnemonic-unix mule string)
74 (eol-mnemonic-dos mule string)
75 (eol-mnemonic-mac mule string)
76 (file-coding-system-alist
79 :key-type (regexp :tag "File regexp")
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"
88 (function :value ignore))))
89 (selection-coding-system mule coding-system)
91 (completion-ignored-extensions dired
92 (repeat (string :format "%v")))
94 (baud-rate display integer)
95 (inverse-video display boolean)
96 (visible-bell display boolean)
97 (no-redraw-on-reenter display boolean)
99 (user-full-name mail string)
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"
107 (symbol :format "%v"))
108 (const :tag "always" t)))
109 (debug-on-error debug
110 (choice (const :tag "off")
111 (repeat :menu-tag "When"
113 (symbol :format "%v"))
114 (const :tag "always" t)))
115 (debug-ignored-errors debug (repeat (choice symbol regexp)))
117 (choice (const :tag "off")
118 (repeat :menu-tag "When"
120 (symbol :format "%v"))
121 (const :tag "always" t)))
123 (insert-default-directory minibuffer boolean)
124 (read-file-name-completion-ignore-case minibuffer boolean "21.4")
126 (use-dialog-box menu boolean "21.1")
127 (use-file-dialog menu boolean "21.4")
129 (default-frame-alist frames
130 (repeat (cons :format "%v"
131 (symbol :tag "Parameter")
132 (sexp :tag "Value"))))
133 (mouse-highlight mouse (choice (const :tag "disabled" nil)
134 (const :tag "always shown" t)
135 (other :tag "hidden by keypress" 1)))
137 (indent-tabs-mode fill boolean)
139 (meta-prefix-char keyboard character)
140 (auto-save-interval auto-save integer)
141 (auto-save-timeout auto-save (choice (const :tag "off" nil)
142 (integer :format "%v")))
143 (echo-keystrokes minibuffer number)
144 (polling-period keyboard integer)
145 (double-click-time mouse (restricted-sexp
146 :match-alternatives (integerp 'nil 't)))
147 (double-click-fuzz mouse integer)
148 (inhibit-local-menu-bar-menus menu boolean)
149 (help-char keyboard character)
150 (help-event-list keyboard (repeat (sexp :format "%v")))
151 (menu-prompting menu boolean)
152 (suggest-key-bindings keyboard (choice (const :tag "off" nil)
153 (integer :tag "time" 2)
156 ;; This is not good news because it will use the wrong
157 ;; version-specific directories when you upgrade. We need
158 ;; customization of the front of the list, maintaining the standard
159 ;; value intact at the back.
160 ;;; (load-path environment
161 ;;; (repeat (choice :tag "[Current dir?]"
162 ;;; :format "%[Current dir?%] %v"
163 ;;; (const :tag " current dir" nil)
164 ;;; (directory :format "%v"))))
166 (completion-auto-help minibuffer boolean)
167 (enable-recursive-minibuffers minibuffer boolean)
168 (history-length minibuffer
169 (choice (const :tag "Infinite" t)
171 (history-delete-duplicates minibuffer boolean)
172 (minibuffer-prompt-properties
176 (const :tag "Read-Only"
177 :doc "Prevent prompt from being modified"
181 (const :tag "Inviolable"
182 :doc "Prevent point from ever entering prompt"
185 (point-entered minibuffer-avoid-prompt)))
187 :tag "Other Properties"
190 (symbol :tag "Property")
191 (sexp :tag "Value"))))
193 (minibuffer-auto-raise minibuffer boolean)
194 ;; options property set at end
195 (read-buffer-function minibuffer
197 (function-item iswitchb-read-buffer)
200 (dos-unsupported-char-glyph display integer)
202 (delete-exited-processes processes-basics boolean)
204 (parse-sexp-ignore-comments editing-basics boolean)
205 (words-include-escapes editing-basics boolean)
206 (open-paren-in-column-0-is-defun-start editing-basics boolean
209 (temp-buffer-show-function windows (choice (const nil) function))
210 (display-buffer-function windows (choice (const nil) function))
211 (pop-up-frames frames boolean)
212 (pop-up-frame-function frames function)
213 (special-display-buffer-names
215 (repeat (choice :tag "Buffer"
217 (string :format "%v")
218 (cons :tag "With attributes"
221 (string :format "%v")
222 (repeat :tag "Attributes"
224 (symbol :tag "Parameter")
225 (sexp :tag "Value")))))))
226 (special-display-regexps
228 (repeat (choice :tag "Buffer"
230 (regexp :format "%v")
231 (cons :tag "With attributes"
234 (regexp :format "%v")
235 (repeat :tag "Attributes"
237 (symbol :tag "Parameter")
238 (sexp :tag "Value")))))))
239 (special-display-function frames function)
240 (same-window-buffer-names windows (repeat (string :format "%v")))
241 (same-window-regexps windows (repeat (regexp :format "%v")))
242 (pop-up-windows windows boolean)
243 (even-window-heights windows boolean)
244 (next-screen-context-lines windows integer)
245 (split-height-threshold windows integer)
246 (window-min-height windows integer)
247 (window-min-width windows integer)
248 (scroll-preserve-screen-position windows boolean)
249 (display-buffer-reuse-frames windows boolean "21.1")
251 (scroll-step windows integer)
252 (scroll-conservatively windows integer)
253 (scroll-margin windows integer)
254 (hscroll-margin windows integer "21.3")
255 (hscroll-step windows number "21.3")
256 (truncate-partial-width-windows display boolean)
257 (mode-line-inverse-video modeline boolean)
258 (mode-line-in-non-selected-windows modeline boolean "21.3")
259 (line-number-display-limit display
261 (const :tag "No limit" nil)))
262 (line-number-display-limit-width display integer)
263 (highlight-nonselected-windows display boolean)
264 (message-log-max debug (choice (const :tag "Disable" nil)
265 (integer :menu-tag "lines"
267 (other :tag "Unlimited" t)))
268 (unibyte-display-via-language-environment mule boolean)
269 (blink-cursor-alist cursor alist "21.4")
271 (scalable-fonts-allowed display boolean)
273 (x-bitmap-file-path installation
274 (repeat (directory :format "%v")))
276 (mouse-autoselect-window display boolean "21.3")
277 (x-use-underline-position-properties display boolean "21.3")
278 (x-stretch-cursor display boolean "21.1")))
279 this symbol group type native-p version
280 ;; This function turns a value
281 ;; into an expression which produces that value.
282 (quoter (lambda (sexp)
283 (if (or (memq sexp '(t nil))
286 (memq (car sexp) '(lambda)))
288 ;; (and (fboundp 'characterp)
289 ;; (characterp sexp))
292 (list 'quote sexp)))))
300 ;; Don't complain about missing variables which are
301 ;; irrelevant to this platform.
302 native-p (save-match-data
304 ((string-match "\\`dos-" (symbol-name symbol))
305 (eq system-type 'ms-dos))
306 ((string-match "\\`w32-" (symbol-name symbol))
307 (eq system-type 'windows-nt))
308 ((string-match "\\`x-" (symbol-name symbol))
309 (fboundp 'x-create-frame))
311 (if (not (boundp symbol))
312 ;; If variables are removed from C code, give an error here!
314 (message "Note, built-in variable `%S' not bound" symbol))
315 ;; Save the standard value, unless we already did.
316 (or (get symbol 'standard-value)
317 (put symbol 'standard-value
318 (list (funcall quoter (default-value symbol)))))
319 ;; If this is NOT while dumping Emacs,
320 ;; set up the rest of the customization info.
322 ;; Add it to the right group.
323 (custom-add-to-group group symbol 'custom-variable)
325 (put symbol 'custom-type type)
326 (put symbol 'custom-version version)))))
328 (custom-add-to-group 'iswitchb 'read-buffer-function 'custom-variable)
329 (custom-add-to-group 'font-lock 'open-paren-in-column-0-is-defun-start
331 (put 'selection-coding-system 'custom-set
332 (lambda (symbol value)
333 (set-selection-coding-system value)
336 ;; Record cus-start as loaded
337 ;; if we have set up all the info that we can set up.
338 ;; Don't record cus-start as loaded
339 ;; if we have set up only the standard values.
341 (provide 'cus-start))
343 ;;; arch-tag: 4502730d-bcb3-4f5e-99a3-a86f2d54af60
344 ;;; cus-start.el ends here