tiddlywiki 5.2.0 → 5.2.1

package/editions/tw5.com/tiddlers/system/operator-macros.tid

@@ -5,22 +5,29 @@ tags: $:/tags/Macro
 
 \define .operator-examples(op,text:"Examples") <$link to="$op$ Operator (Examples)">$text$</$link>
 
+\define .operator-example-tryit-actions() <$action-setfield $tiddler=<<.state>> text="show" filter=<<__eg__>>/>
 \define .operator-example(n,eg,ie)
 <div class="doc-example">
-`$eg$`
-<$macrocall $name=".if" cond="""$ie$""" then="""<dd>&rarr; $ie$</dd>"""/>
 <$list filter="[title<.state-prefix>addsuffix{!!title}addsuffix[/]addsuffix[$n$]]" variable=".state">
 <$reveal state=<<.state>> type="nomatch" text="show">
+	`$eg$`
+	<$macrocall $name=".if" cond="""$ie$""" then="""<dd>&rarr; $ie$</dd>"""/>
 	<dl>
-	<dd><$button set=<<.state>> setTo="show">Try it</$button></dd>
+	<dd><$button actions=<<.operator-example-tryit-actions>>>Try it</$button></dd>
 	</dl>
 </$reveal>
 <$reveal state=<<.state>> type="match" text="show">
+	<$edit-text tiddler=<<.state>> field="filter" tag="input" type=search focus="true"/>
 	<dl>
-	<dd><$button set=<<.state>> setTo="">Hide</$button></dd>
+	<dd>
+	<$button set=<<.state>> setTo="">Hide</$button>
+	<$reveal stateTitle=<<.state>> stateField="filter" type="nomatch" text=<<__eg__>>>
+		<$button actions=<<.operator-example-tryit-actions>>>Reset</$button>
+	</$reveal>
+	</dd>
 	</dl>
 	<blockquote class="doc-example-result">
-	<ul><$list filter="""$eg$""" emptyMessage="(empty)">
+	<ul><$list filter={{{[<.state>get[filter]]}}} emptyMessage="(empty)">
 	<li><$link><$view field="title"/></$link></li>
 	</$list></ul>
 	</blockquote>

package/editions/tw5.com/tiddlers/system/operator-template.tid

@@ -23,25 +23,25 @@ list-before: $:/core/ui/ViewTemplate/body
 <$set name="op-name" value="">
 <$list filter="[all[current]tag[Filter Operators]]">
 <table class="doc-table before-tiddler-body">
