docs: reword notes on cancellation

diff --git a/docs/api/connections.rst b/docs/api/connections.rst
index afa546cc2fc915ba4637c885088bebba05665969..4dfaec271ba1632a4077c29a22fad6c29be82580 100644 (file)
--- 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