From 263ace6657195776addcce66fab6e16b68fc39e3 Mon Sep 17 00:00:00 2001
From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Thu, 20 May 2021 14:13:00 +0200
Subject: [PATCH] Add note about cursor.callproc() and PostgreSQL procedures

Close #1155
---
 doc/src/cursor.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/src/cursor.rst b/doc/src/cursor.rst
index 78db03f0..ad0e74be 100644
--- a/doc/src/cursor.rst
+++ b/doc/src/cursor.rst
@@ -232,6 +232,16 @@ The ``cursor`` class
         .. versionchanged:: 2.7
           added support for named arguments.
 
+        .. note::
+
+            `!callproc()` can only be used with PostgreSQL functions__, not
+            with the procedures__ introduced in PostgreSQL 11, which require
+            the :sql:`CALL` statement to run. Please use a normal
+            `execute()` to run them.
+
+            .. __: https://www.postgresql.org/docs/current/sql-createfunction.html
+            .. __: https://www.postgresql.org/docs/current/sql-createprocedure.html
+
     .. method:: mogrify(operation [, parameters])
 
         Return a query string after arguments binding. The string returned is