-<!-->
+<!-- -->
 <$set name="op-head" value="purpose">
 <$set name="op-body" value={{!!op-purpose}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[input|Filter Syntax]]">
 <$set name="op-body" value={{!!op-input}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="`!` input">
 <$set name="op-body" value={{!!op-neg-input}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[suffix|Filter Step]]">
 <$set name="op-body" value={{!!op-suffix}}>
 <$set name="op-name" value={{!!op-suffix-name}}>
@@ -49,7 +49,7 @@ list-before: $:/core/ui/ViewTemplate/body
 </$set>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="[[parameter|Filter Parameter]]">
 <$set name="op-body" value={{!!op-parameter}}>
 <$set name="op-name" value={{!!op-parameter-name}}>
@@ -57,19 +57,19 @@ list-before: $:/core/ui/ViewTemplate/body
 </$set>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="output">
 <$set name="op-body" value={{!!op-output}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 <$set name="op-head" value="`!` output">
 <$set name="op-body" value={{!!op-neg-output}}>
 <<.op-row>>
 </$set>
 </$set>
-<!-->
+<!-- -->
 </table>
 <$list filter="[all[current]has[from-version]]" variable="listItem">
 <$macrocall $name=".from-version" version={{!!from-version}}/>

package/editions/tw5.com/tiddlers/systemtags/SystemTag_ $__tags_Image.tid

@@ -1,9 +1,9 @@
 caption: $:/tags/Image
 created: 20180926170345251
 description: marks (core) images
-modified: 20180926171456494
+modified: 20211018102336342
 tags: SystemTags
 title: SystemTag: $:/tags/Image
 type: text/vnd.tiddlywiki
 
-The [[system tag|SystemTags]] `$:/tags/Image` marks (core) images
+The [[system tag|SystemTags]] `$:/tags/Image` marks core images. An overview of system icons can be found in the [[Icon Gallery]]

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 1-2-3.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024604173
+tags: [[Variable Examples]]
 title: Sample Headings 1,2,3
 
 ! This is a Level 1 Heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 3-4-5.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 3,4,5
 
 !!! This is written as a Level 3 heading

package/editions/tw5.com/tiddlers/variables/examples/Sample Headings 4-5-6.tid

@@ -1,5 +1,6 @@
 created: 20180609112450207
-modified: 20180609112450207
+modified: 20211117024620368
+tags: [[Variable Examples]]
 title: Sample Headings 4,5,6
 
 !!!! This is written as a Level 4 heading

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 1.tid

@@ -1,6 +1,6 @@
 created: 20200131142401129
-modified: 20201020112608874
-tags: ActionCreateTiddlerWidget
+modified: 20211113230406823
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 1
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 2.tid

@@ -1,6 +1,6 @@
 created: 20200131144828713
-modified: 20201020112601032
-tags: ActionCreateTiddlerWidget
+modified: 20211113011036840
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 2
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 3.tid

@@ -1,6 +1,6 @@
 created: 20200131145355658
-modified: 20201020112553050
-tags: ActionCreateTiddlerWidget
+modified: 20211113011111052
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 3
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Example 4.tid

@@ -1,6 +1,6 @@
 created: 20200131150229551
-modified: 20201020112544146
-tags: ActionCreateTiddlerWidget
+modified: 20211113011129601
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example 4
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget Template.tid

@@ -1,6 +1,6 @@
 created: 20200131145608087
-modified: 20200131150801682
-tags: test
+modified: 20211116192551162
+tags: test [[Widget Examples]]
 title: ActionCreateTiddlerWidget Template
 type: text/vnd.tiddlywiki
 x: x

package/editions/tw5.com/tiddlers/widgets/ActionCreateTiddlerWidget_Example.tid

@@ -1,6 +1,6 @@
 created: 20161020153426686
-modified: 20161020155142990
-tags: ActionCreateTiddlerWidget
+modified: 20211113011019510
+tags: ActionCreateTiddlerWidget Widgets
 title: ActionCreateTiddlerWidget Example
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ActionListopsWidget.tid

@@ -1,7 +1,7 @@
 caption: action-listops
 created: 20141025120850184
 list: efg hlm pqr
-modified: 20151228083329099
+modified: 20211115091121133
 myfield: 
 revision: 0
 tags: ActionWidgets Widgets
@@ -29,13 +29,63 @@ The ''action-listops'' widget is an [[action widget|ActionWidgets]] that manipul
 The ''action-listops'' widget is invisible. Any content within it is ignored.
 
 |!Attribute |!Description |
-|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]] |
+|$tiddler |The title of the tiddler whose lists are to be modified (if not provided defaults to the [[current tiddler|Current Tiddler]]) |
 |$field |The name of a field to be manipulated as a list (defaults to 'list') |
 |$index |Optional index of a property in a [[data tiddler|DataTiddlers]] index to be manipulated as a list |
 |$filter |An optional filter expression, the output of which will be saved to the field/index being manipulated |
 |$subfilter |An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated |
 |$tags |An optional subfilter expression, which takes the 'tags' field of the target tiddler as input, and saves the modified list of tags back to the 'tags' field |
 
