docs: add note about features not supported in pipeline mode

diff --git a/docs/advanced/pipeline.rst b/docs/advanced/pipeline.rst
index 6a50f4cd57b5700eb4e1c948f184871d4e165493..dc4c184518cb9acb077db93ed12be26657aa1b03 100644 (file)
--- a/docs/advanced/pipeline.rst
+++ b/docs/advanced/pipeline.rst
@@ -68,6 +68,14 @@ which executed them. If a cursor had run more than one query, it will receive
 more than one result; results after the first will be available, in their
 execution order, using `~Cursor.nextset()`.
 
+.. warning::
+    Certanin features are not available in pipeline mode, including:
+
+    - COPY is not supported in pipeline mode by PostgreSQL.
+    - `Cursor.stream()` doesn't make sense in pipeline mode (its job is the
+      opposite of batching!)
+    - `ServerCursor` are currently not implemented in pipeline mode.
+
 .. note::
     Starting from Psycopg 3.1, `Cursor.executemany()` is optimised to make use
     of pipeline mode.