@@ -39,14 +39,14 @@ The focus of this document is on interacting with Clay from userspace applicatio
3939
4040# `%warp`
4141
42−```hoon
43−[%warp wer=ship rif=riff] :: internal file req
44−```
45−
4642A `%warp` `task` is for reading a subscribing to files and directories.
4743
4844### Accepts
4945
46+```hoon
47+[wer=ship rif=riff]
48+```
49+
5050The `wer` field is the target ship. The `(unit rave)` of the [riff](@/docs/arvo/clay/data-types.md#riff-clay-request-desist) is null to cancel an existing subscription, otherwise the [rave](@/docs/arvo/clay/data-types.md#rave-clay-general-subscription-request) is tagged with one of:
5151
5252- `%sing` - Read a single file or directory.
@@ -172,14 +172,14 @@ To cancel a subscription, you just send a `%warp` with a null `(unit rave)` in t
172172
173173## `%info`
174174
175−```hoon
176−[%info des=desk dit=nori] :: internal edit
177−```
178−
179175To write or modify a file, we send Clay a `%info` `task`.
180176
181177### Accepts
182178
179+```hoon
180+[des=desk dit=nori]
181+```
182+
183183The `%|` tag in the [nori](@/docs/arvo/clay/data-types.md#nori-clay-repository-action) is not currently supported and will crash with a `%labelling-not-implemented` if used, so you can focus on the `%&` part. The [soba](@/docs/arvo/clay/data-types.md#soba-clay-delta) in the `nori` is just a list of changes so you can make more than one change in one request. Its `path` is just the path to a file like `/gen/hood/hi/hoon` and the [miso](@/docs/arvo/clay/data-types.md#miso-clay-ankh-delta) is one of these types of requests:
184184
185185- `%del` - Delete a file.
@@ -214,14 +214,14 @@ There are four Clay `task`s relevant to mounts:
214214
215215## `%boat`
216216
217−```hoon
218−[%boat ~]
219−```
220−
221217A `%boat` `task` requests the list of existing mounts.
222218
223219### Accepts
224220
221+```hoon
222+~
223+```
224+
225225A `%boat` `task` does not take any arguments.
226226
227227### Returns
@@ -240,14 +240,15 @@ The type it returns is a `%hill` `gift`, which looks like:
240240
241241## `%mont`
242242
243−```hoon
244−[%mont pot=term bem=beam]
245−```
246243
247244A `%mont` `task` mounts the specified `beam` to the specified `term` mount point.
248245
249246### Accepts
250247
248+```hoon
249+[pot=term bem=beam]
250+```
251+
251252A `beam:clay` is the following structure:
252253
253254```hoon
@@ -266,14 +267,14 @@ Clay does not return a `gift` in response to a `%mont` `%task`.
266267
267268## `%ogre`
268269
269−```hoon
270−[%ogre pot=$@(desk beam)]
271−```
272−
273270A `%ogre` `task` unmounts the specified mount.
274271
275272### Accepts
276273
274+```hoon
275+[pot=$@(desk beam)]
276+```
277+
277278It's defined in `lull.hoon` as taking `$@(desk beam)` but in fact it will only unmount the target when specified as a `term` mount name. Passing it a `desk` will incidentally work if the mount is named the same as the `desk` but otherwise it won't work. Passing it a `beam:clay` will simply not work.
278279
279280### Returns
@@ -286,13 +287,13 @@ Clay does not return a `gift` in response to a `%ogre` `task`.
286287
287288## `%dirk`
288289
289−```hoon
290−[%dirk des=desk]
291−```
290+A `%dirk` `task` commits changes in the target mount.
292291
293292### Accepts
294293
295−A `%dirk` `task` commits changes in the target mount.
294+```hoon
295+des=desk
296+```
296297
297298It's defined in `lull.hoon` as taking a `desk` but like [%ogre](#ogre), it actually takes the name of a mount point rather than a `desk` as is specified.
298299
@@ -308,18 +309,16 @@ Clay does not return a `gift` in response to a `%dirk` `task`.
308309
309310## `%merg`
310311
311−```hoon
312−$: %merg :: merge desks
313− des=desk :: target
314− her=@p dem=desk cas=case :: source
315− how=germ :: method
316−== ::
317−```
318−
319312A `%merg` `task` will merge the specified source `desk` into the target local `desk`.
320313
321314### Accepts
322315
316+```hoon
317+$: des=desk :: target
318+ her=@p dem=desk cas=case :: source
319+ how=germ :: method
320+==
321+```
323322The `germ` specifies the merge strategy. You can refer to the [Strategies](@/docs/arvo/clay/using.md#strategies) section of the [Using Clay](@/docs/arvo/clay/using.md) document for details of each `germ`.
324323
325324If you're merging into a new `desk` you must use `%init`, all other strategies will fail. If the desk already exists, you cannot use `%init`. Otherwise, you're free to use whichever you'd like.
@@ -393,16 +392,16 @@ We'll look at each of these in turn.
393392
394393## `%perm`
395394
396−```hoon
397−[%perm des=desk pax=path rit=rite] :: change permissions
398−```
399−
400395A `%perm` `task` sets permissions for the target file or directory.
401396
402397Note this will replace existing permissions rather than add to them, so if you want to add a ship to an existing whitelist or whatever you'll have to first read the existing permissions, add the ship, then send the whole lot back.
403398
404399### Accepts
405400
401+```hoon
402+[des=desk pax=path rit=rite]
403+```
404+
406405The `pax` path is the file or directory whose permissions you want to change, and the `rite` is this structure:
407406
408407```hoon
@@ -436,14 +435,14 @@ Clay does not return a `gift` in response to a `%perm` `task`.
436435
437436## `%cred`
438437
439−```hoon
440−[%cred nom=@ta cew=crew] :: set permission group
441−```
442−
443438This simply creates a permission group.
444439
445440### Accepts
446441
442+```hoon
443+[nom=@ta cew=crew]
444+```
445+
447446The `nom` is a name for the group and the `crew` is just a `(set ship)`:
448447
449448```hoon
@@ -460,13 +459,14 @@ Clay does not return a `gift` in response to a `%cred` `task`.
460459
461460## `%crew`
462461
463−```hoon
464−[%crew ~] :: permission groups
465−```
466462This retrieves all permission groups.
467463
468464### Accepts
469465
466+```hoon
467+~
468+```
469+
470470A `%crew` `task` takes no arguments.
471471
472472### Returns
@@ -485,14 +485,14 @@ The `cez` is just a map from group name to `crew` which is just a `(set ship)`.
485485
486486## `%crow`
487487
488−```hoon
489−[%crow nom=@ta] :: group usage
490−```
491−
492488A `%crow` `task` retrieves all files and directories in all `desk`s which have permissions set for the group in question. It will not return inherited permissions, only those explicitly set.
493489
494490### Accepts
495491
492+```hoon
493+nom=@ta
494+```
495+
496496The `nom` is the name of a `crew`.
497497
498498### Returns