From a5d380006ead9923d75918277e6297eba7c58cdf Mon Sep 17 00:00:00 2001 From: Tobias Beer Date: Sun, 10 Jan 2016 10:13:23 +0100 Subject: [PATCH] updates to overall operators docs * info on default input being `all[tiddlers]` * clearer column layout * removed fiddly done button --- .../tw5.com/tiddlers/filters/FilterOperators.tid | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/editions/tw5.com/tiddlers/filters/FilterOperators.tid b/editions/tw5.com/tiddlers/filters/FilterOperators.tid index 22c7245f5..a66884b74 100644 --- a/editions/tw5.com/tiddlers/filters/FilterOperators.tid +++ b/editions/tw5.com/tiddlers/filters/FilterOperators.tid @@ -1,5 +1,5 @@ created: 20140410103123179 -modified: 20150917193612610 +modified: 20160110091222187 tags: Filters title: Filter Operators type: text/vnd.tiddlywiki @@ -7,24 +7,28 @@ type: text/vnd.tiddlywiki \define .operator-rows(filter) <$list filter="$filter$"> <$link to={{!!title}}>{{!!caption}} -{{!!op-purpose}} <$list filter="[all[current]tag[Common Operators]]">{{$:/core/images/done-button}} +{{!!op-purpose}} +<$list filter="[all[current]tag[Common Operators]]">✓ <$list filter="[all[current]tag[Negatable Operators]]">`!` \end \define .group-heading(_) -$_$ +$_$ \end A <<.def "filter operator">> is a predefined keyword attached to an individual [[step|Filter Step]] of a [[filter|Filters]]. It defines the particular action of that step. -The following table lists all the core operators. The commonest ones are checkmarked. The third column indicates which operators allow <$link to="Filter Step">the ! prefix to reverse their meaning. +''Important:'' Each first [[step|Filter Step]] of a [[filter run|Filter Run]] not given any input titles receives the output of <$link to="all Operator">[all[tiddlers]] as its input. + +The following table lists all core operators, the most common ones marked ✓. The last column indicates whether an operator allows ''negation'' using the <$link to="Filter Step">! prefix. For specifics as to each operator's negated output please refer to its documentation. - + + <<.operator-rows "[tag[Filter Operators]!tag[Order Operators]!tag[String Operators]!tag[Tag Operators]!tag[Special Operators]sort[]]">> <<.group-heading "Order Operators">> @@ -41,4 +45,4 @@ The following table lists all the core operators. The commonest ones are checkma A typical step is written as `[operator[parameter]]`, although not all of the operators need a [[parameter|Filter Parameter]]. -Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few [[construct an entirely new selection|Selection Constructors]] instead. For the exact rules, see [[Filter Syntax]]. +Most steps process the [[selection of titles|Title Selection]] that are supplied as their input, but a few [[construct an entirely new selection|Selection Constructors]] instead. For the exact rules, see [[Filter Syntax]]. \ No newline at end of file
Operator PurposeNeg`!`