+! $filter vs. $subfilter
+
+Standalone use of the `$subfilter` attribute can be replaced by using a (more complicated) `$filter` attribute value.
+
+For example, the items "abc" and "123" can be appended to the field `myfield` using the `$subfilter` attribute:
+
+```
+<$action-listops $field="myfield" $subfilter="abc 123"/>
+```
+
+The same can be achieved using the `$filter` attribute and prepending the [[Filter Run]] `[all[current]get[myfield]enlist-input[]]` to the [[Filter Expression]]:
+
+```
+<$action-listops $field="myfield" $filter="[all[current]get[myfield]enlist-input[]] abc 123"/>
+```
+
+The short form is more convenient, but the long form is useful for live-debugging complicated `$subfilter` values using the filter tab of [[$:/AdvancedSearch]]. By using [[$:/AdvancedSearch]], the [[Filter Expression]] can be tested before using ''action-listops'' to modify actual tiddler fields. For this use case, the `all[current]` portion of the expression needs to be changed to select the proper test tiddler.
+
+! $tags vs. $field + $subfilter
+
+[[Tagging]] is implemented using a tiddler's 'tags' field, so appending the tags "abc" and "123" using the `$tags` attribute like this:
+
+```
+<$action-listops $tags="abc 123"/>
+```
+
+is mostly equivalent to using `$subfilter` along with "tags" for the value of `$field`:
+
+```
+<$action-listops $field="tags" $subfilter="abc 123"/>
+```
+
+! $action-listops widget vs. $action-setfield widget
+
+The ActionSetFieldWidget replaces a field's value using `$field`/`$value` attributes. A single ActionSetFieldWidget can be used to set any number of fields by using attributes not starting with $.
+
+The ActionListopsWidget replaces or modifies a single field's value. The new value is generated using filters.
+
+The following two examples are functionally equivalent:
+
+```
+<$action-setfield $field="myfield" $value="abc 123"/>
+```
+
+```
+<$action-listops $field="myfield" $filter="abc 123"/>
+```
+
+In general, ActionSetFieldWidget is better for setting multiple fields at once and for replacing a field's value. The ActionListopsWidget is better for modifying a field based on the field's existing value and for using a [[Filter Expression]] to derive the value.
+
 ! Extended Filter Operators
 
 A number of [[extended filter operators|The Extended Listops Filters]] are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.

package/editions/tw5.com/tiddlers/widgets/ActionSendMessageWidget.tid

@@ -1,6 +1,6 @@
 caption: action-sendmessage
 created: 20141008134309742
-modified: 20150518210909583
+modified: 20211023160110220
 tags: Widgets ActionWidgets
 title: ActionSendMessageWidget
 type: text/vnd.tiddlywiki
@@ -18,6 +18,8 @@ The ''action-sendmessage'' widget is invisible. Any content within it is ignored
 |$param |Optional parameter string whose meaning is dependent on the message being sent |
 |$name |Optional name of additional parameter |
 |$value |Value for optional parameter whose name is specified in `$name` |
+|$names |<<.from-version "5.2.1">> Optional filter evaluating to a list of additional parameter names |
+|$values |<<.from-version "5.2.1">> Optional filter evaluating to a list of parameter values corresponding to the parameters names specified in `$names` |
 |//{any attributes not starting with $}// |Multiple additional, optional named parameters that are attached to the message |
 
 ! Examples

package/editions/tw5.com/tiddlers/widgets/ActionSetMultipleFieldsWidget.tid

@@ -0,0 +1,31 @@
+caption: action-setmultiplefields
+created: 20211023160110220
+modified: 20211023160110220
+tags: Widgets ActionWidgets
+title: ActionSetMultipleFieldsWidget
+type: text/vnd.tiddlywiki
+
+! Introduction
+
+The ''action-setmultiplefields'' widget is an [[action widget|ActionWidgets]] that assigns multiple fields to a tiddler where the names and values of the fields are specified as separate filters. ActionWidgets are used within triggering widgets such as the ButtonWidget.
+
+! Content and Attributes
+
+The ''action-setmultiplefields'' widget is invisible. Any content within it is ignored.
+
+|!Attribute |!Description |
+|$tiddler |Optional title of the tiddler to modify (defaults to the current tiddler) |
+|$fields |Optional filter evaluating to the names of a list of fields to assign. Either `$fields` or `$indexes` must be specified  |
+|$indexes |Optional filter evaluating to the names of a list of indexes to assign. Either `$fields` or `$indexes` must be specified |
+|$values |Filter evaluating to the values to be assigned to the fields or indexes |
+|$timestamp |Specifies whether the timestamp(s) of the target tiddler will be updated (''modified'' and ''modifier'', plus ''created'' and ''creator'' for newly created tiddlers). Can be "yes" (the default) or "no" |
+
+! Examples
+
+Here is an example of button that uses the data in [[Days of the Week]] to assign fields `day-Monday`, `day-Tuesday` etc. to the tiddler "HelloThere":
+
+<$macrocall $name='wikitext-example-without-html'
+src='<$button>
+<$action-setmultiplefields $tiddler="HelloThere" $fields="[list[Days of the Week]addprefix[day-]]" $values="[list[Days of the Week]]"/>
+Click me!
+</$button>'/>

