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

;; Copyright (C) 1997, 1999-2012 Free Software Foundation, Inc.

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
	     (mode-line-format mode-line sexp) ;Hard to do right.
55
	     (major-mode internal function)
Per Abrahamsen's avatar
Per Abrahamsen committed
56 57 58 59 60 61
	     (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)
62
	     (word-wrap display boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
63
	     (selective-display-ellipses display boolean)
64
	     (indicate-empty-lines fringe boolean)
65 66 67 68 69 70
	     (indicate-buffer-boundaries
	      fringe
	      (choice
	       (const :tag "No indicators" nil)
	       (const :tag "On left, with arrows" left)
	       (const :tag "On right, with arrows" right)
71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
	       (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))))
103
	       (other :tag "On left, no arrows" t)))
104 105 106 107 108 109
	     (scroll-up-aggressively windows
				     (choice (const :tag "off" nil) number)
				     "21.1")
	     (scroll-down-aggressively windows
				       (choice (const :tag "off" nil) number)
				       "21.1")
110 111
	     (line-spacing display (choice (const :tag "none" nil) integer)
			   "22.1")
112
	     (cursor-in-non-selected-windows
113 114
	      cursor boolean nil
	      :tag "Cursor In Non-selected Windows"
Glenn Morris's avatar
Glenn Morris committed
115 116 117
	      :set (lambda (symbol value)
		     (set-default symbol value)
		     (force-mode-line-update t)))
118
	     (transient-mark-mode editing-basics boolean nil
119
				  :standard (not noninteractive)
120 121
				  :initialize custom-initialize-delay
				  :set custom-set-minor-mode)
122 123 124 125 126
	     (bidi-paragraph-direction
	      paragraphs
	      (choice
	       (const :tag "Left to Right" left-to-right)
	       (const :tag "Right to Left" right-to-left)
127 128
	       (const :tag "Dynamic, according to paragraph text" nil))
	      "24.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
129 130 131 132 133
	     ;; callint.c
	     (mark-even-if-inactive editing-basics boolean)
	     ;; callproc.c
	     (shell-file-name execute file)
	     (exec-path execute
134
			(repeat (choice (const :tag "default directory" nil)
135
					(directory :format "%v"))))
136
	     (exec-suffixes execute (repeat string))
Dave Love's avatar
Dave Love committed
137
	     ;; charset.c
138 139
	     (charset-map-path installation
			       (repeat (directory :format "%v")))
Dave Love's avatar
Dave Love committed
140 141
	     ;; coding.c
	     (inhibit-eol-conversion mule boolean)
142
	     (eol-mnemonic-undecided mule string)
143 144 145 146 147 148 149 150 151 152 153 154
	     ;; 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
155 156 157 158 159 160 161 162 163 164
	     (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"))
165 166 167 168 169
			    (coding-system
			     :tag "Single coding system"
			     :value undecided
			     :match (lambda (widget value)
				      (and value (not (functionp value)))))
Dave Love's avatar
Dave Love committed
170
			    (function :value ignore))))
Per Abrahamsen's avatar
Per Abrahamsen committed
171
	     ;; dired.c
172
	     (completion-ignored-extensions dired
Per Abrahamsen's avatar
Per Abrahamsen committed
173
					    (repeat (string :format "%v")))
174
	     ;; dispnew.c
Per Abrahamsen's avatar
Per Abrahamsen committed
175 176 177 178
	     (baud-rate display integer)
	     (inverse-video display boolean)
	     (visible-bell display boolean)
	     (no-redraw-on-reenter display boolean)
179 180 181 182 183 184 185

	     ;; 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
186 187 188 189 190
	     ;; editfns.c
	     (user-full-name mail string)
	     ;; eval.c
	     (max-specpdl-size limits integer)
	     (max-lisp-eval-depth limits integer)
191 192
	     (max-mini-window-height limits
				     (choice (const :tag "quarter screen" nil)
193
					     number) "23.1")
194
	     (debug-on-error debug
Per Abrahamsen's avatar
Per Abrahamsen committed
195 196 197 198 199 200
			     (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)))
201
	     (debug-on-quit debug boolean)
202 203 204
	     (debug-on-signal debug boolean)
	     ;; fileio.c
	     (delete-by-moving-to-trash auto-save boolean "23.1")
205
	     (auto-save-visited-file-name auto-save boolean)
