on master help sign in
miso
df6236edrbeefsupreme
arvo/clay/data-types.md+16−11
@@ -582,21 +582,26 @@ This describes a `list` of changes to make to a `desk`. The `path`s are `path`s
582to files to be changed, and the corresponding `miso` value is a description of
582to files to be changed, and the corresponding `miso` value is a description of
583the change itself.
583the change itself.
584
584
585−#### `++miso:clay`, ankh delta
585+#### `$miso:clay`, ankh delta
586
586
587```hoon
587```hoon
588− ++ miso :: ankh delta
588+ +$ miso :: ankh delta
589− $% [%del p=*] :: delete
589+ $% [%del ~] :: delete
590− [%ins p=*] :: insert
590+ [%ins p=cage] :: insert
591+ [%dif p=cage] :: mutate from diff
591− [%mut p=udon] :: mutate
592+ [%mut p=cage] :: mutate from raw
592− == ::
593+ == ::
593```
594```
594
595
595−There are three kinds of changes that may be made to a node in a desk.
596+There are four kinds of changes that may be made to a node in a `desk`.
596−We can insert a file, in which case `p` is the contents of the new file.
597+
597−We can delete a file, in which case `p` is the contents of the old file.
598+`%del` deletes the node.
598−Finally, we can mutate that file, in which case the `udon` describes the
599+
599−changes we are applying to the file.
600+`%ins` inserts a file given by `p`.
601+
602+`%dif` is currently unimplemented.
603+
604+`%mut` mutates the file using raw data given by `p`.
600
605
601#### `++mizu:clay`, merged state
606#### `++mizu:clay`, merged state
602
607