doc: yambar-modules: script: stress the importance of an empty line after a transaction

Closes #34
This commit is contained in:
Daniel Eklöf 2021-02-21 20:27:29 +01:00
parent cc6be3a923
commit 153d7a2ffa
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F

View file

@ -738,8 +738,11 @@ terminated. Or, the script can continue executing and update yambar
with new tag sets, either periodically, or when there is new data to
feed to yambar.
Tag sets, or _transactions_, are separated by an empty line. Each
_tag_ is a single line on the format:
Tag sets, or _transactions_, are separated by an empty line
(e.g. *echo ""*). The empty line is required to commit (update) the
tag even for only one transaction.
Each _tag_ is a single line on the format:
```
name|type|value
@ -754,14 +757,16 @@ Example:
```
var1|string|hello
var2|int|13
<empty>
var1|string|world
var2|int|37
<empty>
```
The example above consists of two transactions. Each transaction has
two tags: one string tag and one integer tag. The second transaction
replaces the tags from the first transaction.
replaces the tags from the first transaction. Note that **both**
transactions need to be terminated with an empty line.
Supported _types_ are: