on master help sign in
update terminators reference
e035bf3Tinnus Napbus
content/docs/hoon/reference/rune/terminators.md+24−13
@@ -3,21 +3,24 @@ title = "Terminators -- and =="
3weight = 15
3weight = 15
4template = "doc.html"
4template = "doc.html"
5+++
5+++
6−The `--` and `==` are used as terminators: `--` for core expressions, and `==` for terminating a 'running' or 'jogging' series of Hoon expressions.
7
6
8−## Runes
7+The `--` and `==` are used as terminators: `--` for core expressions, and `==`
8+for terminating a 'running' or 'jogging' series of Hoon expressions.
9
9
10−### `--` "hephep"
10+## `--` "hephep"
11
11
12−##### Syntax
12+#### Syntax
13
13
14The `--` rune is used to indicate the end of a core expression.
14The `--` rune is used to indicate the end of a core expression.
15
15
16−##### Discussion
16+#### Discussion
17
17
18+The `|%`, `|_`, and `|^` runes are used to create cores that can have
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.
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.
19
22
20−##### Examples
23+#### Examples
21
24
22```
25```
23> =num |%
26> =num |%
@@ -36,17 +39,25 @@ The `|%`, `|_`, and `|^` runes are used to create cores that can have arbitraril
3624
3924
37```
40```
38
41
39−### `==` "tistis"
42+---
40
43
41−##### Syntax
44+## `==` "tistis"
42
45
43−The `==` rune is used to indicate the end of a 'jogging' or 'running' series of Hoon expressions.
46+#### Syntax
44
47
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).
46
50
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
48
52
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+
49−##### Examples
60+#### Examples
50
61
51```
62```
52> :* 2
63> :* 2