*** empty log message ***
[gnus] / texi / widget.texi
index 1556892..7ef06a6 100644 (file)
@@ -1,6 +1,6 @@
 \input texinfo.tex
 
-@c $Id: widget.texi,v 1.4 1997/02/16 21:58:10 steve Exp $
+@c $Id: widget.texi,v 1.87 1997/03/08 16:21:38 abraham Exp $
 
 @c %**start of header
 @setfilename widget
@@ -15,7 +15,7 @@
 @comment  node-name,  next,  previous,  up
 @top The Emacs Widget Library
 
-Version: 1.34
+Version: 1.59
 
 @menu
 * Introduction::                
@@ -115,7 +115,7 @@ create any widgets, the code has been split in two files:
 @item widget.el
 This will declare the user variables, define the function
 @code{widget-define}, and autoload the function @code{widget-create}. 
-@item widget-edit.el
+@item wid-edit.el
 Everything else is here, there is no reason to load it explicitly, as
 it will be autoloaded when needed.
 @end table
@@ -236,8 +236,8 @@ time.  When you push one of the unselected radio buttons, it will be
 selected and the previous selected radio button will become unselected. 
 @item The @samp{@b{[Apply Form]}} @samp{@b{[Reset Form]}} buttons.
 These are explicit buttons made with the @code{push-button} widget.  The main
-difference from the @code{link} widget is that the buttons are intended
-to be displayed more like buttons in a GUI, once Emacs grows powerful
+difference from the @code{link} widget is that the buttons are will be
+displayed as GUI buttons when possible.
 enough. 
 @end table
 
@@ -278,7 +278,7 @@ Interface}).
 (require 'widget)
 
 (eval-when-compile
-  (require 'widget-edit))
+  (require 'wid-edit))
 
 (defvar widget-example-repeat)
 
@@ -401,7 +401,7 @@ The inserted text will be read only.
 There is a standard widget keymap which you might find useful.
 
 @defvr Const widget-keymap
-A keymap with the global keymap as its parent.@br
+A keymap with the global keymap as its parent.@*
 @key{TAB} and @kbd{C-@key{TAB}} are bound to @code{widget-forward} and
 @code{widget-backward}, respectively.  @kbd{@key{RET}} and @kbd{mouse-2}
 are bound to @code{widget-button-press} and
@@ -533,6 +533,13 @@ return the widget containing the invalid data, and set that widgets
 @item :parent
 The parent of a nested widget (e.g. a @code{menu-choice} item or an element of a
 @code{editable-list} widget). 
+
+@item :sibling-args
+This keyword is only used for members of a @code{radio-button-choice} or
+@code{checklist}.  The value should be a list of extra keyword
+arguments, which will be used when creating the @code{radio-button} or
+@code{checkbox} associated with this item.
+
 @end table
 
 @deffn {User Option} widget-glyph-directory
@@ -635,7 +642,7 @@ The following extra properties are recognized.
 
 @table @code
 @item :size
-The width of the editable field.@br
+The width of the editable field.@*
 By default the field will reach to the end of the line.
 
 @item :value-face
@@ -754,6 +761,10 @@ Replace with the radio button.
 Insert a literal @samp{%}. 
 @end table
 
+@item button-args
+A list of keywords to pass to the radio buttons.  Useful for setting
+e.g. the @samp{:help-echo} for each button.
+
 @item :buttons
 The widgets representing the radio buttons.
 
@@ -881,6 +892,10 @@ Replace with the checkbox.
 Insert a literal @samp{%}. 
 @end table
 
+@item button-args
+A list of keywords to pass to the checkboxes.  Useful for setting
+e.g. the @samp{:help-echo} for each checkbox.
+
 @item :buttons
 The widgets representing the checkboxes.
 
@@ -922,6 +937,16 @@ Insert the @b{[DEL]} button.
 Insert a literal @samp{%}. 
 @end table
 
+@item :insert-button-args
+A list of keyword arguments to pass to the insert buttons.
+
+@item :delete-button-args
+A list of keyword arguments to pass to the delete buttons.
+
+@item :append-button-args
+A list of keyword arguments to pass to the trailing insert button.
+
+
 @item :buttons
 The widgets representing the insert and delete buttons.
 
@@ -1310,7 +1335,7 @@ Document `helper' functions for defining new widgets.
 @item
 Activate the item this is below the mouse when the button is
 released, not the item this is below the mouse when the button is
-pressed.  Dired and grep gets this right.
+pressed.  Dired and grep gets this right.  Give feedback if possible.
 
 @item
 Use @samp{@@deffn Widget} to document widgets. 
@@ -1336,6 +1361,9 @@ Perhaps the correct model is delegation?
 @item
 Document @code{widget-browse}.
 
+@item
+Make indentation work with glyphs and propertional fonts.
+
 @item
 Add object and class hierarchies to the browser.