diff --git a/reference/pgsql/functions/pg-insert.xml b/reference/pgsql/functions/pg-insert.xml
index 8434d5b754..4789d4bbba 100644
--- a/reference/pgsql/functions/pg-insert.xml
+++ b/reference/pgsql/functions/pg-insert.xml
@@ -79,7 +79,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;  Returns <type>string</type> if <constant>PGSQL_DML_STRING</constant> is passed
+   Returns the connection resource on success, &return.falseforfailure;. Returns <type>string</type> if <constant>PGSQL_DML_STRING</constant> is passed
    via <parameter>options</parameter>.
   </para>
  </refsect1>
@@ -119,6 +119,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>5.6.0</entry>
+       <entry>
+        Unless <constant>PGSQL_DML_STRING</constant> is passed, the function
+        now returns the connection resource instead of &true; on success.
+       </entry>
+      </row>
       <row>
        <entry>5.6.0</entry>
        <entry>