on master help sign in
gall-guide: commit more poprox suggestions
166de36tinnus-napbus
content/docs/userspace/gall-guide/6-pokes.md+3−3
@@ -144,7 +144,7 @@ The simplest way to handle a `%poke-ack` by passing it to `default-agent`'s
144`on-agent` arm, which will just print an error message to the terminal if it's a
144`on-agent` arm, which will just print an error message to the terminal if it's a
145nack, and otherwise do nothing. Sometimes you'll want your agent to do something
145nack, and otherwise do nothing. Sometimes you'll want your agent to do something
146different depending on whether the poke failed or succeeded (and therefore
146different depending on whether the poke failed or succeeded (and therefore
147−whether it's a nack or an ack). In that case, you'd typically first test the
147+whether it's a nack or an ack). As stated in the [Precepts](/docs/development/precepts#specifics): "Route on wire before sign, never sign before wire.". Thus we first test the
148`wire` so you can tell what the `%poke-ack` was for. You might do something
148`wire` so you can tell what the `%poke-ack` was for. You might do something
149like:
149like:
150
150
@@ -384,7 +384,7 @@ rather that updating its own state, it sends two pokes to `%pokeme`, so
384 ?+ wire (on-agent:def wire sign)
384 ?+ wire (on-agent:def wire sign)
385 [%inc ~]
385 [%inc ~]
386 ?. ?=(%poke-ack -.sign)
386 ?. ?=(%poke-ack -.sign)
387− (on-agent wire sign)
387+ (on-agent:def wire sign)
388 ?~ p.sign
388 ?~ p.sign
389 %- (slog '%pokeit: Increment poke succeeded!' ~)
389 %- (slog '%pokeit: Increment poke succeeded!' ~)
390 `this
390 `this
@@ -393,7 +393,7 @@ rather that updating its own state, it sends two pokes to `%pokeme`, so
393 ::
393 ::
394 [%dec ~]
394 [%dec ~]
395 ?. ?=(%poke-ack -.sign)
395 ?. ?=(%poke-ack -.sign)
396− (on-agent wire sign)
396+ (on-agent:def wire sign)
397 ?~ p.sign
397 ?~ p.sign
398 %- (slog '%pokeit: Decrement poke succeeded!' ~)
398 %- (slog '%pokeit: Decrement poke succeeded!' ~)
399 `this
399 `this
content/docs/userspace/gall-guide/9-vanes.md+2
@@ -234,6 +234,8 @@ to `on-arvo`, on the `wire` we specified (`/timers`). Here's the `on-arvo` arm:
234
234
235We remark that, just like in the case of agent-agent communication, `gift`s from Arvo are also routed `wire` before `sign-arvo`.
235We remark that, just like in the case of agent-agent communication, `gift`s from Arvo are also routed `wire` before `sign-arvo`.
236
236
237+We remark that, just like in the case of agent-agent communication, `gift`s from Arvo are also routed `wire` before `sign-arvo`.
238+
237First we check the `wire` is `/timers`, and then we check the `sign-arvo` begins
239First we check the `wire` is `/timers`, and then we check the `sign-arvo` begins
238with `[%behn %wake ....]`. Behn's `%wake` gift has the following format:
240with `[%behn %wake ....]`. Behn's `%wake` gift has the following format:
239
241