emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] emacs-26 0b1a2ae: Delete description of deleted Customize


From: Eli Zaretskii
Subject: [Emacs-diffs] emacs-26 0b1a2ae: Delete description of deleted Customize functions
Date: Fri, 15 Jun 2018 03:33:54 -0400 (EDT)

branch: emacs-26
commit 0b1a2ae84afe840997c1444b1dc56909b542b011
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Delete description of deleted Customize functions
    
    * doc/lispref/customize.texi (Variable Definitions): Remove the
    description of 'custom-initialize-safe-set' and
    'custom-initialize-safe-default', which were deleted in Emacs
    23.2, and replace with the description of
    'custom-initialize-delay'.
---
 doc/lispref/customize.texi | 22 ++++++++--------------
 1 file changed, 8 insertions(+), 14 deletions(-)

diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index 4d88d7c..02fcd80 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -416,20 +416,14 @@ Use the @code{:set} function to initialize the variable, 
if it is
 already set or has been customized; otherwise, just use
 @code{set-default}.
 
address@hidden custom-initialize-safe-set
address@hidden 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
address@hidden using @code{set-default}, and signal no error.
-
-These functions are meant for options defined in pre-loaded files,
-where the @var{standard} expression may signal an error because some
-required variable or function is not yet defined.  The value normally
-gets updated in @file{startup.el}, ignoring the value computed by
address@hidden  After startup, if one unsets the value and
-reevaluates the @code{defcustom}, the @var{standard} expression can be
-evaluated without error.
address@hidden custom-initialize-delay
+This functions behaves like @code{custom-initialize-set}, but it
+delays the actual initialization to the next Emacs start.  This should
+be used in files that are preloaded (or for autoloaded variables), so
+that the initialization is done in the run-time context rather than
+the build-time context.  This also has the side-effect that the
+(delayed) initialization is performed with the @code{:set} function.
address@hidden Emacs}.
 @end table
 
 @item :risky @var{value}



reply via email to

[Prev in Thread] Current Thread [Next in Thread]