diff options
| author | Mauro Aranda <maurooaranda@gmail.com> | 2020-09-01 16:59:58 +0200 |
|---|---|---|
| committer | Lars Ingebrigtsen <larsi@gnus.org> | 2020-09-01 17:00:58 +0200 |
| commit | 0996047476e93f036740c630279629a4c2a825c7 (patch) | |
| tree | 0fff0178791da1aa97115b42aaedde67714a608c /doc/lispref/customize.texi | |
| parent | ed8dd998847e08be3baebc570b6f08c443b72028 (diff) | |
| download | emacs-0996047476e93f036740c630279629a4c2a825c7.tar.gz emacs-0996047476e93f036740c630279629a4c2a825c7.tar.bz2 emacs-0996047476e93f036740c630279629a4c2a825c7.zip | |
Improve documentation for custom :options
* doc/lispref/customize.texi (Variable Definitions):
Mention that re-evaluating a defcustom form doesn't reset custom
options (bug#30101).
Diffstat (limited to 'doc/lispref/customize.texi')
| -rw-r--r-- | doc/lispref/customize.texi | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi index 2a72276bc56..b9c9130a920 100644 --- a/doc/lispref/customize.texi +++ b/doc/lispref/customize.texi @@ -358,6 +358,10 @@ This is meaningful only for certain types, currently including @code{hook}, @code{plist} and @code{alist}. See the definition of the individual types for a description of how to use @code{:options}. +Re-evaluating a @code{defcustom} form with a different @code{:options} +value does not clear the values added by previous evaluations, or +added by calls to @code{custom-add-frequent-value} (see below). + @item :set @var{setfunction} @kindex set@r{, @code{defcustom} keyword} Specify @var{setfunction} as the way to change the value of this @@ -485,6 +489,10 @@ list of reasonable values. The precise effect of adding a value depends on the customization type of @var{symbol}. + +Since evaluating a @code{defcustom} form does not clear values added +previously, Lisp programs can use this function to add values for user +options not yet defined. @end defun Internally, @code{defcustom} uses the symbol property |