on master help sign in
=* alias not macro
90ab0dddrbeefsupreme
content/docs/hoon/reference/rune/tis.md+7−3
@@ -423,11 +423,11 @@ Regular: **running**.
423
423
424### `=*` "tistar"
424### `=*` "tistar"
425
425
426−`[%tstr p=term q=hoon r=hoon]`: define a macro.
426+`[%tstr p=term q=hoon r=hoon]`: define an alias.
427
427
428##### Produces
428##### Produces
429
429
430−`r`, compiled with a subject in which `p` is a macro for `q`.
430+`r`, compiled with a subject in which `p` is an alias for `q`.
431
431
432##### Syntax
432##### Syntax
433
433
@@ -435,7 +435,11 @@ Regular: **3-fixed**.
435
435
436##### Discussion
436##### Discussion
437
437
438+The difference between aliasing and pinning is that pinning changes the subject,
439+but for aliasing the subject noun stays the same. This allows you to "write"
440+through it to the original subject axis. The alias'd expression, `q`,
438−The difference between macroing and pinning is that pinning changes the subject, but for macroing the subject noun stays the same. The macro'd expression, `q`, is recorded in the type information of `p`. `q` is calculated every time you use the `p` macro.
441+is recorded in the type information of `p`. `q` is calculated every time you use
442+the `p` alias.
439
443
440##### Examples
444##### Examples
441
445