This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Actions & Rules

An action is an automatic way of setting a certain attribute to a certain value (with the exception of system read-only attributes which can't be altered). In the context of this section, Rules should regarded as synonymous as they differ only in the scope of action. Similarly, here 'note' may be read to mean any note-like object (note, agent, adornment, etc.).

Case sensitivity: Action code operators are always case-sensitive (unlike export codes).

Agents can have actions. An agent performs its action on aliases of all the notes it finds that match its agent query.

Notes can have actions. A note performs its action, once - via $OnAdd, on all its children — but not on the children's children, i.e. descendants. A rule ($Rule) is a special form of note action whose effect is applied only to the note and not any children. To effect both the note and children, the same code can be added as both and action and a rule.

Making/deleting notes: action code can not create new notes nor delete existing ones.

Syntax: discussed under basic action code syntax. Note the point above re case-sensitivity.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Actions & Rules