\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
@comment node-name, next, previous, up
@top The Emacs Widget Library
-Version: 1.34
+Version: 1.59
@menu
* Introduction::
@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
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
(require 'widget)
(eval-when-compile
- (require 'widget-edit))
+ (require 'wid-edit))
(defvar widget-example-repeat)
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
@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
@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
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.
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.
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.
@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.
@item
Document @code{widget-browse}.
+@item
+Make indentation work with glyphs and propertional fonts.
+
@item
Add object and class hierarchies to the browser.