on master help sign in
rave
526d2fedrbeefsupreme
arvo/clay/data-types.md+21−4
@@ -124,7 +124,7 @@ permissions by `path` and `pew` is a `map` of write permissions by `path`.
124`wove` is mapped to a set of `duct`s associated to subscribers who should be
124`wove` is mapped to a set of `duct`s associated to subscribers who should be
125notified when the request is filled/updated.
125notified when the request is filled/updated.
126
126
127−#### `++rave:clay`, general subscription request
127+#### `$rave:clay`, general subscription request
128
128
129```hoon
129```hoon
130 ++ rave :: general request
130 ++ rave :: general request
@@ -133,9 +133,26 @@ notified when the request is filled/updated.
133 == ::
133 == ::
134```
134```
135
135
136+```hoon
137+ +$ rave :: general request
138+ $% [%sing =mood] :: single request
139+ [%next =mood] :: await next version
140+ [%mult =mool] :: next version of any
141+ [%many track=? =moat] :: track range
142+ == ::
143+```
144+
136−This represents a subscription request for a desk. The request can be
145+This represents a subscription request for a `desk`.
137−for either a single item in the desk or else for a range of changes on
146+
138−the desk.
147+A `%sing` request asks for data at single revision.
148+
149+A `%next` request asks to be notified the next time there’s a change to the
150+specified file.
151+
152+A `%mult` request asks to be notified the next time there's a change to a
153+specified set of files.
154+
155+A `%many` request asks to be notified on every change in a `desk` for a range of changes (including into the future).
139
156
140### `++rove`, stored general subscription request
157### `++rove`, stored general subscription request
141
158