Point out in async connection about blocking DNS and solution

diff --git a/docs/advanced/async.rst b/docs/advanced/async.rst
index 492584fcaa8259f1e09ed0e7caae6856ee18c2b0..4f3e61a093bf204d358fe1e0a42e60ddc5b010fc 100644 (file)
--- a/docs/advanced/async.rst
+++ b/docs/advanced/async.rst
@@ -29,6 +29,18 @@ here and there.
                 print(record)
 
 
+.. warning::
+
+    `AsyncConnection.connect()` may still block on DNS name resolution.
+    To avoid that you should `set the hostaddr connection parameter`__.
+
+    The `~psycopg._dns.resolve_hostaddr_async()` is an experimental solution
+    to help to do that. Feedback about the feature is welcome!
+
+    .. __: https://www.postgresql.org/docs/current/libpq-connect.html
+           #LIBPQ-PARAMKEYWORDS
+
+
 .. index:: with
 
 .. _async-with: