@@ -12,14 +12,51 @@ The `/+` rune accepts a filename as an argument. It interprets that filename
12as a hoon source file within the `lib` directory. This is how we import a shared
12as a hoon source file within the `lib` directory. This is how we import a shared
13library in urbit.
13library in urbit.
15−Example:
15+To run this example, put this code in your desk at `gen/faslus.hoon` and run
16+`+faslus` in your dojo. This example is a generator. For more information on
17+generators, see the [generator docs](https://urbit.org/docs/arvo/generators).
17/+ time-to-id
20/+ time-to-id
23+|= {now/@da * *} $~ $~}
19(time-to-id now)
25(time-to-id now)
21produces: `"c.314d"` (or something similar depending on when you run it)
28produces: `"c.314d"` (or something similar depending on when you run it)
30+You can import multiple libraries with a single `/+` rune by separating them
33+Replace the code in `gen/faslus.hoon` with the following:
36+/+ time-to-id, hep-to-cab
39+|= {{now/@da * *} $~ $~}
41+=/ id (time-to-id now)
42+=/ str "my-id-is-{id}"
43+(hep-to-cab (crip str))
46+This should print something like `my_id_is_c.3588`.
48+Another feature of the
49+`/+ and`/-`runes is the ability to specify the`ship`and`case\` from which to
55+/+ time-to-id, hep-to-cab/4/~zod
58+will load the `hep-to-cab` library from `~zod` at `%clay` revision `4`.
23### `/-` import from sur/
60### `/-` import from sur/
25The `/-` rune accepts a filename as an argument. It interprets that filename as
62The `/-` rune accepts a filename as an argument. It interprets that filename as
@@ -35,6 +72,10 @@ Example:
36produces: `0v0`
73produces: `0v0`
75+`/-` can also take multiple files as arguments, and the ship and case of those
76+arguments can be specified. See the `/+` docs for more details about the syntax
38### `/~` twig by hand
79### `/~` twig by hand
40`/~ <twig>` produces a "horn" that evaluates a twig and places the product in
81`/~ <twig>` produces a "horn" that evaluates a twig and places the product in