@@ -163,7 +163,7 @@ A `%many` request asks to be notified on every change in a `desk` for a range of
163163 == ::
164164```
165165
166−Like a `rave` but with caches of current versions for `%next` and `%many`.
166+Like a `rave` but with provisions to store current versions for `%next` and `%many`.
167167Generally used when we store a request in our state somewhere. This is so that
168168we can determine whether new versions actually affect the path we're subscribed to.
169169
@@ -174,9 +174,9 @@ we can determine whether new versions actually affect the path we're subscribed
174174 +$ mood [=care =case =path] :: request in desk
175175```
176176
177−This represents a request for the state of the `desk` at a particular
178−commit, specfied by `case`. `care` specifies what kind of information is
179−desired, and `path` specifies the path we are requesting.
177+This represents a request for data related to the state of the `desk` at a
178+particular commit, specfied by `case`. `care` specifies what kind of information
179+is desired, and `path` specifies the path we are requesting.
180180
181181#### `$moat:clay`, range subscription request
182182
@@ -248,9 +248,10 @@ if `q:ankh` is null), then this produces null.
248248 == ::
249249```
250250
251−This is a single node in the filesystem. This may be file or a directory
252−or both. In Earth filesystems, a node is a file xor a directory. On
253−Mars, we're inclusive, so a node is a file ior a directory.
251+This is a recursive filesystem node type that can describe a whole tree of
252+folders and files, with subtrees organized by path prefix. In Earth filesystems,
253+a node is a file xor a directory. On Mars, we're inclusive, so a node is a file
254+ior a directory.
254255
255256`fil` is the contents of this file, if any. `p.fil` is a hash of the
256257contents while `q.fil` is the data itself.