206 207 208 209
	     ;; filelock.c
	     (temporary-file-directory
	      ;; Darwin section added 24.1, does not seem worth :version bump.
	      files directory nil
210
	      :standard
211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235
	      (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
236
	     ;; fns.c
237
	     (use-dialog-box menu boolean "21.1")
238
	     (use-file-dialog menu boolean "22.1")
239
	     (focus-follows-mouse frames boolean "20.3")
240 241
	     ;; fontset.c
	     (vertical-centering-font-regexp display regexp)
Per Abrahamsen's avatar
Per Abrahamsen committed
242 243 244 245 246
	     ;; 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
247 248
	     (mouse-highlight mouse (choice (const :tag "disabled" nil)
					    (const :tag "always shown" t)
249 250
					    (other :tag "hidden by keypress" 1))
			      "22.1")
251
	     (make-pointer-invisible mouse boolean "23.2")
252
	     (menu-bar-mode frames boolean nil
253 254 255
			    ;; FIXME?
;			    :initialize custom-initialize-default
			    :set custom-set-minor-mode)
256
	     (tool-bar-mode (frames mouse) boolean nil
257 258
;			    :initialize custom-initialize-default
			    :set custom-set-minor-mode)
259
	     ;; fringe.c
260
	     (overflow-newline-into-fringe fringe boolean)
Glenn Morris's avatar
Glenn Morris committed
261 262
	     ;; image.c
	     (imagemagick-render-type image integer "24.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
263
	     ;; indent.c
264
	     (indent-tabs-mode indent boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
265 266 267 268 269
	     ;; 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
270
	     (echo-keystrokes minibuffer number)
Per Abrahamsen's avatar
Per Abrahamsen committed
271
	     (polling-period keyboard integer)
272 273
	     (double-click-time mouse (restricted-sexp
				       :match-alternatives (integerp 'nil 't)))
274
	     (double-click-fuzz mouse integer "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
275 276 277 278
	     (inhibit-local-menu-bar-menus menu boolean)
	     (help-char keyboard character)
	     (help-event-list keyboard (repeat (sexp :format "%v")))
	     (menu-prompting menu boolean)
279
	     (select-active-regions killing
280 281
				    (choice (const :tag "always" t)
					    (const :tag "only shift-selection or mouse-drag" only)
282 283
					    (const :tag "off" nil))
				    "24.1")
Daniel Colascione's avatar
Daniel Colascione committed
284 285 286 287 288
             (debug-on-event debug
                             (choice (const :tag "None" nil)
                                     (const :tag "When sent SIGUSR1" sigusr1)
                                     (const :tag "When sent SIGUSR2" sigusr2))
                             "24.1")
289

290 291 292 293
;; 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.
294
;;; 	     (load-path environment
295 296 297 298
;;; 			(repeat (choice :tag "[Current dir?]"
;;; 					:format "%[Current dir?%] %v"
;;; 					(const :tag " current dir" nil)
;;;					(directory :format "%v"))))
Per Abrahamsen's avatar
Per Abrahamsen committed
299 300
	     ;; minibuf.c
	     (enable-recursive-minibuffers minibuffer boolean)
301
	     (history-length minibuffer
302 303 304
			     (choice (const :tag "Infinite" t) integer)
			     "22.1")
	     (history-delete-duplicates minibuffer boolean "22.1")
305 306
	     (read-buffer-completion-ignore-case minibuffer boolean "23.1")

307 308 309 310 311 312 313 314 315
	     (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))
316
			  (const :tag "Don't Enter"
317 318 319 320 321 322 323 324 325
				 :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
326 327
			     (sexp :tag "Value"))))
	      "21.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
328
	     (minibuffer-auto-raise minibuffer boolean)
Dave Love's avatar
Dave Love committed
329
	     ;; options property set at end
Dave Love's avatar
Dave Love committed
330 331 332 333
	     (read-buffer-function minibuffer
				   (choice (const nil)
					   (function-item iswitchb-read-buffer)
					   function))
334 335
	     ;; msdos.c
	     (dos-unsupported-char-glyph display integer)
336
	     ;; nsterm.m
Eli Zaretskii's avatar
Eli Zaretskii committed
337
	     (ns-control-modifier
338
	      ns
339 340 341 342
	      (choice (const :tag "No modifier" nil)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
343 344 345 346 347 348 349 350
	     (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)
		      (const super)) "24.0")
Eli Zaretskii's avatar
Eli Zaretskii committed
351
	     (ns-command-modifier
352
	      ns
353 354 355 356
	      (choice (const :tag "No modifier" nil)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
357 358 359 360 361 362 363 364
	     (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)
		      (const super)) "24.0")
Eli Zaretskii's avatar
Eli Zaretskii committed
365
	     (ns-alternate-modifier
366
	      ns
367 368 369 370
	      (choice (const :tag "No modifier (work as alternate/option)" none)
		      (const control) (const meta)
		      (const alt) (const hyper)
		      (const super)) "23.1")
371 372 373 374 375 376 377 378
	     (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
379
	     (ns-function-modifier
380
	      ns
381 382 383 384 385
	      (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")
386
	     (ns-auto-hide-menu-bar ns boolean "24.0")
Per Abrahamsen's avatar
Per Abrahamsen committed
387
	     ;; process.c
388
	     (delete-exited-processes processes-basics boolean)
Per Abrahamsen's avatar
Per Abrahamsen committed
389 390 391
	     ;; syntax.c
	     (parse-sexp-ignore-comments editing-basics boolean)
	     (words-include-escapes editing-basics boolean)
Kenichi Handa's avatar
Kenichi Handa committed
392 393
	     (open-paren-in-column-0-is-defun-start editing-basics boolean
						    "21.1")
Stefan Monnier's avatar
Stefan Monnier committed
394 395
             ;; term.c
             (visible-cursor cursor boolean "22.1")
396 397 398 399 400 401 402 403 404 405 406 407 408 409
	     ;; 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
410
	     ;; window.c
411
	     (temp-buffer-show-function windows (choice (const nil) function))
412
	     (next-screen-context-lines windows integer)
413 414 415 416
 	     (scroll-preserve-screen-position
 	      windows (choice
 		       (const :tag "Off (nil)" :value nil)
 		       (const :tag "Full screen (t)" :value t)
417
 		       (other :tag "Always" 1)) "22.1")
418 419 420 421 422
	     (recenter-redisplay
	      windows (choice
		       (const :tag "Never (nil)" :value nil)
		       (const :tag "Only on ttys" :value tty)
		       (other :tag "Always" t)) "23.1")
423
	     (window-combination-resize windows boolean "24.1")
424
	     (window-combination-limit windows boolean "24.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
425
	     ;; xdisp.c
426
	     (show-trailing-whitespace whitespace-faces boolean nil
427
				       :safe booleanp)
Per Abrahamsen's avatar
Per Abrahamsen committed
428
	     (scroll-step windows integer)
429 430
	     (scroll-conservatively windows integer)
	     (scroll-margin windows integer)
Eli Zaretskii's avatar
Eli Zaretskii committed
431 432
	     (hscroll-margin windows integer "22.1")
	     (hscroll-step windows number "22.1")
433
	     (truncate-partial-width-windows display boolean "23.1")
434
	     (make-cursor-line-fully-visible windows boolean)
435 436
	     (mode-line-inverse-video mode-line boolean)
	     (mode-line-in-non-selected-windows mode-line boolean "22.1")
437 438 439
	     (line-number-display-limit display
					(choice integer
						(const :tag "No limit" nil)))
440
	     (line-number-display-limit-width display integer "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
441 442 443 444
	     (highlight-nonselected-windows display boolean)
	     (message-log-max debug (choice (const :tag "Disable" nil)
					    (integer :menu-tag "lines"
						     :format "%v")
445
					    (other :tag "Unlimited" t)))
446
	     (unibyte-display-via-language-environment mule boolean)
447
	     (blink-cursor-alist cursor alist "22.1")
448
	     (overline-margin display integer "22.1")
449
	     (underline-minimum-offset display integer "23.1")
450 451 452 453 454
             (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")
455 456 457 458 459 460
             (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)
461
		      (const :tag "Text-image-horiz" :value text-image-horiz)
462 463
		      (const :tag "System default" :value nil)) "23.3")
             (tool-bar-max-label-size frames integer "23.3")
464
	     (auto-hscroll-mode scrolling boolean "21.1")
465 466 467 468 469 470 471 472 473 474
	     (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)))
475 476
	     (display-hourglass cursor boolean)
	     (hourglass-delay cursor number)
477

478
	     ;; xfaces.c
479
	     (font-list-limit display integer)
480
	     (scalable-fonts-allowed display boolean "22.1")
Per Abrahamsen's avatar
Per Abrahamsen committed
481 482
	     ;; xfns.c
	     (x-bitmap-file-path installation
483
				 (repeat (directory :format "%v")))
484
	     (x-gtk-use-old-file-dialog menu boolean "22.1")
Jan Djärv's avatar
Jan Djärv committed
485
	     (x-gtk-show-hidden-files menu boolean "22.1")
486
	     (x-gtk-file-dialog-help-text menu boolean "22.1")
487
	     (x-gtk-whole-detached-tool-bar x boolean "22.1")
488
	     (x-gtk-use-system-tooltips tooltip boolean "23.3")
489
	     ;; xterm.c
Eli Zaretskii's avatar
Eli Zaretskii committed
490
	     (x-use-underline-position-properties display boolean "22.1")
491
	     (x-underline-at-descent-line display boolean "22.1")
492
	     (x-stretch-cursor display boolean "21.1")
493 494
	     ;; xselect.c
	     (x-select-enable-clipboard-manager killing boolean "24.1")
495 496
	     ;; xsettings.c
	     (font-use-system-font font-selection boolean "23.2")))
497
      this symbol group type standard version native-p rest prop propval
498 499 500 501
      ;; 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
502
			(keywordp sexp)
503 504 505
			(and (listp sexp)
			     (memq (car sexp) '(lambda)))
			(stringp sexp)
506
			(numberp sexp))
507 508
		    sexp
		  (list 'quote sexp)))))
509
  (while all
Per Abrahamsen's avatar
Per Abrahamsen committed
510 511 512 513
    (setq this (car all)
	  all (cdr all)
	  symbol (nth 0 this)
	  group (nth 1 this)
514
	  type (nth 2 this)
515
	  version (nth 3 this)
516
	  rest (nthcdr 4 this)
517 518
	  ;; If we did not specify any standard value expression above,
	  ;; use the current value as the standard value.
519 520 521 522
	  standard (if (setq prop (memq :standard rest))
		       (cadr prop)
		     (if (default-boundp symbol)
			 (funcall quoter (default-value symbol))))
523 524 525 526 527 528 529 530
	  ;; 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
531 532
		      ((string-match "\\`ns-" (symbol-name symbol))
		       (featurep 'ns))
533
		      ((string-match "\\`x-.*gtk" (symbol-name symbol))
Karoly Lorentey's avatar
Karoly Lorentey committed
534
		       (featurep 'gtk))
535 536
		      ((string-match "clipboard-manager" (symbol-name symbol))
		       (boundp 'x-select-enable-clipboard-manager))
537 538
		      ((string-match "\\`x-" (symbol-name symbol))
		       (fboundp 'x-create-frame))
539 540 541 542
		      ((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
543 544
		      ((string-match "\\`imagemagick" (symbol-name symbol))
		       (fboundp 'imagemagick-types))
545 546
		      ((equal "font-use-system-font" (symbol-name symbol))
		       (featurep 'system-font-setting))
547 548 549 550
		      ;; 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))
551
		      (t t))))
Per Abrahamsen's avatar
Per Abrahamsen committed
552 553
    (if (not (boundp symbol))
	;; If variables are removed from C code, give an error here!
554 555
	(and native-p
	     (message "Note, built-in variable `%S' not bound" symbol))
556 557
      ;; Save the standard value, unless we already did.
      (or (get symbol 'standard-value)
558
	  (put symbol 'standard-value (list standard)))
559 560 561 562 563
      ;; 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)))
564 565
      (if (setq prop (memq :set rest))
	  (put symbol 'custom-set (cadr prop)))
566 567 568
      ;; Note this is the _only_ initialize property we handle.
      (if (eq (cadr (memq :initialize rest)) 'custom-initialize-delay)
	  (push symbol custom-delayed-init-variables))
569 570 571
      ;; 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.
572
      (unless purify-flag
573 574 575 576 577
	;; 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))
578
	;; Set the type.
579
	(put symbol 'custom-type type)
580
	(if version (put symbol 'custom-version version))
581 582 583 584
	(while rest
	  (setq prop (car rest)
		propval (cadr rest)
		rest (nthcdr 2 rest))
585
	  (cond ((memq prop '(:standard :risky :safe :set))) ; handled above
586 587
		((eq prop :tag)
		 (put symbol 'custom-tag propval))))))))
588

Dave Love's avatar
Dave Love committed
589
(custom-add-to-group 'iswitchb 'read-buffer-function 'custom-variable)
Kenichi Handa's avatar
Kenichi Handa committed
590 591
(custom-add-to-group 'font-lock 'open-paren-in-column-0-is-defun-start
		     'custom-variable)
Dave Love's avatar
Dave Love committed
592

593 594 595
;; 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.
596 597
(unless purify-flag
  (provide 'cus-start))
Per Abrahamsen's avatar
Per Abrahamsen committed
598

599
;;; cus-start.el ends here