From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Sat, 13 Apr 2024 10:23:38 +0000 (+0200)
Subject: docs: reword notes on cancellation
X-Git-Tag: 3.2.0~41^2~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d854aafb9db1d3724dcaf1e5ea2778ce5717f840;p=thirdparty%2Fpsycopg.git

docs: reword notes on cancellation
---

diff --git a/docs/api/connections.rst b/docs/api/connections.rst
index afa546cc2..4dfaec271 100644
--- a/docs/api/connections.rst
+++ b/docs/api/connections.rst
@@ -290,7 +290,8 @@ The `!Connection` class
         .. note::
 
             You can use the `~Capabilities.has_cancel_safe` capability to check
-            if `!cancel_safe()` will not fall back on the legacy implementation.
+            if `!cancel_safe()` will not fall back on the legacy libpq
+            functions.
 
         .. warning::
 
@@ -325,7 +326,8 @@ The `!Connection` class
         .. note::
 
             Unlike `cancel_safe()`, it is safe to call this method as a
-            `~signal.signal` handler.
+            `~signal.signal` handler. This is pretty much the only case in
+            which you might want to use this function.
 
     .. automethod:: notifies