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

default value for all types.

Fixes: debbugs:7386
This commit is contained in:
Lars Magne Ingebrigtsen 2011-07-02 15:36:11 +02:00
parent e17d05e2ef
commit 0ec389b977
2 changed files with 9 additions and 4 deletions

View file

@ -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>

View file

@ -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