on master help sign in
update terminators reference
commite035bf301d7b12d52ae22a2bf31b2a85dafdf6ed authorTinnus Napbus <admin@tinnus-napbus.xyz> dateSun 10 Apr 2022, 02:29 (5 years ago) parent69149b3
1 file changed+24−13
content/docs/hoon/reference/rune/terminators.md+24−13
content/docs/hoon/reference/rune/terminators.md+24−13
@@ -3,21 +3,24 @@ title = "Terminators -- and =="
33weight = 15
44template = "doc.html"
55+++
6−The `--` and `==` are used as terminators: `--` for core expressions, and `==` for terminating a 'running' or 'jogging' series of Hoon expressions.
76
8−## Runes
7+The `--` and `==` are used as terminators: `--` for core expressions, and `==`
8+for terminating a 'running' or 'jogging' series of Hoon expressions.
99
10−### `--` "hephep"
10+## `--` "hephep"
1111
12−##### Syntax
12+#### Syntax
1313
1414The `--` rune is used to indicate the end of a core expression.
1515
16−##### Discussion
16+#### Discussion
1717
18−The `|%`, `|_`, and `|^` runes are used to create cores that can have arbitrarily many arms. When you have defined all the desired arms in a core expression (using the `++`, `+$`, and `+*` runes), use `--` to terminate the expression.
18+The `|%`, `|_`, and `|^` runes are used to create cores that can have
19+arbitrarily many arms. When you have defined all the desired arms in a core
20+expression (using the `++`, `+$`, and `+*` runes), use `--` to terminate the
21+expression.
1922
20−##### Examples
23+#### Examples
2124
2225```
2326> =num |%
@@ -36,17 +39,25 @@ The `|%`, `|_`, and `|^` runes are used to create cores that can have arbitraril
363924
3740```
3841
39−### `==` "tistis"
42+---
4043
41−##### Syntax
44+## `==` "tistis"
4245
43−The `==` rune is used to indicate the end of a 'jogging' or 'running' series of Hoon expressions.
46+#### Syntax
4447
45−##### Discussion
48+The `==` rune is used to indicate the end of a 'jogging' or 'running' series of
49+Hoon expressions (runes that take a variable number of arguments).
4650
47−Certain runes are used to create expressions that may include arbitrarily many subexpressions. Such expressions are terminated with the `==` rune. For example, the `:*` and `:~` runes are used to create a cell of any length. (The latter is just like the former except that it adds a null value at the end of the cell.) For another example, the `%=` rune used used to make arbitrarily many changes to a given wing value.
51+#### Discussion
4852
49−##### Examples
53+Certain runes are used to create expressions that may include arbitrarily many
54+subexpressions. Such expressions are terminated with the `==` rune. For example,
55+the `:*` and `:~` runes are used to create a cell of any length. (The latter is
56+just like the former except that it adds a null value at the end of the cell.)
57+For another example, the `%=` rune used used to make arbitrarily many changes to
58+a given wing value.
59+
60+#### Examples
5061
5162```
5263> :* 2