tiddlywiki 5.1.21 → 5.2.1

package/editions/tw5.com/tiddlers/filters/examples/sortsub Operator (Examples).tid

@@ -0,0 +1,34 @@
+created: 20200425110427700
+modified: 20201118103327392
+tags: [[sortsub Operator]] [[Operator Examples]]
+title: sortsub Operator (Examples)
+type: text/vnd.tiddlywiki
+
+\define show-variable(name)
+<li>''$name$'': <code><$text text=<<$name$>>/></code></li>
+\end
+
+
+<$vars
+	compare-by-title-length="[length[]]"
+	compare-by-text-length="[get[text]else[]length[]]"
+	compare-by-newest-of-modified-and-created-dates="[get[modified]else[19700101]]"
+>
+
+These examples make use of the following variables:
+
+<ul>
+<<show-variable compare-by-title-length>>
+<<show-variable compare-by-text-length>>
+<<show-variable compare-by-newest-of-modified-and-created-dates>>
+</ul>
+
+<<.operator-example 1 "[sortsub:number<compare-by-title-length>limit[10]]">>
+<<.operator-example 2 "[!sortsub:number<compare-by-title-length>limit[10]]">>
+<<.operator-example 3 "[sortsub:number<compare-by-text-length>limit[10]]">>
+<<.operator-example 4 "[!sortsub:number<compare-by-text-length>limit[10]]">>
+<<.operator-example 5 "[tag[Field Operators]sortsub:date<compare-by-newest-of-modified-and-created-dates>]">>
+
+{{How to remove stop words}}
+
+</$vars>

package/editions/tw5.com/tiddlers/filters/examples/standard-deviation Operator (Examples).tid

@@ -0,0 +1,10 @@
+created: 20210426130306824
+modified: 20210426131553553
+tags: [[Operator Examples]] [[standard-deviation Operator]]
+title: standard-deviation Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "=1 =3 =4 =5 +[standard-deviation[]]">>
+
+Note that if there is no input the operator returns `NaN`
+<<.operator-example 2 "[title[NotATiddler]get[price]] +[standard-deviation[]]">>

package/editions/tw5.com/tiddlers/filters/examples/stringify_Operator_(Examples).tid

