Mercurial > hg > xemacs-beta
diff man/widget.texi @ 155:43dd3413c7c7 r20-3b4
Import from CVS: tag r20-3b4
author | cvs |
---|---|
date | Mon, 13 Aug 2007 09:39:39 +0200 |
parents | 25f70ba0133c |
children | 6b37e6ddd302 |
line wrap: on
line diff
--- a/man/widget.texi Mon Aug 13 09:38:27 2007 +0200 +++ b/man/widget.texi Mon Aug 13 09:39:39 2007 +0200 @@ -13,7 +13,7 @@ @comment node-name, next, previous, up @top The Emacs Widget Library -Version: 1.98 +Version: 1.9907 @menu * Introduction:: @@ -64,7 +64,7 @@ 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 activated, the user +An button item only intended for use in choices. When invoked, the user will be asked to select another option from the choice widget. @item toggle A simple @samp{on}/@samp{off} switch. @@ -191,22 +191,22 @@ @subsection Buttons Some portions of the buffer have an associated @dfn{action}, which can -be @dfn{activated} by a standard key or mouse command. These portions +be @dfn{invoked} by a standard key or mouse command. These portions are called @dfn{buttons}. The default commands for activating a button are: @table @kbd @item @key{RET} @deffn Command widget-button-press @var{pos} &optional @var{event} -Activate the button at @var{pos}, defaulting to point. -If point is not located on a button, activate the binding in +Invoke the button at @var{pos}, defaulting to point. +If point is not located on a button, invoke the binding in @code{widget-global-map} (by default the global map). @end deffn @item mouse-2 @deffn Command widget-button-click @var{event} -Activate the button at the location of the mouse pointer. If the mouse -pointer is located in an editable text field, activate the binding in +Invoke the button at the location of the mouse pointer. If the mouse +pointer is located in an editable text field, invoke the binding in @code{widget-global-map} (by default the global map). @end deffn @end table @@ -216,7 +216,7 @@ @table @emph @item The Option Field Tags. -When you activate one of these buttons, you will be asked to choose +When you invoke one of these buttons, you will be asked to choose between a number of different options. This is how you edit an option field. Option fields are created by the @code{menu-choice} widget. In the example, @samp{@b{Choose}} is an option field tag. @@ -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 activate one of the unselected radio +selected at any time. When you invoke 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. @@ -660,7 +660,7 @@ TYPE ::= (url-link [KEYWORD ARGUMENT]... URL) @end example -When this link is activated, the @sc{www} browser specified by +When this link is invoked, the @sc{www} browser specified by @code{browse-url-browser-function} will be called with @var{url}. @node info-link, push-button, url-link, Basic Types @@ -673,7 +673,7 @@ TYPE ::= (info-link [KEYWORD ARGUMENT]... ADDRESS) @end example -When this link is activated, the build-in info browser is started on +When this link is invoked, the build-in info browser is started on @var{address}. @node push-button, editable-field, info-link, Basic Types @@ -739,29 +739,7 @@ Keymap used in the editable field. The default value is @code{widget-field-keymap}, which allows you to use all the normal editing commands, even if the buffers major mode supress some of them. -Pressing return activates the function specified by @code{:activate}. - -@item :hide-front-space -@itemx :hide-rear-space -In order to keep track of the editable field, emacs places an invisible -space character in front of the field, and for fixed sized fields also -in the rear end of the field. For fields that extent to the end of the -line, the terminating linefeed serves that purpose instead. - -Emacs will try to make the spaces intangible when it is safe to do so. -Intangible means that the cursor motion commands will skip over the -character as if it didn't exist. This is safe to do when the text -preceding or following the widget cannot possible change during the -lifetime of the @code{editable-field} widget. The preferred way to tell -Emacs this, is to add text to the @code{:format} property around the -value. For example @code{:format "Tag: %v "}. - -You can overwrite the internal safety check by setting the -@code{:hide-front-space} or @code{:hide-rear-space} properties to -non-nil. This is not recommended. For example, @emph{all} text that -belongs to a widget (i.e. is created from its @code{:format} string) will -change whenever the widget changes its value. - +Pressing return invokes the function specified by @code{:action}. @end table @node text, menu-choice, editable-field, Basic Types @@ -1160,7 +1138,7 @@ @end deffn @deffn Widget file -Allows you to edit a file name in an editable field. You you activate +Allows you to edit a file name in an editable field. If you invoke the tag button, you can edit the file name in the mini-buffer with completion. @@ -1581,7 +1559,7 @@ @item The @samp{[INS]} and @samp{[DEL]} buttons should be replaced by a single -dash (@samp{-}). The dash should be a button that, when activated, ask +dash (@samp{-}). The dash should be a button that, when invoked, ask whether you want to add or delete an item (@sc{rms} wanted to git rid of the ugly buttons, the dash is my idea). @@ -1624,6 +1602,9 @@ @item @kbd{C-h} in @code{widget-prompt-value} should give type specific help. +@item +A mailto widget. + @end itemize @contents