@@ -198,42 +198,43 @@ any of its children.
198198This specifies what type of information is requested in a subscription
199199or a scry.
200200
201−`%a` build a Hoon file at a path.
201+`%a` build a Hoon file at a `path`.
202202
203−`%b` build a dynamically typed mark by name (a `$dais` mark-interface core).
203+`%b` build a dynamically typed `mark` by name (a `$dais` mark-interface core).
204204
205−`%c` build a dynamically typed mark conversion gate (a `$tube`) by "from" and
206−"to" mark names
205+`%c` build a dynamically typed `mark` conversion gate (a `$tube`) by "from" and
206+"to" `mark` names.
207207
208−`%d` retrieves a `set desk`. `.^((set desk) %cd %)`.
208+`%d` returns a `(set desk)` of the `desk`s that exist on your ship.
209209
210−`%e` builds a statically typed mark by name (a `$nave` mark-interface core).
210+`%e` builds a statically typed `mark` by name (a `$nave` mark-interface core).
211211
212212`%f` builds a statically typed mark converstion gate.
213213
214−`%p` produces the permissions for a directory.
214+`%p` produces the permissions for a directory, returned as a `[dict:clay dict:clay]`.
215215
216−`%r` requests the file in the same fashion as `%x`, but wraps the result in a vase.
216+`%r` requests the file in the same fashion as `%x`, but wraps the result in a `vase`.
217217
218218`%s` has miscellaneous debug endpoints.
219219
220−`%t` produces a list of descendent paths for a directory within a `yaki`.
220+`%t` produces a `(list path)` of descendent `path`s for a directory within a `yaki`.
221221
222−`%u` checks whether or not the specified file exists. It does not check any of
223−its children.
222+`%u` produces a `?` depending on whether or not the specified file exists. It
223+does not check any of its children.
224224
225225`%v` requests the entire `dome` for a specified `desk` at a particular `aeon`.
226226When used on a foreign `desk`, this get us up-to-date to the requested version.
227227
228−`%w` requests the version number and date of the specified path.
228+`%w` requests the revision number and date of the specified path, returned as a `cass:clay`.
229229
230−`%x` requests the file at a specified path at the specified commit. If
231−there is no node at that path or if the node has no contents (that is,
232−if `q:ankh` is null), then this produces null.
230+`%x` requests the file at a specified path at the specified commit, returned as
231+an `@`. If there is no node at that path or if the node has no contents (that
232+is, if `fil:ankh` is null), then this crashes.
233233
234−`%y` requests an `arch` of the specfied commit at the specified path.
234+`%y` requests an `arch` of the specfied commit at the specified path. It will
235+return the bunt of an `arch` if the file or directory is not found.
235236
236−`%z` requests a recursive hash of a node and all its children.
237+`%z` requests a recursive hash of a node and all its children, returned as a `@uxI`.
237238
238239#### `$ankh`, filesystem node
239240