git.iko.soy/urbit.org
on master help sign in
sm/ and ts/
050e818Henry Ault
docs/system/hoon/runes/sm/smcl.md+6−38
compare with master
unifiedsplit
@@ -1,48 +1,16 @@
1−`;: semcol`
1+# ``, `;:`, "semcol" `{$wad p/twig q/(list twig)}`
2−====
3
2
4Fold over tuple.
3Fold over tuple.
5
4
6Apply a binary function `p` to a tuple `q` with n elements. Similar to folding over the tuple `q`.
5Apply a binary function `p` to a tuple `q` with n elements. Similar to folding over the tuple `q`.
7
6
8−Syntax
7+Regular form: *running*
9−======
10
8
11−`;:` is a synthetic rune that applies `p`, a binary gate, to the n-ary
9+Irregular form:
12−tuple `q`. `;:` is similar to folding over the tuple `q`, producing the
13−final result.
14
10
15−Produces
11+`:(p i.q i.t.q i.t.t.q) ;:(p i.q i.t.q i.t.t.q)`
16−--------
17
12
18−Twig: `[%smcl p=twig q=tusk]`
19−
20−Accepts
21−-------
22−
23−`p` is a [`++twig`](). `q` is a [`++tusk`](), a list of twigs.
24−
25−Tall form
26−---------
27−
28− ;: p
29− i.q
30− i.t.q
31− i.t.t.q
32− ==
33−
34−Wide form
35−---------
36−
37− ;:(p i.q i.t.q i.t.t.q)
38−
39−Irregular form
40−--------------
41−
42− :(p i.q i.t.q i.t.t.q)
43−
44−Examples
13+Examples:
45−--------
46
14
47 ~zod/try=> (add 3 (add 4 5))
15 ~zod/try=> (add 3 (add 4 5))
48 12
16 12
@@ -61,5 +29,5 @@ gate `++add`.
61 ~zod/try=> `tape`(weld "foo" (weld "bar" "baz"))
29 ~zod/try=> `tape`(weld "foo" (weld "bar" "baz"))
62 "foobarbaz"
30 "foobarbaz"
63
31
64−Following on from our previous example, using `;:` with [`++weld`]() is
32+Following on from our previous example, using `;:` with `++weld` is
65convenient for concatenating multiple strings.
33convenient for concatenating multiple strings.
docs/system/hoon/runes/sm/smcn.mddeleted−82
@@ -1,82 +0,0 @@
1−`;% semcen`
2−====
3−
4−`%-` in `++sail`.
5−
6−Performs the same function as `%-`, except within XML template syntax
7−(aka sail). Passes `q`, a list of n arguments, to function `p`.
8−
9−Produces
10−--------
11−
12−Twig: [`++marl`]()
13−
14−Accepts
15−-------
16−
17−`p` is a [`++twig`]().
18−
19−Tall form
20−---------
21−
22− ;% p
23−
24−Wide form
25−---------
26−
27− %{p}
28−
29−(within quoted form)
30−
31−Examples
32−--------
33−
34− ~zod/try=>
35− ;div:"%{|=(a=marl (weld a a))} repeat"
36− [ [%div ~]
37− ~[
38− [g=[n=%$ a=~[[n=%$ v=" repeat"]]] c=~]
39− [g=[n=%$ a=~[[n=%$ v=" repeat"]]] c=~]
40− ]
41− ]
42− ~zod/try=>
43− (poxo ;div:"%{|=(a=marl (weld a a))} repeat")
44− "<div> repeat repeat</div>"
45−
46−In this simple example we use a function, `|=(a=marl (weld a a))` that
47−produces a `++marl` twice. Using the irregular form of `;%` we produce a
48−repeated child node `'repeat'`. [`++poxo`]() prints our result in XML.
49−
50− ~zod/try=>
51− ;=
52− ;% |=(a=marl (turn a |=(b=manx ;script(src (poxo b));)))
53− ; /gep/hart.js
54− ; /main/lib/urb.js
55− ; //cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.js
56− ==
57− ~[
58− [[%script [%src "/gep/hart.js
59− "] ~] ~]
60− [[%script [%src "/main/lib/urb.js
61− "] ~] ~]
62− [ [ %script
63− [%src "//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.js
64− "]
65− ~
66− ]
67− ~
68− ]
69− ]
70− ~zod/try=>
71− %- many:poxo :_ ~
72− ;=
73− ;% |=(a=marl (turn a |=(b=manx ;script(src (poxo b));)))
74− ; /gep/hart.js
75− ; /main/lib/urb.js
76− ; //cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.js
77− ==
78− "<script src="/gep/hart.js"></script><script src="/main/lib/urb.js"></script><script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.js"></script>"
79−
80−Here we go through a similar example, passing a list of urls for a
81−script tag to a gate that produces a `<script>` tag. Since we produce
82−multiple tags, we use `many:poxo` to print our result as XML.
docs/system/hoon/runes/sm/smdq.mddeleted−46
@@ -1,46 +0,0 @@
1−`;" semdoq`
2−====
3−
4−Make string.
5−
6−`semdoq` is a synthetic rune used to make strings, interpreted or not.
7−
8−Produces
9−--------
10−
11−Twig: `[%smdq p=(list beer)]`
12−
13−Sample
14−------
15−
16−`p` is a [`++list`]() of [`++beer`]()s.
17−
18−Irregular form
19−--------------
20−
21− "foo"
22−
23−Examples
24−--------
25−
26− ~zod/try=> "foo"
27− "foo"
28− ~zod/try=> "bar"
29− "bar"
30−
31−Here we see our most common case of `semdoq`, producing strings ([`++tape`]()s).
32−
33− ~zod/try=> "ba{<+(2)>}r"
34− "ba3r"
35−
36−In this case we include some simple string interpolation using `{` and
37−`}`.
38−
39− ~zod/try=> (ream '"foo"')
40− [%smdq p=~[102 111 111]]
41− ~zod/try=> (ream '"ba{<+(2)>}r"')
42− [ %smdq
43− p=~[98 97 [~ p=[%cltr p=~[[%hxgl p=~[[%dtls p=[%dtzy p=%ud q=2]]]]]]] 114]
44− ]
45−
46−Using [`++ream`]() we can see how our previous expressions are parsed.
docs/system/hoon/runes/sm/smhp.mddeleted−45
@@ -1,45 +0,0 @@
1−`;- semhep`
2−====
3−
4−Interpolate string.
5−
6−Interpolates a string (aka [++tape]()) into a [`++marl`](), our datastructure for XML.
7−
8−Produces
9−--------
10−
11−Twig: tape
12−
13−Sample
14−------
15−
16−`p` is a [`++twig`]().
17−
18−Tall form
19−---------
20−
21− ;- a
22−
23−Wide form
24−---------
25−
26− -{a}
27−
28−(within quoted form)
29−
30−Examples
31−--------
32−
33− ~zod/try=>
34− =+ c="contents!"
35− ;div: -{c}
36− [[%div ~] [[%~. [%~. "contents!"] ~] ~] ~]
37− ~zod/try=>
38− %- poxo
39− =+ c="contents!"
40− ;div: -{c}
41− "<div>contents!</div>"
42−
43−Here we add `c` to our context as a `++tape`, and interpolate it within
44−our `;div` using the irregular form of `;-`. By using [`++poxo`]() we
45−can see our result in XML form.
docs/system/hoon/runes/sm/smls.mddeleted−48
@@ -1,48 +0,0 @@
1−`;+ semlus`
2−====
3−
4−Interpolate `++manx`.
5−
6−`;+` is a virtual rune used within [`++sail`]() to interpolate a manx.
7−`;+` is useful when you need to dynamically produce a tag in a `++sail`
8−block.
9−
10−Produces
11−--------
12−
13−Twig: [`++manx`]()
14−
15−Sample
16−------
17−
18−`p` is a twig
19−
20−Tall form
21−---------
22−
23− ;+ a
24−
25−Wide form
26−---------
27−
28− +{a}
29−
30−(within quoted form)
31−
32−Examples
33−--------
34−
35− ~zod/try=>
36− =+ tag=;p(class "doc")
37− ;div ;+ tag
38− ==
39− [[%div ~] [[%p [%class "doc"] ~] ~] ~]
40− ~zod/try=>
41− %- poxo
42− =+ tag=;p(class "doc")
43− ;div ;+ tag
44− ==
45− "<div><p class="doc"></p></div>"
46−
47−Here we add `tag` to our context as a `;p` tag and use `;+` to add it to
48−our `;div`. Using [`++poxo`]() we can print our result as XML.
docs/system/hoon/runes/sm/smsg.md+4−28
@@ -1,36 +1,12 @@
1−`;~ semsig`
1+# `:dip`, `;~`, "semsig" `{$dip p/twig q/(list twig)}`
2−====
3
2
4Monad composer.
3Monad composer.
5
4
6−`;~` is a synthetic rune used to compose functions under a monad.
5+Composes a list of functions `p` and `q` under a monad. `q` can be 1 or more functions.
7
6
8−Produces
7+Regular form: 1-fixed, `q` is *running*
9−--------
10
8
11−Twig: `[%smsg p=(list beer)]`
9+Examples:
12−
13−Accepts
14−-------
15−
16−`p` is a [`++list`]() of [`++beer`]().
17−
18−Tall form
19−---------
20−
21− ;~ p
22− i.q
23− i.t.q
24− i.t.t.q
25− ==
26−
27−Wide form
28−---------
29−
30− ;~(p i.q i.t.q i.t.t.q)
31−
32−Examples
33−--------
34
10
35 ~zod/try=> =cmp |=([a=tape b=$+(char tape)] `tape`?~(a ~ (weld (b i.a) t.a)))
11 ~zod/try=> =cmp |=([a=tape b=$+(char tape)] `tape`?~(a ~ (weld (b i.a) t.a)))
36 ~zod/try=> ;~(cmp trip)
12 ~zod/try=> ;~(cmp trip)
docs/system/hoon/runes/sm/smsm.md+4−33
@@ -1,40 +1,11 @@
1−`;; semsem`
1+# `:fry`, `;;`, "semsem" `{$fry p/twig q/twig}`
2−====
3
2
4Fixpoint.
3Fixpoint.
5
4
6−`;;` is a synthetic rune that types `q` as a fixpoint of `p`. More
7−specifically, `;;` slams `q` through gate `p`, asserting that the
5+Slams `q` through gate `p`, asserting that the
8−resulting noun [`.=`]() the original, and produces it.
6+resulting noun is equal to `.=` the original, and produces it.
9
7
10−See also
8+Examples: XX Review closely
11−--------
12−
13−[`++hard`]()
14−
15−Produces
16−--------
17−
18−Twig: `[%smsm p=twig q=twig]`
19−
20−Accepts
21−-------
22−
23−`p` is a [`++twig`](). `q` is a twig.
24−
25−Tall form
26−---------
27−
28− ;; p
29− q
30−
31−Wide form
32−---------
33−
34− ;;(p q)
35−
36−Examples
37−--------
38
9
39 ~zod/try=> ^-(tape ~[97 98 99])
10 ~zod/try=> ^-(tape ~[97 98 99])
40 ! type-fail
11 ! type-fail
docs/system/hoon/runes/sm/smtr.mddeleted−50
@@ -1,50 +0,0 @@
1−`;* semtar`
2−===========
3−
4−Interpolate list of XML nodes.
5−
6−Interpolates a list of XML nodes within our XML template syntax (aka sail)
7−
8−Produces
9−--------
10−
11−Twig: [`++marl`]()
12−
13−Accepts
14−-------
15−
16−`p` is a [`++twig`]()
17−
18−Tall form
19−---------
20−
21− ;* a
22−
23−Wide form
24−---------
25−
26− *{a}
27−
28−(within quoted form)
29−
30−Examples
31−--------
32−
33− ~zod/try=> ;div ;* ~[;hi; ;p;]
34− ==
35− [[%div ~] [[%hi ~] ~] [[%p ~] ~] ~]
36− ~zod/try=> ;div:"*{~[;hi; ;p;]}"
37− [[%div ~] [[%hi ~] ~] [[%p ~] ~] ~]
38− ~zod/try=> ;div:"a*{~[;hi; ;p;]}b"
39− [ [%div ~]
40− [[%~. [%~. "a"] ~] ~]
41− [[%hi ~] ~]
42− [[%p ~] ~]
43− [[%~. [%~. "b"] ~] ~]
44− ~
45− ]
46− ~zod/try=> (poxo ;div:"a*{~[;hi; ;p;]}b")
47− "<div>a<hi></hi><p></p>b</div>"
48−
49−Here we use the tall, wide and irregular forms of `;*` to interpolate a
50−list of `++marl` into our containing [`++manx`]() `;div`.
docs/system/hoon/runes/sm/smzz.mddeleted−79
@@ -1,79 +0,0 @@
1−`semzaz`
2−========
3−
4−`++sail` tag.
5−
6−`semzaz`, is a virtual rune frequently referred to as [`++sail`]() in
7−reference to `++sail`:vast which parses it. It is the most basic part of
8−the templating structure frequently used to produce [`++manx`](). In its
9−simplest and most common form we see `semzaz` as
10−`;tagname(property1 "value1", property2 "value2")`.
11−
12−Produces
13−--------
14−
15−[`++twig`]()
16−
17−Accepts
18−-------
19−
20−`p` is a [`++mane`](), `q` is a list of pairs of mane to twig producing a
21−tape, `r` is a list of twigs producing manx.
22−
23−Tall form
24−---------
25−
26− ;p
27− i.r
28− i.t.r
29− ==
30−
31− ;p
32− =p.i.q q.i.q
33− =p.i.t.q q.i.t.q
34− i.r
35− i.t.r
36− ==
37−
38− ;p(p.i.q q.i.q, p.i.t.q q.i.t.q)
39− i.r
40− i.t.r
41− ==
42−
43−Wide form
44−---------
45−
46− ;p;
47−
48− ;p:(i.r i.t.r i.t.t.r)
49−
50− ;p(p.i.q q.i.q, p.i.t.q q.i.t.q):"{...}"
51−
52− ;p(p.i.q q.i.q, p.i.t.q q.i.t.q):(i.r i.t.r i.t.t.r)
53−
54− ;p(p.i.q q.i.q, p.i.t.q q.i.t.q):"{...}"
55−
56−Within quoted form,
57−
58− `;{p}`, `{p i.r i.t.r}`, `;{p(p.i.q q.i.q, p.i.t.q q.i.t.q) i.r i.t.r}`
59−
60−Examples
61−--------
62−
63− ~zod/try=> ;html ;head;
64− ;body;
65− ==
66− [[%html ~] [[%head ~] ~] [[%body ~] ~] ~]
67− ~zod/try=> ;html:(head body)
68− [[%html ~] [[%head ~] ~] [[%body ~] ~] ~]
69− ~zod/try=> ;html:";{head meta(charset "utf-8")};{body p p}"
70− [ [%html ~]
71− [[%head ~] [[%meta [%charset "utf-8"] ~] ~] ~]
72− [[%body ~] [[%p ~] ~] [[%p ~] ~] ~]
73− ~
74− ]
75− ~zod/try=> (poxo ;html:";{head meta(charset "utf-8")};{body p p}")
76− "<html><head><meta charset="utf-8"></meta></head><body><p></p><p></p></body></html>"
77−
78−Here we create the most basic HTML structure using nested `semzaz`, and
79−eventually print it properly using [`++poxo`]().
docs/system/hoon/runes/ts/.tsbr.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tscl.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tsdt.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tsgl.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tsgr.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tshp.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tskt.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tsls.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tssg.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/.tstr.md.swpnew file

Binary file not shown.

docs/system/hoon/runes/ts/tsbr.md+6−7
@@ -1,5 +1,4 @@
1−`=| tisbar`
1+# `:new`, `=|`, "tisbar", `{$new p/twig q/twig}`
2−====
3
2
4Default value.
3Default value.
5
4
@@ -7,7 +6,7 @@ Produces the default value of input type (aka mold) `p` and makes it
7available/pushes it onto `q`.
6available/pushes it onto `q`.
8
7
9
8
10−`=|` is a synthetic rune that pushes the [bunt](), or default value, of
9+`=|` is a synthetic rune that pushes the bunt, or default value, of
11`p` on the subject and sends it to `q`.
10`p` on the subject and sends it to `q`.
12
11
13Produces
12Produces
@@ -18,7 +17,7 @@ Twig: `[%tsbr p=mold q=twig]`
18Accepts
17Accepts
19-------
18-------
20
19
21−`p` is a [mold](). `q` is a [twig]().
20+`p` is a mold. `q` is a twig.
22
21
23Tall form
22Tall form
24---------
23---------
@@ -34,16 +33,16 @@ Wide form
34Examples
33Examples
35--------
34--------
36
35
37− ~zod/try=> =|(a=@p a)
36+ ~zod/try=> =|(a/@p a)
38 ~zod
37 ~zod
39
38
40Here we use `=|` to generate the default value of a `@p`, which is
39Here we use `=|` to generate the default value of a `@p`, which is
41`~zod`.
40`~zod`.
42
41
43 /~zod/try=>
42 /~zod/try=>
44− =| a=[b=@ c=@]
43+ =| a=[b/@ c/@]
45 [+(b.a) +(+(c.a))]
44 [+(b.a) +(+(c.a))]
46 [1 2]
45 [1 2]
47
46
48−Here we add the bunt of `a=[b=@ c=@]` and perform a very basic operation
47+Here we add the bunt of `a/[b/@ c/@]` and perform a very basic operation
49on it.
48on it.
docs/system/hoon/runes/ts/tscl.md+4−29
@@ -1,38 +1,13 @@
1−`=: tiscol`
1+# `:fix`, `=:`, "tiscol", `{$fix p/(list (pair wing twig)) q/twig}`
2−====
3
2
4List of changes.
3List of changes.
5
4
6Makes a list of changes `p` to the subject and then evaluates `q`.
5Makes a list of changes `p` to the subject and then evaluates `q`.
7−Allows you to change values in your context (not in the hoon sense).
6+Useful when you need to make a batch of changes to your subject.
8
7
8+Regular form: *jogging*
9
9
10−`=:` is a synthetic rune that produces `q` with the subject modified by
10+Examples:
11−the list of changes in `p` which must be terminated by a `==`. `=:` is
12−useful when you need to make a batch of changes to your subject.
13−
14−Produces
15−--------
16−
17−Twig: `[%tscl p=tram q=twig]`
18−
19−Accepts
20−-------
21−
22−`p` is a [`++tram`](), a list of [`++wing`]()s and twigs. `q` is a
23−[twig]().
24−
25−Tall form
26−---------
27−
28− =: p.i.p q.i.p
29− p.i.t.p q.i.t.p
30− p.i.t.t.p q.i.t.t.p
31− ==
32− q
33−
34−Examples
35−--------
36
11
37 ~zod/try=> =+ a=[b=1 c=2]
12 ~zod/try=> =+ a=[b=1 c=2]
38 =: c.a 4
13 =: c.a 4
docs/system/hoon/runes/ts/tsdt.md+2−35
@@ -1,46 +1,13 @@
1`=. tisdot`
1`=. tisdot`
2−====
3
2
4Change value.
3Change value.
5
4
6Produces `r` with `p` in the subject set to `q`. Allows you to change
5Produces `r` with `p` in the subject set to `q`. Allows you to change
7a value in your subject before executing more code against it.
6a value in your subject before executing more code against it.
8
7
8+Regular form: *3-fixed*
9
9
10−`=.` is a synthetic rune that produces `r` with `p` in the subject set
11−to `q`.
12−
13−Produces
14−--------
15−
16−Twig: `[%tsdt p=wing q=twig r=twig]`
17−
18−Accepts
19−-------
20−
21−`p` is a [`wing`](). `q` and `r` are [`twig`]()s.
22−
23−Tall form
24−---------
25−
26−Kingside:
27−
28− =. p
29− q
30− r
31−
32−Queenside:
33−
34− =. p q
35− r
36−
37−Wide form
38−---------
39−
40− =.(p q r)
41−
42−Examples
10+Examples:
43−--------
44
11
45 ~zod/try=> =+ a=[b=1 c=2]
12 ~zod/try=> =+ a=[b=1 c=2]
46 =. b.a 3
13 =. b.a 3
docs/system/hoon/runes/ts/tsgl.md+7−37
@@ -1,45 +1,15 @@
1−`=< tisgal`
1+# `:rap`, `=<`, "tisgal" `{$rap p/twig q/twig}`
2−====
3
2
4−Inverted `=>`.
3+Inverted `=>`: `q` as subject of `p`.
5
4
6−An inverted `=>`. Uses the product of `q` as the subject of formula
5+Uses the product of `q` as the subject of formula
7`p`. Allows us to keep the heavier of `p` `q` as the bottom expression, which
6`p`. Allows us to keep the heavier of `p` `q` as the bottom expression, which
8−makes for more readable code. Please see the section on [backstep]().
7+makes for more readable code. Please see the syntax section for more detail.
9
8
9+Regular form: *2-fixed*
10
10
11−`=<` is a synthetic rune that uses the product of `q` as the subject of
11+Examples:
12−`p`. `=<` is the inverse of `=>`. Use `=<` when your computation, `q` is
13−lengthier and `=<` makes for more readable code.
14
12
15−Produces
16−--------
17−
18−Twig: `[%tsgl p=twig q=twig]`
19−
20−Accepts
21−-------
22−
23−`p` and `q` are [twig]()s.
24−
25−Tall form
26−---------
27−
28− =< p
29− q
30−
31−Wide form
32−---------
33−
34− =<(p q)
35−
36−Irregular form
37−--------------
38−
39− p:q
40−
41−Examples
42−--------
43
13
44 ~zod/try=> b:[a=1 b=2 c=3]
14 ~zod/try=> b:[a=1 b=2 c=3]
45 2
15 2
@@ -59,4 +29,4 @@ produce our context from the computation `(add 2 4)` as a cell, `[6 6]`.
59
29
60This example is a more common case, where we want to pull some specific
30This example is a more common case, where we want to pull some specific
61value out of a longer computation. Here we use the tall form of `=<` to
31value out of a longer computation. Here we use the tall form of `=<` to
62−pull the arm `lom` from the core created with [`|%`]().
32+pull the arm `lom` from the core created with `|%`.
docs/system/hoon/runes/ts/tsgr.md+7−28
@@ -1,35 +1,14 @@
1−`=> tisgar`
1+# `:per`, `=>`, "tisgar" `{$per p/twig q/twig}`
2−====
3
2
4−Product as subject.
3+`p` as subject of `q`.
5
4
6−`=>` is a natural rune that uses the product of `p` as the subject of
5+Uses the product of `p` as the subject of formula `q`. For code readability,
7−`q`. `=>` is the inverse of `=<`. Use `=>` when your `p` isn't too long
6+use `=>` when your `p` isn't as long as `q`, and `=<` when `q` is longer than
8−and `=>` makes for more readable code.
7+`p`.
9
8
10−Produces
9+Regular form: *2-fixed*
11−--------
12
10
13−Twig: `[%tsgr p=twig q=twig]`
11+Examples:
14−
15−Accepts
16−-------
17−
18−`p` and `q` are [twig]()s.
19−
20−Tall form
21−---------
22−
23− => p
24− q
25−
26−Wide form
27−---------
28−
29− =>(p q)
30−
31−Examples
32−--------
33
12
34 ~zod/try=> =>([a=1 b=2 c=3] b)
13 ~zod/try=> =>([a=1 b=2 c=3] b)
35 2
14 2
docs/system/hoon/runes/ts/tshp.md+6−32
@@ -1,41 +1,15 @@
1−`=- tishep`
1+# `:nip`, `=-`, "tishep" `{$nip p/twig q/twig}`
2−====
3
2
4Inverted `=+`.
3Inverted `=+`.
5
4
6−An inverted `=+`. Pushes variable `q` onto the subject and then
5+Pushes variable `q` onto the subject and then
7executes `p` against the new subject. Allows us to place the larger of `p` and
6executes `p` against the new subject. Allows us to place the larger of `p` and
8`q` as the bottom expression, making for for more readable code (see the
7`q` as the bottom expression, making for for more readable code (see the
9−section on [backstep]()).
8+section on backstep in the syntax section).
10
9
10+Regular form: *2-fixed*
11
11
12−`=-` is a synthetic rune that pushes `q` on the subject and sends it to
12+Examples:
13−`p`. `=-` is the inverse of `=+`. Use `=-` when your computation, `q` is
14−lengthier and `=-` makes for more readable code.
15−
16−Produces
17−--------
18−
19−Twig: `[%tshp p=twig q=twig]`
20−
21−Accepts
22−-------
23−
24−`p` and `q` are [twig]()s.
25−
26−Tall form
27−---------
28−
29− =- p
30− q
31−
32−Wide form
33−---------
34−
35− =-(p q)
36−
37−Examples
38−--------
39
13
40 ~zod/try=> =- [%a a]
14 ~zod/try=> =- [%a a]
41 [a=1]
15 [a=1]
@@ -46,7 +20,7 @@ In this simple example we push `[a=1]` on to our subject, and produce
46`[%a 1]`.
20`[%a 1]`.
47
21
48 ~zod/try=>
22 ~zod/try=>
49− =cor |= [a=@ b=@]
23+ =cor |= [a/@ b/@]
50 =- [[%a a] [%b b]]
24 =- [[%a a] [%b b]]
51 [a b]=[(add a 2) (add a b)]
25 [a b]=[(add a 2) (add a b)]
52 new var %cor
26 new var %cor
docs/system/hoon/runes/ts/tskt.md+7−44
@@ -1,52 +1,15 @@
1−`=^ tisket`
1+# `:sip`, `=^`, "tisket" `{$sip p/taco q/wing r/twig s/twig}`
2====
2====
3
3
4−State monad.
4+State monad: push a new variable on the subject, change value of another.
5
5
6−Used to both push a new variable on the subject as well as change the
7−value of another. Similar to `=+` in that it pushes a value on the stack with
6+Similar to `=+` in that it pushes a value `q` on the stack with
8−variable name (face) `p`. However, in addition to pushing a new variable onto
9−the subject, it also modifies whatever value is tied to `q` within the subject.
7+face (variable name) `p`. It then modifies the new value of `q` within the subject.
10−`r` is the cell of [new-product-p updated-value-1]. You can think of `=^` like
8+`r` is the cell of [new-product-p updated-value-1].
11−a state monad.
12
9
10+Regular form: *2-fixed*
13
11
14−`=^` is a synthetic rune that handles a product which is a cell of a new
15−result, and a mutation to the subject.
16−
17−Produces
18−--------
19−
20−Twig: `[%tskt p=twig q=twig r=twig s=twig]`
21−
22−Accepts
23−-------
24−
25−`p`, `q`, `r` and `s` are [twig]()s.
26−
27−Tall form
28−---------
29−
30−Kingside:
31−
32− =^ p
33− q
34− r
35− s
36−
37−Queenside:
38−
39− =^ p q
40− r
41− s
42−
43−Wide form
44−---------
45−
46− =^(p q r s)
47−
48−Examples
12+Examples:
49−--------
50
13
51 > =+ rng=~(. og 0wrando.mseed.12345)
14 > =+ rng=~(. og 0wrando.mseed.12345)
52 =^ r1 rng (rads:rng 100)
15 =^ r1 rng (rads:rng 100)
docs/system/hoon/runes/ts/tsls.md+5−33
@@ -1,39 +1,11 @@
1−`=+ tislus`
1+# `:pin`, `=+`, "tislus" `{$pin p/twig q/twig}`
2−====
3
2
4−Assign.
3+Push variable onto the subject.
5
4
6−Easiest way to declare variables. Pushes a new variable `p` onto the
7−subject and then executes `q` against it.
5+Pushes a new variable `p` onto the subject and then executes `q` against it.
6+Can use `$=` to put an optional face (variable name) on the value.
8
7
9−
8+Examples:
10−`=+` is a synthetic rune that pushes `p` on the subject and sends it to
11−`q`. `=+` is the inverse of `=-`. Use `=+` when your `p` isn't too long
12−and `=+` makes for more readable code.
13−
14−Produces
15−--------
16−
17−Twig: `[%tsls p=twig q=twig]`
18−
19−Accepts
20−-------
21−
22−`p` and `q` are [twig]()s.
23−
24−Tall form
25−---------
26−
27− =+ p
28− q
29−
30−Wide form
31−---------
32−
33− =+(p q)
34−
35−Examples
36−--------
37
9
38 ~zod/try=>
10 ~zod/try=>
39 =+ a=1
11 =+ a=1
docs/system/hoon/runes/ts/tssg.md+3−34
@@ -1,4 +1,4 @@
1−`=~ tissig`
1+# `:tow`, `=~`, "tissig" `{$tow p/(list twig)}`
2====
2====
3
3
4List of twigs.
4List of twigs.
@@ -6,40 +6,9 @@ List of twigs.
6Composes a list of twigs. Applies `=>` to a list of expressions, using each result as the
6Composes a list of twigs. Applies `=>` to a list of expressions, using each result as the
7subject to the following expression.
7subject to the following expression.
8
8
9−Produces
9+Regularm form: *running*
10−--------
11
10
12−Twig: `[%tssg p=tusk]`
13−
14−Sample
15−------
16−
17−`p` is a [`++tusk`](), a list of [twig]()s.
18−
19−Tall form
20−---------
21−
22− =~ i.p
23− i.t.p
24− i.t.t.p
25− ==
26−
27−Queenside:
28−
29− =~ i.p
30− i.t.p
31− i.t.t.p
32− ==
33−
34−
35−Wide form
36−---------
37−
38− =~(i.p i.t.p i.t.t.p)
39−
40−
41−Examples
11+Examples:
42−--------
43
12
44 ~zod/try=> =~(1 +(.) +(.))
13 ~zod/try=> =~(1 +(.) +(.))
45 3
14 3
docs/system/hoon/runes/ts/tstr.md+3−29
@@ -1,37 +1,11 @@
1−`=* tistar`
1+# `:aka`, `=*`, "tistar" `{$aka p/term q/twig r/twig}`
2−====
3
2
4Alias.
3Alias.
5
4
6−Makes `p` an alias of value `q`. Useful when you don't want to write
5+Makes `p` an alias of value `q`, producing a `%bull`, the alias type. Useful when you don't want to write
7out a long address multiple times, for example `p.s.+.variable`, which translates to `p` within `s` within the tail of `variable`.
6out a long address multiple times, for example `p.s.+.variable`, which translates to `p` within `s` within the tail of `variable`.
8
7
9−
10−`=*` is a natural rune that creates a `%bull`, or alias, type.
11−
12−Produces
13−--------
14−
15−Twig: `[%tstr p=term q=wing r=twig]`
16−
17−Accepts
18−-------
19−
20−`p` is a [`term`](). `q` is a [`++wing`](). `r` is a [twig]().
21−
22−Tall form
23−---------
24−
25− =* p q
26− r
27−
28−Wide form
29−---------
30−
31− =*(p q r)
32−
33−Examples
8+Examples:
34−--------
35
9
36 ~zod/try=>
10 ~zod/try=>
37 =+ a=1
11 =+ a=1