tiddlywiki 5.3.3 → 5.3.5

package/editions/tw5.com/tiddlers/filters/remove.tid

@@ -2,12 +2,12 @@ caption: remove
 created: 20151017144531676
 modified: 20170125200005000
 op-input: a list of items
-op-neg-output: items removed from current list that appear at the tail of the operand array
-op-output: items removed from current list that appear at the head of the operand array
+op-neg-output: items removed from current list that appear at the tail of the parameter array
+op-output: items removed from current list that appear at the head of the parameter array
 op-parameter: an array of items to remove
 op-parameter-name: array
 op-prefix: causes N items from the end of the array to be removed
-op-purpose: remove a list of titles specified in the operand from the input
+op-purpose: remove a list of titles specified in the parameter from the input
 op-suffix: an integer N, defaulting to all
 tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
 title: remove Operator

package/editions/tw5.com/tiddlers/filters/removeprefix.tid

@@ -1,15 +1,15 @@
-created: 20140410103123179
-modified: 20220218023400000
-tags: [[Filter Operators]] [[String Operators]]
-title: removeprefix Operator
-type: text/vnd.tiddlywiki
 caption: removeprefix
-op-purpose: filter the input titles by how they start, deleting that prefix
+created: 20140410103123179
+modified: 20230711082842515
 op-input: a [[selection of titles|Title Selection]]
+op-output: those input titles that start with <<.place S>>, but with those characters discarded
 op-parameter: a string of characters
 op-parameter-name: S
-op-output: those input titles that start with <<.place S>>, but with those characters discarded
+op-purpose: filter the input titles by how they start, deleting that prefix
 op-suffix: the <<.op removeprefix>> operator uses a rich suffix, see below for details
+tags: [[Filter Operators]] [[String Operators]]
+title: removeprefix Operator
+type: text/vnd.tiddlywiki
 
 <<.tip " This filters out input titles that do not start with S. For removing S without filtering out input titles that don't start with S, see [[trim|trim Operator]].">>
 
@@ -18,11 +18,10 @@ op-suffix: the <<.op removeprefix>> operator uses a rich suffix, see below for d
 The <<.op removeprefix>> operator uses an extended syntax that permits multiple flags to be passed:
 
 ```
-[removeprefix:<flag list>[<operand>]]
+[removeprefix:<flag list>[<parameter>]]
 ```
 
 * ''flag list'': a comma delimited list of flags
-* ''operand'': filter operand
 
 The available flags are:
 

package/editions/tw5.com/tiddlers/filters/removesuffix.tid

@@ -1,15 +1,15 @@
-created: 20140828133830424
-modified: 20220218023400000
-tags: [[Filter Operators]] [[String Operators]]
-title: removesuffix Operator
-type: text/vnd.tiddlywiki
 caption: removesuffix
-op-purpose: filter the input titles by how they end, deleting that suffix
+created: 20140828133830424
+modified: 20230711082859816
 op-input: a [[selection of titles|Title Selection]]
+op-output: those input titles that end with <<.place S>>, but with those characters discarded
 op-parameter: a string of characters
 op-parameter-name: S
-op-output: those input titles that end with <<.place S>>, but with those characters discarded
+op-purpose: filter the input titles by how they end, deleting that suffix
 op-suffix: the <<.op removesuffix>> operator uses a rich suffix, see below for details
+tags: [[Filter Operators]] [[String Operators]]
+title: removesuffix Operator
+type: text/vnd.tiddlywiki
 
 <<.tip " This filters out input titles that do not end with S. For removing S without filtering out input titles that don't end with S, see [[trim|trim Operator]].">>
 
@@ -18,11 +18,10 @@ op-suffix: the <<.op removesuffix>> operator uses a rich suffix, see below for d
 The <<.op removesuffix>> operator uses an extended syntax that permits multiple flags to be passed:
 
 ```
-[removesuffix:<flag list>[<operand>]]
+[removesuffix:<flag list>[<parameter>]]
 ```
 
 * ''flag list'': a comma delimited list of flags
-* ''operand'': filter operand
 
 The available flags are:
 

package/editions/tw5.com/tiddlers/filters/search.tid

@@ -1,6 +1,6 @@
 caption: search
 created: 20140410103123179
