From c48e0c9dc7a0292fd8280cc31c55bfd8b45c1bdd Mon Sep 17 00:00:00 2001 From: Automatic website updater <> Date: Mon, 23 Mar 2026 11:57:27 +0000 Subject: [PATCH] Automatic website update --- index.html | 165 +++++++++++++++++++++++++++++++++++------------------ 1 file changed, 109 insertions(+), 56 deletions(-) diff --git a/index.html b/index.html index 89a7382..9508809 100644 --- a/index.html +++ b/index.html @@ -224,7 +224,8 @@ on CVAR in a fiber to implement clean shutdown on Ctrl-C:
Procedure: call-with-temporary-thread a
-

Undocumented procedure. +

Run THUNK in a temporary thread and return its result to the calling +fiber.

@@ -256,7 +257,7 @@ buffering.
Procedure: knots-exception-stack obj
-

Undocumented procedure. +

Return the stack from a &knots-exception.

@@ -265,7 +266,7 @@ buffering.
Procedure: knots-exception? obj
-

Undocumented procedure. +

Return #t if OBJ is a &knots-exception.

@@ -274,7 +275,7 @@ buffering.
Procedure: make-knots-exception a
-

Undocumented procedure. +

Construct a &knots-exception with the given stack.

@@ -283,7 +284,33 @@ buffering.
Procedure: print-backtrace-and-exception/knots _ KEY: #:port
-

Undocumented procedure. +

Print the backtrace and exception information from EXN to PORT. This +procedure captures the stack, so should be run before the stack is +unwound, so using with-exception-handler without #:unwind? +#t, the exception may need to then be re-raised and handled in an outer +exception handler. +

