diff --git a/functions/pgsql.xml b/functions/pgsql.xml
index f986803295..55714f7299 100644
--- a/functions/pgsql.xml
+++ b/functions/pgsql.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.86 $ -->
+<!-- $Revision: 1.87 $ -->
  <reference id="ref.pgsql">
   <title>PostgreSQL functions</title>
   <titleabbrev>PostgreSQL</titleabbrev>
@@ -707,11 +707,18 @@ $dbconn4 = pg_connect ($conn_string);
       <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
      </methodsynopsis>
     <para>
-     <function>pg_last_error</function> returns the last error
-     message for given <parameter>connection</parameter>. Error messages
-     may be overwritten by calls to other PostgreSQL functions, so make
-     sure you call <function>pg_last_error</function> before any other 
-     PostgreSQL functions.
+     <function>pg_last_error</function> returns the last error message
+     for given <parameter>connection</parameter>. 
+    </para>
+    <para>
+     Error messages may be overwritten by internal PostgreSQL(libpq)
+     function calls. It may not return appropriate error message, if
+     multiple errors are occured inside a PostgreSQL module function.
+    </para>
+    <para>
+     Use <function>pg_result_error</function>,
+     <function>pg_result_status</function> and
+     <function>pg_connection_status</function> for better error handling.
     </para>
     <note>
      <para>
@@ -719,7 +726,7 @@ $dbconn4 = pg_connect ($conn_string);
      </para>
     </note>
     <para>
-     See also <function>pg_result_error_message</function>.
+     See also <function>pg_result_error</function>.
     </para>
    </refsect1>
   </refentry>