[bpt/emacs.git] / lisp / cus-start.el

;;; cus-start.el --- define customization properties of builtins.
;;
;; Copyright (C) 1997, 1999, 2000 Free Software Foundation, Inc.
;;
;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
;; Keywords: internal

;; 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.

;;; Commentary:
;;
;; This file adds customize support for built-in variables.

;; 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.

;;; Code:

(let ((all '(;; abbrev.c 
	     (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)
	     (enable-multibyte-characters mule boolean)
	     (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)
	     (transient-mark-mode editing-basics boolean)
	     (indicate-empty-lines display boolean "21.1")
	     (scroll-up-aggressively windows boolean "21.1")
	     (scroll-down-aggressively windows boolean "21.1")
	     ;; 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"))))
	     ;; coding.c
	     (inhibit-eol-conversion mule boolean)
	     (eol-mnemonic-undecided mule string)
	     (eol-mnemonic-unix mule string)
	     (eol-mnemonic-dos mule string)
	     (eol-mnemonic-mac mule string)
	     (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))))
	     ;; dired.c
	     (completion-ignored-extensions dired 
					    (repeat (string :format "%v")))
	     ;; dispnew.c
	     (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)))
	     (debug-on-error debug 
			     (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)))
	     (debug-on-quit debug
			    (choice (const :tag "off")
				    (repeat :menu-tag "When"
					    :value (nil)
					    (symbol :format "%v"))
				    (const :tag "always" t)))
	     ;; fileio.c
	     (insert-default-directory minibuffer boolean)
	     ;; fns.c
	     (use-dialog-box menu boolean "21.1")
	     ;; frame.c
	     (default-frame-alist frames
	       (repeat (cons :format "%v"
			     (symbol :tag "Parameter")
			     (sexp :tag "Value"))))
	     ;; 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")))
	     (echo-keystrokes minibuffer number)
	     (polling-period keyboard integer)
	     (double-click-time mouse (restricted-sexp
				       :match-alternatives (integerp 'nil 't)))
	     (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)
						    (other :tag "on")))
	     ;; lread.c

