changeset 32925:94a4a1908711

checklist custom type.
author Dave Love <fx@gnu.org>
date Thu, 26 Oct 2000 18:36:21 +0000
parents b491fc65a56e
children 756edd811cd5
files lispref/customize.texi
diffstat 1 files changed, 17 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/customize.texi	Thu Oct 26 18:35:31 2000 +0000
+++ b/lispref/customize.texi	Thu Oct 26 18:36:21 2000 +0000
@@ -734,6 +734,23 @@
 @var{element-type}.  This appears in the customization buffer as a
 list of elements, with @samp{[INS]} and @samp{[DEL]} buttons for adding
 more elements or removing elements.
+
+@item (checklist @var{type} @dots{})
+The @var{type} arguments represent each checklist item.  The value will
+be a list containing the values of all checked @var{type} arguments.
+The checklist will match a list whose elements all match at least one of
+the specified @var{type} arguments.
+
+Usually a checklist will only match if the items are in the exact
+sequence given in the specification.  If you supply the additional
+arguments @code{:greedy t}, it will allow the items to come in any
+sequence.  However, if you extract the value they will be in the
+sequence given in the checklist, i.e.@: the original sequence is
+forgotten.
+
+Using this type with @code{:greedy} is useful for specifying association
+or property lists with keys from a fixed set and properly-typed
+arguments.
 @end table
 
 @node Splicing into Lists