-modified: 20211129120739275
+modified: 20230711084359603
 op-input: a [[selection of titles|Title Selection]]
 op-neg-output: those input tiddlers in which <<.em not>> all of the search terms can be found
 op-output: those input tiddlers in which <<.em all>> of the search terms can be found in the value of field <<.place F>>
@@ -16,7 +16,7 @@ type: text/vnd.tiddlywiki
 The <<.op search>> operator uses an extended syntax that permits multiple fields and flags to be passed:
 
 ```
-[search:<field list>:<flag list>[<operand>]]
+[search:<field list>:<flag list>[<parameter>]]
 ```
 
 * ''field list'': a comma delimited list of field names to restrict the search
@@ -24,7 +24,7 @@ The <<.op search>> operator uses an extended syntax that permits multiple fields
 ** an asterisk `*` instead of the field list causes the search to be performed across all fields available on each tiddler
 ** preceding the list with a minus sign `-` reverses the order so that the search is performed on all fields except the listed fields
 * ''flag list'': a comma delimited list of flags (defaults to `words` if blank)
-* ''operand'': filter operand
+* ''parameter'': filter parameter
 
 This example searches the fields <<.field title>> and <<.field caption>> for a case-sensitive match for the literal string <<.op-word "The first">>:
 

package/editions/tw5.com/tiddlers/filters/sortby.tid

@@ -5,7 +5,7 @@ op-input: a list of items
 op-output: all items sorted by lookup list
 op-parameter: a list specifying the order in which to sort the current list
 op-parameter-name: order
-op-purpose: sort the current list in the order of the list referenced in the operand
+op-purpose: sort the current list in the order of the list referenced in the parameter
 tags: [[Filter Operators]] [[Order Operators]] [[Listops Operators]]
 title: sortby Operator
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/filters/splitregexp Operator.tid

@@ -1,6 +1,6 @@
 caption: splitregexp
 created: 20190613154722705
-modified: 20190613154924724
+modified: 20240606113433618
 op-input: a [[selection of titles|Title Selection]]
 op-output: the input titles split into separate items according to the specified regular expression <<.place R>>
 op-parameter: The regular expression at which to split each title
@@ -13,7 +13,7 @@ type: text/vnd.tiddlywiki
 
 <<.from-version "5.1.20">>
 
-Note that in some circumstances the <<.op splitregexp>> operator will include blank items in the list of results. For example, 
+<<.note """... that in some circumstances the <<.op splitregexp>> operator will include blank items in the list of results. For example, """>>
 
 ```
 [[the band thethe are the best the]splitregexp[the]]
@@ -42,3 +42,21 @@ Syntax errors in the regular expression will cause the filter to return an error
 <<.operator-example 2 "[[the cat sat on the mat]splitregexp[\]]">>
 
 <<.operator-examples "splitregexp">>
+
+----
+
+The <<.op splitregexp>> operator is intended to be used as described above. If the `regexp` contains //capture groups// those groups will be included into the output.
+
+<<.bad-example """```
+\procedure re() (color)|(colour)ed
+\procedure str() Some coloured text
+{{{ [<str>splitregexp<re>join[, ]] }}}
+```""">>
+
+Somewhat more useful may be this code. 
+
+```
+\procedure re() (colou?red)
+\procedure str() Some coloured text
+{{{ [<str>splitregexp<re>join[, ]] }}}
+```

package/editions/tw5.com/tiddlers/filters/subfilter Operator.tid

@@ -7,14 +7,14 @@ op-neg-output: those input titles that are <<.em not>> returned from the subfilt
 op-output: the [[selection of titles|Title Selection]] returned from the subfilter <<.place S>>
 op-parameter: a [[filter expression|Filter Expression]]
 op-parameter-name: S
-op-purpose: select titles from the operand interpreted as a [[filter expression|Filter Expression]]
+op-purpose: select titles from the parameter interpreted as a [[filter expression|Filter Expression]]
 tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]] [[Selection Constructors: Conditional]]
 title: subfilter Operator
 type: text/vnd.tiddlywiki
 
 <<.from-version "5.1.18">> Note that the <<.op subfilter>> operator was introduced in version 5.1.18 and is not available in earlier versions.
 
-<<.tip " Literal filter operands cannot contain square brackets but you can work around the issue by using a variable:">>
+<<.tip " Literal filter parameters cannot contain square brackets but you can work around the issue by using a variable:">>
 
 ```
 <$set name="myFilter" value="[tag[one]]">