package/editions/tw5.com/tiddlers/widgets/ActionWidget Execution Modes.tid

@@ -1,3 +1,6 @@
+created: 20211003094722447
+modified: 20211116193245990
+tags: Widgets
 title: ActionWidget Execution Modes
 
 <<.from-version "5.2.0">> The default behaviour of action widgets has some peculiarities that often cause confusion. There is now an improved mode that simplifies how things work, but due to BackwardsCompatibility constraints, it must be explicitly engaged in order to take advantage of it.
@@ -21,9 +24,9 @@ Current value of ActionTestTiddler: {{ActionTestTiddler}}
 Click me
 </$button>'/>
 
-The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scopr that includes the variable `tv-action-refresh-policy` set to the value `always`.
+The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scope that includes the variable `tv-action-refresh-policy` set to the value `always`.  (The default value for `tv-action-refresh-policy` is `once`).
 
-This can be done within an action string, or via a local variable declaration containing the widget triggering the action.
+The assignment can be done within an action string, or via a local variable declaration containing the widget triggering the action.
 
 <<.warning "Do not attempt to set `tv-action-refresh-policy` globally; the core will only work correctly with the default setting">>
 

package/editions/tw5.com/tiddlers/widgets/ActionWidgets.tid

@@ -1,10 +1,10 @@
 created: 20141008134425548
-modified: 20210630163127249
+modified: 20211031172913375
 tags: Widgets
 title: ActionWidgets
 type: text/vnd.tiddlywiki
 
-Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
+Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that [[trigger those actions|TriggeringWidgets]] (for example, the ButtonWidget).
 
 The following action widgets are provided:
 
@@ -17,7 +17,7 @@ There are two ways to use action widgets:
 
 !! Using action string attributes
 
-The action widgets are passed as a string to the `actions` attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
+The action widgets are passed as a string to the `actions` attribute of the [[triggering widget|TriggeringWidgets]]. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
 
 ```
 \define my-actions()
@@ -32,7 +32,7 @@ Click me!
 
 !! Directly embedding action widgets
 
-The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
+The action widgets need not be immediate children of their [[triggering widget|TriggeringWidgets]], but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
 
 ```
 <$button>

package/editions/tw5.com/tiddlers/widgets/ButtonWidget.tid

@@ -1,7 +1,7 @@
 caption: button
 created: 20131024141900000
-modified: 20201108183908170
-tags: Widgets
+modified: 20211009121239795
+tags: Widgets TriggeringWidgets
 title: ButtonWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/CheckboxWidget.tid

@@ -1,7 +1,7 @@
 caption: checkbox
 created: 20131024141900000
-modified: 20201109090732190
-tags: Widgets
+modified: 20211009121239806
+tags: Widgets TriggeringWidgets
 title: CheckboxWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/DraggableWidget.tid

@@ -1,7 +1,7 @@
 caption: draggable
 created: 20170406081938627
-modified: 20210912141544224
-tags: Widgets
+modified: 20211009122105437
+tags: Widgets TriggeringWidgets
 title: DraggableWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/DroppableWidget.tid

@@ -1,7 +1,7 @@
 caption: droppable
 created: 20170406082820317
-modified: 20200317142604572
-tags: Widgets
+modified: 20211009122023265
+tags: Widgets TriggeringWidgets
 title: DroppableWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/DropzoneWidget.tid

@@ -1,7 +1,7 @@
 caption: dropzone
 created: 20131024141900000
-modified: 20210506115809131
-tags: Widgets
+modified: 20211009122205481
+tags: Widgets TriggeringWidgets
 title: DropzoneWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/EditTextWidget.tid

@@ -1,6 +1,6 @@
 caption: edit-text
 created: 20131024141900000
-modified: 20210519154352055
+modified: 20211104200554064
 tags: Widgets
 title: EditTextWidget
 type: text/vnd.tiddlywiki
@@ -33,29 +33,18 @@ The content of the `<$edit-text>` widget is ignored.
 |minHeight |Minimum height for automatically resized `textarea` editors, specified in CSS length units such as "px", "em" or "%" |
 |rows|Sets the rows attribute of a generated textarea |
 |cancelPopups |<<.from-version "5.1.23">> if set to "yes", cancels all popups when the input gets focus |
