clay api: note only %sing works for remote ships

This commit is contained in:
hosted-fornet 2023-05-24 20:23:37 -06:00 committed by GitHub
parent 5fb044c30e
commit 8b24cf135a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -748,6 +748,8 @@ Clay only allows a subset of `care`s to be used remotely. They are:
Any other `care` will crash with a `%clay-bad-foreign-request-care` error.
In addition, Clay only allows `%sing` requests -- not `%next`, `%mult`, or `%many`. To be informed when a desk on a foreign ship is updated, first `%sing` the current revision number using `%w` and case `da+now` and then `%sing` again with the next revision number using case `ud+<next-revision-number>`.
The foreign ship will respond only if correct permissions have been set. See the [Permissions](#permissions) section for details.
Note that if you're reading a whole `desk` or directory, all subfolders and files must also permit reading. If even a single file does not permit you reading it, the foreign ship will not respond to the request.