on master help sign in
virtual arms are aliases
6bfa63esyzygyzer
reference/hoon-expressions/rune/lus.md+6−10
@@ -135,7 +135,7 @@ Any Hoon expression, `q`, may be used to define the arm computation.
135
135
136### +* "lustar"
136### +* "lustar"
137
137
138−Used to assign an alias to doors and define virtual arms.
138+Defines aliases within doors.
139
139
140##### Syntax
140##### Syntax
141
141
@@ -158,12 +158,8 @@ type of lus arm.
158##### Discussion
158##### Discussion
159
159
160The primary use of `+*` is to assign aliases to doors (see Examples below).
160The primary use of `+*` is to assign aliases to doors (see Examples below).
161−However, they may also be used to define "virtual arms" that do not count
162−towards the number of arms in cores that requires a specific
161+Aliases given by `+*` do not count towards the number of arms in the door, which
163−number of arms, such as Gall app cores. Put another way, no matter how many virtual
162+can be important for things like Gall app cores.`
164−arms are defined in a `+*` statement, the interpreter does not count it towards
165−the number of arms in the core. How these virtual arms really work can be understood more
166−precisely by the following.
167
163
168Under the hood, `+*` gets compiled as `=*`'s. `+* foo bar` rewrites each `++`
164Under the hood, `+*` gets compiled as `=*`'s. `+* foo bar` rewrites each `++`
169arm beneath it in the core to include
165arm beneath it in the core to include
@@ -199,9 +195,9 @@ To assign an alias to a door, we often write the following.
199This is the idomatic way to assign the alias `this` to the door.
195This is the idomatic way to assign the alias `this` to the door.
200
196
201Sometimes cores, such as Gall app cores, have a fixed number of arms, but you'd
197Sometimes cores, such as Gall app cores, have a fixed number of arms, but you'd
202−like to include more. This is where virtual arms may be of use. We note that it
198+like to include more. This is where aliases employed as "virtual arms" may be of
203−is often better style to compose cores with `=>` or `=<` to add more arms to a
199+use. We note that it is often better style to compose cores with `=>` or `=<` to add more arms to a
204−Gall app, though. This usage of `+*` is controversial and should be minimized.
200+Gall app core. This usage of `+*` is controversial and should be minimized.
205
201
206```hoon
202```hoon
207|_ =bowl:gall
203|_ =bowl:gall