+
+
(with-exception-handler
+    (lambda (exn)
+      ;; Recover from the exception
+      #f)
+  (lambda ()
+    (with-exception-handler
+        (lambda (exn)
+          (print-backtrace-and-exception/knots exn)
+          (raise-exception exn))
+      (lambda ()
+        (do-things))))
+  #:unwind? #t)
+
+ +

It’s important to use print-backtrace-and-exception/knots for +displaying backtraces involving functionality from Guile Knots, since +the stack involved is potentially split across several fibers. The +stacks involved are attached to the exception, and this procedure +extracts this information out and assembles a backtrace including all +the code involved.

@@ -367,18 +394,9 @@ Next:

-
-
Procedure: classify-stack-situation a
-

Undocumented procedure. -

-
- - - -
Procedure: knots-exception-stack obj
-

Undocumented procedure. +

Return the stack from a &knots-exception.

@@ -387,7 +405,7 @@ Next:
-

Undocumented procedure. +

Return #t if OBJ is a &knots-exception.

@@ -396,7 +414,7 @@ Next:
-

Undocumented procedure. +

Construct a &knots-exception with the given stack.

@@ -405,7 +423,33 @@ Next:
-

Undocumented procedure. +

Print the backtrace and exception information from EXN to PORT. This +procedure captures the stack, so should be run before the stack is +unwound, so using with-exception-handler without #:unwind? +#t, the exception may need to then be re-raised and handled in an outer +exception handler. +

+
+
(with-exception-handler
+    (lambda (exn)
+      ;; Recover from the exception
+      #f)
+  (lambda ()
+    (with-exception-handler
+        (lambda (exn)
+          (print-backtrace-and-exception/knots exn)
+          (raise-exception exn))
+      (lambda ()
+        (do-things))))
+  #:unwind? #t)
+
+ +

It’s important to use print-backtrace-and-exception/knots for +displaying backtraces involving functionality from Guile Knots, since +the stack involved is potentially split across several fibers. The +stacks involved are attached to the exception, and this procedure +extracts this information out and assembles a backtrace including all +the code involved.

@@ -525,7 +569,7 @@ this will be raised after all exceptions have finished.
Macro: parallelism-limiter? a
-

Undocumented macro. +

Return #t if OBJ is a <parallelism-limiter>.

@@ -534,7 +578,8 @@ this will be raised after all exceptions have finished.
Macro: with-parallelism-limiter a
-

Undocumented macro. +

Evaluate EXP ... while holding a slot from PARALLELISM-LIMITER. +Syntactic sugar around call-with-parallelism-limiter.

@@ -560,7 +605,7 @@ available.
Procedure: destroy-parallelism-limiter a
-

Undocumented procedure. +

Destroy PARALLELISM-LIMITER, releasing its underlying resource pool.

@@ -675,7 +720,7 @@ Next: , Pre
Macro: fibers-promise? a
-

Undocumented macro. +

Return #t if OBJ is a <fibers-promise>.

@@ -810,7 +855,7 @@ Next: , Previ
Macro: resource-pool-channel a
-

Undocumented macro. +

Return the channel used by the resource pool.

@@ -819,7 +864,7 @@ Next: , Previ
Macro: resource-pool-configuration a
-

Undocumented macro. +

Return the configuration alist of the resource pool.

@@ -828,7 +873,7 @@ Next: , Previ
Macro: resource-pool-name a
-

Undocumented macro. +

Return the name of the resource pool.

@@ -837,7 +882,7 @@ Next: , Previ
Macro: resource-pool? a
-

Undocumented macro. +

Return #t if OBJ is a <resource-pool>.

@@ -846,7 +891,8 @@ Next: , Previ
Macro: with-resource-from-pool a
-

Undocumented macro. +

Evaluate EXP ... with RESOURCE bound to a resource checked out from +POOL. Syntactic sugar around call-with-resource-from-pool.

@@ -1009,7 +1055,7 @@ the current scheduler.
Procedure: make-resource-pool-destroy-resource-exception
-

Undocumented procedure. +

Construct a &resource-pool-destroy-resource exception.

@@ -1018,7 +1064,8 @@ the current scheduler.
Procedure: resource-pool-destroy-resource-exception? obj
-

Undocumented procedure. +

Return #t if OBJ is a &resource-pool-destroy-resource +exception.

@@ -1027,7 +1074,7 @@ the current scheduler.
Procedure: resource-pool-destroyed-error-pool obj
-

Undocumented procedure. +

Return the pool from a &resource-pool-destroyed exception.

@@ -1036,7 +1083,7 @@ the current scheduler.
Procedure: resource-pool-destroyed-error? obj
-

Undocumented procedure. +

Return #t if OBJ is a &resource-pool-destroyed exception.

@@ -1078,7 +1125,7 @@ number of seconds to wait; defaults to 5. Raises
Procedure: resource-pool-timeout-error-pool obj
-

Undocumented procedure. +

Return the pool from a &resource-pool-timeout exception.

@@ -1087,7 +1134,7 @@ number of seconds to wait; defaults to 5. Raises
Procedure: resource-pool-timeout-error? obj
-

Undocumented procedure. +

Return #t if OBJ is a &resource-pool-timeout exception.

@@ -1096,7 +1143,7 @@ number of seconds to wait; defaults to 5. Raises
Procedure: resource-pool-too-many-waiters-error-pool obj
-

Undocumented procedure. +

Return the pool from a &resource-pool-too-many-waiters exception.

@@ -1105,7 +1152,8 @@ number of seconds to wait; defaults to 5. Raises
Procedure: resource-pool-too-many-waiters-error-waiters-count obj
-

Undocumented procedure. +

Return the waiters count from a &resource-pool-too-many-waiters +exception.

@@ -1114,7 +1162,8 @@ number of seconds to wait; defaults to 5. Raises
Procedure: resource-pool-too-many-waiters-error? obj
-

Undocumented procedure. +

Return #t if OBJ is a &resource-pool-too-many-waiters +exception.

@@ -1242,7 +1291,7 @@ Next: ,
Macro: fixed-size-thread-pool-channel a
-

Undocumented macro. +

Return the channel of the fixed-size thread pool.

@@ -1251,7 +1300,7 @@ Next: ,
Macro: fixed-size-thread-pool-current-procedures a
-

Undocumented macro. +

Return the current procedures vector of the fixed-size thread pool.

@@ -1260,7 +1309,7 @@ Next: ,
Macro: fixed-size-thread-pool? a
-

Undocumented macro. +

Return #t if OBJ is a <fixed-size-thread-pool>.

@@ -1269,7 +1318,7 @@ Next: ,
Macro: thread-pool-resource-pool a
-

Undocumented macro. +

Return the underlying resource pool of the thread pool.

@@ -1278,7 +1327,7 @@ Next: ,
Macro: thread-pool? a
-

Undocumented macro. +

Return #t if OBJ is a <thread-pool>.

@@ -1468,7 +1517,7 @@ bytes.
Procedure: thread-pool-arguments-parameter a
-

Undocumented procedure. +

Return the arguments parameter for POOL, dispatching on pool type.

@@ -1477,7 +1526,7 @@ bytes.
Procedure: thread-pool-default-checkout-timeout a
-

Undocumented procedure. +

Return the default checkout timeout for POOL.

@@ -1486,7 +1535,7 @@ bytes.
Procedure: thread-pool-timeout-error-pool obj
-

Undocumented procedure. +

Return the pool from a &thread-pool-timeout-error exception.

@@ -1495,7 +1544,8 @@ bytes.
Procedure: thread-pool-timeout-error? obj
-

Undocumented procedure. +

Return #t if OBJ is a &thread-pool-timeout-error +exception.

@@ -1546,7 +1596,7 @@ Next:
-

Undocumented procedure. +

Return #t if OBJ is a &port-read-timeout-error.

@@ -1555,7 +1605,7 @@ Next:
-

Undocumented procedure. +

Return #t if OBJ is a &port-timeout-error.

@@ -1564,7 +1614,7 @@ Next:
-

Undocumented procedure. +

Return #t if OBJ is a &port-write-timeout-error.

@@ -1695,7 +1745,7 @@ Next: , Previou
Macro: web-server-port a
-

Undocumented macro. +

Return the port number of the web server.

@@ -1704,7 +1754,7 @@ Next: , Previou
Macro: web-server-socket a
-

Undocumented macro. +

Return the socket of the web server.

@@ -1713,7 +1763,7 @@ Next: , Previou
Macro: web-server? a
-

Undocumented macro. +

Return #t if OBJ is a <web-server>.

@@ -1728,7 +1778,8 @@ Next: , Previou
Procedure: default-write-response-exception-handler a b
-

Undocumented procedure. +

Default handler for exceptions raised while writing an HTTP response. +Logs the error for REQUEST to the current error port.

@@ -1753,7 +1804,8 @@ true.
Procedure: read-request-body/knots a
-

Undocumented procedure. +

Read and return the full body of request R as a bytevector. Handles +chunked transfer encoding.

@@ -1762,7 +1814,8 @@ true.
Procedure: request-body-ended-prematurely-error? obj
-

Undocumented procedure. +

Return #t if OBJ is a &request-body-ended-prematurely +exception.

@@ -1771,7 +1824,8 @@ true.
Procedure: request-body-port/knots a
-

Undocumented procedure. +

Return an input port for reading the body of request REQUEST. Handles +chunked transfer encoding.

@@ -2048,7 +2102,6 @@ Next: , Pre call-with-sigintknots call-with-temporary-threadknots call-with-threadknots_thread-pool -classify-stack-situationknots_backtraces
D default-write-response-exception-handlerknots_web-server