* customize.texi (Type Keywords): Clarify that :value provides a

default value for all types.

Fixes: debbugs:7386

2 files changed, 9 insertions, 4 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 8cea06eb30a..d458dcc207a 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,8 @@
 2011-07-02  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+        * customize.texi (Type Keywords): Clarify that :value provides a
+        default value for all types (bug#7386).
+
         * streams.texi (Output Functions): Document `pp'.
 
 2011-06-25  Chong Yidong  <cyd@stupidchicken.com>
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