-|inputActions |<<.from-version 5.1.23>> Optional actions that are triggered every time an input event occurs within the input field or textarea |
+|inputActions |<<.from-version 5.1.23>> Optional actions that are triggered every time an input event occurs within the input field or textarea.<br><<.from-version "5.2.1">> The variable `actionValue` is available to the `inputActions` and contains the value of the input field. |
 |refreshTitle |<<.from-version 5.1.23>> An optional tiddler title that makes the input field update whenever the specified tiddler changes |
 |disabled|<<.from-version "5.1.23">> Optional, disables the text input if set to "yes". Defaults to "no"|
 |fileDrop|<<.from-version "5.2.0">> Optional. When set to "yes" allows dropping or pasting images into the editor to import them. Defaults to "no"|
 
-! Notes
 
-One trap to be aware of is that the edit text widget //cannot be used// to edit a field of the tiddler that contains it. Each keypress results in the tiddler being re-rendered, which loses the cursor position within the text field.
+! Example
 
-Instead, place the edit text widget in a [[template|TemplateTiddlers]] that references the tiddler you want to modify.
+If you wanted to change the field //myconfig// of the tiddler //AppSettings//, you could use an EditTextWidget to edit the field, and then show the result anywhere else by using `{{AppSettings!!myconfig}}`. Note that this will create tiddler AppSettings if it doesn't already exist.
 
-For example, if you wanted the tiddler GettingStarted to edit the value of the "myconfig" field of the tiddler "AppSettings", you might do so by creating a separate tiddler "ChangeAppSettings" that contains the following:
+<$macrocall $name=".example" n="1"
+eg="""<$edit-text tiddler="AppSettings" field="myconfig"/><p/>
+Value of ''myconfig'' : {{AppSettings!!myconfig}}
+"""/>
 
-```
-<$edit-text tiddler="AppSettings" field="myconfig"/>
-```
-
-And reference the template in any other tiddler (e.g. GettingStarted) with `{{ChangeAppSettings}}`.
-
-This works when your use of the tiddler //is not// the AppSettings itself which would cause a recursion problem. In this latter case you have to save the fields to a temporary (or alternative) tiddler (sort of the reverse of above) like so:
-
-```
-<$edit-text tiddler="StoreAppSettings" field="myconfig"/>
-```
-
-In short the EditTextWidget //can not// change properties of the tiddler it is embedded in or part of. It can only change fields of //other// tiddlers. One could use ShadowTiddlers to accomplish the field storage if needed.

package/editions/tw5.com/tiddlers/widgets/EditWidget.tid

@@ -1,7 +1,7 @@
 caption: edit
 created: 20131024141900000
-modified: 20201130184647904
-tags: Widgets
+modified: 20211009121634055
+tags: Widgets TriggeringWidgets
 title: EditWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/EventCatcherWidget.tid

@@ -1,6 +1,6 @@
 created: 20201123113532200
-modified: 20210805083352068
-tags: Widgets
+modified: 20211031180336257
+tags: Widgets TriggeringWidgets
 title: EventCatcherWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/FieldManglerWidget.tid

@@ -1,9 +1,9 @@
+caption: fieldmangler
 created: 20131024141900000
-modified: 20150220161229000
-tags: Widgets
+modified: 20211009122821085
+tags: Widgets MessageHandlerWidgets
 title: FieldManglerWidget
 type: text/vnd.tiddlywiki
-caption: fieldmangler
 
 ! Introduction
 

package/editions/tw5.com/tiddlers/widgets/KeyboardWidget.tid

@@ -1,7 +1,7 @@
 caption: keyboard
 created: 20140302192136805
-modified: 20210612101618855
-tags: Widgets
+modified: 20211009121239821
+tags: Widgets TriggeringWidgets
 title: KeyboardWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/LetWidget.tid

