diff man/widget.texi @ 22:8fc7fe29b841 r19-15b94

Import from CVS: tag r19-15b94
author cvs
date Mon, 13 Aug 2007 08:50:29 +0200
parents 859a2309aef8
children 4103f0995bd7
line wrap: on
line diff
--- a/man/widget.texi	Mon Aug 13 08:50:06 2007 +0200
+++ b/man/widget.texi	Mon Aug 13 08:50:29 2007 +0200
@@ -1,6 +1,6 @@
 \input texinfo.tex
 
-@c $Id: widget.texi,v 1.2 1997/02/09 23:52:13 steve Exp $
+@c $Id: widget.texi,v 1.3 1997/02/16 01:29:52 steve Exp $
 
 @c %**start of header
 @setfilename widget
@@ -15,7 +15,7 @@
 @comment  node-name,  next,  previous,  up
 @top The Emacs Widget Library
 
-Version: 1.30
+Version: 1.40
 
 @menu
 * Introduction::                
@@ -236,8 +236,8 @@
 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
 
@@ -483,6 +483,10 @@
 The string inserted by the @samp{%t} escape in the format
 string.  
 
+@item :tag-glyph
+Name of image to use instead of the string specified by `:tag' on
+Emacsen that supports it.
+
 @item :help-echo
 Message displayed whenever you move to the widget with either
 @code{widget-forward} or @code{widget-backward}.
@@ -531,6 +535,17 @@
 @code{editable-list} widget). 
 @end table
 
+@deffn {User Option} widget-glyph-directory
+Directory where glyphs are found.  
+Widget will look here for a file with the same name as specified for the
+image, with either a @samp{.xpm} (if supported) or @samp{.xbm} extension.
+@end deffn
+
+@deffn{User Option} widget-glyph-enable
+If non-nil, allow glyphs to appear on displayes where they are supported.
+@end deffn
+
+
 @menu
 * link::                        
 * url-link::                    
@@ -815,12 +830,12 @@
 String representing the `on' state.  By default the string @samp{on}.
 @item :off 
 String representing the `off' state.  By default the string @samp{off}.
-@item :on-type
-Type representing the `on' state.  By default an `item' widget displaying
-the string specified with the @code{:on} keyword.
-@item :off-type
-Type representing the `off' state.  By default an `item' widget
-displaying the string specified with the @code{:off} keyword.
+@item :on-glyph
+Name of a glyph to be used instead of the `:on' text string, on emacsen
+that supports it.
+@item :off-glyph
+Name of a glyph to be used instead of the `:off' text string, on emacsen
+that supports it.
 @end table
 
 @node checkbox, checklist, toggle, Basic Types
@@ -1144,7 +1159,7 @@
 Occasionally it can be useful to know which kind of widget you have,
 i.e. the name of the widget type you gave when the widget was created. 
 
-@defun widget-name widget
+@defun widget-type widget
 Return the name of @var{widget}, a symbol.
 @end defun
 
@@ -1257,9 +1272,6 @@
 @section Wishlist.
 
 @itemize @bullet
-@item
-A Smalltalk style widget browser.
-
 @item 
 It should be possible to add or remove items from a list with @kbd{C-k}
 and @kbd{C-o} (suggested by @sc{rms}).
@@ -1271,14 +1283,6 @@
 the ugly buttons, the dash is my idea).
 
 @item
-Use graphical versions of the widgets for emacsen that can do that.
-I.e. real radio buttons and checkmarks instead of their @sc{ascii}
-equivalents. 
-
-@item
-There should be support for browsing the widget documentation.
-
-@item
 Widgets such as @code{file} and @code{symbol} should prompt with completion. 
 
 @item
@@ -1304,12 +1308,9 @@
 Document `helper' functions for defining new widgets.
 
 @item
-Show button menus on mouse down.
-
-@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. 
@@ -1325,6 +1326,22 @@
 Split, when needed, keywords into those useful for normal
 customization, those primarily useful when deriving, and those who
 represent runtime information. 
+
+@item
+Figure out terminology and @sc{api} for the class/type/object/super
+stuff. 
+
+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.
+
 @end itemize
 
 @contents