Merge pull request #1436 from aelocson/filter-terminology

Revise filter terminology: constructors and modifiers

editions/tw5.com/tiddlers/concepts/AbsoluteOperators.tid

@@ -1,13 +0,0 @@
-created: 20150117204109000
-modified: 20150124185709000
-tags: Concepts
-title: Absolute Operators
-type: text/vnd.tiddlywiki
-
-The output of a [[filter|Filters]] step depends on its [[operator|Filter Operators]]:
-
-* Most operators perform <<.def relative>> to their input. They examine each input title in turn and filter out any that don't match. Such steps narrow down the output of a run.
-
-* <<.def Absolute>> operators ignore their input and generate an independent output instead.
-
-A good example of an absolute operator is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is relative, so `[title[A]field:title[B]` outputs nothing at all.

editions/tw5.com/tiddlers/concepts/SelectionConstructors.tid

@@ -0,0 +1,13 @@
+created: 20150117204109000
+modified: 20150129133830000
+tags: Concepts
+title: Selection Constructors
+type: text/vnd.tiddlywiki
+
+The output of a [[filter|Filters]] step depends on its [[operator|Filter Operators]]:
+
+* Most operators derive their output from their input. For example, many of them output a subset of their input, and thus truly live up to the name of <<.word filters>>, narrowing down the overall output of the containing [[run|Filter Run]]. These operators are called <<.def "selection modifiers">>.
+
+* A few operators ignore their input and generate an independent output instead. These are called <<.def "selection constructors">>: they construct an entirely new [[selection|Title Selection]].
+
+A good example of a constructor is <<.olink title>>. The output of `[title[A]title[B]]` is just <<.tid B>>. But the <<.olink field>> operator is a modifier, so `[title[A]field:title[B]` outputs nothing at all.

editions/tw5.com/tiddlers/filters/FilterOperators.tid

@@ -1,5 +1,5 @@
 created: 20140410103123179
-modified: 20150124200331000
+modified: 20150129133657000
 tags: Concepts Filters
 title: Filter Operators
 type: text/vnd.tiddlywiki
@@ -39,4 +39,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 are [[absolute|Absolute Operators]]. 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]].

editions/tw5.com/tiddlers/filters/all.tid

@@ -1,6 +1,6 @@
 created: 20140410103123179
-modified: 20150124200847000
+modified: 20150129133636000
-tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]]
+tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]]
 title: all Operator
 type: text/vnd.tiddlywiki
 caption: all

editions/tw5.com/tiddlers/filters/commands.tid

@@ -1,6 +1,6 @@
 created: 20140410103123179
-modified: 20150124155303000
+modified: 20150129133643000
-tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
+tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
 title: commands Operator
 type: text/vnd.tiddlywiki
 caption: commands

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

@@ -1,6 +1,6 @@
 created: 20150111145738451
-modified: 20150124150912000
+modified: 20150129133647000
-tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
+tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
 title: editions Operator
 type: text/vnd.tiddlywiki
 caption: editions

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

@@ -1,6 +1,6 @@
 created: 20140410103123179
-modified: 20150124203324000
+modified: 20150129133705000
-tags: [[Filter Operators]] [[Field Operators]] [[Absolute Operators]] [[Negatable Operators]]
+tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]]
 title: list Operator
 type: text/vnd.tiddlywiki
 caption: list

editions/tw5.com/tiddlers/filters/moduletypes.tid

@@ -1,6 +1,6 @@
 created: 20140410103123179
-modified: 20150124170640000
+modified: 20150129133709000
-tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]]
+tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]]
 title: moduletypes Operator
 type: text/vnd.tiddlywiki
 caption: moduletypes

editions/tw5.com/tiddlers/filters/syntax/FilterRun.tid

@@ -1,5 +1,5 @@
 created: 20150124182117000
-modified: 20150124190233000
+modified: 20150129133716000
 tags: [[Filter Syntax]]
 title: Filter Run
 type: text/vnd.tiddlywiki
@@ -19,7 +19,7 @@ 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.
 
-{{Absolute Operators}}
+{{Selection Constructors}}
 
 The lower three options in the diagram match syntax like `HelloThere`, `"HelloThere"`, `'HelloThere'` and `"Filter Operators"`. They are short for `[title[...]]`.
 

editions/tw5.com/tiddlers/filters/title.tid

@@ -1,6 +1,6 @@
 created: 20140410103123179
-modified: 20150124192051000
+modified: 20150129133732000
-tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]] [[Negatable Operators]]
+tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]] [[Negatable Operators]]
 title: title Operator
 type: text/vnd.tiddlywiki
 caption: title
@@ -17,6 +17,6 @@ negationOutput="the input, but with tiddler <<.place t>> filtered out if it exis
 
 `[title[An Example]]` can be shortened to `[[An Example]]`, because <<.op title>> is the default filter operator.
 
-<<.op title>> is an [[absolute operator|Absolute Operators]] (except in the form `!title`), but <<.olink2 "field:title" field>> is relative.
+<<.op title>> is a [[constructor|Selection Constructors]] (except in the form `!title`), but <<.olink2 "field:title" field>> is a [[modifier|Selection Constructors]].
 
 <<.operator-examples "title">>