@@ -24,6 +24,6 @@ type: text/vnd.tiddlywiki
 
 <<.tip "Compare with the similar [[filter|filter Operator]] operator which runs a subfilter against each title, returning those titles that return a non-empty list (and discards the results of the subfilter)">>
 
-The <<.op subfilter>> operator will act as a [[constructor|Selection Constructors]] whenever the filter defined by its operand is a [[constructor|Selection Constructors]]. Otherwise, it will act as a [[modifier|Selection Constructors]].
+The <<.op subfilter>> operator will act as a [[constructor|Selection Constructors]] whenever the filter defined by its parameter is a [[constructor|Selection Constructors]]. Otherwise, it will act as a [[modifier|Selection Constructors]].
 
 <<.operator-examples "subfilter">>

package/editions/tw5.com/tiddlers/filters/subtract Operator.tid

@@ -5,7 +5,7 @@ op-input: a [[selection of titles|Title Selection]]
 op-output: the input as numbers, but with <<.place N>> subtracted from each one
 op-parameter: a number
 op-parameter-name: N
-op-purpose: treating each input title as a number, subtract from each the numeric value of the operand
+op-purpose: treating each input title as a number, subtract from each the numeric value of the parameter
 tags: [[Filter Operators]] [[Mathematics Operators]] [[Binary Mathematics Operators]]
 title: subtract Operator
 type: text/vnd.tiddlywiki

package/editions/tw5.com/tiddlers/filters/suffix.tid

@@ -1,27 +1,26 @@
-created: 20140828133830424
-modified: 20220218023400000
-tags: [[Filter Operators]] [[String Operators]] [[Negatable Operators]]
-title: suffix Operator
-type: text/vnd.tiddlywiki
 caption: suffix
-op-purpose: filter the input titles by how they end
+created: 20140828133830424
+modified: 20230711083049169
 op-input: a [[selection of titles|Title Selection]]
+op-neg-output: those input tiddlers that do <<.em not>> end with <<.place S>>
+op-output: those input titles that end with <<.place S>>
 op-parameter: a string of characters
 op-parameter-name: S
-op-output: those input titles that end with <<.place S>>
-op-neg-output: those input tiddlers that do <<.em not>> end with <<.place S>>
+op-purpose: filter the input titles by how they end
 op-suffix: the <<.op suffix>> operator uses a rich suffix, see below for details
+tags: [[Filter Operators]] [[String Operators]] [[Negatable Operators]]
+title: suffix Operator
+type: text/vnd.tiddlywiki
 
 <<.from-version "5.2.2">>
 
 The <<.op suffix>> operator uses an extended syntax that permits multiple flags to be passed:
 
 ```
-[suffix:<flag list>[<operand>]]
+[suffix:<flag list>[<parameter>]]
 ```
 
 * ''flag list'': a comma delimited list of flags
-* ''operand'': filter operand
 
 The available flags are:
 

package/editions/tw5.com/tiddlers/filters/syntax/All Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230316150731234
+from-version: 5.1.23
+modified: 20230711084644541
+rp-input: all titles from previous filter runs
+rp-output: output titles are appended to the output of previous filter runs without de-duplication.
+rp-purpose: union of sets without de-duplication
+tags: [[Named Filter Run Prefix]]
+title: All Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+<$railroad text="""
+\start none
+\end none
+( ":all" | - )
+[[run|"Filter Run"]]
+"""/>
+
+This prefix has an optional [[shortcut syntax|Shortcut Filter Run Prefix]] symbol `=run`

package/editions/tw5.com/tiddlers/filters/syntax/And Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230318142752854
+from-version: 5.1.23
+modified: 20230711084712170
+op-purpose: accumulation of filter steps
+rp-input: the filter output of all previous runs so far
+rp-output: output titles replace the output of previous filter runs
+tags: [[Named Filter Run Prefix]]
+title: And Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+<$railroad text="""
+\start none
+\end none
+( ":and" | - )
+[[run|"Filter Run"]]
+"""/>
+
+This prefix has an optional [[shortcut syntax|Shortcut Filter Run Prefix]] symbol `+run`

package/editions/tw5.com/tiddlers/filters/syntax/Cascade Filter Run Prefix (Examples).tid