@@ -5,3 +5,5 @@ title: stringify Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 """[[Title with "double quotes" and single ' and \backslash]] +[stringify[]]""">>
+<<.operator-example 2 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 without suffix]] +[stringify[]]""">>
+<<.operator-example 3 """[[Accents and emojis -> äñøßπ ⌛🎄🍪🍓 with rawunicode suffix]] +[stringify:rawunicode[]]""">>

package/editions/tw5.com/tiddlers/filters/examples/subfilter Operator (Examples).tid

@@ -1,8 +1,30 @@
 created: 20181031175129475
-modified: 20181031175129475
+modified: 20211030223407188
 tags: [[subfilter Operator]] [[Operator Examples]]
 title: subfilter Operator (Examples)
 type: text/vnd.tiddlywiki
 
-<<.operator-example 1 "[subfilter[one two three]addsuffix[!]]">>
-<<.operator-example 2 "[subfilter{$:/StoryList!!list}]">>
+\define recent-mods() [has[modified]!sort[modified]limit[5]]
+\define display-variable(name)
+''<$text text=<<__name__>>/>'': <code><$text text={{{ [<__name__>getvariable[]] }}}/></code>
+\end
+
+Literal filter operands can be used, but such cases are better rewritten without using <<.op subfilter>>:
+<<.operator-example 1 "[subfilter[one two three]addsuffix[!]]" "same as `one two three +[addsuffix[!]]`">>
+
+The <<.op subfilter>> operator can be used to dynamically define parts of a [[filter run|Filter Run]]. This is useful for sharing a common pieces of a filter across multiple filters.
+
+For example, this variable:
+
+* <<display-variable recent-mods>>
+
+can be used in one filter like this:
+
+<<.operator-example 2 "[tag[Filter Operators]subfilter<recent-mods>addsuffix[!]]" "same as `[tag[Filter Operators]has[modified]!sort[modified]limit[5]addsuffix[!]]`">>
+
+and in another similar filter like this:
+<<.operator-example 3 "[tag[ActionWidgets]subfilter<recent-mods>addprefix[!]]">>
+
+Variables are not the only way to define dynamic subfilters. [[Text references|TextReference]] can be used to load a subfilter from a tiddler field (see also [[Filter Parameter]]):
+<<.operator-example 4 "[subfilter{$:/StoryList!!list}limit[5]]">>
+<<.operator-example 5 "[subfilter{$:/StoryList!!list}subfilter<recent-mods>]">>

package/editions/tw5.com/tiddlers/filters/examples/tan Operator (Examples).tid

@@ -0,0 +1,7 @@
+created: 20211020142158187
+modified: 20211020142222782
+tags: [[Operator Examples]] [[tan Operator]]
+title: tan Operator (Examples)
+
+<<.operator-example 1 "[[2]tan[]]">>
+<<.operator-example 2 "=1 =2 =3 =4 +[tan[]]">>

package/editions/tw5.com/tiddlers/filters/examples/toggle Operator (Examples).tid

@@ -0,0 +1,27 @@
+created: 20201107154352695
+modified: 20201118174726982
+tags: [[Operator Examples]] [[toggle Operator]]
+title: toggle Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.using-days-of-week>>
+
+<<.operator-example 1 """[list[Days of the Week]] +[toggle[Wednesday]]""">>
+
+To toggle a tag in a tiddler:
+
+```
+<$action-listops  $tiddler="target" $tags="+[toggle[done]]" />
+```
+
+To toggle a title in a field:
+
+```
+<$action-listops $tiddler="target" $field="my-field" $subfilter="+[toggle[done]]" />
+```
+
+To toggle between a value pair:
+
+```
+<$action-listops $tiddler="target" $field="my-field" $subfilter="+[toggle[todo],[done]]" />
+```

package/editions/tw5.com/tiddlers/filters/examples/trim Operator (Examples).tid

@@ -5,3 +5,11 @@ title: trim Operator (Examples)
 type: text/vnd.tiddlywiki
 
 <<.operator-example 1 "[[ a b ]trim[]addprefix[-]addsuffix[-]]">>
+
+<<.operator-example 2 "[[ abc ]] [[def ]] [[ ghi]] +[trim[]addprefix[-]addsuffix[-]]">>
+<<.operator-example 3 "[[ abc ]] [[def ]] [[ ghi]] +[trim:prefix[]addprefix[-]addsuffix[-]]">>
+<<.operator-example 4 "[[ abc ]] [[def ]] [[ ghi]] +[trim:suffix[]addprefix[-]addsuffix[-]]">>
+
+<<.operator-example 5 "abacus baobab +[trim[ab]]">>
+<<.operator-example 6 "abacus baobab +[trim:prefix[ab]]">>
+<<.operator-example 7 "abacus baobab +[trim:suffix[ab]]">>

package/editions/tw5.com/tiddlers/filters/examples/unique Operator (Examples).tid

@@ -0,0 +1,8 @@
+created: 20210216203925301
+modified: 20210217003209935
+tags: [[unique Operator]] [[Operator Examples]]
+title: unique Operator (Examples)
+
+To remove duplicate entries from a list where deduplication has been prevented using the [[filter run prefix|Filter Expression]] `=`:
+
+<<.operator-example 1 """=[[E]] =[[A]] =[[B]] =[[C]] =[[C]] =[[D]] =[[C]] +[unique[]]""">>

package/editions/tw5.com/tiddlers/filters/examples/variance Operator (Examples).tid

@@ -0,0 +1,10 @@
+created: 20210426130620777
+modified: 20210426131553522
+tags: [[Operator Examples]] [[variance Operator]]
+title: variance Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.operator-example 1 "1 3 4 5 +[variance[]]">>
+
+Note that if there is no input the operator returns `NaN`
+<<.operator-example 2 "[title[NotATiddler]is[tiddler]get[price]] +[variance[]]">>

package/editions/tw5.com/tiddlers/filters/examples/zth Operator (Examples).tid

@@ -0,0 +1,10 @@
+created: 20211029023246203
+modified: 20211029023559616
+tags: [[Operator Examples]] [[zth Operator]]
+title: zth Operator (Examples)
+type: text/vnd.tiddlywiki
+
+<<.using-days-of-week>>
+
+<<.operator-example 1 "[list[Days of the Week]zth[]]">>
+<<.operator-example 2 "[list[Days of the Week]zth[5]]">>

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

@@ -1,14 +1,17 @@
+caption: fields
 created: 20140924115616653
-modified: 20150203184828000
+modified: 20200129165038748
+op-input: a [[selection of titles|Title Selection]]
+op-output: all the field names contained in the input tiddlers
+op-parameter: <<.from-version "5.1.22">> optional: a [[list of field names|TiddlerFields]]
+op-purpose: select all field names of the input titles
+op-suffix: <<.from-version "5.1.22">> optional: `include`, `exclude` parameter list
 tags: [[Filter Operators]] [[Field Operators]]
 title: fields Operator
 type: text/vnd.tiddlywiki
-caption: fields
-op-purpose: select all field names of the input titles
-op-input: a [[selection of titles|Title Selection]]
-op-parameter: none
-op-output: all the field names contained in the input tiddlers
 
-Each input title is processed in turn. Its list of field names is retrieved (in no particular order) and then [[dominantly appended|Dominant Append]] to the operator's output.
+Each input title is processed in turn. Its list of field names is retrieved (in no particular order) and then [[dominantly appended|Dominant Append]] to the operator's output. 
+
+<<.from-version "5.1.22">> If the `include` suffix is used, fields are only included, if they exist. It doesn't matter, if fields have a value. The `exclude` suffix is there for convenience, since it would be possible to use a second filter run. For more info see the examples.
 
 <<.operator-examples "fields">>

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

@@ -0,0 +1,49 @@
+caption: filter
+created: 20200929174420821
+modified: 20210522162551921
+op-input: a [[selection of titles|Title Selection]] passed as input to the filter
+op-neg-input: a [[selection of titles|Title Selection]] passed as input to the filter
+op-neg-output: those input titles that <<.em "do not">> pass the filter  <<.place S>>
+op-output: the [[selection of titles|Title Selection]] that pass the filter <<.place S>>
+op-parameter: a [[filter expression|Filter Expression]]
+op-parameter-name: S
+op-purpose: apply a subfilter to each input title and return the titles that return a non-empty result from the subfilter
+tags: [[Filter Operators]] [[Negatable Operators]]
+title: filter Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">> The <<.op filter>> operator runs a subfilter for each input title, and returns those input titles for which the subfilter returns a non-empty result (in other words the result is not an empty list). The results of the subfilter are thrown away.
+
+Simple filter operations can be concatenated together directly (eg `[tag[HelloThere]search[po]]`) but this doesn't work when the filtering operations require intermediate results to be computed. The <<.op filter>> operator can be used to filter on an intermediate result which is discarded. To take the same example but to also filter by those tiddlers whose text field is longer than 1000 characters:
+
+```
+<$vars myfilter="[get[text]length[]compare:integer:gteq[1000]]">
+<$list filter="[tag[HelloThere]search[po]filter<myfilter>]">
+<div>
+<$link>
+<$text text=<<currentTiddler>>/>
+</$link>
+</div>
+</$list>
+</$vars>
+```
+
+Note that within the subfilter, 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">>
+
+<<.tip "Compare with the similar [[subfilter|subfilter Operator]] operator which runs a subfilter and directly returns the results">>
+
+<<.tip "Compare with the analagous named filter run prefix `:filter`">>
+
+```
+\define larger-than-1k() [get[text]length[]compare:integer:gteq[1000]]
+
+{{{ [tag[HelloThere]filter<larger-than-1k>] }}}
+```
+
+is equivalent to:
+
+```
+{{{ [tag[HelloThere]] :filter[get[text]length[]compare:integer:gteq[1000]] }}}
+```
+
+<<.operator-examples "filter">>

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

@@ -0,0 +1,24 @@
+caption: format
+created: 20201020100834443
+modified: 20210524090002126
+op-input: a [[selection of titles|Title Selection]]
+op-output: input strings formatted according to the specified suffix <<.place B>>
+op-parameter: optional format string for the formats
+op-parameter-name: C
+op-purpose: format the input string according to one of supported formats
+op-suffix: one of supported formats
+op-suffix-name: B
+tags: [[Filter Operators]] [[String Operators]]
+title: format Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+The suffix <<.place B>> is one of the following supported string formats:
+
+|!Format |!Description |
+|^`date` |The input string is interpreted as a UTC date and displayed according to the DateFormat specified in the optional operator parameter. (Defaults to "YYYY MM DD 0hh:0mm") |
+|^`relativedate` |The input string is interpreted as a UTC date and displayed as the interval from the present instant. Any operator parameters are ignored. |
+|^`titlelist` |<<.from-version "5.2.0">>The input string wrapped in double square brackets if it contains a space. Appropriate for use in a [[title list|Title List]]. |
+
+<<.operator-examples "format">>

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

@@ -2,12 +2,13 @@ caption: has
 created: 20140410103123179
 modified: 20190518145446047
 op-input: a [[selection of titles|Title Selection]]
-op-neg-output: ''without suffix''<br>&raquo; those input tiddlers in which field <<.place F>> does <<.em not>> exist or has an empty value<br>''suffix `field`''<br>&raquo; those input tiddlers in which field <<.place F>> does <<.em not>> exist
+op-neg-output: ''without suffix''<br>&raquo; those input tiddlers in which field <<.place F>> does <<.em not>> exist or has an empty value<br>''suffix `field`''<br>&raquo; those input tiddlers in which field <<.place F>> does <<.em not>> exist<br>''suffix `index`''<br>&raquo; those input tiddlers in which index <<.place F>> does <<.em not>> exist
 op-output: ''without suffix''<br>&raquo; those input tiddlers in which field <<.place F>> has a non-empty value<br>''suffix `field`''<br>&raquo; those input tiddlers in which field <<.place F>> exists
-op-parameter: the name of a [[field|TiddlerFields]]
+op-parameter: the name of a [[field|TiddlerFields]]<br>''suffix `index`''<br>&raquo; those input tiddlers in which index <<.place F>> exists
+op-parameter: the name of a [[field|TiddlerFields]] or, optionally an [[index|TextReference]]
 op-parameter-name: F
 op-purpose: filter the input by field existence
-op-suffix: <<.from-version "5.1.14">> optionally, the keyword `field`
+op-suffix: <<.from-version "5.1.14">> optionally, the keyword `field` or <<.from-version "5.1.22">> optionally, the keyword `index`
 op-suffix-name: S
 tags: [[Filter Operators]] [[Common Operators]] [[Field Operators]] [[Negatable Operators]]
 title: has Operator

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

@@ -1,21 +1,22 @@
-created: 20140410103123179
-modified: 20190225130632157
-tags: [[Filter Operators]] [[Common Operators]] [[Negatable Operators]]
-title: is Operator
-type: text/vnd.tiddlywiki
 caption: is
-op-purpose: filter the input by fundamental category
+created: 20140410103123179
+modified: 20201107110947882
 op-input: a [[selection of titles|Title Selection]]
+op-neg-output: those input tiddlers that do <<.em not>> belong to category <<.place C>>
+op-output: those input tiddlers that belong to category <<.place C>>
 op-parameter: a category
 op-parameter-name: C
-op-output: those input tiddlers that belong to category <<.place C>>
-op-neg-output: those input tiddlers that do <<.em not>> belong to category <<.place C>>
+op-purpose: filter the input by fundamental category
+tags: [[Filter Operators]] [[Common Operators]] [[Negatable Operators]]
+title: is Operator
+type: text/vnd.tiddlywiki
 
 The parameter <<.place C>> is one of the following fundamental categories:
 
 |!Category |!Matches any tiddler title that... |
 |^`current` |is the [[current tiddler|Current Tiddler]] |
 |^`image` |has an image ContentType |
+|^`binary` |has a binary ContentType |
 |^`missing` |does not exist (other than possibly as a shadow tiddler), regardless of whether there are any links to it |
 |^`orphan` |has no [[hard links|Hard and Soft Links]] to it |
 |^`shadow` |is a [[shadow tiddler|ShadowTiddlers]], regardless of whether it has been overridden with a non-shadow tiddler |
@@ -24,6 +25,7 @@ The parameter <<.place C>> is one of the following fundamental categories:
 |^`tiddler` |exists as a non-shadow tiddler |
 |^`variable` |<<.from-version "5.1.20">> exists as a variable (whether or not that variable has a non-blank value) |
 |^`blank` |<<.from-version "5.1.20">> is blank (i.e. is a zero length string) |
+|^`draft` |<<.from-version "5.1.23">> is a draft of another tiddler. Synonym for `[has[draft.of]]` |
 
 If <<.place C>> is anything else an error message is returned. <<.from-version "5.1.14">> if <<.place C>> is blank, the output is passed through unchanged (in earlier versions an error message was returned).
 

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

@@ -7,20 +7,29 @@ op-output: the input with JSON string encodings applied
 op-parameter: 
 op-parameter-name: 
 op-purpose: apply JSON string encoding to a string
+op-suffix: <<.from-version "5.1.23">> optionally, the keyword `rawunicode`
+op-suffix-name: R
 tags: [[Filter Operators]] [[String Operators]]
 title: jsonstringify Operator
 type: text/vnd.tiddlywiki
 
 The following substitutions are made:
 
-|!Character |!Replacement |
-|`\` |`\\` |
-|`"` |`\\` |
-|`'` |`\\` |
-|`\r` (carriage return) |`\\r` |
-|`\n` (line feed) |`\\n` |
-|Characters from 0x00 to 0x1f |`\\x##` where ## is two hex digits |
-|Characters from 0x80 to 0xffff |`\\u####` where #### is four hex digits |
+|!Character |!Replacement |!Condition |
+|`\` |`\\` |Always |
+|`"` |`\"` |Always |
+|Carriage return (0x0d) |`\\r` |Always |
+|Line feed (0x0a) |`\\n` |Always |
+|Backspace (0x08) |`\\b` |Always |
+|Form field (0x0c) |`\\f` |Always |
+|Tab (0x09) |`\\t` |Always |
+|Characters from 0x00 to 0x1f |`\\u####` where #### is four hex digits |Always |
+|Characters from 0x80 to 0xffff|`\\u####` where #### is four hex digits |If `rawunicode` suffix is not present (default) |
+|Characters from 0x80 to 0xffff|Unchanged |If `rawunicode` suffix is present <<.from-version "5.1.23">> |
+
+<<.from-version "5.1.23">> If the suffix `rawunicode` is present, Unicode characters above 0x80 (such as ß, ä, ñ or 🎄) will be passed through unchanged. Without the suffix, they will be substituted with `\\u` codes, which was the default behavior before 5.1.23.
+
+<<.note """Technical note: Characters outside the Basic Multilingual Plane, such as 🎄 and other emojis, will be encoded as a UTF-16 surrogate pair, i.e. with two `\u` sequences.""">>
 
 Also see the [[stringify Operator]].
 

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

@@ -3,7 +3,7 @@ created: 20190613153225735
 modified: 20190613153321546
 op-input: a [[selection of titles|Title Selection]]
 op-output: replaces each input title with its length as an integer
-op-purpose: returns the lengths of each item in the list
+op-purpose: returns the number of characters of each item in the list
 tags: [[Filter Operators]]
 title: length Operator
 type: text/vnd.tiddlywiki

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

@@ -1,5 +1,5 @@
 created: 20140410103123179
-modified: 20150220161020000
+modified: 20211115092315020
 tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]]
 title: list Operator
 type: text/vnd.tiddlywiki
@@ -14,7 +14,7 @@ op-neg-output: those input titles that are <<.em not>> mentioned at <<.place R>>
 
 <<.place R>> can reference either a field or a property. See [[TextReference]] for the syntax.
 
-* If neither is specified, the <<.field list>> field is used by default. So `[list[T]]` outputs the titles listed in the <<.field list>> of tiddler T.
+* If neither is specified, the <<.field list>> field is used by default. So `[list[T]]` outputs the titles listed in the <<.field list>> field of tiddler T.
 * If <<.place R>> consists of <<.em only>> a field or a property, the tiddler part of the reference defaults to the [[current tiddler|Current Tiddler]]. So `[list[!!tags]]` outputs the titles listed in the <<.field tags>> field of the current tiddler.
 
 <<.operator-examples "list">>

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

@@ -0,0 +1,15 @@
+caption: log
+created: 20201120041113537
+modified: 20201120041443518
+op-input: a [[selection of titles|Title Selection]]
+op-output: the logarithm of each input title as numbers, with base <<.place N>> if specified otherwise base `e`
+op-parameter: a number
+op-parameter-name: N
+op-purpose: treating each input title as a number, return its logarithm with base equal to the numeric value of the operand if specified, otherwise base `e`
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Binary Mathematics Operators]]
+title: log Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+<<.operator-examples "log">>

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

@@ -0,0 +1,13 @@
+caption: median
+created: 20210417090137714
+modified: 20210426131553507
+op-input: a [[selection of titles|Title Selection]]
+op-output: the median of the input numbers
+op-purpose: treating each input title as a number, compute their median value
+tags: [[Filter Operators]] [[Mathematics Operators]]
+title: median Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.2.0">> See [[Mathematics Operators]] for an overview.
+
+<<.operator-examples "median">>

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

@@ -0,0 +1,12 @@
+caption: modulesproperty
+created: 20210919201126246
+modified: 20210919201347702
+op-input: a [[selection|Title Selection]] of modules
+op-output: the value of the module property as specified in the operand
+op-parameter: module property to retrieve
+op-purpose: retrieve a module property
+tags: [[Filter Operators]] [[Special Operators]]
+title: moduleproperty Operator
+type: text/vnd.tiddlywiki
+
+<<.operator-examples "moduleproperty">>

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

@@ -1,12 +1,14 @@
+caption: modules
 created: 20140410103123179
-modified: 20150203185838000
+modified: 20210919201148915
+op-input: a [[selection|Title Selection]] of module types
+op-output: the title of each module with any of the input types
+op-parameter: none
+op-purpose: select the names of all modules of the input module types
 tags: [[Filter Operators]] [[Special Operators]]
 title: modules Operator
 type: text/vnd.tiddlywiki
-caption: modules
-op-purpose: select the names of all modules of the input module types
-op-input: a [[selection|Title Selection]] of module types
-op-parameter: none
-op-output: the title of each module with any of the input types
+
+<<.from-version "5.2.0">>The <<.op modules>> filter allows two optional operands. When both are specified, it returns the modules with the module property specified in the first operand which has the value in the second operand.
 
 <<.operator-examples "modules">>

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

@@ -1,15 +1,17 @@
-created: 20150122204111000
-modified: 20150203192048000
-tags: [[Filter Operators]] [[Order Operators]]
-title: nth Operator
-type: text/vnd.tiddlywiki
 caption: nth
-op-purpose: select the <<.place N>>th input title
+created: 20150122204111000
+modified: 20211029023739450
 op-input: a [[selection of titles|Title Selection]]
+op-output: the <<.place N>>th input title
 op-parameter: an integer, defaulting to 1
 op-parameter-name: N
-op-output: the <<.place N>>th input title
+op-purpose: select the <<.place N>>th input title
+tags: [[Filter Operators]] [[Order Operators]]
+title: nth Operator
+type: text/vnd.tiddlywiki
 
 <<.place N>> is one-based. In other words, `nth[1]` has the same effect as the <<.olink first>> operator.
 
+<<.tip "See <<.olink zth>> for an equivalent operator with a 0 based parameter">>
+
 <<.operator-examples "nth">>

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

@@ -0,0 +1,23 @@
+caption: pad
+created: 20201129174215674
+modified: 20201129175301148
+op-input: a [[selection of titles|Title Selection]]
+op-output: the input titles padded to the specified length
+op-parameter: the <<.op pad>> operator accepts 1 or more parameters, see below for details
+op-purpose: returns each item in the list padded to the specified length
+op-suffix: (optional). Whether to pad by adding a "suffix" or "prefix". Defaults to "prefix".
+tags: [[Filter Operators]] [[String Operators]]
+title: pad Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+The <<.op pad>> operator requires at least one parameter which specifies the desired length of the input titles. A second optional parameter can be used to specify the string to pad with (defaults to "0").
+
+```
+[pad[<length>],[<padding-string>]]
+```
+* ''length'' : the desired final length of the input titles.
+* ''padding-string'': (optional). The string to use to pad to the desired length. Defaults to "0".
+
+<<.operator-examples "pad">>

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

@@ -0,0 +1,15 @@
+caption: power
+created: 20201120040720190
+modified: 20201120040852980
+op-input: a [[selection of titles|Title Selection]]
+op-output: the input as numbers, but with each one raised to the power of <<.place N>>
+op-parameter: a number
+op-parameter-name: N
+op-purpose: treating each input title as a number, raise it to the power of the numeric value of the operand
+tags: [[Filter Operators]] [[Mathematics Operators]] [[Binary Mathematics Operators]]
+title: power Operator
+type: text/vnd.tiddlywiki
+
+<<.from-version "5.1.23">>
+
+<<.operator-examples "power">>

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

@@ -1,14 +1,15 @@
 created: 20171221184734665
-modified: 20171229211834620
-tags: [[Filter Operators]] [[Negatable Operators]]
+modified: 20210907170339891
+tags: [[Filter Operators]] [[Negatable Operators]] [[Selection Constructors]]
 title: range Operator
 type: text/vnd.tiddlywiki
 caption: range
 op-purpose: generate a range of numbers
 op-input: ignored
-op-parameter: a range specification, like `[1,5]`
+op-parameter: a range specification, like `[1],[5]`
 op-parameter-name: N
 op-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>`
+op-neg-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>` in reverse order
 
 \define range_example(range)
 ```
@@ -18,20 +19,22 @@ op-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>`
 <$list variable=n filter="[range[$range$]]"><<n>> </$list>
 \end
 
-The `range` operator produces a list of numbers counting up or down.  It's useful for counting and numbering, or in combination with the [[Formula Plugin]].
+The `range` operator produces a list of numbers counting up or down.  It is useful for counting and numbering.
 
-|!Purpose|produce a range of numbers|
-|!Input|ignored.|
-|!Parameter|1-3 numbers separated by `,` or `;`.|
-|!Output|A series of evenly spaced numbers ranging from `<begin>` to `<end>`|
-|!`!` Output|As ''Output'', but with order reversed.|
+<<.from-version "5.2.0">> The range operator has been updated to use multiple operands to specify its parameters. Prior to this version, the range operator only had one operand, with the three parts delimited by `,`, `;` or `:`.
 
-The parameter has three forms:
+```
+[range[<begin>]]
+[range[<begin>],[<end>]]
+[range[<begin>],[<end>],[<step>]]
+```
 
-|Parameter|Output|h
-|`<end>`|Whole numbers up to `<end>`.|
-|`<begin>,<end>`|Numbers from `<begin>` to `<end>`, spaced by whole numbers.|
-|`<begin>,<end>,<step>`|Numbers from `<begin>` to `<end>` spaced out by `<step>`.|
+The behaviour depends on the number of operands:
+
+|Parameter |Output |h
+|`<end>` |Whole numbers up to `<end>` |
+|`<begin>,<end>` |Numbers from `<begin>` to `<end>`, spaced by whole numbers |
+|`<begin>,<end>,<step>` |Numbers from `<begin>` to `<end>` spaced out by `<step>` |
 
 Each part must be a number, and works as follows:
 
@@ -44,19 +47,18 @@ Each part must be a number, and works as follows:
 ** Cannot be zero.
 ** We always count from `<begin>` toward `<end>`, whether `<step>` is positive or negative.
 
-The number of decimal points in the output is fixed, and based on the parameter with the //most// decimal points.
+The number of decimal points in the output is fixed, and based on the operand with the //most// decimal points.
 
 To prevent the browser from freezing, `range` is currently limited to 10,000 values.
 
-
 !!Examples
 
 <<range_example "7">>
 
-<<range_example "1, 10">>
+<<range_example "1],[10">>
 
-<<range_example "17,13">>
+<<range_example "17],[13">>
 
-<<range_example "1.001, 5, 1">>
+<<range_example "1.001],[5],[1">>
 
-<<range_example ".5,1.4,.004">>
+<<range_example ".5],[1.4],[.004">>