@@ -163,7 +163,7 @@ A `%many` request asks to be notified on every change in a `desk` for a range of
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`.
167Generally used when we store a request in our state somewhere. This is so that
167Generally used when we store a request in our state somewhere. This is so that
168we can determine whether new versions actually affect the path we're subscribed to.
168we can determine whether new versions actually affect the path we're subscribed to.
@@ -174,9 +174,9 @@ we can determine whether new versions actually affect the path we're subscribed
174 +$ mood [=care =case =path] :: request in desk
174 +$ mood [=care =case =path] :: request in desk
177−This represents a request for the state of the `desk` at a particular
177+This represents a request for data related to the state of the `desk` at a
178−commit, specfied by `case`. `care` specifies what kind of information is
178+particular commit, specfied by `case`. `care` specifies what kind of information
179−desired, and `path` specifies the path we are requesting.
179+is desired, and `path` specifies the path we are requesting.
181#### `$moat:clay`, range subscription request
181#### `$moat:clay`, range subscription request
@@ -248,9 +248,10 @@ if `q:ankh` is null), then this produces null.
251−This is a single node in the filesystem. This may be file or a directory
251+This is a recursive filesystem node type that can describe a whole tree of
252−or both. In Earth filesystems, a node is a file xor a directory. On
252+folders and files, with subtrees organized by path prefix. In Earth filesystems,
253−Mars, we're inclusive, so a node is a file ior a directory.
253+a node is a file xor a directory. On Mars, we're inclusive, so a node is a file
255`fil` is the contents of this file, if any. `p.fil` is a hash of the
256`fil` is the contents of this file, if any. `p.fil` is a hash of the
256contents while `q.fil` is the data itself.
257contents while `q.fil` is the data itself.