@@ -2,8 +2,8 @@ created: 20211130114857532
 filter1: [prefix[ca]then[ca]]
 filter2: [suffix[at]then[at]]
 filter3: other
-modified: 20211204010918504
-tags: [[Filter Run Prefix Examples]] [[Filter Syntax]] [[Cascade Filter Run Prefix]]
+modified: 20230305125250563
+tags: [[Cascade Filter Run Prefix]]
 title: Cascade Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Cascade Filter Run Prefix.tid

@@ -1,20 +1,25 @@
 created: 20211130114043280
-modified: 20211130121544118
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.2.1
+modified: 20230710073343947
+rp-input: the filter output of all previous runs so far
+rp-output: the input titles as modified by the filters returned by this filter run
+rp-purpose: modify input titles by successively evaluating a list of filters and applying the first result
+tags: [[Named Filter Run Prefix]]
 title: Cascade Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.2.1">>
-
-|''purpose'' |modify input titles by evaluating in turn a list of filters - as returned by the filter expression for this run - for each input title. |
-|''input'' |all titles from previous filter runs |
-|''output''|the input titles as modified by the filters returned by this filter run |
+<$railroad text="""
+\start none
+\end none
+( ":cascade" | - )
+[[run|"Filter Run"]]
+"""/>
 
 The [[filter expression|Filter Expression]] for this [[filter run|Filter Run]] is evaluated to return a list of filters. Each input title is then evaluated against each of the filters in turn, and the input title is replaced with the first result of the first filter that returns a non-empty list. If none of the filters return a result for an input title, it is replaced with an empty string.
 
 The following variables are available within the filter run:
 
 * <<.var currentTiddler>> - the input title
-* <<.var ..currentTiddler>> - the value of the variable `currentTiddler` outside the filter run.
+* <<.var ..currentTiddler>> - the value of the variable <<.var currentTiddler>> outside the filter run.
 
-[[Examples|Cascade Filter Run Prefix (Examples)]]
+[[Cascade Filter Run Prefix (Examples)]]

package/editions/tw5.com/tiddlers/filters/syntax/Else Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230318142408662
+from-version: 5.1.23
+modified: 20230322140756821
+rp-input: all titles from previous filter runs
+rp-output: if the filter output so far is an empty list then the output titles of the run are [[dominantly appended|Dominant Append]] to the filter's output.<br>if the filter output so far is not an empty list then the run is ignored.
+rp-purpose: the filter run is only evaluated if the filter output of all previous runs so far is an empty list
+tags: [[Named Filter Run Prefix]]
+title: Else Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+<$railroad text="""
+\start none
+\end none
+( ":else" | - )
+[[run|"Filter Run"]]
+"""/>
+
+This prefix has a [[Shortcut Filter Run Prefix]] symbol `~run`

package/editions/tw5.com/tiddlers/filters/syntax/Except Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230318142056008
+from-version: 5.1.23
+modified: 20230322140643066
+rp-input: all titles from previous filter runs
+rp-output: output titles are removed from the filter's output (if such tiddlers exist)
+rp-purpose: if output titles of this filter run are contained in the output of previous filter runs, they are removed, and otherwise ignored
+tags: [[Named Filter Run Prefix]]
+title: Except Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+<$railroad text="""
+\start none
+\end none
+( ":except" | - )
+[[run|"Filter Run"]]
+"""/>
+
+This prefix has a [[Shortcut Filter Run Prefix]] symbol `-run`

package/editions/tw5.com/tiddlers/filters/syntax/Filter Expression.tid

@@ -1,73 +1,21 @@
 created: 20150124182421000
-modified: 20211129014550442
+modified: 20230710074507466
 tags: [[Filter Syntax]]
 title: Filter Expression
 type: text/vnd.tiddlywiki
 
+A <<.def "filter expression">> is the outermost level of the [[filter syntax|Filter Syntax]]. It consists of [[filter runs|Filter Run]] with optional [[filter run prefixes|Filter Run Prefix]]. Multiple filter runs are separated by [[whitespace|Filter Whitespace]].
+
 <$railroad text="""
-[{:
-  [: [[whitespace|"Filter Whitespace"]] ]
-  ("+"|"~"|:-|"-"|"="|":"[[named-prefix|"Named Filter Run Prefix"]])
+{ (
+    - |
+    : [[<"prefix">|"Filter Run Prefix"]]
+  )
   [[run|"Filter Run"]]
-}]
+  +  [[whitespace|"Filter Whitespace"]]
+}
 """/>
 
