cus-start.el 11.7 KB
Newer Older
1
;;; cus-start.el --- define customization properties of builtins
Per Abrahamsen's avatar
Per Abrahamsen committed
2
;;
3
;; Copyright (C) 1997, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
Per Abrahamsen's avatar
Per Abrahamsen committed
4 5 6 7
;;
;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
;; Keywords: internal

Richard M. Stallman's avatar
Richard M. Stallman committed
8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
;; This file is part of GNU Emacs.

;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING.  If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.

Per Abrahamsen's avatar
Per Abrahamsen committed
25 26
;;; Commentary:
;;
27
;; This file adds customize support for built-in variables.
Per Abrahamsen's avatar
Per Abrahamsen committed
28

29 30 31 32 33
;; While dumping Emacs, this file is loaded, but it only records
;; the standard values; it does not do the rest of the job.
;; Later on, if the user makes a customization buffer,
;; this file is loaded again with (require 'cus-start);
;; then it does the whole job.
Per Abrahamsen's avatar
Per Abrahamsen committed
34

35
;;; Code:
Per Abrahamsen's avatar
Per Abrahamsen committed
36

37
(let ((all '(;; abbrev.c
Per Abrahamsen's avatar
Per Abrahamsen committed
38 39 40 41 42 43 44 45 46 47
	     (abbrev-all-caps abbrev-mode boolean)
	     (pre-abbrev-expand-hook abbrev-mode hook)
	     ;; alloc.c
	     (gc-cons-threshold alloc integer)
	     (undo-limit undo integer)
	     (undo-strong-limit undo integer)
	     (garbage-collection-messages alloc boolean)
	     ;; buffer.c
	     (mode-line-format modeline sexp) ;Hard to do right.
	     (default-major-mode internal function)
48
	     (enable-multibyte-characters mule boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
49 50 51 52 53 54 55
	     (case-fold-search matching boolean)
	     (fill-column fill integer)
	     (left-margin fill integer)
	     (tab-width editing-basics integer)
	     (ctl-arrow display boolean)
	     (truncate-lines display boolean)
	     (selective-display-ellipses display boolean)
56
	     (indicate-empty-lines display boolean "21.1")
57 58 59 60 61 62
	     (scroll-up-aggressively windows
				     (choice (const :tag "off" nil) number)
				     "21.1")
	     (scroll-down-aggressively windows
				       (choice (const :tag "off" nil) number)
				       "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
63 64 65 66 67 68 69
	     ;; callint.c
	     (mark-even-if-inactive editing-basics boolean)
	     ;; callproc.c
	     (shell-file-name execute file)
	     (exec-path execute
			(repeat (choice (const :tag "default" nil)
					(file :format "%v"))))
Dave Love's avatar
Dave Love committed
70 71
	     ;; coding.c
	     (inhibit-eol-conversion mule boolean)
72 73 74 75
	     (eol-mnemonic-undecided mule string)
	     (eol-mnemonic-unix mule string)
	     (eol-mnemonic-dos mule string)
	     (eol-mnemonic-mac mule string)
Dave Love's avatar
Dave Love committed
76 77 78 79 80 81 82 83 84 85 86 87 88
	     (file-coding-system-alist
	      mule
	      (alist
	       :key-type (regexp :tag "File regexp")
	       :value-type (choice
			    :value (undecided . undecided)
			    (cons :tag "Encoding/decoding pair"
				  :value (undecided . undecided)
				  (coding-system :tag "Decoding")
				  (coding-system :tag "Encoding"))
			    (coding-system :tag "Single coding system"
					   :value undecided)
			    (function :value ignore))))
89
	     (selection-coding-system mule coding-system)
Per Abrahamsen's avatar
Per Abrahamsen committed
90
	     ;; dired.c
91
	     (completion-ignored-extensions dired
Per Abrahamsen's avatar
Per Abrahamsen committed
92
					    (repeat (string :format "%v")))
93
	     ;; dispnew.c
Per Abrahamsen's avatar
Per Abrahamsen committed
94 95 96 97 98 99 100 101 102 103 104 105 106 107 108
	     (baud-rate display integer)
	     (inverse-video display boolean)
	     (visible-bell display boolean)
	     (no-redraw-on-reenter display boolean)
	     ;; editfns.c
	     (user-full-name mail string)
	     ;; eval.c
	     (max-specpdl-size limits integer)
	     (max-lisp-eval-depth limits integer)
	     (stack-trace-on-error debug
				   (choice (const :tag "off")
					   (repeat :menu-tag "When"
						   :value (nil)
						   (symbol :format "%v"))
					   (const :tag "always" t)))
109
	     (debug-on-error debug
Per Abrahamsen's avatar
Per Abrahamsen committed
110 111 112 113 114 115
			     (choice (const :tag "off")
				     (repeat :menu-tag "When"
					     :value (nil)
					     (symbol :format "%v"))
				     (const :tag "always" t)))
	     (debug-ignored-errors debug (repeat (choice symbol regexp)))
116 117 118 119 120 121
	     (debug-on-quit debug
			    (choice (const :tag "off")
				    (repeat :menu-tag "When"
					    :value (nil)
					    (symbol :format "%v"))
				    (const :tag "always" t)))
Per Abrahamsen's avatar
Per Abrahamsen committed
122 123
	     ;; fileio.c
	     (insert-default-directory minibuffer boolean)
Dave Love's avatar
Dave Love committed
124
	     ;; fns.c
125
	     (use-dialog-box menu boolean "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
126 127 128 129 130
	     ;; frame.c
	     (default-frame-alist frames
	       (repeat (cons :format "%v"
			     (symbol :tag "Parameter")
			     (sexp :tag "Value"))))
Kim F. Storm's avatar
Kim F. Storm committed
131 132 133
	     (mouse-highlight mouse (choice (const :tag "disabled" nil)
					    (const :tag "always shown" t)
					    (other :tag "hidden by keypress" 1)))
Per Abrahamsen's avatar
Per Abrahamsen committed
134 135 136 137 138 139 140
	     ;; indent.c
	     (indent-tabs-mode fill boolean)
	     ;; keyboard.c
	     (meta-prefix-char keyboard character)
	     (auto-save-interval auto-save integer)
	     (auto-save-timeout auto-save (choice (const :tag "off" nil)
						  (integer :format "%v")))
Dave Love's avatar
Dave Love committed
141
	     (echo-keystrokes minibuffer number)
Per Abrahamsen's avatar
Per Abrahamsen committed
142
	     (polling-period keyboard integer)
143 144
	     (double-click-time mouse (restricted-sexp
				       :match-alternatives (integerp 'nil 't)))
145
	     (double-click-fuzz mouse integer)
Per Abrahamsen's avatar
Per Abrahamsen committed
146 147 148 149 150 151
	     (inhibit-local-menu-bar-menus menu boolean)
	     (help-char keyboard character)
	     (help-event-list keyboard (repeat (sexp :format "%v")))
	     (menu-prompting menu boolean)
	     (suggest-key-bindings keyboard (choice (const :tag "off" nil)
						    (integer :tag "time" 2)
152
						    (other :tag "on")))
153

154 155 156 157
;; This is not good news because it will use the wrong
;; version-specific directories when you upgrade.  We need
;; customization of the front of the list, maintaining the standard
;; value intact at the back.
158
;;; 	     (load-path environment
159 160 161 162
;;; 			(repeat (choice :tag "[Current dir?]"
;;; 					:format "%[Current dir?%] %v"
;;; 					(const :tag " current dir" nil)
;;;					(directory :format "%v"))))
Per Abrahamsen's avatar
Per Abrahamsen committed
163 164 165
	     ;; minibuf.c
	     (completion-auto-help minibuffer boolean)
	     (enable-recursive-minibuffers minibuffer boolean)
166 167 168
	     (history-length minibuffer
			     (choice (const :tag "Infinite" t)
				     integer))
169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
	     (minibuffer-prompt-properties
	      minibuffer
	      (list
	       (checklist :inline t
			  (const :tag "Read-Only"
				 :doc "Prevent prompt from being modified"
				 :format "%t%n%h"
				 :inline t
				 (read-only t))
			  (const :tag "Inviolable"
				 :doc "Prevent point from ever entering prompt"
				 :format "%t%n%h"
				 :inline t
				 (point-entered minibuffer-avoid-prompt)))
	       (repeat :inline t
		       :tag "Other Properties"
		       (list :inline t
			     :format "%v"
			     (symbol :tag "Property")
Dave Love's avatar
Dave Love committed
188 189
			     (sexp :tag "Value"))))
	      "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
190
	     (minibuffer-auto-raise minibuffer boolean)
Dave Love's avatar
Dave Love committed
191
	     ;; options property set at end
Dave Love's avatar
Dave Love committed
192 193 194 195
	     (read-buffer-function minibuffer
				   (choice (const nil)
					   (function-item iswitchb-read-buffer)
					   function))
196 197
	     ;; msdos.c
	     (dos-unsupported-char-glyph display integer)
Per Abrahamsen's avatar
Per Abrahamsen committed
198
	     ;; process.c
199
	     (delete-exited-processes processes-basics boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
200 201 202 203
	     ;; syntax.c
	     (parse-sexp-ignore-comments editing-basics boolean)
	     (words-include-escapes editing-basics boolean)
	     ;; window.c
204 205
	     (temp-buffer-show-function windows (choice (const nil) function))
	     (display-buffer-function windows (choice (const nil) function))
Per Abrahamsen's avatar
Per Abrahamsen committed
206 207
	     (pop-up-frames frames boolean)
	     (pop-up-frame-function frames function)
208 209
	     (special-display-buffer-names
	      frames
Per Abrahamsen's avatar
Per Abrahamsen committed
210 211 212 213 214 215 216 217 218 219 220 221
	      (repeat (choice :tag "Buffer"
			      :value ""
			      (string :format "%v")
			      (cons :tag "With attributes"
				    :format "%v"
				    :value ("" . nil)
				    (string :format "%v")
				    (repeat :tag "Attributes"
					    (cons :format "%v"
						  (symbol :tag "Parameter")
						  (sexp :tag "Value")))))))
	     (special-display-regexps
222
	      frames
Per Abrahamsen's avatar
Per Abrahamsen committed
223 224 225 226 227 228 229 230 231 232 233 234 235 236 237
	      (repeat (choice :tag "Buffer"
			      :value ""
			      (regexp :format "%v")
			      (cons :tag "With attributes"
				    :format "%v"
				    :value ("" . nil)
				    (regexp :format "%v")
				    (repeat :tag "Attributes"
					    (cons :format "%v"
						  (symbol :tag "Parameter")
						  (sexp :tag "Value")))))))
	     (special-display-function frames function)
	     (same-window-buffer-names windows (repeat (string :format "%v")))
	     (same-window-regexps windows (repeat (regexp :format "%v")))
	     (pop-up-windows windows boolean)
238
	     (even-window-heights windows boolean)
239
	     (next-screen-context-lines windows integer)
Per Abrahamsen's avatar
Per Abrahamsen committed
240 241 242
	     (split-height-threshold windows integer)
	     (window-min-height windows integer)
	     (window-min-width windows integer)
243
	     (scroll-preserve-screen-position windows boolean)
Dave Love's avatar
Dave Love committed
244
	     (display-buffer-reuse-frames windows boolean "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
245 246
	     ;; xdisp.c
	     (scroll-step windows integer)
247 248
	     (scroll-conservatively windows integer)
	     (scroll-margin windows integer)
249 250
	     (hscroll-margin windows integer "21.3")
	     (hscroll-step windows number "21.3")
Per Abrahamsen's avatar
Per Abrahamsen committed
251
	     (truncate-partial-width-windows display boolean)
252
	     (mode-line-inverse-video modeline boolean)
253
	     (mode-line-in-non-selected-windows modeline boolean "21.3")
254 255 256
	     (line-number-display-limit display
					(choice integer
						(const :tag "No limit" nil)))
Per Abrahamsen's avatar
Per Abrahamsen committed
257 258 259 260
	     (highlight-nonselected-windows display boolean)
	     (message-log-max debug (choice (const :tag "Disable" nil)
					    (integer :menu-tag "lines"
						     :format "%v")
261
					    (other :tag "Unlimited" t)))
262
	     (unibyte-display-via-language-environment mule boolean)
263 264
	     ;; xfaces.c
	     (scalable-fonts-allowed display boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
265 266
	     ;; xfns.c
	     (x-bitmap-file-path installation
267 268
				 (repeat (directory :format "%v")))
	     ;; xterm.c
269
             (mouse-autoselect-window display boolean "21.3")
270
	     (x-use-underline-position-properties display boolean "21.3")
271 272
	     (x-stretch-cursor display boolean "21.1")))
      this symbol group type native-p version
273 274 275 276
      ;; This function turns a value
      ;; into an expression which produces that value.
      (quoter (lambda (sexp)
		(if (or (memq sexp '(t nil))
Dave Love's avatar
Dave Love committed
277
			(keywordp sexp)
278 279 280
			(and (listp sexp)
			     (memq (car sexp) '(lambda)))
			(stringp sexp)
281 282 283
;; 			(and (fboundp 'characterp)
;; 			     (characterp sexp))
			(numberp sexp))
284 285
		    sexp
		  (list 'quote sexp)))))
286
  (while all
Per Abrahamsen's avatar
Per Abrahamsen committed
287 288 289 290
    (setq this (car all)
	  all (cdr all)
	  symbol (nth 0 this)
	  group (nth 1 this)
291
	  type (nth 2 this)
292
	  version (nth 3 this)
293 294 295 296 297 298 299 300
	  ;; Don't complain about missing variables which are
	  ;; irrelevant to this platform.
	  native-p (save-match-data
		     (cond
		      ((string-match "\\`dos-" (symbol-name symbol))
		       (eq system-type 'ms-dos))
		      ((string-match "\\`w32-" (symbol-name symbol))
		       (eq system-type 'windows-nt))
301 302
		      ((string-match "\\`x-" (symbol-name symbol))
		       (fboundp 'x-create-frame))
303
		      (t t))))
Per Abrahamsen's avatar
Per Abrahamsen committed
304 305
    (if (not (boundp symbol))
	;; If variables are removed from C code, give an error here!
306 307
	(and native-p
	     (message "Note, built-in variable `%S' not bound" symbol))
308 309
      ;; Save the standard value, unless we already did.
      (or (get symbol 'standard-value)
310
	  (put symbol 'standard-value
311 312 313 314 315 316 317
	       (list (funcall quoter (default-value symbol)))))
      ;; If this is NOT while dumping Emacs,
      ;; set up the rest of the customization info.
      (unless purify-flag
	;; Add it to the right group.
	(custom-add-to-group group symbol 'custom-variable)
	;; Set the type.
318 319
	(put symbol 'custom-type type)
	(put symbol 'custom-version version)))))
320

Dave Love's avatar
Dave Love committed
321
(custom-add-to-group 'iswitchb 'read-buffer-function 'custom-variable)
322 323 324 325
(put 'selection-coding-system 'custom-set
     (lambda (symbol value)
       (set-selection-coding-system value)
       (set symbol value)))
Dave Love's avatar
Dave Love committed
326

327 328 329 330 331 332
;; Record cus-start as loaded
;; if we have set up all the info that we can set up.
;; Don't record cus-start as loaded
;; if we have set up only the standard values.
(unless purify-flag
  (provide 'cus-start))
Per Abrahamsen's avatar
Per Abrahamsen committed
333

334
;;; cus-start.el ends here