@@ -0,0 +1,57 @@
+title: LetWidget
+created: 20211028115900000
+tags: Widgets
+caption: let
+
+! Introduction
+
+<<.from-version "5.2.1">> The <<.wid let>> widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible <<.wlink SetWidget>> widget. It differs from the <<.wlink VarsWidget>> widget in that variables you're defining may depend on earlier variables defined within the same <<.wid let>>.
+
+! Content and Attributes
+
+The content of the <<.wid let>> widget is the scope for the value assigned to the variable.
+
+|!Attribute |!Description |
+|//{attributes not starting with $}// |Each attribute name specifies a variable name. The attribute value is assigned to the variable |
+
+Attributes are evaluated in the order they are written. Attributes with the same name are allowed. Each time a duplicate attribute is encountered, it will replace the existing value set by the earlier duplicate.
+
+! Examples
+
+Consider a case where you need to set multiple variables, where some depend on the evaluation of others.
+
+Using the <<.wid let>> widget, this situation may be handled in the following way:
+
+```
+\define helloworld() Hello world!
+
+<$let target="MyTiddler" currentTiddler={{{ [<target>prefix[$:/settings/for/]] }}} settings={{!!text}} currentTiddler=<<target>> >
+  The settings for <<currentTiddler>> are: <<settings>>
+</$let>
+```
+
+In contrast, here is the same example using the <<.wid set>> widget:
+
+```
+<$set name="target" value="MyTiddler" >
+<$set name="currentTiddler" value={{{ [<target>prefix[$:/settings/for/]] }}} >
+<$set name="settings" value={{!!text}} >
+<$set name="currentTiddler" value=<<target>> >
+  The settings for <<currentTiddler>> are: <<settings>>
+</$set>
+</$set>
+</$set>
+</$set>
+```
+
+! Remarks
+
+This widget differs from <<.wid vars>> in the following way:
+
+* Each variable's definition will be immediately available to all proceeding variables in the same let widget. This differs from vars, in which definitions which depend on some variable will always look to the widget's outer scope for a value.
+
+This widget differs from <<.wid set>> in the following ways:
+
+* A fallback (also known as "emptyValue") cannot be specified
+* Filters cannot be used to produce a conditional variable assignment
+* Variable names must be literal strings

package/editions/tw5.com/tiddlers/widgets/LinkCatcherWidget.tid

@@ -1,7 +1,7 @@
 caption: linkcatcher
 created: 20131024141900000
-modified: 20170707111536556
-tags: Widgets
+modified: 20211009122821108
+tags: Widgets MessageHandlerWidgets TriggeringWidgets
 title: LinkCatcherWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/ListopsData.tid

@@ -3,5 +3,6 @@ daysoftheweek: four three Fri Thu Wed Tue Mon
 modified: 20151108041839747
 title: ListopsData
 type: application/x-tiddler-dictionary
+tags: [[Operator Examples]]
 
 DataIndex: 

package/editions/tw5.com/tiddlers/widgets/MessageCatcherWidget.tid

@@ -1,6 +1,6 @@
 created: 20210309133636211
-modified: 20210711193113104
-tags: Widgets
+modified: 20211009122821123
+tags: Widgets MessageHandlerWidgets TriggeringWidgets
 title: MessageCatcherWidget
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/widgets/MessageHandlerWidgets.tid

@@ -0,0 +1,13 @@
+created: 20211031174746965
+modified: 20211113163856255
+tags: Widgets
+title: MessageHandlerWidgets
+type: text/vnd.tiddlywiki
+
+Message handler widgets are those widgets which can react to one or more [[widget messages|Messages]].
+
+<<.tip "Widget messages are similar to low-level DOM events, except they are higher-level and specific to TiddlyWiki. To handle DOM events see the EventCatcherWidget">>
+
+The following message handler widgets are provided:
+
+<<list-links "[tag[MessageHandlerWidgets]]">>

package/editions/tw5.com/tiddlers/widgets/NavigatorWidget.tid

@@ -1,7 +1,7 @@
 caption: navigator
 created: 20131024141900000
-modified: 20170629074415261
-tags: Widgets
+modified: 20211127023932158
+tags: Widgets MessageHandlerWidgets
 title: NavigatorWidget
 type: text/vnd.tiddlywiki
 
@@ -39,3 +39,6 @@ The following [[Variables]] are assigned by the navigator widget:
 * <<.vlink tv-story-list>>, giving the name of the tiddler containing the story list
 * <<.vlink tv-history-list>>, giving the name of the tiddler containing the history list
 
+! Examples
+
+See [[Creating SubStories]].