-A <<.def "filter expression">> is the outermost level of the [[filter syntax|Filter Syntax]]. It consists of one or more [[runs|Filter Run]].
-
-If a run has:
-
-* no prefix, its output titles are [[dominantly appended|Dominant Append]] to the filter's output
-* the prefix `=`, output titles are appended to the filter's output without de-duplication. <<.from-version "5.1.20">> 
-* the prefix `-`, output titles are <<.em removed>> from the filter's output (if such tiddlers exist)
-* the prefix `+`, it receives the filter output so far as its input; its output then <<.em "replaces">> all filter output so far and forms the input for the next run
-* the prefix `~`, if the filter output so far is an empty list then the output titles of the run are [[dominantly appended|Dominant Append]] to the filter's output. If the filter output so far is not an empty list then the run is ignored. <<.from-version "5.1.18">>
-* named prefixes for filter runs are available. <<.from-version "5.1.23">>
-* named prefix `:filter`, it receives the filter output so far as its input. The next run is evaluated for each title of the input, removing every input title for which the output is an empty list. <<.from-version "5.1.23">>
-** See [[Filter Filter Run Prefix]].
-* named prefix `:intersection` replaces all filter output so far with titles that are present in the output of this run, as well as the output from previous runs. Forms the input for the next run. <<.from-version "5.1.23">>
-** See [[Intersection Filter Run Prefix]].
-* named prefix `:reduce` replaces all filter output so far with a single item by repeatedly applying a formula to each input title. A typical use is to add up the values in a given field of each input title. <<.from-version "5.1.23">>
-** See [[Reduce Filter Run Prefix]].
-* named prefix `:sort` sorts all filter output so far by applying this run to each input title and sorting according to that output. <<.from-version "5.2.0">>
-** See [[Sort Filter Run Prefix]].
-* named prefix `:map` transforms all filter output so far by applying this run to each input title and replacing the input title with the output of this run for that title.
-** See [[Map Filter Run Prefix]]. <<.from-version "5.2.0">>
-
-
-<<.tip "Compare named filter run prefix `:filter` with [[filter Operator]] which applies a subfilter to every input title, removing the titles that return an empty result from the subfilter">>
-
-<<.tip "Compare named filter run prefix `:reduce` with [[reduce Operator]] which is used to used to flatten a list of items down to a single item by repeatedly applying a subfilter.">> 
-
-<<.tip """Within the filter runs prefixed with `:reduce`, `:sort`, `:map` and `:filter`, the "currentTiddler" variable is set to the title of the tiddler being processed. The value of currentTiddler outside the subfilter is available in the variable "..currentTiddler".<<.from-version "5.2.0">>""" >>
-
-In technical / logical terms:
-
-|!Run |!Equivalent named prefix |!Interpretation |!Output |
-|`run` |`:or[run]` |de-duplicated union of sets |... OR run |
-|`=run` |`:all[run]` |union of sets without de-duplication |... OR run |
-|`+run` |`:and[run]` |accumulation of filter steps |... AND run |
-|`-run` |`:except[run]` |difference of sets |... AND NOT run |
-|`~run` |`:else[run]` |else |... ELSE run |
-||`:intersection`|intersection of sets||
-
-For the difference between `+` and `:intersection`, see [[Intersection Filter Run Prefix (Examples)]].
-
-The input of a run is normally a list of all the non-[[shadow|ShadowTiddlers]] tiddler titles in the wiki (in no particular order). But the `+` prefix can change this:
-
-|Prefix|Input|h
-|`-`, `~`, `=`, `:intersection` or none| <$link to="all Operator">`[all[]]`</$link> tiddler titles, unless otherwise determined by the first [[filter operator|Filter Operators]]|
-|`+`, `:filter`, `:reduce`,`:sort`|the filter output of all previous runs so far|
-
-Precisely because of varying inputs, be aware that both prefixes `-` and `+` do not behave inverse to one another!
-
-For example, in both of the following, `$:/baz` will only be removed if it actually exists:
-
-* <$link to="is Operator"> `foo bar $:/baz -[is[system]]`</$link>
-* <$link to="prefix Operator">`foo bar $:/baz -[prefix[$:/]]`</$link>
-
-To understand why, consider the input for both final runs with their `-` prefix.
-
-In order to remove `$:/baz` in any case, existing or not, simply use the `+` prefix with [[negated filter operators|Filter Operators]]:
+<<.tip """If the diagram has a single start and end line, as shown above, it means there is more info in the linked level above. The breadcrumbs can be used to navigate""">>
 
