From 0ec389b9771ea943a0710fa529c88af37a295d43 Mon Sep 17 00:00:00 2001 From: Lars Magne Ingebrigtsen Date: Sat, 2 Jul 2011 15:36:11 +0200 Subject: [PATCH] * customize.texi (Type Keywords): Clarify that :value provides a default value for all types. Fixes: debbugs:7386 --- doc/lispref/ChangeLog | 3 +++ doc/lispref/customize.texi | 10 ++++++---- 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 + * 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 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 -- 2.39.2