on master help sign in
separate returns, minor clarifications
commit5bb9587b08f366e808ccb404baf7122d36356e47 authorsyzygyzer <jon@tlon.io> dateThu 3 Dec 2020, 17:50 (6 years ago) parentf230b32
1 file changed+31−11
reference/vane-apis/jael.md+31−11
reference/vane-apis/jael.md+31−11
@@ -70,8 +70,13 @@ with the Azimuth smart contract.
7070
7171#### Returns
7272
73−As mentioned above, this `task` `%slip`s `%init` `task`s to most other vanes and
74−`%give`s an `%init` `gift` to Unix.
73+Jael `%give`s an `%init` `gift` to Unix. This occurs after the Dill `%slip`
74+init.
75+
76+#### Slips
77+
78+Jael `%slip`s `%init` `task`s to each of Eyre, Dill, Gall, Clay, and Ames, in
79+that order.
7580
7681
7782### `%fake`
@@ -94,9 +99,12 @@ sponsorship chain and galaxy public keys are left at their bunted values.
9499
95100#### Returns
96101
97−Like `%dawn`, `%fake` is used to initialize the other vanes. In response to a
98−`%fake` `task`, Jael `%slip`s a `%init` `task` to each of Eyre, Dill, Gall,
99−Clay, and Ames, and `%give`s a `%init` `gift` to Unix.
102+Jael `%give`s a `%init` `gift` to Unix.
103+
104+#### Slips
105+
106+In response to a `%fake` `task`, Jael `%slip`s a `%init` `task` to each of Eyre, Dill, Gall,
107+Clay, and Ames, in that order.
100108
101109
102110### `%listen`
@@ -134,13 +142,16 @@ spawned that moon, and the `source` for a comet will be the comet itself.
134142
135143#### Returns
136144
145+This `task` returns no `gift`s.
146+
147+#### Passes
148+
137149If the `source` is a `term`, Jael will `%pass` a `%deal` `task` to Gall asking to
138150`%watch` the app given by `source` at path `/`.
139151
140152If the `source` is a `ship`, Jael will `%pass` a `%plea` `task` to Ames wrapping
141153a `%public-keys` `task` intended for Jael on the `ship` specified by `source`.
142154
143−This `task` returns no `gift`s.
144155
145156### `%meet`
146157
@@ -199,11 +210,12 @@ This `task` returns no `gift`s.
199210
200211This `task` is `%pass`ed to Jael from Ames. `%plea`s are wrappers for `task`s
201212that originate from a remote source, as the `%plea` pattern
202−is used to extend the `%pass`/`%give` semantics over the Ames network.
213+is used to extend the `%pass`/`%give` semantics over the Ames network. Jael
214+attempts to perform the `task` wrapped in the `%plea`.
203215
204216Jael accepts two kinds of `%plea`s: [`%nuke`](#nuke) and
205−[`%public-keys`](#public-keys) and will crash if passed anything else. See the relevant entries to learn how Jael
206−responds to these.
217+[`%public-keys`](#public-keys) and will crash if passed anything else. See the
218+relevant entries to learn how Jael responds to these.
207219
208220#### Accepts
209221
@@ -216,8 +228,11 @@ a `%public-keys` `task`.
216228
217229#### Returns
218230
219−Jael `%give`s a `%done` `gift` in response to a `%plea` `task`. It also
220−`%pass`es itself the wrapped `task`.
231+Jael `%give`s a `%done` `gift` in response to a `%plea` `task`.
232+
233+#### Passes
234+
235+Jael `%pass`es itself the wrapped `task`.
221236
222237
223238### `%private-keys`
@@ -373,3 +388,8 @@ This `task` has no arguments.
373388
374389In response to this `task,` Jael `%give`s a `%mass` `gift` containing Ames'
375390current memory usage.
391+
392+
393+
394+
395+