-* <$link to="is Operator">`foo bar $:/baz +[!is[system]]`</$link>
-* <$link to="prefix Operator">`foo bar $:/baz +[!prefix[$:/]]`</$link>
+<<.tip """If the diagram has no start and no end, as used in lower levels, it means that higher level syntax elements have been removed, to increase readability and simplicity. The breadcrumbs can be used to navigate""">>

package/editions/tw5.com/tiddlers/filters/syntax/Filter Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20211129022707404
-modified: 20211204154839890
-tags: [[Filter Syntax]] [[Filter Run Prefix Examples]] [[Filter Filter Run Prefix]]
+modified: 20230305125338118
+tags: [[Filter Filter Run Prefix]]
 title: Filter Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Filter Filter Run Prefix.tid

@@ -1,27 +1,32 @@
 created: 20211129022455873
-modified: 20211129022550425
-tags: [[Filter Syntax]] [[Filter Run Prefix]]
+from-version: 5.1.23
+modified: 20230710073334078
+rp-input: the filter output of all previous runs so far
+rp-output: the input titles for which the filter run is not empty
+rp-purpose: remove every input title for which the filter run output is an empty list
+tags: [[Named Filter Run Prefix]]
 title: Filter Filter Run Prefix
 type: text/vnd.tiddlywiki
 
-<<.from-version "5.1.23">>
-
-|''purpose'' |remove every input title for which the filter run output is an empty list |
-|''input'' |all titles from previous filter runs |
-|''output''|the input titles for which the filter run is not empty |
+<$railroad text="""
+\start none
+\end none
+( ":filter" | - )
+[[run|"Filter Run"]]
+"""/>
 
 It receives the filter output so far as its input. The next run is evaluated for each title of the input, removing every input title for which the output is an empty list.
 
-Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like `:filter[{!!price}multiply{!!cost}compare:integer:gteq[5]]` to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
+Note that within the filter run, the <<.var currentTiddler>> variable is set to the title of the tiddler being processed. This permits filter runs like `:filter[{!!price}multiply{!!cost}compare:integer:gteq[5]]` to be used for computation. The value of currentTiddler outside the run is available in the variable <<.var ..currentTiddler>>.
 
 The following variables are available within the filter run:
 
-* ''currentTiddler'' - the input title
-* ''..currentTiddler'' - the value of the variable `currentTiddler` outside the filter run.
-* ''index'' - <<.from-version "5.2.1">> the numeric index of the current list item (with zero being the first item in the list).
-* ''revIndex'' - <<.from-version "5.2.1">> the reverse numeric index of the current list item (with zero being the last item in the list).
-* ''length'' - <<.from-version "5.2.1">> the total length of the input list.
+* <<.var currentTiddler>> - the input title
+* <<.var ..currentTiddler>> - the value of the variable `currentTiddler` outside the filter run.
+* <<.var index>> - <<.from-version "5.2.1">> the numeric index of the current list item (with zero being the first item in the list).
+* <<.var revIndex>> - <<.from-version "5.2.1">> the reverse numeric index of the current list item (with zero being the last item in the list).
+* <<.var length>> - <<.from-version "5.2.1">> the total length of the input list.
 
 <<.tip "Compare named filter run prefix `:filter` with [[filter Operator]] which applies a subfilter to every input title, removing the titles that return an empty result from the subfilter">>
 
-[[Examples|Filter Filter Run Prefix (Examples)]]
+[[Filter Filter Run Prefix (Examples)]]

package/editions/tw5.com/tiddlers/filters/syntax/Filter Parameter.tid

@@ -1,15 +1,17 @@
 created: 20150220152540000
