From: Lars Magne Ingebrigtsen Date: Sat, 2 Jul 2011 13:36:11 +0000 (+0200) Subject: * customize.texi (Type Keywords): Clarify that :value provides a X-Git-Tag: emacs-pretest-24.0.90~104^2~152^2~249 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=0ec389b9771ea943a0710fa529c88af37a295d43;p=emacs.git * customize.texi (Type Keywords): Clarify that :value provides a default value for all types. Fixes: debbugs:7386 --- 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