summaryrefslogtreecommitdiff
path: root/doc/lispref/customize.texi
diff options
context:
space:
mode:
authorLars Magne Ingebrigtsen <larsi@gnus.org>2011-07-02 15:36:11 +0200
committerLars Magne Ingebrigtsen <larsi@gnus.org>2011-07-02 15:36:11 +0200
commit0ec389b9771ea943a0710fa529c88af37a295d43 (patch)
treeae57e4839d6a24595a00fe66f8463300986e1221 /doc/lispref/customize.texi
parente17d05e2ef0ef1982d4fe7ecad4f7124506ca57b (diff)
downloademacs-0ec389b9771ea943a0710fa529c88af37a295d43.tar.gz
* customize.texi (Type Keywords): Clarify that :value provides a
default value for all types. Fixes: debbugs:7386
Diffstat (limited to 'doc/lispref/customize.texi')
-rw-r--r--doc/lispref/customize.texi10
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/lispref/customize.texi b/doc/lispref/customize.texi
index e58c8c298c9..cb32d0ef340 100644
--- a/doc/lispref/customize.texi
+++ b/doc/lispref/customize.texi
@@ -1035,7 +1035,12 @@ meanings:
@table @code
@item :value @var{default}
-This is used for a type that appears as an alternative inside of
+Provide a default value.
+
+If @code{nil} is not a valid value for the alternative, then it is
+essential to specify a valid default with @code{:value}.
+
+If you use this for a type that appears as an alternative inside of
@code{choice}; it specifies the default value to use, at first, if and
when the user selects this alternative with the menu in the
customization buffer.
@@ -1043,9 +1048,6 @@ customization buffer.
Of course, if the actual value of the option fits this alternative, it
will appear showing the actual value, not @var{default}.
-If @code{nil} is not a valid value for the alternative, then it is
-essential to specify a valid default with @code{:value}.
-
@item :format @var{format-string}
@kindex format@r{, customization keyword}
This string will be inserted in the buffer to represent the value