@@ -226,7 +226,8 @@ history of the ship.
226226
227227### `%public-keys`
228228
229−This `task` creates a subscription for the callee to a selection of the public keys kept by Jael.
229+This `task` creates a subscription for the callee to a selection of the public
230+keys kept by Jael. This `task` can originate locally or remotely.
230231
231232#### Accepts
232233
@@ -240,6 +241,18 @@ This `task` creates a subscription for the callee to a selection of the public k
240241```hoon
241242[%public-keys =public-keys-result]
242243```
244+If the `task` originated locally, Jael `%give`s a `%public-keys` `gift` in
245+ response. If it originated remotely, Jael `%give`s a `%boon` `gift` to back
246+ to Ames wrapping a `%public-keys` `gift`.
247+
248+A `$public-keys-result` is the following.
249+```hoon
250+ +$ public-keys-result
251+ $% [%full points=(map ship point)]
252+ [%diff who=ship =diff:point]
253+ [%breach who=ship]
254+```
255+
243256
244257
245258### `%rekey`
@@ -252,7 +265,7 @@ This `task` updates the ship's private keys.
252265[=life =ring]
253266```
254267
255−`life` is a `@ud` that is the new ship key revision number. `ring` is an `@` that is the new private key.
268+`life` is a `@ud` that is the new ship key revision number. `ring` is a `@` that is the new private key.
256269
257270#### Returns
258271