diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 402c4b1b26..b4a9fc3b60 100644
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -3781,6 +3781,14 @@ bar
         fail after having already displayed some rows.
         </para>
 
+        <note>
+        <para>
+        This feature does not works properly with multi-command
+        (<literal>\;</literal>) queries as it depends on the command
+        types encountered in the string.
+        </para>
+        </note>
+
         <tip>
         <para>
         Although you can use any output format with this feature,
