@@ -124,7 +124,7 @@ permissions by `path` and `pew` is a `map` of write permissions by `path`.
124124`wove` is mapped to a set of `duct`s associated to subscribers who should be
125125notified when the request is filled/updated.
126126
127−#### `++rave:clay`, general subscription request
127+#### `$rave:clay`, general subscription request
128128
129129```hoon
130130 ++ rave :: general request
@@ -133,9 +133,26 @@ notified when the request is filled/updated.
133133 == ::
134134```
135135
136−This represents a subscription request for a desk. The request can be
137−for either a single item in the desk or else for a range of changes on
138−the desk.
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+
145+This represents a subscription request for a `desk`.
146+
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).
139156
140157### `++rove`, stored general subscription request
141158