cus-start.el 24.8 KB
Newer Older
1
;;; cus-start.el --- define customization properties of builtins
2

Paul Eggert's avatar
Paul Eggert committed
3
;; Copyright (C) 1997, 1999-2015 Free Software Foundation, Inc.
4

Per Abrahamsen's avatar
Per Abrahamsen committed
5 6
;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
;; Keywords: internal
7
;; Package: emacs
Per Abrahamsen's avatar
Per Abrahamsen committed
8

Richard M. Stallman's avatar
Richard M. Stallman committed
9 10
;; This file is part of GNU Emacs.

11
;; GNU Emacs is free software: you can redistribute it and/or modify
Richard M. Stallman's avatar
Richard M. Stallman committed
12
;; it under the terms of the GNU General Public License as published by
13 14
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
Richard M. Stallman's avatar
Richard M. Stallman committed
15 16 17 18 19 20 21

;; 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
22
;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
Richard M. Stallman's avatar
Richard M. Stallman committed
23

Per Abrahamsen's avatar
Per Abrahamsen committed
24
;;; Commentary:
25

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

28 29 30 31 32
;; 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
33

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

36 37 38 39 40 41 42 43 44 45 46 47 48
;; Elements of this list have the form:
;; SYMBOL GROUP TYPE VERSION REST...
;; SYMBOL is the name of the variable.
;; GROUP is the custom group to which it belongs (may also be a list
;; of groups)
;; TYPE is the defcustom :type.
;; VERSION is the defcustom :version (or nil).
;; REST is a set of :KEYWORD VALUE pairs.  Accepted :KEYWORDs are:
;; :standard - standard value for SYMBOL (else use current value)
;; :set - custom-set property
;; :risky - risky-local-variable property
;; :safe - safe-local-variable property
;; :tag - custom-tag property
Stefan Monnier's avatar
Stefan Monnier committed
49
(let ((all '(;; alloc.c
Per Abrahamsen's avatar
Per Abrahamsen committed
50
	     (gc-cons-threshold alloc integer)
51
	     (gc-cons-percentage alloc float)
Luc Teirlinck's avatar
Luc Teirlinck committed
52
	     (garbage-collection-messages alloc boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
53
	     ;; buffer.c
54 55 56 57 58 59 60 61 62 63 64 65 66
	     (cursor-type
	      display
	      (choice
	       (const :tag "Frame default" t)
	       (const :tag "Filled box" box)
	       (const :tag "Hollow cursor" hollow)
	       (const :tag "Vertical bar" bar)
	       (cons  :tag "Vertical bar with specified width"
		      (const bar) integer)
	       (const :tag "Horizontal bar" hbar)
	       (cons  :tag "Horizontal bar with specified width"
		      (const hbar) integer)
	       (const :tag "None "nil)))
67
	     (mode-line-format mode-line sexp) ;Hard to do right.
68
	     (major-mode internal function)
Per Abrahamsen's avatar
Per Abrahamsen committed
69 70 71 72 73 74
	     (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)
75
	     (word-wrap display boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
76
	     (selective-display-ellipses display boolean)
77
	     (indicate-empty-lines fringe boolean)
78 79 80 81 82 83
	     (indicate-buffer-boundaries
	      fringe
	      (choice
	       (const :tag "No indicators" nil)
	       (const :tag "On left, with arrows" left)
	       (const :tag "On right, with arrows" right)
84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115
	       (set :tag "Pick your own design"
		    :value ((t . nil))
		    :format "%{%t%}:\n%v\n%d"
		    :doc "You can specify a default and then override it \
for individual indicators.
Leaving \"Default\" unchecked is equivalent with specifying a default of
\"Do not show\"."
		    (choice :tag "Default"
			    :value (t . nil)
			    (const :tag "Do not show" (t . nil))
			    (const :tag "On the left" (t . left))
			    (const :tag "On the right" (t . right)))
		    (choice :tag "Top"
			    :value (top . left)
			    (const :tag "Do not show" (top . nil))
			    (const :tag "On the left" (top . left))
			    (const :tag "On the right" (top . right)))
		    (choice :tag "Bottom"
			    :value (bottom . left)
			    (const :tag "Do not show" (bottom . nil))
			    (const :tag "On the left" (bottom . left))
			    (const :tag "On the right" (bottom . right)))
		    (choice :tag "Up arrow"
			    :value (up . left)
			    (const :tag "Do not show" (up . nil))
			    (const :tag "On the left" (up . left))
			    (const :tag "On the right" (up . right)))
		    (choice :tag "Down arrow"
			    :value (down . left)
			    (const :tag "Do not show" (down . nil))
			    (const :tag "On the left" (down . left))
			    (const :tag "On the right" (down . right))))
116
	       (other :tag "On left, no arrows" t)))
117
	     (scroll-up-aggressively windows
118
				     (choice (const :tag "off" nil) float)
119 120
				     "21.1")
	     (scroll-down-aggressively windows
121
				       (choice (const :tag "off" nil) float)
122
				       "21.1")
123
	     (line-spacing display (choice (const :tag "none" nil) number)
124
			   "22.1")
125
	     (cursor-in-non-selected-windows
126 127
	      cursor boolean nil
	      :tag "Cursor In Non-selected Windows"
Glenn Morris's avatar
Glenn Morris committed
128 129 130
	      :set (lambda (symbol value)
		     (set-default symbol value)
		     (force-mode-line-update t)))
131
	     (transient-mark-mode editing-basics boolean nil
132
				  :standard (not noninteractive)
133 134
				  :initialize custom-initialize-delay
				  :set custom-set-minor-mode)
135 136 137 138 139
	     (bidi-paragraph-direction
	      paragraphs
	      (choice
	       (const :tag "Left to Right" left-to-right)
	       (const :tag "Right to Left" right-to-left)
140 141
	       (const :tag "Dynamic, according to paragraph text" nil))
	      "24.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
142 143 144 145 146
	     ;; callint.c
	     (mark-even-if-inactive editing-basics boolean)
	     ;; callproc.c
	     (shell-file-name execute file)
	     (exec-path execute
147
			(repeat (choice (const :tag "default directory" nil)
148
					(directory :format "%v"))))
149
	     (exec-suffixes execute (repeat string))
Dave Love's avatar
Dave Love committed
150
	     ;; charset.c
151 152
	     (charset-map-path installation
			       (repeat (directory :format "%v")))
Dave Love's avatar
Dave Love committed
153 154
	     ;; coding.c
	     (inhibit-eol-conversion mule boolean)
155
	     (eol-mnemonic-undecided mule string)
156 157 158 159 160 161 162 163 164 165 166 167
	     ;; startup.el fiddles with the values.  IMO, would be
	     ;; simpler to just use #ifdefs in coding.c.
	     (eol-mnemonic-unix mule string nil
				:standard
				(if (memq system-type '(ms-dos windows-nt))
				    "(Unix)" ":"))
	     (eol-mnemonic-dos mule string nil
			       :standard
			       (if (memq system-type '(ms-dos windows-nt))
				   "\\" "(DOS)"))
	     (eol-mnemonic-mac mule string nil
			       :standard "(Mac)")
Dave Love's avatar
Dave Love committed
168 169 170 171 172 173 174 175 176 177
	     (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"))
178 179 180 181 182
			    (coding-system
			     :tag "Single coding system"
			     :value undecided
			     :match (lambda (widget value)
				      (and value (not (functionp value)))))
Dave Love's avatar
Dave Love committed
183
			    (function :value ignore))))
Per Abrahamsen's avatar
Per Abrahamsen committed
184
	     ;; dired.c
185
	     (completion-ignored-extensions dired
Per Abrahamsen's avatar
Per Abrahamsen committed
186
					    (repeat (string :format "%v")))
187
	     ;; dispnew.c
Per Abrahamsen's avatar
Per Abrahamsen committed
188 189 190 191
	     (baud-rate display integer)
	     (inverse-video display boolean)
	     (visible-bell display boolean)
	     (no-redraw-on-reenter display boolean)
192 193 194 195 196 197 198

	     ;; dosfns.c
	     (dos-display-scancodes display boolean)
	     (dos-hyper-key keyboard integer)
	     (dos-super-key keyboard integer)
	     (dos-keypad-mode keyboard integer)

Per Abrahamsen's avatar
Per Abrahamsen committed
199 200
	     ;; editfns.c
	     (user-full-name mail string)
Glenn Morris's avatar
Glenn Morris committed
201 202
	     ;; emacs.c
	     (report-emacs-bug-address emacsbug string)
Per Abrahamsen's avatar
Per Abrahamsen committed
203 204 205
	     ;; eval.c
	     (max-specpdl-size limits integer)
	     (max-lisp-eval-depth limits integer)
206 207
	     (max-mini-window-height limits
				     (choice (const :tag "quarter screen" nil)
208
					     number) "23.1")
209
	     (debug-on-error debug
Per Abrahamsen's avatar
Per Abrahamsen committed
210 211 212 213 214 215
			     (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)))
216
	     (debug-on-quit debug boolean)
217 218 219
	     (debug-on-signal debug boolean)
	     ;; fileio.c
	     (delete-by-moving-to-trash auto-save boolean "23.1")
220
	     (auto-save-visited-file-name auto-save boolean)
221
	     ;; filelock.c
222
	     (create-lockfiles files boolean "24.3")
223 224 225
	     (temporary-file-directory
	      ;; Darwin section added 24.1, does not seem worth :version bump.
	      files directory nil
226
	      :standard
227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251
	      (file-name-as-directory
	       ;; FIXME ? Should there be Ftemporary_file_directory to do this
	       ;; more robustly (cf set_local_socket in emacsclient.c).
	       ;; It could be used elsewhere, eg Fcall_process_region,
	       ;; server-socket-dir.  See bug#7135.
	       (cond ((memq system-type '(ms-dos windows-nt))
		      (or (getenv "TEMP") (getenv "TMPDIR") (getenv "TMP")
			  "c:/temp"))
		     ((eq system-type 'darwin)
		      (or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
			  ;; See bug#7135.
			  (let ((tmp (ignore-errors
				       (shell-command-to-string
					"getconf DARWIN_USER_TEMP_DIR"))))
			    (and (stringp tmp)
				 (setq tmp (replace-regexp-in-string
					    "\n\\'" "" tmp))
				 ;; Handles "getconf: Unrecognized variable..."
				 (file-directory-p tmp)
				 tmp))
			  "/tmp"))
		     (t
		      (or (getenv "TMPDIR") (getenv "TMP") (getenv "TEMP")
			  "/tmp"))))
	      :initialize custom-initialize-delay)
Dave Love's avatar
Dave Love committed
252
	     ;; fns.c
253
	     (use-dialog-box menu boolean "21.1")
254
	     (use-file-dialog menu boolean "22.1")
255
	     (focus-follows-mouse frames boolean "20.3")
256
	     ;; fontset.c
257 258 259
	     ;; FIXME nil is the initial value, fontset.el setqs it.
	     (vertical-centering-font-regexp display
					     (choice (const nil) regexp))
Per Abrahamsen's avatar
Per Abrahamsen committed
260 261 262 263 264
	     ;; 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
265 266
	     (mouse-highlight mouse (choice (const :tag "disabled" nil)
					    (const :tag "always shown" t)
267 268
					    (other :tag "hidden by keypress" 1))
			      "22.1")
269
	     (make-pointer-invisible mouse boolean "23.2")
270
	     (menu-bar-mode frames boolean nil
271 272 273
			    ;; FIXME?
;			    :initialize custom-initialize-default
			    :set custom-set-minor-mode)
274
	     (tool-bar-mode (frames mouse) boolean nil
275 276
;			    :initialize custom-initialize-default
			    :set custom-set-minor-mode)
277 278 279 280 281 282 283
	     (frame-resize-pixelwise frames boolean "24.4")
	     (frame-inhibit-implied-resize frames
					   (choice
					    (const :tag "Never" nil)
					    (const :tag "Always" t)
					    (repeat (symbol :tag "Parameter")))
					   "25.1")
284
	     ;; fringe.c
285
	     (overflow-newline-into-fringe fringe boolean)
Glenn Morris's avatar
Glenn Morris committed
286 287
	     ;; image.c
	     (imagemagick-render-type image integer "24.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
288
	     ;; indent.c
289
	     (indent-tabs-mode indent boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
290 291 292 293 294
	     ;; 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
295
	     (echo-keystrokes minibuffer number)
Per Abrahamsen's avatar
Per Abrahamsen committed
296
	     (polling-period keyboard integer)
297 298
	     (double-click-time mouse (restricted-sexp
				       :match-alternatives (integerp 'nil 't)))
299
	     (double-click-fuzz mouse integer "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
300 301 302
	     (help-char keyboard character)
	     (help-event-list keyboard (repeat (sexp :format "%v")))
	     (menu-prompting menu boolean)
303
	     (select-active-regions killing
304 305
				    (choice (const :tag "always" t)
					    (const :tag "only shift-selection or mouse-drag" only)
306 307
					    (const :tag "off" nil))
				    "24.1")
Daniel Colascione's avatar
Daniel Colascione committed
308 309 310 311 312
             (debug-on-event debug
                             (choice (const :tag "None" nil)
                                     (const :tag "When sent SIGUSR1" sigusr1)
                                     (const :tag "When sent SIGUSR2" sigusr2))
                             "24.1")
313

314 315 316 317 318 319 320 321 322
             ;; 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.
	     ;;(load-path environment
	     ;;    	(repeat (choice :tag "[Current dir?]"
	     ;;    			:format "%[Current dir?%] %v"
	     ;;    			(const :tag " current dir" nil)
	     ;;    			(directory :format "%v"))))
323
	     (load-prefer-newer lisp boolean "24.4")
Per Abrahamsen's avatar
Per Abrahamsen committed
324 325
	     ;; minibuf.c
	     (enable-recursive-minibuffers minibuffer boolean)
326
	     (history-length minibuffer
327
			     (choice (const :tag "Infinite" t) integer)
328
			     "24.5")	; 30 -> 100
329
	     (history-delete-duplicates minibuffer boolean "22.1")
330 331
	     (read-buffer-completion-ignore-case minibuffer boolean "23.1")

332 333 334 335 336 337 338 339 340
	     (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))
341
			  (const :tag "Don't Enter"
342 343 344 345 346 347 348 349 350
				 :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
351 352
			     (sexp :tag "Value"))))
	      "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
353
	     (minibuffer-auto-raise minibuffer boolean)
Dave Love's avatar
Dave Love committed
354
	     ;; options property set at end
Dave Love's avatar
Dave Love committed
355 356 357 358
	     (read-buffer-function minibuffer
				   (choice (const nil)
					   (function-item iswitchb-read-buffer)
					   function))
359 360
	     ;; msdos.c
	     (dos-unsupported-char-glyph display integer)
361
	     ;; nsterm.m
Eli Zaretskii's avatar
Eli Zaretskii committed
362
	     (ns-control-modifier
363
	      ns
364 365 366 367
	      (choice (const :tag "No modifier" nil)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
368 369 370 371 372 373 374
	     (ns-right-control-modifier
	      ns
	      (choice (const :tag "No modifier (work as control)" none)
		      (const :tag "Use the value of ns-control-modifier"
			     left)
		      (const control) (const meta)
		      (const alt) (const hyper)
375
		      (const super)) "24.1")
Eli Zaretskii's avatar
Eli Zaretskii committed
376
	     (ns-command-modifier
377
	      ns
378 379 380 381
	      (choice (const :tag "No modifier" nil)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
382 383 384 385 386 387 388
	     (ns-right-command-modifier
	      ns
	      (choice (const :tag "No modifier (work as command)" none)
		      (const :tag "Use the value of ns-command-modifier"
			     left)
		      (const control) (const meta)
		      (const alt) (const hyper)
389
		      (const super)) "24.1")
Eli Zaretskii's avatar
Eli Zaretskii committed
390
	     (ns-alternate-modifier
391
	      ns
392 393 394 395
	      (choice (const :tag "No modifier (work as alternate/option)" none)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
396 397 398 399 400 401 402 403
	     (ns-right-alternate-modifier
	      ns
	      (choice (const :tag "No modifier (work as alternate/option)" none)
		      (const :tag "Use the value of ns-alternate-modifier"
			     left)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.3")
Eli Zaretskii's avatar
Eli Zaretskii committed
404
	     (ns-function-modifier
405
	      ns
406 407 408 409 410
	      (choice (const :tag "No modifier (work as function)" none)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
	     (ns-antialias-text ns boolean "23.1")
411
	     (ns-auto-hide-menu-bar ns boolean "24.1")
412
	     (ns-use-native-fullscreen ns boolean "24.4")
413
             (ns-use-fullscreen-animation ns boolean "25.1")
414
             (ns-use-srgb-colorspace ns boolean "24.4")
Per Abrahamsen's avatar
Per Abrahamsen committed
415
	     ;; process.c
416
	     (delete-exited-processes processes-basics boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
417 418 419
	     ;; syntax.c
	     (parse-sexp-ignore-comments editing-basics boolean)
	     (words-include-escapes editing-basics boolean)
Kenichi Handa's avatar
Kenichi Handa committed
420 421
	     (open-paren-in-column-0-is-defun-start editing-basics boolean
						    "21.1")
Stefan Monnier's avatar
Stefan Monnier committed
422 423
             ;; term.c
             (visible-cursor cursor boolean "22.1")
424 425 426 427 428 429
             ;; terminal.c
             (ring-bell-function display
              (choice
               (const :tag "Default" nil)
               (const :tag "Silent" ignore)
               function))
430 431 432 433 434 435 436 437 438 439 440 441 442 443
	     ;; undo.c
	     (undo-limit undo integer)
	     (undo-strong-limit undo integer)
	     (undo-outer-limit undo
			       (choice integer
				       (const :tag "No limit"
					      :format "%t\n%d"
					      :doc
					      "With this choice, \
the undo info for the current command never gets discarded.
This should only be chosen under exceptional circumstances,
since it could result in memory overflow and make Emacs crash."
					      nil))
			       "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
444
	     ;; window.c
445
	     (temp-buffer-show-function windows (choice (const nil) function))
446
	     (next-screen-context-lines windows integer)
447 448 449 450
 	     (scroll-preserve-screen-position
 	      windows (choice
 		       (const :tag "Off (nil)" :value nil)
 		       (const :tag "Full screen (t)" :value t)
451
 		       (other :tag "Always" 1)) "22.1")
452 453 454 455 456
	     (recenter-redisplay
	      windows (choice
		       (const :tag "Never (nil)" :value nil)
		       (const :tag "Only on ttys" :value tty)
		       (other :tag "Always" t)) "23.1")
457
	     (window-combination-resize windows boolean "24.1")
458 459 460 461 462 463 464 465 466 467 468
	     (window-combination-limit
	      windows (choice
		       (const :tag "Never (nil)" :value nil)
		       (const :tag "For Temp Buffer Resize mode (temp-buffer-resize)"
			      :value temp-buffer-resize)
		       (const :tag "For temporary buffers (temp-buffer)"
			      :value temp-buffer)
		       (const :tag "For buffer display (display-buffer)"
			      :value display-buffer)
		       (other :tag "Always (t)" :value t))
	      "24.3")
469
	     (fast-but-imprecise-scrolling scrolling boolean "25.1")
470
	     (window-resize-pixelwise windows boolean "24.4")
Per Abrahamsen's avatar
Per Abrahamsen committed
471
	     ;; xdisp.c
Glenn Morris's avatar
Glenn Morris committed
472 473
	     ;; The whitespace group is for whitespace.el.
	     (show-trailing-whitespace editing-basics boolean nil
474
				       :safe booleanp)
Per Abrahamsen's avatar
Per Abrahamsen committed
475
	     (scroll-step windows integer)
476 477
	     (scroll-conservatively windows integer)
	     (scroll-margin windows integer)
Eli Zaretskii's avatar
Eli Zaretskii committed
478 479
	     (hscroll-margin windows integer "22.1")
	     (hscroll-step windows number "22.1")
Glenn Morris's avatar
Glenn Morris committed
480 481 482 483 484 485
	     (truncate-partial-width-windows
	      display
	      (choice (integer :tag "Truncate if narrower than")
		      (const :tag "Respect `truncate-lines'" nil)
		      (other :tag "Truncate if not full-width" t))
	      "23.1")
486
	     (make-cursor-line-fully-visible windows boolean)
487
	     (mode-line-in-non-selected-windows mode-line boolean "22.1")
488 489 490
	     (line-number-display-limit display
					(choice integer
						(const :tag "No limit" nil)))
491
	     (line-number-display-limit-width display integer "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
492 493 494 495
	     (highlight-nonselected-windows display boolean)
	     (message-log-max debug (choice (const :tag "Disable" nil)
					    (integer :menu-tag "lines"
						     :format "%v")
496 497
					    (other :tag "Unlimited" t))
			      "24.3")
498
	     (unibyte-display-via-language-environment mule boolean)
499
	     (blink-cursor-alist cursor alist "22.1")
500
	     (overline-margin display integer "22.1")
501
	     (underline-minimum-offset display integer "23.1")
502 503 504 505 506
             (mouse-autoselect-window
	      display (choice
		       (const :tag "Off (nil)" :value nil)
		       (const :tag "Immediate" :value t)
		       (number :tag "Delay by secs" :value 0.5)) "22.1")
507 508 509 510 511 512
             (tool-bar-style
	      frames (choice
		      (const :tag "Images" :value image)
		      (const :tag "Text" :value text)
		      (const :tag "Both" :value both)
		      (const :tag "Both-horiz" :value both-horiz)
513
		      (const :tag "Text-image-horiz" :value text-image-horiz)
Glenn Morris's avatar
Glenn Morris committed
514 515
		      (const :tag "System default" :value nil)) "24.1")
             (tool-bar-max-label-size frames integer "24.1")
516
	     (auto-hscroll-mode scrolling boolean "21.1")
517 518 519 520 521 522 523 524 525 526
	     (void-text-area-pointer cursor
				     (choice
				      (const :tag "Standard (text pointer)" :value nil)
				      (const :tag "Arrow" :value arrow)
				      (const :tag "Text pointer" :value text)
				      (const :tag "Hand" :value hand)
				      (const :tag "Vertical dragger" :value vdrag)
				      (const :tag "Horizontal dragger" :value hdrag)
				      (const :tag "Same as mode line" :value modeline)
				      (const :tag "Hourglass" :value hourglass)))
527 528
	     (display-hourglass cursor boolean)
	     (hourglass-delay cursor number)
529 530 531 532 533 534
	     (resize-mini-windows
	      windows (choice
		       (const :tag "Off (nil)" :value nil)
		       (const :tag "Fit (t)" :value t)
		       (const :tag "Grow only" :value grow-only))
	      "25.1")
535
	     ;; xfaces.c
536
	     (scalable-fonts-allowed display boolean "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
537 538
	     ;; xfns.c
	     (x-bitmap-file-path installation
539
				 (repeat (directory :format "%v")))
540
	     (x-gtk-use-old-file-dialog menu boolean "22.1")
Jan Djärv's avatar
Jan Djärv committed
541
	     (x-gtk-show-hidden-files menu boolean "22.1")
542
	     (x-gtk-file-dialog-help-text menu boolean "22.1")
543
	     (x-gtk-use-system-tooltips tooltip boolean "23.3")
544
	     ;; xterm.c
Eli Zaretskii's avatar
Eli Zaretskii committed
545
	     (x-use-underline-position-properties display boolean "22.1")
546
	     (x-underline-at-descent-line display boolean "22.1")
547
	     (x-stretch-cursor display boolean "21.1")
548
	     (scroll-bar-adjust-thumb-portion windows boolean "24.4")
549 550
	     ;; xselect.c
	     (x-select-enable-clipboard-manager killing boolean "24.1")
551 552
	     ;; xsettings.c
	     (font-use-system-font font-selection boolean "23.2")))
553
      this symbol group type standard version native-p rest prop propval
554 555 556 557
      ;; 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
558
			(keywordp sexp)
559 560 561
			(and (listp sexp)
			     (memq (car sexp) '(lambda)))
			(stringp sexp)
562
			(numberp sexp))
563 564
		    sexp
		  (list 'quote sexp)))))
565
  (while all
Per Abrahamsen's avatar
Per Abrahamsen committed
566 567 568 569
    (setq this (car all)
	  all (cdr all)
	  symbol (nth 0 this)
	  group (nth 1 this)
570
	  type (nth 2 this)
571
	  version (nth 3 this)
572
	  rest (nthcdr 4 this)
573 574
	  ;; If we did not specify any standard value expression above,
	  ;; use the current value as the standard value.
575 576 577 578
	  standard (if (setq prop (memq :standard rest))
		       (cadr prop)
		     (if (default-boundp symbol)
			 (funcall quoter (default-value symbol))))
579 580 581 582 583 584 585 586
	  ;; 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))
Eli Zaretskii's avatar
Eli Zaretskii committed
587 588
		      ((string-match "\\`ns-" (symbol-name symbol))
		       (featurep 'ns))
589
		      ((string-match "\\`x-.*gtk" (symbol-name symbol))
Karoly Lorentey's avatar
Karoly Lorentey committed
590
		       (featurep 'gtk))
591 592
		      ((string-match "clipboard-manager" (symbol-name symbol))
		       (boundp 'x-select-enable-clipboard-manager))
593 594
		      ((string-match "\\`x-" (symbol-name symbol))
		       (fboundp 'x-create-frame))
595 596 597 598
		      ((string-match "selection" (symbol-name symbol))
		       (fboundp 'x-selection-exists-p))
		      ((string-match "fringe" (symbol-name symbol))
		       (fboundp 'define-fringe-bitmap))
Glenn Morris's avatar
Glenn Morris committed
599 600
		      ((string-match "\\`imagemagick" (symbol-name symbol))
		       (fboundp 'imagemagick-types))
601 602
		      ((equal "font-use-system-font" (symbol-name symbol))
		       (featurep 'system-font-setting))
603 604 605 606
		      ;; Conditioned on x-create-frame, because that's
		      ;; the condition for loadup.el to preload tool-bar.el.
		      ((string-match "tool-bar-" (symbol-name symbol))
		       (fboundp 'x-create-frame))
607 608 609 610
		      ((equal "vertical-centering-font-regexp"
			      (symbol-name symbol))
		       ;; Any function from fontset.c will do.
		       (fboundp 'new-fontset))
611 612 613
		      ((equal "scroll-bar-adjust-thumb-portion"
			      (symbol-name symbol))
		       (featurep 'x))
614
		      (t t))))
Per Abrahamsen's avatar
Per Abrahamsen committed
615 616
    (if (not (boundp symbol))
	;; If variables are removed from C code, give an error here!
617 618
	(and native-p
	     (message "Note, built-in variable `%S' not bound" symbol))
619 620
      ;; Save the standard value, unless we already did.
      (or (get symbol 'standard-value)
621
	  (put symbol 'standard-value (list standard)))
622 623 624 625 626
      ;; We need these properties independent of whether cus-start is loaded.
      (if (setq prop (memq :safe rest))
	  (put symbol 'safe-local-variable (cadr prop)))
      (if (setq prop (memq :risky rest))
	  (put symbol 'risky-local-variable (cadr prop)))
627 628
      (if (setq prop (memq :set rest))
	  (put symbol 'custom-set (cadr prop)))
629 630 631
      ;; Note this is the _only_ initialize property we handle.
      (if (eq (cadr (memq :initialize rest)) 'custom-initialize-delay)
	  (push symbol custom-delayed-init-variables))
632 633 634
      ;; If this is NOT while dumping Emacs, set up the rest of the
      ;; customization info.  This is the stuff that is not needed
      ;; until someone does M-x customize etc.
635
      (unless purify-flag
636 637 638 639 640
	;; Add it to the right group(s).
	(if (listp group)
	    (dolist (g group)
	      (custom-add-to-group g symbol 'custom-variable))
	  (custom-add-to-group group symbol 'custom-variable))
641
	;; Set the type.
642
	(put symbol 'custom-type type)
643
	(if version (put symbol 'custom-version version))
644 645 646 647
	(while rest
	  (setq prop (car rest)
		propval (cadr rest)
		rest (nthcdr 2 rest))
648
	  (cond ((memq prop '(:standard :risky :safe :set))) ; handled above
649 650
		((eq prop :tag)
		 (put symbol 'custom-tag propval))))))))
651

Dave Love's avatar
Dave Love committed
652
(custom-add-to-group 'iswitchb 'read-buffer-function 'custom-variable)
Kenichi Handa's avatar
Kenichi Handa committed
653 654
(custom-add-to-group 'font-lock 'open-paren-in-column-0-is-defun-start
		     'custom-variable)
Dave Love's avatar
Dave Love committed
655

656 657 658
;; Record cus-start as loaded if we have set up all the info that we can.
;; Don't record it as loaded if we have only set up the standard values
;; and safe/risky properties.
659 660
(unless purify-flag
  (provide 'cus-start))
Per Abrahamsen's avatar
Per Abrahamsen committed
661

662
;;; cus-start.el ends here