From 992e5eb9d1e143f3fc61d322f65f7ae4fda0a479 Mon Sep 17 00:00:00 2001
From: Yasuo Ohgaki <yohgaki@php.net>
Date: Mon, 17 Dec 2001 01:36:02 +0000
Subject: [PATCH] Added notification for function rename and obsolete API.
 Changed pg_last_notice() note. pg_last_notice() is experimental. It's not
 implemented fully. (It does not take into account connection parameter,
 currently)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@65383 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/pgsql.xml | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/functions/pgsql.xml b/functions/pgsql.xml
index 637020d568..cfb65ec194 100644
--- a/functions/pgsql.xml
+++ b/functions/pgsql.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.59 $ -->
+<!-- $Revision: 1.60 $ -->
  <reference id="ref.pgsql">
   <title>PostgreSQL functions</title>
   <titleabbrev>PostgreSQL</titleabbrev>
@@ -11,6 +11,21 @@
      a bug in notice message handling.
     </para>
    </warning>
+   <warning>
+    <para>
+     PostgreSQL function names will be changed in 4.2.0 release to
+     confirm current coding standard. Most of new names will have
+     additional under score(s), e.g. pg_lo_open(). Some functions are
+     renamed to different name for consistency. e.g. pg_exec() to
+     pg_query(). Older names may be used in 4.2.0 and a few releases
+     from 4.2.0, but they may be deleted in the future. CVS version
+     has new function names.
+    </para>
+    <para>
+     Obsolete pg_connect()/pg_pconnect() may be depreciated to support
+     async connect feature in the future.
+    </para>
+   </warning>
    <para>
     Postgres, developed originally in the UC Berkeley Computer Science
     Department, pioneered many of the object-relational concepts now
@@ -983,10 +998,12 @@ for ($i=0; $i < $num; $i++) {
     </para>
     <warning>
      <para>
-      <function>pg_last_notice</function> is added form PHP
+      This function is EXPERIMENTAL and it is not fully implemented
+      yet. <function>pg_last_notice</function> is added form PHP
       4.0.6. However, PHP 4.0.6 has problem with notice message
-      handling. Use of PostgreSQL module with PHP 4.0.6 is not recommended
-      even if you are not using <function>pg_last_notice</function>.
+      handling. Use of PostgreSQL module with PHP 4.0.6 is not
+      recommended even if you are not using
+      <function>pg_last_notice</function>.
      </para>
     </warning>
     <para>