on master help sign in
gall-guide: 5-cards - clarify acks in response to poke/watch and poke-as/watch-as
7bd96e3Tinnus Napbus
content/docs/userspace/gall-guide/5-cards.md+7−7
@@ -208,13 +208,13 @@ These can be divided into two categories:
208
208
209### Acknowledgements
209### Acknowledgements
210
210
211+`%watch-ack` is sent in response to a `%watch` or `%watch-as` request, and
211−`%watch-ack` and `%poke-ack` are sent in response to a `%watch` or `%poke`
212+`%poke-ack` is sent in response to a `%poke` or `%poke-as` request. If the
212−request respectively. If the `(unit tang)` is null, it's an ack - a positive
213−acknowledgement. If the `(unit tang)` is non-null, it's a nack - a negative
213+`(unit tang)` is null, it's an ack - a positive acknowledgement. If the `(unit tang)` is non-null, it's a nack - a negative acknowledgement, and the `tang`
214−acknowledgement, and the `tang` contains an error message. Gall automatically
214+contains an error message. Gall automatically sends a nack with a stack trace if
215−sends a nack with a stack trace if your agent crashes while processing the
215+your agent crashes while processing the request, and automatically sends an ack
216−request, and automatically sends an ack if it does not. Therefore, you would not
217−explicitly produce a `%watch-ack` or `%poke-ack` gift.
216+if it does not. Therefore, you would not explicitly produce a `%watch-ack` or
217+`%poke-ack` gift.
218
218
219#### Examples
219#### Examples
220
220