[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/doc/lispref/customize.texi,v
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] Changes to emacs/doc/lispref/customize.texi,v |
Date: |
Sun, 19 Oct 2008 12:02:26 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Eli Zaretskii <eliz> 08/10/19 12:02:26
Index: customize.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/customize.texi,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- customize.texi 8 Jan 2008 20:45:49 -0000 1.6
+++ customize.texi 19 Oct 2008 12:02:25 -0000 1.7
@@ -302,6 +302,12 @@
arranges to set the variable unconditionally, without testing whether
its value is void. (The same feature applies to @code{defvar}.)
@xref{Defining Variables}.
+
+If you put a @code{defcustom} in a file that is preloaded at dump time
+(@pxref{Building Emacs}), and the standard value installed for the
+variable at that time might not be correct, use
address@hidden, described below, to re-evaluate the
+standard value during or after Emacs startup.
@end defmac
@code{defcustom} accepts the following additional keywords:
@@ -452,6 +458,25 @@
customization buffer. Both properties are actually lists whose car is
an expression which evaluates to the value.
address@hidden custom-reevaluate-setting symbol
+This function re-evaluates the standard value of a user-customizable
+variable declared via @code{defcustom}. (If the variable was
+customized, this function re-evaluates the saved value instead.) This
+is useful for customizable options that are defined before their value
+could be computed correctly, such as variables defined in packages
+that are loaded at dump time, but depend on the run-time information.
+For example, the value could be a file whose precise name depends on
+the hierarchy of files when Emacs runs, or a name of a program that
+needs to be searched at run time.
+
+The argument @var{symbol} is the symbol of the variable whose value
+you want to re-evaluate.
+
+A good place to put calls to this function is in the function
address@hidden that is run during startup (@pxref{Startup Summary})
+or in the various hooks it calls.
address@hidden defun
+
@node Customization Types
@section Customization Types
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/doc/lispref/customize.texi,v,
Eli Zaretskii <=