Mercurial > hg > xemacs-beta

comparison man/lispref/customize.texi @ 444:576fb035e263 r21-2-37

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-2-37
author cvs
date Mon, 13 Aug 2007 11:36:19 +0200
parents 74fd4e045ea6
children 7d972c3de90a
comparison
equal deleted inserted replaced
443:a8296e22da4e 444:576fb035e263
1 @c -*-texinfo-*- 1 @c -*-texinfo-*-
2 @c This is part of the XEmacs Lisp Reference Manual. 2 @c This is part of the XEmacs Lisp Reference Manual.
3 @c Copyright (C) 1997, 1998 Free Software Foundation, Inc. 3 @c Copyright (C) 1997, 1998 Free Software Foundation, Inc.
4 @c See the file lispref.texi for copying conditions. 4 @c See the file lispref.texi for copying conditions.
5 @setfilename ../info/customize 5 @setfilename ../info/customize
6 @node Customization, , , Top 6 @node Customization, , , Top
7 @chapter Writing Customization Definitions 7 @chapter Writing Customization Definitions
8 8
11 @dfn{customization item} to include both kinds of customization 11 @dfn{customization item} to include both kinds of customization
12 definitions---as well as face definitions. 12 definitions---as well as face definitions.
13 13
14 @menu 14 @menu
15 * Common Keywords:: 15 * Common Keywords::
16 * Group Definitions:: 16 * Group Definitions::
17 * Variable Definitions:: 17 * Variable Definitions::
18 * Customization Types:: 18 * Customization Types::
19 @end menu 19 @end menu
20 20
21 @node Common Keywords 21 @node Common Keywords
22 @section Common Keywords for All Kinds of Items 22 @section Common Keywords for All Kinds of Items
625 @item %t 625 @item %t
626 Substitute the tag here. You specify the tag with the @code{:tag} 626 Substitute the tag here. You specify the tag with the @code{:tag}
627 keyword. 627 keyword.
628 628
629 @item %% 629 @item %%
630 Display a literal @samp{%}. 630 Display a literal @samp{%}.
631 @end table 631 @end table
632 632
633 @item :action @var{action} 633 @item :action @var{action}
634 Perform @var{action} if the user clicks on a button. 634 Perform @var{action} if the user clicks on a button.
635 635
708 in a @code{menu-choice} widget. By default, the tag used will be either the 708 in a @code{menu-choice} widget. By default, the tag used will be either the
709 @code{:menu-tag} or @code{:tag} property if present, or the @code{princ} 709 @code{:menu-tag} or @code{:tag} property if present, or the @code{princ}
710 representation of the @code{:value} property if not. 710 representation of the @code{:value} property if not.
711 711
712 @item :validate 712 @item :validate
713 A function which takes a widget as an argument, and return nil if the 713 A function which takes a widget as an argument, and returns @code{nil} if the
714 widgets current value is valid for the widget. Otherwise, it should 714 widgets current value is valid for the widget. Otherwise, it should
715 return the widget containing the invalid data, and set that widgets 715 return the widget containing the invalid data, and set that widgets
716 @code{:error} property to a string explaining the error. 716 @code{:error} property to a string explaining the error.
717 717
718 You can use the function @code{widget-children-validate} for this job; 718 You can use the function @code{widget-children-validate} for this job;
725 725
726 @enumerate a 726 @enumerate a
727 @item 727 @item
728 Widgets with tabbing order @code{-1} are ignored. 728 Widgets with tabbing order @code{-1} are ignored.
729 729
730 @item 730 @item
731 (Unimplemented) When on a widget with tabbing order @var{n}, go to the 731 (Unimplemented) When on a widget with tabbing order @var{n}, go to the
732 next widget in the buffer with tabbing order @var{n+1} or @code{nil}, 732 next widget in the buffer with tabbing order @var{n+1} or @code{nil},
733 whichever comes first. 733 whichever comes first.
734 734
735 @item 735 @item