[Emacs-diffs] Changes to emacs/lispref/Attic/customize.texi, v [EMACS_22_BASE]

[Richard M. Stallman]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Branch:         EMACS_22_BASE
Changes by:     Richard M. Stallman <rms>       07/12/23 16:45:02

Index: customize.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/Attic/customize.texi,v
retrieving revision 1.69.2.1
retrieving revision 1.69.2.2
diff -u -b -r1.69.2.1 -r1.69.2.2
--- customize.texi      29 Nov 2007 22:36:10 -0000      1.69.2.1
+++ customize.texi      23 Dec 2007 16:45:02 -0000      1.69.2.2
@@ -1113,6 +1113,16 @@
 two arguments, a widget and a value; it should return address@hidden if
 the value is acceptable.
 
address@hidden :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
address@hidden: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 @@
 buttons, and for editable lists.  It affects the whole of the
 item except for the first line.
 
address@hidden :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.
-
address@hidden :extra-offset
-An integer indicating how many extra spaces to add to this item's
-indentation, compared to its parent.
-
address@hidden :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.
-
address@hidden :menu-tag
-A tag used in the menu when the widget is used as an option in a
address@hidden widget.
address@hidden :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.
+
address@hidden :extra-offset @var{n}
+Add @var{n} extra spaces to this item's indentation, compared to its
+parent's indentation.
+
address@hidden :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.
+
address@hidden :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 @@
 @code{:menu-tag} or @code{:tag} property if present, or the @code{princ}
 representation of the @code{:value} property if not.
 
address@hidden :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