From 72b7e664f44a0a9d96358c18d043c76772c32356 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sun, 23 Dec 2007 16:45:07 +0000 Subject: [PATCH] (Type Keywords): Uncomment :validate and clarify it. Improve some of the commented-out keywords' text too. --- lispref/ChangeLog | 5 +++++ lispref/customize.texi | 48 ++++++++++++++++++++++-------------------- 2 files changed, 30 insertions(+), 23 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index a00eb3e65d..73af0a17dd 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,8 @@ +2007-12-23 Richard Stallman + + * customize.texi (Type Keywords): Uncomment :validate and clarify it. + Improve some of the commented-out keywords' text too. + 2007-12-04 Richard Stallman * objects.texi (Symbol Type): Fix typo. diff --git a/lispref/customize.texi b/lispref/customize.texi index fede33bd04..feb72387e4 100644 --- a/lispref/customize.texi +++ b/lispref/customize.texi @@ -1113,6 +1113,16 @@ corresponding value, @var{function}, should be a function that accepts two arguments, a widget and a value; it should return non-@code{nil} if the value is acceptable. +@item :validate @var{function} +Specify a validation function for input. @var{function} takes a +widget as an argument, and should return @code{nil} if the widget's +current value is valid for the widget. Otherwise, it should return +the widget containing the invalid data, and set that widget's +@code{:error} property to a string explaining the error. + +In many cases you can use the function @code{widget-children-validate} +for this job; it tests that all children of @var{widget} are valid. + @ignore @item :indent @var{columns} Indent this item by @var{columns} columns. The indentation is used for @@ -1120,23 +1130,24 @@ Indent this item by @var{columns} columns. The indentation is used for buttons, and for editable lists. It affects the whole of the item except for the first line. -@item :offset @var{columns} -An integer indicating how many extra spaces to indent the subitems of -this item. By default, subitems are indented the same as their parent. +@item :offset @var{extra} +Indent the subitems of this item @var{extra} columns more than this +item itself. By default, subitems are indented the same as their +parent. -@item :extra-offset -An integer indicating how many extra spaces to add to this item's -indentation, compared to its parent. +@item :extra-offset @var{n} +Add @var{n} extra spaces to this item's indentation, compared to its +parent's indentation. -@item :notify -A function called each time the item or a subitem is changed. The -function is called with two or three arguments. The first argument is -the item itself, the second argument is the item that was changed, and -the third argument is the event leading to the change, if any. +@item :notify @var{function} +Call @var{function} each time the item or a subitem is changed. The +function gets two or three arguments. The first argument is the item +itself, the second argument is the item that was changed, and the +third argument is the event leading to the change, if any. -@item :menu-tag -A tag used in the menu when the widget is used as an option in a -@code{menu-choice} widget. +@item :menu-tag @var{tag-string} +Use @var{tag-string} in the menu when the widget is used as an option +in a @code{menu-choice} widget. @item :menu-tag-get A function used for finding the tag when the widget is used as an option @@ -1144,15 +1155,6 @@ in a @code{menu-choice} widget. By default, the tag used will be either the @code{:menu-tag} or @code{:tag} property if present, or the @code{princ} representation of the @code{:value} property if not. -@item :validate -A function which takes a widget as an argument, and return @code{nil} -if the widget's current value is valid for the widget. Otherwise, it -should return the widget containing the invalid data, and set that -widget's @code{:error} property to a string explaining the error. - -You can use the function @code{widget-children-validate} for this job; -it tests that all children of @var{widget} are valid. - @item :tab-order Specify the order in which widgets are traversed with @code{widget-forward} or @code{widget-backward}. This is only partially -- 2.20.1