Document that libpq's PQgetResult() should be called after a fatal error

bmomjian · bmomjian · commit 06711de9d9d4 · 2011-03-11T05:55:13.000-05:00
to fully process errors.
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
@@ -3846,6 +3846,15 @@ PGresult *PQgetResult(PGconn *conn);
        active and the necessary response data has not yet been read by
        <function>PQconsumeInput</function>.
       </para>
+
+      <note>
+       <para>
+        Even when <function>PQresultStatus</function> indicates a fatal
+        error, <function>PQgetResult</function> should be called until it
+        returns a null pointer to allow <application>libpq</> to
+        process the error information completely.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>
