on master help sign in
rove
commit979ae2153a5814a46ae4b517e20a8e9d2fef85b1 authordrbeefsupreme <drbeefsupreme@discordja.net> dateThu 25 Mar 2021, 14:28 (6 years ago) parent526d2fe
1 file changed+18−7
arvo/clay/data-types.md+18−7
arvo/clay/data-types.md+18−7
@@ -154,15 +154,26 @@ specified set of files.
154154
155155A `%many` request asks to be notified on every change in a `desk` for a range of changes (including into the future).
156156
157−### `++rove`, stored general subscription request
158−
159−```hoon
160− ++ rove (each mood moot) :: stored request
157+### `$rove`, stored general subscription request
158+
159+```hoon
160+ +$ rove :: stored request
161+ $% [%sing =mood] :: single request
162+ [%next =mood aeon=(unit aeon) =cach] :: next version of one
163+ $: %mult :: next version of any
164+ =mool :: original request
165+ aeon=(unit aeon) :: checking for change
166+ old-cach=(map [=care =path] cach) :: old version
167+ new-cach=(map [=care =path] cach) :: new version
168+ == ::
169+ [%many track=? =moat lobes=(map path lobe)] :: change range
170+ == ::
161171```
162172
163−When we store a request, we store subscriptions with a little extra
164−information so that we can determine whether new versions actually
165−affect the path we're subscribed to.
173+Like a `rave` but with caches of current versions for `%next` and `%many`.
174+Generally used when we store a request in our state somewhere. This is so that
175+we can determine whether new versions actually affect the path we're subscribed to.
176+
166177
167178#### `++mood:clay`, single subscription request
168179