@@ -32,7 +32,7 @@ receipt of a `%dawn` `task`, Jael will:
3232 - save the public keys of all galaxies
3333 - set Jael to subscribe to `%azimuth-tracker`
3434 - `%slip` a `%init` `task` to Ames, Clay, Gall, Dill, and Eyre, and `%give` an `%init`
35−`gift` to Unix??.
35+`gift` to Arvo, which then informs Unix that the initialization process has concluded.
3636
3737#### Accepts
3838
@@ -96,7 +96,7 @@ sponsorship chain and galaxy public keys are left at their bunted values.
9696
9797Like `%dawn`, `%fake` is used to initialize the other vanes. In response to a
9898`%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 (?)
99+Clay, and Ames, and `%give`s a `%init` `gift` to Arvo.
100100
101101
102102### `%listen`
@@ -191,7 +191,7 @@ This `task` returns no `gift`s.
191191### `%plea`
192192
193193This `task` is `%pass`ed to Jael from Ames. `%plea`s are wrappers for `task`s
194−that (typically? always?) originate from a remote source, as the `%plea` pattern
194+that originate from a remote source, as the `%plea` pattern
195195is used to extend the `%pass`/`%give` semantics over the Ames network.
196196
197197Jael accepts two kinds of `%plea`s: [`%nuke`](#nuke) and
@@ -257,8 +257,8 @@ keys kept by Jael. This `task` can originate locally or remotely.
257257[%public-keys =public-keys-result]
258258```
259259If the `task` originated locally, Jael `%give`s a `%public-keys` `gift` in
260− response. If it originated remotely, Jael `%give`s a `%boon` `gift` to back
261− to Ames wrapping a `%public-keys` `gift`.
260+response. If it originated remotely, Jael `%give`s a `%boon` `gift` to back
261+to Ames wrapping a `%public-keys` `gift`.
262262
263263A `$public-keys-result` is the following.
264264```hoon
@@ -267,7 +267,12 @@ A `$public-keys-result` is the following.
267267 [%diff who=ship =diff:point]
268268 [%breach who=ship]
269269```
270−
270+The first time Jael receives a `%public-keys` `task` from a ship it will return
271+a `[%public-keys-result %full]` `gift`, which contains all information about ships and
272+their associated points that Jael knows. Subsequent updates will typically be
273+`[%public-keys-result %diff]`, which tells the caller what has changed
274+since last time they sent a `%public-keys` `task`, and `[%public-keys-result
275+%breach]`, which informs the caller of ship breaches.
271276
272277
273278### `%rekey`