35 |
;; that the user will run with M-x, and `Custom-' for interactive commands. |
;; that the user will run with M-x, and `Custom-' for interactive commands. |
36 |
|
|
37 |
;; The identity of a customize option is represented by a Lisp symbol. |
;; The identity of a customize option is represented by a Lisp symbol. |
38 |
;; There is the following values associated with an option. |
;; The following values are associated with an option. |
39 |
|
|
40 |
;; 0. The current value. |
;; 0. The current value. |
41 |
|
|
48 |
|
|
49 |
;; 1. The widget value. |
;; 1. The widget value. |
50 |
|
|
51 |
;; This is the value shown in the widget in a customize buffer. |
;; This is the value shown in the widget in a customize buffer. |
52 |
|
|
53 |
;; 2. The customized value. |
;; 2. The customized value. |
54 |
|
|
55 |
;; This is the last value given to the option through customize. |
;; This is the last value given to the option through customize. |
56 |
|
|
57 |
;; It is stored in the 'customized-value' property of the option, in a |
;; It is stored in the 'customized-value' property of the option, in a |
58 |
;; cons-cell whose car evaluate to the customized value. |
;; cons-cell whose car evaluates to the customized value. |
59 |
|
|
60 |
;; 3. The saved value. |
;; 3. The saved value. |
61 |
|
|
62 |
;; This is last value saved from customize. |
;; This is last value saved from customize. |
63 |
|
|
64 |
;; It is stored in the 'saved-value' property of the option, in a |
;; It is stored in the 'saved-value' property of the option, in a |
65 |
;; cons-cell whose car evaluate to the saved value. |
;; cons-cell whose car evaluates to the saved value. |
66 |
|
|
67 |
;; 4. The standard value. |
;; 4. The standard value. |
68 |
|
|
69 |
;; This is the value given in the 'defcustom' declaration. |
;; This is the value given in the 'defcustom' declaration. |
70 |
|
|
71 |
;; It is stored in the 'standard-value' property of the option, in a |
;; It is stored in the 'standard-value' property of the option, in a |
72 |
;; cons-cell whose car evaluate to the standard value. |
;; cons-cell whose car evaluates to the standard value. |
73 |
|
|
74 |
;; 5. The "think" value. |
;; 5. The "think" value. |
75 |
|
|
76 |
;; This is what customize think the current value should be. |
;; This is what customize thinks the current value should be. |
77 |
|
|
78 |
;; This is the customize value, if any such value exists, otherwise |
;; This is the customized value, if any such value exists, otherwise |
79 |
;; the saved value, if that exists, and as a last resort the standard |
;; the saved value, if that exists, and as a last resort the standard |
80 |
;; value. |
;; value. |
81 |
|
|
82 |
;; The reason for storing values unevaluated: This is so you can have |
;; The reason for storing values unevaluated: This is so you can have |
83 |
;; values that depend on the environment. For example, you can have a |
;; values that depend on the environment. For example, you can have a |
84 |
;; valiable that has one value when Emacs is running under a window |
;; variable that has one value when Emacs is running under a window |
85 |
;; system, and another value on a tty. Since the evaluation is only done |
;; system, and another value on a tty. Since the evaluation is only done |
86 |
;; when the variable is firsty initialized, this is only relevant for the |
;; when the variable is first initialized, this is only relevant for the |
87 |
;; saved (and standard) values, but affect others values for |
;; saved (and standard) values, but affect others values for |
88 |
;; compatibility. |
;; compatibility. |
89 |
|
|
103 |
;; The widget value is different from the current value. |
;; The widget value is different from the current value. |
104 |
|
|
105 |
;; 2. changed |
;; 2. changed |
106 |
|
|
107 |
;; The current value is different from the "think" value. |
;; The current value is different from the "think" value. |
108 |
|
|
109 |
;; 3. set |
;; 3. set |
110 |
|
|
120 |
|
|
121 |
;; 6. rogue |
;; 6. rogue |
122 |
|
|
123 |
;; There are no standard value. |
;; There is no standard value. This means that the variable was |
124 |
|
;; not defined with defcustom. You can not create a Custom buffer |
125 |
|
;; for such variables using the normal interactive Custom commands. |
126 |
|
;; However, such Custom buffers can be created in other ways, for |
127 |
|
;; instance, by calling `customize-option' non-interactively. |
128 |
|
|
129 |
;; 7. hidden |
;; 7. hidden |
130 |
|
|
133 |
;; 8. mismatch |
;; 8. mismatch |
134 |
|
|
135 |
;; The widget value is not valid member of the :type specified for the |
;; The widget value is not valid member of the :type specified for the |
136 |
;; option. |
;; option. |
137 |
|
|
138 |
;;; Code: |
;;; Code: |
139 |
|
|