procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document that the :match function for a widget takes an external value

Browse source 
* doc/misc/widget.texi (Basic Types): Document what an external value
is.  Document that a :match function expects the value to be in the
external format.  (Bug#8717)
This commit is contained in:
Mauro Aranda 2020-11-02 09:33:55 -03:00
parent 1b7ab9d0ac
commit 5932df7435
1 changed files with 16 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
doc/misc/widget.texi
View file

@ -484,9 +484,21 @@ are interpreted in a widget specific way.
The following keyword arguments apply to all widgets: The following keyword arguments apply to all widgets:
@table @code @table @code
@cindex internal format
@cindex external format
@vindex value@r{ keyword} @vindex value@r{ keyword}
@item :value @item :value
The initial value for widgets of this type. The initial value for widgets of this type. Typically, a widget
represents its value in two formats: external and internal. The
external format is the value as the rest of Emacs sees it, and the
internal format is a representation that the widget defines and uses
in a widget specific way.
Both formats might be the same for certain widgets and might differ
for others, and there is no guarantee about which format the value
stored in the @code{:value} property has. However, when creating a
widget or defining a new one (@pxref{Defining New Widgets}), the
@code{:value} should be in the external format.
@vindex format@r{ keyword} @vindex format@r{ keyword}
@item :format @item :format
@ -629,8 +641,9 @@ representation of the @code{:value} property if not.
@vindex match@r{ keyword} @vindex match@r{ keyword}
@item :match @item :match
Should be a function called with two arguments, the widget and a value, Should be a function called with two arguments, the widget and an
and returning non-@code{nil} if the widget can represent the specified value. external value, and should return non-@code{nil} if the widget can
represent the specified value.
@vindex validate@r{ keyword} @vindex validate@r{ keyword}
@item :validate @item :validate