git.iko.soy/urbit.org
on master help sign in
almost done
commitbfaa358c28d6b80dc106c01688fedf54782456c2 authorHenry Ault <henry@tlon.io> dateThu 14 Apr 2016, 17:50 (11 years ago) parent79d793b
6 files changed+27−41
compare with master
unifiedsplit
docs/programming/system/basic.md+9−23 docs/programming/system/generators.md+1−1 docs/programming/system/http.md+1−1 docs/programming/system/marks.md+14−14 docs/programming/system/network.md+1−1 docs/programming/system/subject.md+1−1
docs/programming/system/basic.md+9−23
@@ -1,5 +1,4 @@
11---
2−logo: black
32sort: 1
43next: true
54title: Hoon refresher / crash course
@@ -19,33 +18,20 @@ simple programs: the first [Project
1918Euler](https://projecteuler.net/) problem and
2019[fizzbuzz](https://en.wikipedia.org/wiki/Fizz_buzz).
2120
22−To run this code, you'll need an urbit, and you'll need the
23−`%examples` desk from `~zod`. If you haven't installed
21+To run this code, you'll need an urbit, and will have to copy the [examples repo](https://github.com/urbit/examples) into it.
22+
23+If you haven't installed
2424urbit yet, check out the [installation
25−instructions](http://urbit.org/docs/user/install). Once urbit is
25+instructions](/docs/user/install). Once urbit is
2626installed, take a look at the [basic
27−operation](http://urbit.org/docs/user/basic) of your urbit.
28−
29−If you haven't pulled the examples desk from `~zod`, do
30−so now:
31−
32− ~fintud-macrep:dojo> |merge %examples ~zod %examples
33− >=
34− [time passes...]
35− merged with strategy %init
36−
37−This merge could take several minutes; you'll know it's done when
38−"merged with strategy %init" is printed. Next, mount the new files to
39−your Unix pier directory:
40−
41− ~fintud-macrep:dojo> |mount /=examples=
27+operation](/docs/user/basic) of your urbit.
4228
43−Switch desks to run commands from the `%examples` desk:
29+If you haven't copied in the examples repo, running the following commands from your urbit directory should do the trick:
4430
45− ~fintud-macrep:dojo> =dir /=examples=
46− =% /~fintud-macrep/examples/~2015.11.13..02.25.00..41e9/
31+`cp -r {wherever-you've-pulled-to}/examples/gall/*/ arvo/`
32+`cp -r {wherever-you've-pulled-to}/examples/dojo/*/ arvo/`
4733
48−Run an example:
34+Run an example to ensure it worked:
4935
5036 ~fintud-macrep:dojo> +examples-euler1
5137 233.168
docs/programming/system/generators.md+1−1
@@ -182,7 +182,7 @@ Now we can run this with:
182182```
183183~fintud-macrep:dojo> |start %examples-ping
184184>=
185−~fintud-macrep:dojo> :examples-ping &ping-message [~sampel-sipnym 'heyya']
185+~fintud-macrep:dojo> :examples-ping &examples-ping-message [~sampel-sipnym 'heyya']
186186>=
187187```
188188
docs/programming/system/http.md+1−1
@@ -32,7 +32,7 @@ code isn't 2xx. Here's `app/up.hoon`:
3232 ==
3333--
3434|_ {hid/bowl on/_| in-progress/_| target/@t}
35−++ poke-atom
35+++ poke-cord
3636 |= url-or-command/@t ^- (quip move +>)
3737 =+ ^- act/action
3838 ?: ?=($on url-or-command) [%on ~]
docs/programming/system/marks.md+14−14
@@ -9,9 +9,9 @@ our own marks. Let's write a sample mark of our own, then chain
99it together with some preexisting ones to have fun with type
1010conversions.
1111
12−Let's make a small "cord" mark. "Cord" is a name we use for `@t`
13−text, but there's no predefined mark for it. This is
14−`/mar/cord.hoon`:
12+Let's make a small "examples-cord" mark. "Cord" is a name we use for `@t`
13+text, but there's no predefined mark for it. Let's put the following code in:
14+`/mar/examples/cord.hoon`:
1515
1616```
1717/? 314
@@ -57,9 +57,9 @@ marked atom and convert it to our new mark.
5757```
5858~fintud-macrep:dojo> &atom 9
59599
60−~fintud-macrep:dojo> &cord &atom 9
60+~fintud-macrep:dojo> &examples-cord &atom 9
6161'9'
62−~fintud-macrep:dojo> &cord &atom &cord &atom 9
62+~fintud-macrep:dojo> &examples-cord &atom &examples-cord &atom 9
6363'57'
6464```
6565
@@ -71,9 +71,9 @@ same concept. They're not isomorphisms.
7171Let's play around a little more:
7272
7373```
74−~fintud-macrep:dojo> &md &cord &atom 17
74+~fintud-macrep:dojo> &md &examples-cord &atom 17
7575'17'
76−~fintud-macrep:dojo> &hymn &md &cord &atom 17
76+~fintud-macrep:dojo> &hymn &md &examples-cord &atom 17
7777[ [%html ~]
7878 [[%head ~] [[%title ~] [[%~. [%~. "Untitled"] ~] ~] ~] ~]
7979 [ [%body ~]
@@ -93,7 +93,7 @@ the time this gets to the web page, it's plain html. Let's do
9393the final step in the conversion.
9494
9595```
96−~fintud-macrep:dojo> &mime &hymn &md &cord &atom 17
96+~fintud-macrep:dojo> &mime &hymn &md &examples-cord &atom 17
9797[ [%text %html ~]
9898 p=121
9999 q='<html><head><title>Untitled</title></head><body><meta value="{}" name="frontmatter" urb:front="" /><p>17</p></body></html>'
@@ -102,26 +102,26 @@ the final step in the conversion.
102102
103103This is a mime-typed octet stream with type `/text/html`, length
104104121 bytes, and our lowly number `17` rendered to a web page.
105−`cord` was just one step in the chain.
105+`examples-cord` was just one step in the chain.
106106
107107Of course, arvo can infer some parts of this chain:
108108
109109```
110−~fintud-macrep:dojo> &cord 17
110+~fintud-macrep:dojo> &examples-cord 17
111111'17'
112112```
113113
114−Likewise, `md` is the only way to get from `cord` to `hymn`, so
114+Likewise, `md` is the only way to get from `examples-cord` to `hymn`, so
115115that can be omitted. If we omit the `hymn`, though, we get:
116116
117117```
118−~fintud-macrep:dojo> &mime &cord 17
118+~fintud-macrep:dojo> &mime &examples-cord 17
119119[[%text %x-markdown ~] p=1 q='7']
120120```
121121
122−Here, we converted straight from `cord` to `md` to `mime`. Arvo
122+Here, we converted straight from `examples-cord` to `md` to `mime`. Arvo
123123decided that was the most straightforward conversion, but it
124124gives a different result than passing it through the `hymn`
125125mark.
126126
127−The minimal correct input, then, is `&mime &hymn &cord &atom 17`.
127+The minimal correct input, then, is `&mime &hymn &examples-cord &atom 17`.
docs/programming/system/network.md+1−1
@@ -191,7 +191,7 @@ Run it with these commands:
191191```
192192
193193Replace `~sampel-sipnym` with another urbit. The easiest thing to
194−do is to start a [moon](), a sub-identity of your urbit. Don't
194+do is to start a moon, a sub-identity of your urbit. If you don't know how to start a moon, see [the user admin section](/docs/using/admin/) Don't
195195forget to start the `%examples-pong` app on that urbit too. You should
196196see, on the foreign urbit, this output:
197197
docs/programming/system/subject.md+1−1
@@ -1,7 +1,7 @@
11---
22sort: 2
33next: true
4−title: Hoon refresher / crash course
4+title: The subject
55---
66
77# The subject