From: "Drew Adams" <drew.adams@oracle.com>
To: 7386@debbugs.gnu.org
Subject: bug#7386: 24.0.50; (elisp)Type Keywords: incorrect description of :value keyword
Date: Fri, 12 Nov 2010 08:42:47 -0800 [thread overview]
Message-ID: <96F2D9A2458C40E6920A379C76DF75F8@us.oracle.com> (raw)
emacs -Q
The description of :value is misleading/incorrect:
`:value DEFAULT'
This is used for a type that appears as an alternative inside of
`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.
Of course, if the actual value of the option fits this
alternative, it will appear showing the actual value, not DEFAULT.
If `nil' is not a valid value for the alternative, then it is
essential to specify a valid default with `:value'.
This gives the impression that :value can be used only within a
`choice', which is incorrect. The truth is that :value just provides a
default value - in all cases, not just "...if and when the user selects
this alternative with the menu...".
Here is an example where :value is used to specify the command `ignore'
(instead of `nil') as the default value:
;; Use `symbolp' in case the library defining the command is not yet loaded.
(restricted-sexp :tag "Command" :match-alternatives (symbolp) :value ignore)
In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
of 2010-11-09 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'
next reply other threads:[~2010-11-12 16:42 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-11-12 16:42 Drew Adams [this message]
2011-07-02 13:36 ` bug#7386: 24.0.50; (elisp)Type Keywords: incorrect description of :value keyword Lars Magne Ingebrigtsen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=96F2D9A2458C40E6920A379C76DF75F8@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=7386@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.