diff man/widget.texi @ 153:25f70ba0133c r20-3b3

Import from CVS: tag r20-3b3
author cvs
date Mon, 13 Aug 2007 09:38:25 +0200
parents 538048ae2ab8
children 43dd3413c7c7
line wrap: on
line diff
--- a/man/widget.texi	Mon Aug 13 09:37:21 2007 +0200
+++ b/man/widget.texi	Mon Aug 13 09:38:25 2007 +0200
@@ -13,7 +13,7 @@
 @comment  node-name,  next,  previous,  up
 @top The Emacs Widget Library
 
-Version: 1.97
+Version: 1.98
 
 @menu
 * Introduction::                
@@ -57,14 +57,14 @@
 option is itself a widget.  Only the selected option will be visible in
 the buffer.
 @item radio-button-choice
-Allows the user to choose one of multiple options by pushing radio
+Allows the user to choose one of multiple options by activating radio
 buttons.  The options are implemented as widgets.  All options will be
 visible in the buffer.
 @item item
 A simple constant widget intended to be used in the @code{menu-choice} and
 @code{radio-button-choice} widgets. 
 @item choice-item
-An button item only intended for use in choices.  When pushed, the user
+An button item only intended for use in choices.  When activated, the user
 will be asked to select another option from the choice widget.
 @item toggle
 A simple @samp{on}/@samp{off} switch.
@@ -233,7 +233,7 @@
 for implementing multiple-choice fields.  You can create it wit
 @item The @samp{@b{( )}} and @samp{@b{(*)}} buttons.
 Only one radio button in a @code{radio-button-choice} widget can be
-selected at any time.  When you push one of the unselected radio
+selected at any time.  When you activate 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.
@@ -445,6 +445,17 @@
 @itemx %]
 The text inside will be marked as a button.
 
+By default, the text will be shown in @code{widget-button-face}, and
+surrounded by brackets. 
+
+@defopt widget-button-prefix
+String to prefix buttons.
+@end defopt
+
+@defopt widget-button-suffix
+String to suffix buttons.
+@end defopt
+
 @item %@{
 @itemx %@}
 The text inside will be displayed with the face specified by
@@ -477,6 +488,23 @@
 @item :button-face
 Face used to highlight text inside %[ %] in the format.
 
+@item :button-prefix
+@itemx :button-suffix
+
+Text around %[ %] in the format.
+
+These can be
+@table @emph
+@item nil
+No text is inserted.
+
+@item a string
+The string is inserted literally.
+
+@item a symbol
+The value of the symbol is expanded according to this table.
+@end table
+
 @item :doc
 The string inserted by the @samp{%d} escape in the format
 string.  
@@ -612,6 +640,16 @@
 property.  The value should be a string, which will be inserted in the
 buffer. 
 
+By default the link will be shown in brackets.
+
+@defopt widget-link-prefix
+String to prefix links.
+@end defopt
+
+@defopt widget-link-suffix
+String to suffix links.
+@end defopt
+
 @node url-link, info-link, link, Basic Types
 @comment  node-name,  next,  previous,  up
 @subsection The @code{url-link} Widget
@@ -652,17 +690,15 @@
 property. The value should be a string, which will be inserted in the
 buffer. 
 
-The following extra properties are recognized.
+By default the tag will be shown in brackets.
 
-@table @code
-@item :text-format
-The format string used when the push button cannot be displayed
-graphically.  There are two escapes, @code{%s}, which must be present
-exactly once, will be substituted with the tag, and @code{%%} will be
-substituted with a singe @samp{%}.
-@end table
+@defopt widget-push-button-prefix
+String to prefix push buttons.
+@end defopt
 
-By default the tag will be shown in brackets.
+@defopt widget-push-button-suffix
+String to suffix push buttons.
+@end defopt
 
 @node editable-field, text, push-button, Basic Types
 @comment  node-name,  next,  previous,  up