From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: obsolete comment in tool-bar.el Date: Sun, 10 Jul 2005 22:21:42 -0500 (CDT) Message-ID: <200507110321.j6B3LgG09526@raven.dms.auburn.edu> References: <200507071915.j67JFZT29961@raven.dms.auburn.edu> <200507090235.j692ZER04883@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1121054814 13905 80.91.229.2 (11 Jul 2005 04:06:54 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 11 Jul 2005 04:06:54 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jul 11 06:06:46 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DrpYq-0000kj-NW for ged-emacs-devel@m.gmane.org; Mon, 11 Jul 2005 06:06:29 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DrpaO-00018d-MF for ged-emacs-devel@m.gmane.org; Mon, 11 Jul 2005 00:08:04 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DrpYA-0007yE-42 for emacs-devel@gnu.org; Mon, 11 Jul 2005 00:05:46 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DrpTm-0006bj-Ae for emacs-devel@gnu.org; Mon, 11 Jul 2005 00:01:15 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DrpTf-0006Py-LQ for emacs-devel@gnu.org; Mon, 11 Jul 2005 00:01:07 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Drp13-0001pQ-QS; Sun, 10 Jul 2005 23:31:33 -0400 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 j6B3O1CK022531; Sun, 10 Jul 2005 22:24:02 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j6B3LgG09526; Sun, 10 Jul 2005 22:21:42 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: rms@gnu.org In-reply-to: (rms@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 Xref: news.gmane.org gmane.emacs.devel:40747 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:40747 This concerns the documentation for the two new :initialize functions. They are kind of internal and hence I believe that maybe they do not need to be mentioned in the already very long NEWS. On the other hand, maybe it might be useful to mention them in the Elisp manual, for instance because people experimenting with changing the defcustoms in question need to be aware of their subtleties. The patch below documents them. The small unrelated change in the patch appears necessary regardless. ===File ~/customize.texi-diff=============================== *** customize.texi 18 Jun 2005 08:44:38 -0500 1.45 --- customize.texi 10 Jul 2005 21:52:01 -0500 *************** *** 270,275 **** --- 270,290 ---- Use the @code{:set} function to initialize the variable, if it is already set or has been customized; otherwise, just use @code{set-default}. + + @item custom-initialize-safe-set + @itemx custom-initialize-safe-default + These functions behave like @code{custom-initialize-set} + (@code{custom-initialize-default}, respectively), but catch errors. + If an error occurs during initialization, they set the variable to + @code{nil} using @code{set-default}, and throw no error. + + These two functions are only meant for options defined in pre-loaded + files, where some variables or functions used to compute the option's + value may not yet be defined. The option normally gets updated in + @file{startup.el}, ignoring the previously computed value. Because of + this typical usage, the value which these two functions compute + normally only matters when, after startup, one unsets the option's + value and then reevaluates the defcustom. @end table @item :set-after @var{variables} *************** *** 318,325 **** Internally, @code{defcustom} uses the symbol property @code{standard-value} to record the expression for the default value, and @code{saved-value} to record the value saved by the user with the ! customization buffer. The @code{saved-value} property is actually a ! list whose car is an expression which evaluates to the value. @node Customization Types @section Customization Types --- 333,340 ---- Internally, @code{defcustom} uses the symbol property @code{standard-value} to record the expression for the default value, and @code{saved-value} to record the value saved by the user with the ! customization buffer. Both properties are actually lists whose car is ! an expression which evaluates to the value. @node Customization Types @section Customization Types ============================================================