[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnunet-scheme] 232/324: doc: Partially document handler procedures and
From: |
gnunet |
Subject: |
[gnunet-scheme] 232/324: doc: Partially document handler procedures and interposers. |
Date: |
Tue, 21 Sep 2021 13:24:32 +0200 |
This is an automated email from the git hooks/post-receive script.
maxime-devos pushed a commit to branch master
in repository gnunet-scheme.
commit b582b55c5603acddf0a4ed237a1d84390f26948d
Author: Maxime Devos <maximedevos@telenet.be>
AuthorDate: Fri Sep 3 20:56:34 2021 +0200
doc: Partially document handler procedures and interposers.
* doc/scheme-gnunet.tm (Message handler): Document the handler
procedure and the interposer somewhat.
---
doc/scheme-gnunet.tm | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/doc/scheme-gnunet.tm b/doc/scheme-gnunet.tm
index 8981b4e..3b60d46 100644
--- a/doc/scheme-gnunet.tm
+++ b/doc/scheme-gnunet.tm
@@ -355,7 +355,7 @@
\ \ \ (symbol-value message-type msg:util:dummy)
- \ \ \ (lambda (p) (p))
+ \ \ \ (lambda (thunk) (thunk))
\ \ \ (lambda (slice)
@@ -382,7 +382,15 @@
the type of the message handler.<space|1em>Messages will only be passed to
the handler procedue if the verifiers returns <scm|#true>.
- <todo|document the message type database, interposer and handler procedure>
+ The handler procedure is passed a bytevector slice with the message, but
+ only if the verifier considers it well-formed.<space|1em>The handler
+ procedure and verifier are run from the
+ <with|font-shape|italic|interposer>.<space|1em>The interposer is passed a
+ thunk to execute and may e.g. install exception handlers and parameterise
+ parameters.<space|1em>It can change the current input, output and error
+ ports for example.
+
+ <todo|document the message type database, various procedures>
<subsection|Error handler>
--
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.
- [gnunet-scheme] 194/324: mq-impl/stream: Eliminate atomic box., (continued)
- [gnunet-scheme] 194/324: mq-impl/stream: Eliminate atomic box., gnunet, 2021/09/21
- [gnunet-scheme] 191/324: doc: Document message queue error handling., gnunet, 2021/09/21
- [gnunet-scheme] 216/324: mq: Inject errors if no appropriate message handler exists., gnunet, 2021/09/21
- [gnunet-scheme] 190/324: Correct XXX and TODO on input:regular-end-of-file., gnunet, 2021/09/21
- [gnunet-scheme] 196/324: mq-impl/stream: Stop all fibers when EOF is reached (part 1)., gnunet, 2021/09/21
- [gnunet-scheme] 201/324: tests/mq-stream: Make test more strict., gnunet, 2021/09/21
- [gnunet-scheme] 204/324: mq-impl/stream: Document implementation pitfall., gnunet, 2021/09/21
- [gnunet-scheme] 214/324: tests/mq: Use 'message-handler' macro., gnunet, 2021/09/21
- [gnunet-scheme] 217/324: tests/mq: Spam the log less., gnunet, 2021/09/21
- [gnunet-scheme] 233/324: doc: Document the message type database a little., gnunet, 2021/09/21
- [gnunet-scheme] 232/324: doc: Partially document handler procedures and interposers.,
gnunet <=
- [gnunet-scheme] 239/324: tests/network-size: Don't let the GC close port., gnunet, 2021/09/21
- [gnunet-scheme] 241/324: nse/client: Add a 'disconnected' callback., gnunet, 2021/09/21
- [gnunet-scheme] 195/324: mq-impl/stream: Reduce nesting., gnunet, 2021/09/21
- [gnunet-scheme] 200/324: mq-impl/stream: Make error injection less unobviously correct., gnunet, 2021/09/21
- [gnunet-scheme] 210/324: mq-stream: Reuse 'type' variable instead of reading the type again., gnunet, 2021/09/21
- [gnunet-scheme] 219/324: mq-impl/stream: Create the message queue as late as possible., gnunet, 2021/09/21
- [gnunet-scheme] 230/324: doc: Correct errors in ‘network structure’ section., gnunet, 2021/09/21
- [gnunet-scheme] 235/324: doc: Document how errors and received/sent messages are ordered., gnunet, 2021/09/21
- [gnunet-scheme] 199/324: guix: Use patched version of guile-fibers., gnunet, 2021/09/21
- [gnunet-scheme] 209/324: doc: Resolve the TODO about broken pipes., gnunet, 2021/09/21