From a5d54a0adaadfb34914d9380111f352fcc19de0a Mon Sep 17 00:00:00 2001 From: Astrid Elocson Date: Thu, 29 Jan 2015 13:23:24 +0000 Subject: [PATCH 1/3] Rename AbsoluteOperators.tid --- .../{AbsoluteOperators.tid => ConstructorsAndModifiers.tid} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename editions/tw5.com/tiddlers/concepts/{AbsoluteOperators.tid => ConstructorsAndModifiers.tid} (100%) diff --git a/editions/tw5.com/tiddlers/concepts/AbsoluteOperators.tid b/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid similarity index 100% rename from editions/tw5.com/tiddlers/concepts/AbsoluteOperators.tid rename to editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid From 9a7bda28e9e4987a20dfcf0bde538a2f59ad4423 Mon Sep 17 00:00:00 2001 From: Astrid Elocson Date: Thu, 29 Jan 2015 13:40:18 +0000 Subject: [PATCH 2/3] Revise filter terminology: constructors and modifiers --- .../tiddlers/concepts/ConstructorsAndModifiers.tid | 10 +++++----- editions/tw5.com/tiddlers/filters/FilterOperators.tid | 4 ++-- editions/tw5.com/tiddlers/filters/all.tid | 4 ++-- editions/tw5.com/tiddlers/filters/commands.tid | 4 ++-- editions/tw5.com/tiddlers/filters/editions.tid | 4 ++-- editions/tw5.com/tiddlers/filters/list.tid | 4 ++-- editions/tw5.com/tiddlers/filters/moduletypes.tid | 4 ++-- editions/tw5.com/tiddlers/filters/syntax/FilterRun.tid | 4 ++-- editions/tw5.com/tiddlers/filters/title.tid | 6 +++--- 9 files changed, 22 insertions(+), 22 deletions(-) diff --git a/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid b/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid index b6736293b..ad8199734 100644 --- a/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid +++ b/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid @@ -1,13 +1,13 @@ created: 20150117204109000 -modified: 20150124185709000 +modified: 20150129133830000 tags: Concepts -title: Absolute Operators +title: Selection Constructors 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. +* 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">>. -* <<.def Absolute>> operators ignore their input and generate an independent output instead. +* 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 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. +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. diff --git a/editions/tw5.com/tiddlers/filters/FilterOperators.tid b/editions/tw5.com/tiddlers/filters/FilterOperators.tid index 80b3755ab..8ad03c34c 100644 --- a/editions/tw5.com/tiddlers/filters/FilterOperators.tid +++ b/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]]. diff --git a/editions/tw5.com/tiddlers/filters/all.tid b/editions/tw5.com/tiddlers/filters/all.tid index 39e250be7..69c0913a5 100644 --- a/editions/tw5.com/tiddlers/filters/all.tid +++ b/editions/tw5.com/tiddlers/filters/all.tid @@ -1,6 +1,6 @@ created: 20140410103123179 -modified: 20150124200847000 -tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]] +modified: 20150129133636000 +tags: [[Filter Operators]] [[Common Operators]] [[Selection Constructors]] title: all Operator type: text/vnd.tiddlywiki caption: all diff --git a/editions/tw5.com/tiddlers/filters/commands.tid b/editions/tw5.com/tiddlers/filters/commands.tid index de6b2abe0..854fe89d7 100644 --- a/editions/tw5.com/tiddlers/filters/commands.tid +++ b/editions/tw5.com/tiddlers/filters/commands.tid @@ -1,6 +1,6 @@ created: 20140410103123179 -modified: 20150124155303000 -tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]] +modified: 20150129133643000 +tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]] title: commands Operator type: text/vnd.tiddlywiki caption: commands diff --git a/editions/tw5.com/tiddlers/filters/editions.tid b/editions/tw5.com/tiddlers/filters/editions.tid index f7ce355e6..4c2ee9e4d 100644 --- a/editions/tw5.com/tiddlers/filters/editions.tid +++ b/editions/tw5.com/tiddlers/filters/editions.tid @@ -1,6 +1,6 @@ created: 20150111145738451 -modified: 20150124150912000 -tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]] +modified: 20150129133647000 +tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]] title: editions Operator type: text/vnd.tiddlywiki caption: editions diff --git a/editions/tw5.com/tiddlers/filters/list.tid b/editions/tw5.com/tiddlers/filters/list.tid index fcdb7581e..49f791021 100644 --- a/editions/tw5.com/tiddlers/filters/list.tid +++ b/editions/tw5.com/tiddlers/filters/list.tid @@ -1,6 +1,6 @@ created: 20140410103123179 -modified: 20150124203324000 -tags: [[Filter Operators]] [[Field Operators]] [[Absolute Operators]] [[Negatable Operators]] +modified: 20150129133705000 +tags: [[Filter Operators]] [[Field Operators]] [[Selection Constructors]] [[Negatable Operators]] title: list Operator type: text/vnd.tiddlywiki caption: list diff --git a/editions/tw5.com/tiddlers/filters/moduletypes.tid b/editions/tw5.com/tiddlers/filters/moduletypes.tid index d47d1580d..e931d37ec 100644 --- a/editions/tw5.com/tiddlers/filters/moduletypes.tid +++ b/editions/tw5.com/tiddlers/filters/moduletypes.tid @@ -1,6 +1,6 @@ created: 20140410103123179 -modified: 20150124170640000 -tags: [[Filter Operators]] [[Special Operators]] [[Absolute Operators]] +modified: 20150129133709000 +tags: [[Filter Operators]] [[Special Operators]] [[Selection Constructors]] title: moduletypes Operator type: text/vnd.tiddlywiki caption: moduletypes diff --git a/editions/tw5.com/tiddlers/filters/syntax/FilterRun.tid b/editions/tw5.com/tiddlers/filters/syntax/FilterRun.tid index ecc5e381b..640891906 100644 --- a/editions/tw5.com/tiddlers/filters/syntax/FilterRun.tid +++ b/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[...]]`. diff --git a/editions/tw5.com/tiddlers/filters/title.tid b/editions/tw5.com/tiddlers/filters/title.tid index 5dda38e29..53966239f 100644 --- a/editions/tw5.com/tiddlers/filters/title.tid +++ b/editions/tw5.com/tiddlers/filters/title.tid @@ -1,6 +1,6 @@ created: 20140410103123179 -modified: 20150124192051000 -tags: [[Filter Operators]] [[Common Operators]] [[Absolute Operators]] [[Negatable Operators]] +modified: 20150129133732000 +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">> From 3dd4f943ce9e48a464a2593b68f3fac1912f4163 Mon Sep 17 00:00:00 2001 From: Astrid Elocson Date: Thu, 29 Jan 2015 13:41:11 +0000 Subject: [PATCH 3/3] Rename to SelectionConstructors.tid --- .../{ConstructorsAndModifiers.tid => SelectionConstructors.tid} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename editions/tw5.com/tiddlers/concepts/{ConstructorsAndModifiers.tid => SelectionConstructors.tid} (100%) diff --git a/editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid b/editions/tw5.com/tiddlers/concepts/SelectionConstructors.tid similarity index 100% rename from editions/tw5.com/tiddlers/concepts/ConstructorsAndModifiers.tid rename to editions/tw5.com/tiddlers/concepts/SelectionConstructors.tid