;; 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"))))
	     ;; minibuf.c
	     (completion-auto-help minibuffer boolean)
	     (enable-recursive-minibuffers minibuffer boolean)
	     (minibuffer-auto-raise minibuffer boolean)
	     ;; msdos.c
	     (dos-unsupported-char-glyph display integer)
	     ;; process.c
	     (delete-exited-processes processes-basics boolean)
	     ;; syntax.c
	     (parse-sexp-ignore-comments editing-basics boolean)
	     (words-include-escapes editing-basics boolean)
	     ;; window.c
	     (temp-buffer-show-function windows function)
	     (display-buffer-function windows function)
	     (pop-up-frames frames boolean)
	     (pop-up-frame-function frames function)
	     (special-display-buffer-names 
	      frames 
	      (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
	      frames 
	      (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)
	     (next-screen-context-lines windows integer)
	     (split-height-threshold windows integer)
	     (window-min-height windows integer)
	     (window-min-width windows integer)
	     (scroll-preserve-screen-position windows boolean)
	     (display-buffer-reuse-frames windows boolean "21.1")
	     ;; xdisp.c
	     (scroll-step windows integer)
	     (scroll-conservatively windows integer)
	     (scroll-margin windows integer)
	     (truncate-partial-width-windows display boolean)
	     (mode-line-inverse-video modeline boolean)
	     (line-number-display-limit display
					(choice integer
						(const :tag "No limit" nil)))
	     (highlight-nonselected-windows display boolean)
	     (message-log-max debug (choice (const :tag "Disable" nil)
					    (integer :menu-tag "lines"
						     :format "%v")
					    (other :tag "Unlimited" t)))
	     (unibyte-display-via-language-environment mule boolean)
	     ;; xfns.c
	     (x-bitmap-file-path installation
				 (repeat (directory :format "%v")))
	     ;; xterm.c
	     (x-stretch-cursor display boolean "21.1")))
      this symbol group type native-p version
      ;; This function turns a value
      ;; into an expression which produces that value.
      (quoter (lambda (sexp)
		(if (or (memq sexp '(t nil))
			(keywordp sexp)
			(and (listp sexp)
			     (memq (car sexp) '(lambda)))
			(stringp sexp)
;; 			(and (fboundp 'characterp)
;; 			     (characterp sexp))
			(numberp sexp))
		    sexp
		  (list 'quote sexp)))))
  (while all 
    (setq this (car all)
	  all (cdr all)
	  symbol (nth 0 this)
	  group (nth 1 this)
	  type (nth 2 this)
	  version (nth 3 this)
	  ;; 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))
		      (t t))))
    (if (not (boundp symbol))
	;; If variables are removed from C code, give an error here!
	(and native-p
	     (message "Note, built-in variable `%S' not bound" symbol))
      ;; Save the standard value, unless we already did.
      (or (get symbol 'standard-value)
	  (put symbol 'standard-value 
	       (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.
	(put symbol 'custom-type type)
	(put symbol 'custom-version version)))))

;; 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))

;;; cus-start.el ends here.
Commit	Line	Data
1444b0c0 PA	1	;;; cus-start.el --- define customization properties of builtins.
1444b0c0 PA	2	;;
37328bcd	3	;; Copyright (C) 1997, 1999, 2000 Free Software Foundation, Inc.
1444b0c0 PA	4	;;
	5	;; Author: Per Abrahamsen <abraham@dina.kvl.dk>
	6	;; Keywords: internal
	7
c2383d2d RS	8	;; This file is part of GNU Emacs.
	9
	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)
	13	;; any later version.
	14
	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.
	19
	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.
	24
1444b0c0 PA	25	;;; Commentary:
1444b0c0 PA	26	;;
4883633e	27	;; This file adds customize support for built-in variables.
1444b0c0	28
4883633e RS	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.
1444b0c0	34
4883633e	35	;;; Code:
1444b0c0 PA	36
	37	(let ((all '(;; abbrev.c
	38	(abbrev-all-caps abbrev-mode boolean)
	39	(pre-abbrev-expand-hook abbrev-mode hook)
	40	;; alloc.c
	41	(gc-cons-threshold alloc integer)
	42	(undo-limit undo integer)
	43	(undo-strong-limit undo integer)
	44	(garbage-collection-messages alloc boolean)
	45	;; buffer.c
	46	(mode-line-format modeline sexp) ;Hard to do right.
	47	(default-major-mode internal function)
924ef223	48	(enable-multibyte-characters mule boolean)
1444b0c0 PA	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)
1444b0c0 PA	55	(selective-display-ellipses display boolean)
1444b0c0 PA	56	(transient-mark-mode editing-basics boolean)
37328bcd DL	57	(indicate-empty-lines display boolean "21.1")
	58	(scroll-up-aggressively windows boolean "21.1")
	59	(scroll-down-aggressively windows boolean "21.1")
1444b0c0 PA	60	;; callint.c
	61	(mark-even-if-inactive editing-basics boolean)
	62	;; callproc.c
	63	(shell-file-name execute file)
	64	(exec-path execute
	65	(repeat (choice (const :tag "default" nil)
	66	(file :format "%v"))))
5fc9eb7c DL	67	;; coding.c
5fc9eb7c DL	68	(inhibit-eol-conversion mule boolean)
de0d1fc5 EZ	69	(eol-mnemonic-undecided mule string)
	70	(eol-mnemonic-unix mule string)
	71	(eol-mnemonic-dos mule string)
	72	(eol-mnemonic-mac mule string)
13eb63ff DL	73	(file-coding-system-alist
	74	mule
	75	(alist
	76	:key-type (regexp :tag "File regexp")
	77	:value-type (choice
	78	:value (undecided . undecided)
	79	(cons :tag "Encoding/decoding pair"
	80	:value (undecided . undecided)
	81	(coding-system :tag "Decoding")
	82	(coding-system :tag "Encoding"))
	83	(coding-system :tag "Single coding system"
	84	:value undecided)
	85	(function :value ignore))))
1444b0c0 PA	86	;; dired.c
	87	(completion-ignored-extensions dired
	88	(repeat (string :format "%v")))
0849a37e	89	;; dispnew.c
1444b0c0 PA	90	(baud-rate display integer)
	91	(inverse-video display boolean)
	92	(visible-bell display boolean)
	93	(no-redraw-on-reenter display boolean)
	94	;; editfns.c
	95	(user-full-name mail string)
	96	;; eval.c
	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"
	102	:value (nil)
	103	(symbol :format "%v"))
	104	(const :tag "always" t)))
	105	(debug-on-error debug
	106	(choice (const :tag "off")
	107	(repeat :menu-tag "When"
	108	:value (nil)
	109	(symbol :format "%v"))
	110	(const :tag "always" t)))
	111	(debug-ignored-errors debug (repeat (choice symbol regexp)))
507c9247 RS	112	(debug-on-quit debug
	113	(choice (const :tag "off")
	114	(repeat :menu-tag "When"
	115	:value (nil)
	116	(symbol :format "%v"))
	117	(const :tag "always" t)))
1444b0c0 PA	118	;; fileio.c
1444b0c0 PA	119	(insert-default-directory minibuffer boolean)
78976e0a	120	;; fns.c
37328bcd	121	(use-dialog-box menu boolean "21.1")
1444b0c0 PA	122	;; frame.c
	123	(default-frame-alist frames
	124	(repeat (cons :format "%v"
	125	(symbol :tag "Parameter")
	126	(sexp :tag "Value"))))
	127	;; indent.c
	128	(indent-tabs-mode fill boolean)
	129	;; keyboard.c
	130	(meta-prefix-char keyboard character)
	131	(auto-save-interval auto-save integer)
	132	(auto-save-timeout auto-save (choice (const :tag "off" nil)
	133	(integer :format "%v")))
ac1b1728	134	(echo-keystrokes minibuffer number)
1444b0c0	135	(polling-period keyboard integer)
4db2b1c7 RS	136	(double-click-time mouse (restricted-sexp
4db2b1c7 RS	137	:match-alternatives (integerp 'nil 't)))
1444b0c0 PA	138	(inhibit-local-menu-bar-menus menu boolean)
	139	(help-char keyboard character)
	140	(help-event-list keyboard (repeat (sexp :format "%v")))
	141	(menu-prompting menu boolean)
1444b0c0 PA	142	(suggest-key-bindings keyboard (choice (const :tag "off" nil)
1444b0c0 PA	143	(integer :tag "time" 2)
79221864	144	(other :tag "on")))
1444b0c0	145	;; lread.c
37328bcd DL	146
	147	;; This is not good news because it will use the wrong
	148	;; version-specific directories when you upgrade. We need
	149	;; customization of the front of the list, maintaining the standard
	150	;; value intact at the back.
	151	;;; (load-path environment
	152	;;; (repeat (choice :tag "[Current dir?]"
	153	;;; :format "%[Current dir?%] %v"
	154	;;; (const :tag " current dir" nil)
	155	;;; (directory :format "%v"))))
1444b0c0 PA	156	;; minibuf.c
	157	(completion-auto-help minibuffer boolean)
	158	(enable-recursive-minibuffers minibuffer boolean)
	159	(minibuffer-auto-raise minibuffer boolean)
b78fba02 EZ	160	;; msdos.c
b78fba02 EZ	161	(dos-unsupported-char-glyph display integer)
1444b0c0	162	;; process.c
4883633e	163	(delete-exited-processes processes-basics boolean)
1444b0c0 PA	164	;; syntax.c
	165	(parse-sexp-ignore-comments editing-basics boolean)
	166	(words-include-escapes editing-basics boolean)
	167	;; window.c
	168	(temp-buffer-show-function windows function)
	169	(display-buffer-function windows function)
	170	(pop-up-frames frames boolean)
	171	(pop-up-frame-function frames function)
	172	(special-display-buffer-names
	173	frames
	174	(repeat (choice :tag "Buffer"
	175	:value ""
	176	(string :format "%v")
	177	(cons :tag "With attributes"
	178	:format "%v"
	179	:value ("" . nil)
	180	(string :format "%v")
	181	(repeat :tag "Attributes"
	182	(cons :format "%v"
	183	(symbol :tag "Parameter")
	184	(sexp :tag "Value")))))))
	185	(special-display-regexps
	186	frames
	187	(repeat (choice :tag "Buffer"
	188	:value ""
	189	(regexp :format "%v")
	190	(cons :tag "With attributes"
	191	:format "%v"
	192	:value ("" . nil)
	193	(regexp :format "%v")
	194	(repeat :tag "Attributes"
	195	(cons :format "%v"
	196	(symbol :tag "Parameter")
	197	(sexp :tag "Value")))))))
	198	(special-display-function frames function)
	199	(same-window-buffer-names windows (repeat (string :format "%v")))
	200	(same-window-regexps windows (repeat (regexp :format "%v")))
	201	(pop-up-windows windows boolean)
74f54b54	202	(next-screen-context-lines windows integer)
1444b0c0 PA	203	(split-height-threshold windows integer)
	204	(window-min-height windows integer)
	205	(window-min-width windows integer)
bcc67965	206	(scroll-preserve-screen-position windows boolean)
13eb63ff	207	(display-buffer-reuse-frames windows boolean "21.1")
1444b0c0 PA	208	;; xdisp.c
1444b0c0 PA	209	(scroll-step windows integer)
ccbb360e RS	210	(scroll-conservatively windows integer)
ccbb360e RS	211	(scroll-margin windows integer)
1444b0c0 PA	212	(truncate-partial-width-windows display boolean)
1444b0c0 PA	213	(mode-line-inverse-video modeline boolean)
37328bcd DL	214	(line-number-display-limit display
	215	(choice integer
	216	(const :tag "No limit" nil)))
1444b0c0 PA	217	(highlight-nonselected-windows display boolean)
	218	(message-log-max debug (choice (const :tag "Disable" nil)
	219	(integer :menu-tag "lines"
	220	:format "%v")
79221864	221	(other :tag "Unlimited" t)))
daba3e25	222	(unibyte-display-via-language-environment mule boolean)
1444b0c0 PA	223	;; xfns.c
1444b0c0 PA	224	(x-bitmap-file-path installation
0849a37e DL	225	(repeat (directory :format "%v")))
0849a37e DL	226	;; xterm.c
37328bcd DL	227	(x-stretch-cursor display boolean "21.1")))
37328bcd DL	228	this symbol group type native-p version
4883633e RS	229	;; This function turns a value
	230	;; into an expression which produces that value.
	231	(quoter (lambda (sexp)
	232	(if (or (memq sexp '(t nil))
017266f8	233	(keywordp sexp)
4883633e RS	234	(and (listp sexp)
	235	(memq (car sexp) '(lambda)))
	236	(stringp sexp)
37328bcd DL	237	;; (and (fboundp 'characterp)
	238	;; (characterp sexp))
	239	(numberp sexp))
4883633e RS	240	sexp
4883633e RS	241	(list 'quote sexp)))))
1444b0c0 PA	242	(while all
	243	(setq this (car all)
	244	all (cdr all)
	245	symbol (nth 0 this)
	246	group (nth 1 this)
00377857	247	type (nth 2 this)
37328bcd	248	version (nth 3 this)
00377857 EZ	249	;; Don't complain about missing variables which are
	250	;; irrelevant to this platform.
	251	native-p (save-match-data
	252	(cond
	253	((string-match "\\`dos-" (symbol-name symbol))
	254	(eq system-type 'ms-dos))
	255	((string-match "\\`w32-" (symbol-name symbol))
	256	(eq system-type 'windows-nt))
	257	(t t))))
1444b0c0 PA	258	(if (not (boundp symbol))
1444b0c0 PA	259	;; If variables are removed from C code, give an error here!
00377857 EZ	260	(and native-p
00377857 EZ	261	(message "Note, built-in variable `%S' not bound" symbol))
4883633e RS	262	;; Save the standard value, unless we already did.
	263	(or (get symbol 'standard-value)
	264	(put symbol 'standard-value
	265	(list (funcall quoter (default-value symbol)))))
	266	;; If this is NOT while dumping Emacs,
	267	;; set up the rest of the customization info.
	268	(unless purify-flag
	269	;; Add it to the right group.
	270	(custom-add-to-group group symbol 'custom-variable)
	271	;; Set the type.
37328bcd DL	272	(put symbol 'custom-type type)
37328bcd DL	273	(put symbol 'custom-version version)))))
4883633e RS	274
	275	;; Record cus-start as loaded
	276	;; if we have set up all the info that we can set up.
	277	;; Don't record cus-start as loaded
	278	;; if we have set up only the standard values.
	279	(unless purify-flag
	280	(provide 'cus-start))
1444b0c0 PA	281
1444b0c0 PA	282	;;; cus-start.el ends here.