From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: cus-edit.el Date: Fri, 18 Feb 2005 20:27:58 -0600 (CST) Message-ID: <200502190227.j1J2Rw623778@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1108781061 25435 80.91.229.2 (19 Feb 2005 02:44:21 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 19 Feb 2005 02:44:21 +0000 (UTC) Cc: abraham@dina.kvl.dk Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Feb 19 03:44:21 2005 Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1D2KaT-0004Dw-FX for ged-emacs-devel@m.gmane.org; Sat, 19 Feb 2005 03:43:18 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D2Kqv-0005O6-If for ged-emacs-devel@m.gmane.org; Fri, 18 Feb 2005 22:00:17 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1D2KlK-0004g6-E5 for emacs-devel@gnu.org; Fri, 18 Feb 2005 21:54:30 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1D2Kl2-0004Xf-9w for emacs-devel@gnu.org; Fri, 18 Feb 2005 21:54:14 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1D2Kky-0004UO-Vm for emacs-devel@gnu.org; Fri, 18 Feb 2005 21:54:09 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1D2KNj-0004dc-Pt for emacs-devel@gnu.org; Fri, 18 Feb 2005 21:30:07 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id j1J2Ts9N003347; Fri, 18 Feb 2005 20:29:54 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j1J2Rw623778; Fri, 18 Feb 2005 20:27:58 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org X-MailScanner-To: ged-emacs-devel@m.gmane.org Xref: main.gmane.org gmane.emacs.devel:33618 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:33618 As I mentioned before, several strings in `custom-magic-alist' are wrong (I previously gave test cases to show that) or too long. There are several typos in the initial comments. The description of the `rogue state' is too vague. I propose the following patch, which I could install if desired: ===File ~/cus-edit.el-diff================================== *** cus-edit.el 14 Feb 2005 15:38:32 -0600 1.212 --- cus-edit.el 18 Feb 2005 19:28:46 -0600 *************** *** 35,41 **** ;; that the user will run with M-x, and `Custom-' for interactive commands. ;; The identity of a customize option is represented by a Lisp symbol. ! ;; There is the following values associated with an option. ;; 0. The current value. --- 35,41 ---- ;; that the user will run with M-x, and `Custom-' for interactive commands. ;; The identity of a customize option is represented by a Lisp symbol. ! ;; The following values are associated with an option. ;; 0. The current value. *************** *** 55,89 **** ;; This is the last value given to the option through customize. ;; It is stored in the 'customized-value' property of the option, in a ! ;; cons-cell whose car evaluate to the customized value. ;; 3. The saved value. ;; This is last value saved from customize. ;; It is stored in the 'saved-value' property of the option, in a ! ;; cons-cell whose car evaluate to the saved value. ;; 4. The standard value. ;; This is the value given in the 'defcustom' declaration. ;; It is stored in the 'standard-value' property of the option, in a ! ;; cons-cell whose car evaluate to the standard value. ;; 5. The "think" value. ;; This is what customize think the current value should be. ! ;; This is the customize value, if any such value exists, otherwise ;; the saved value, if that exists, and as a last resort the standard ;; value. ;; The reason for storing values unevaluated: This is so you can have ;; values that depend on the environment. For example, you can have a ! ;; valiable that has one value when Emacs is running under a window ;; system, and another value on a tty. Since the evaluation is only done ! ;; when the variable is firsty initialized, this is only relevant for the ;; saved (and standard) values, but affect others values for ;; compatibility. --- 55,89 ---- ;; This is the last value given to the option through customize. ;; It is stored in the 'customized-value' property of the option, in a ! ;; cons-cell whose car evaluates to the customized value. ;; 3. The saved value. ;; This is last value saved from customize. ;; It is stored in the 'saved-value' property of the option, in a ! ;; cons-cell whose car evaluates to the saved value. ;; 4. The standard value. ;; This is the value given in the 'defcustom' declaration. ;; It is stored in the 'standard-value' property of the option, in a ! ;; cons-cell whose car evaluates to the standard value. ;; 5. The "think" value. ;; This is what customize think the current value should be. ! ;; This is the customized value, if any such value exists, otherwise ;; the saved value, if that exists, and as a last resort the standard ;; value. ;; The reason for storing values unevaluated: This is so you can have ;; values that depend on the environment. For example, you can have a ! ;; variable that has one value when Emacs is running under a window ;; system, and another value on a tty. Since the evaluation is only done ! ;; when the variable is first initialized, this is only relevant for the ;; saved (and standard) values, but affect others values for ;; compatibility. *************** *** 120,126 **** ;; 6. rogue ! ;; There are no standard value. ;; 7. hidden --- 120,131 ---- ;; 6. rogue ! ;; There is no standard value. This means that the variable was ! ;; not defined with defcustom. In newer Emacs versions, you can ! ;; not create a Custom buffer for such variables using the normal ! ;; interactive Custom commands. However, such Custom buffers can ! ;; be created in other ways, for instance, by calling ! ;; `customize-option' non-interactively. ;; 7. hidden *************** *** 1671,1685 **** the value displayed for this %c is invalid and cannot be set.") (modified "*" custom-modified-face "\ you have edited the value as text, but you have not set the %c." "\ ! you have edited something in this group, but not set anything yet.") (set "+" custom-set-face "\ you have set this %c, but not saved it for future sessions." "\ ! you have set something in this group, but not saved anything yet.") (changed ":" custom-changed-face "\ this %c has been changed outside the customize buffer." "\ something in this group has been changed outside customize.") (saved "!" custom-saved-face "\ ! You have set this %c and saved it through Customize in your init file." "\ something in this group has been set and saved.") (rogue "@" custom-rogue-face "\ this %c has not been changed with customize." "\ --- 1676,1690 ---- the value displayed for this %c is invalid and cannot be set.") (modified "*" custom-modified-face "\ you have edited the value as text, but you have not set the %c." "\ ! you have edited something in this group, but not set it.") (set "+" custom-set-face "\ you have set this %c, but not saved it for future sessions." "\ ! you have set something in this group, but not saved it.") (changed ":" custom-changed-face "\ this %c has been changed outside the customize buffer." "\ something in this group has been changed outside customize.") (saved "!" custom-saved-face "\ ! You have set and saved this %c through Customize." "\ something in this group has been set and saved.") (rogue "@" custom-rogue-face "\ this %c has not been changed with customize." "\ ============================================================