fixing docs

diff --git a/doc/build/changelog/unreleased_20/7156.rst b/doc/build/changelog/unreleased_20/7156.rst
index 15f5207d3ad5159906d4df5ff0540984fb720f07..aa6b235600a61c327c891b692b0eb9ccf125bc17 100644 (file)
--- a/doc/build/changelog/unreleased_20/7156.rst
+++ b/doc/build/changelog/unreleased_20/7156.rst
@@ -3,4 +3,6 @@
     :tickets: 7156
 
     Adds support for PostgreSQL MultiRange types, introduced
-    in PostgreSQL 14.
+    in PostgreSQL 14. Note that this feature currently only
+    tested with `psycopg` and the `psycopg.types.multirange`
+    type.
\ No newline at end of file

diff --git a/doc/build/dialects/postgresql.rst b/doc/build/dialects/postgresql.rst
index 852a9cdba2112f5336b6b2f751f110b73d29894a..2380b9b23a664f1ac2c30a96ba31d712fbc9fce0 100644 (file)
--- a/doc/build/dialects/postgresql.rst
+++ b/doc/build/dialects/postgresql.rst
@@ -187,7 +187,10 @@ mixin:
 .. warning::
 
   The multirange type DDL support should work with any PostgreSQL DBAPI
-  driver, however the data types returned may vary.
+  driver, however the data types returned may vary. The feature is 
+  currently developed against the psycopg driver, and is known to 
+  work with the range types specific to the `psycopg.types.range`
+  extension module.
 
 When instantiating models that use these column types, you should pass
 whatever data type is expected by the DBAPI driver you're using for
@@ -196,7 +199,8 @@ the column type.
 For example:
 
 .. code-block:: python
-
+  # Note: Multirange type currently only tested against the psycopg
+  # driver, hence the use here.
   from psycopg.types.range import Range
   from pscyopg.types.multirange import Multirange
   from sqlalchemy.dialects.postgresql import TSMULTIRANGE