docs: psql '--' comments are not passed to the server

C-style block comments are passed to the server.

diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml
index 5dce06af26ed09929decd29ce2da0108a2ceddf0..85899d78fc591ae78e08abd3ad1894a093ef2e8f 100644 (file)
--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
@@ -679,6 +679,12 @@ testdb=>
     <xref linkend="SQL-LISTEN"> and
     <xref linkend="SQL-NOTIFY">.
     </para>
+
+    <para>
+    While C-style block comments are passed to the server for
+    processing and removal, SQL-standard comments are removed by
+    <application>psql</application>.
+    </para>
   </refsect2>
 
   <refsect2 id="APP-PSQL-meta-commands">