urbit/developers.urbit.org
1
1
Fork 0
mirror of https://github.com/urbit/developers.urbit.org.git synced 2024-09-11 13:55:59 +03:00
Code Issues Packages Projects Releases Wiki Activity

gall: clarify empty fact path only works in on-watch

Browse Source
This commit is contained in:
Tinnus Napbus 2023-07-01 19:33:02 +12:00
parent d9496f1f65
commit 5cd538040b
1 changed files with 6 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
content/reference/arvo/gall/gall-api.md
View File

@ -816,13 +816,14 @@ subscription content for all subscribers on a given path.
#### Structure #### Structure
```hoon ```hoon
[%fact (list path) =cage] [%fact paths=(list path) =cage]
``` ```
`(list path)` is a list of the paths to send the update on. If no path is `paths` is a list of the subscription paths to send the update on. In
given, then the update is only given to the program that instigated the `+on-watch` alone, if no path is given, then the update is given
request. Typical use of this mode is in `+on-watch` to give an initial update exclusively to the source of the `%watch` request. This is useful for
to a new subscriber to get them up to date. giving initial state to new subscribers. In other contexts, one or more
subscription paths should be provided.
`cage` is a cage of the subscription update. `cage` is a cage of the subscription update.