This certianly needs clarification. As I understand it, In the calling filter the function is “invoked once with all the input titles, then moves on to the next part of the calling filter”, ie after where the function is named, but what happens next, the function is processed “as a filter” and filters are effectivly a title at a time. “the filter is invoked once, then moves on to the next part of the filter”, In the below example the next part is either 1. Nothing, 2. a per-title filter, 3. all[]
tiddlers from next filter step.
\function each.tiddler() [!is[blank]]
1. {{{ [tag[Filters]] }}} <!-- all tiddlers with tag Filters -->
2. {{{ [tag[Filters]each.tiddler[]] }}} <!-- all tiddlers with tag Filters calling each.tiddler -->
3. {{{ [tag[Filters]] [each.tiddler[]] }}} <!-- all tiddlers with tag Filters and all tiddlers (calling) calling each.tiddler -->
FYI: In the above function is “invoked” once for each title given, since a title is never blank, it lists each title given.
- Try making each.tiddler definition contain nothing.
The thing is I rarelly have trouble using filters, I just know how they work, after more than a decade of using them, but the language, or metaphores we use to describe them could be improved.