diff options
| author | Chong Yidong <cyd@gnu.org> | 2014-01-06 07:36:13 +0800 |
|---|---|---|
| committer | Chong Yidong <cyd@gnu.org> | 2014-01-06 07:36:13 +0800 |
| commit | 81c7d631e9a46662d02e09cae74e24f4bb6cb20c (patch) | |
| tree | 54afea46133ea78781f9a34067845cd522f26e9a /doc/lispref/customize.texi | |
| parent | 0215e125539d96ec561ff693ad2b5c059e868599 (diff) | |
| download | emacs-81c7d631e9a46662d02e09cae74e24f4bb6cb20c.tar.gz emacs-81c7d631e9a46662d02e09cae74e24f4bb6cb20c.tar.bz2 emacs-81c7d631e9a46662d02e09cae74e24f4bb6cb20c.zip | |
More doc updates.
* backups.texi (Making Backups): Document backup-buffer change.
* commands.texi (Defining Commands): Document the interactive-form
property more carefully. Document interactive-only.
* compile.texi (Compiler Errors): Copyedits. Note that the
details for byte-compile-warnings are in its docstring.
* customize.texi (Variable Definitions): Likewise.
* files.texi (Visiting Files): Copyedits.
(Testing Accessibility): Mention ACLs. Move file-modes here from
File Attributes.
(Truenames): Move file-equal-p here from Kinds of Files.
(File Attributes): Move file-newer-than-file-p here from Testing
Accessibility.
(Extended Attributes): New node. Add file-extended-attributes.
(Changing Files): Document set-file-extended-attributes.
* minibuf.texi (Minibuffer Contents): Remove obsolete function
minibuffer-completion-contents.
* variables.texi (Defining Variables): Note that defvar acts
always on the dynamic value.
Diffstat (limited to 'doc/lispref/customize.texi')
| -rw-r--r-- | doc/lispref/customize.texi | 18 |
1 files changed, 11 insertions, 7 deletions
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi index 1e54a7fa444..4b0a0a9ba2c 100644 --- a/doc/lispref/customize.texi +++ b/doc/lispref/customize.texi @@ -287,13 +287,17 @@ customizable variable). You should not quote @var{option}. The argument @var{standard} is an expression that specifies the standard value for @var{option}. Evaluating the @code{defcustom} form -evaluates @var{standard}, but does not necessarily install the -standard value. If @var{option} already has a default value, -@code{defcustom} does not change it. If the user has saved a -customization for @var{option}, @code{defcustom} installs the user's -customized value as @var{option}'s default value. If neither of those -cases applies, @code{defcustom} installs the result of evaluating -@var{standard} as the default value. +evaluates @var{standard}, but does not necessarily bind the option to +that value. If @var{option} already has a default value, it is left +unchanged. If the user has already saved a customization for +@var{option}, the user's customized value is installed as the default +value. Otherwise, the result of evaluating @var{standard} is +installed as the default value. + +Like @code{defvar}, this macro marks @code{option} as a special +variable, meaning that it should always be dynamically bound. If +@var{option} is already lexically bound, that lexical binding remains +in effect until the binding construct exits. @xref{Variable Scoping}. The expression @var{standard} can be evaluated at various other times, too---whenever the customization facility needs to know @var{option}'s |