-modified: 20210629215024053
-tags: [[Filter Syntax]]
+modified: 20240708202234843
+tags: [[Filter Step]]
 title: Filter Parameter
 type: text/vnd.tiddlywiki
 
 <$railroad text="""
-( "[" [:{/"anything but ]"/}] "]"
+\start none
+\end none
+( "[" [: <-"hard"-> /"anything but ]"/] "]"
   |
-  "{" [:{/"anything but }"/}] "}"
+  "{" [: <-"indirect"-> /"anything but }"/] "}"
   |
-  "<" [:{/"anything but >"/}] ">"
+  "<" [: <-"variable"-> /"anything but >"/] ">"
 )
 """/>
 
@@ -24,9 +26,13 @@ The parameter to a [[filter operator|Filter Operators]] can be:
 :: The parameter is the text indicated by the [[text reference|TextReference]] whose name appears between the curly brackets, i.e. a [[field|TiddlerFields]] of a specified tiddler, or the value of a property of a specified [[data tiddler|DataTiddlers]].
 : <<.def variable>>
 :: `<like this>`
-:: The parameter is the current value of the [[variable|Variables]] whose name appears between the angle brackets. Macro parameters are <<.em not>> supported up to and including ~TiddlyWiki v5.1.23.
+:: The parameter is the current value of the [[variable|Variables]] whose name appears between the angle brackets. Macro parameters are <<.em not>> supported up to v5.2.0
 ::<<.from-version "5.2.0">> Literal macro parameters are supported. For example: `[<now [UTC]YYYY0MM0DD0hh0mm0ssXXX>]`.
 
-<<.from-version "5.1.23">> Filter operators support multiple parameters which are separated by a ` , ` character.
+<<.note """Every [[filter Operator]] must be followed by a parameter expression. In the case of [[Operators without parameters]], that expression is empty, as with the filter Operator <<.olink links>> in `[<currentTiddler>links[]]`.""">>
+
+---
+
+<<.from-version "5.1.23">>  [[Filter Step]]s support multiple parameters which are separated by a `,` character.
 
 For example: `[param1],[param2]` or `<param1>,{param2}`

package/editions/tw5.com/tiddlers/filters/syntax/Filter Run Prefix (Examples).tid

@@ -1,6 +1,6 @@
 created: 20201117073343969
-modified: 20211129032537195
-tags: [[Filter Syntax]] [[Filter Run Prefix Examples]]
+modified: 20230315152812472
+tags:
 title: Filter Run Prefix (Examples)
 type: text/vnd.tiddlywiki
 

package/editions/tw5.com/tiddlers/filters/syntax/Filter Run Prefix.tid

@@ -0,0 +1,18 @@
+created: 20230305130600148
+modified: 20230711090913687
+tags: [[Filter Expression]]
+title: Filter Run Prefix
+type: text/vnd.tiddlywiki
+
+There are 2 types of filter run prefixes that are interchangeable; [[named prefixes|Named Filter Run Prefix]] and [[shortcut prefixes|Shortcut Filter Run Prefix]]. 
+
+<$railroad text="""
+\start none
+\end none
+(
+   - |
+:  [[<":named prefix"> /"starting with v5.1.23"/ |"Named Filter Run Prefix"]] | 
+   [[<"shortcut prefix"> /"prior to v5.1.23"/ |"Shortcut Filter Run Prefix"]]
+)
+[[run|"Filter Run"]]
+"""/>

package/editions/tw5.com/tiddlers/filters/syntax/Filter Run.tid

@@ -1,11 +1,13 @@
 created: 20150124182117000
-modified: 20150129133716000
-tags: [[Filter Syntax]]
+modified: 20230710074357002
+tags: [[Filter Expression]]
 title: Filter Run
 type: text/vnd.tiddlywiki
 
 <$railroad text="""
-( "[" { [[step|"Filter Step"]] } "]"
+\start none
+\end none
+( "[" { [[<"Filter Step">|"Filter Step"]] } "]"
   |
   [:{/"anything but [ ] or whitespace"/}]
   |
@@ -19,7 +21,6 @@ A <<.def run>> consists of [[steps|Filter Step]], and it outputs a [[selection|T
 
 The steps are processed from left to right. The input to the first step is same as the input to the run. For each subsequent step, the input is the output of the previous step.
 
-{{Selection Constructors}}
 
 The lower three options in the diagram match syntax like `HelloThere`, `"HelloThere"`, `'HelloThere'` and `"Filter Operators"`. They are short for `[title[...]]`.