From 1deff0ba31c10a9af1b8e35472cfa57fa0e49f41 Mon Sep 17 00:00:00 2001
From: Nuno Lopes <nlopess@php.net>
Date: Sun, 4 Jul 2004 09:10:50 +0000
Subject: [PATCH] fix #28994: fix proto in field_prtlen and add note about
 upper-case identifiers

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@162614 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/pgsql/functions/pg-field-prtlen.xml | 12 +++++++++---
 reference/pgsql/reference.xml                 |  9 ++++++++-
 2 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/reference/pgsql/functions/pg-field-prtlen.xml b/reference/pgsql/functions/pg-field-prtlen.xml
index f7f979923b..b21f80659f 100644
--- a/reference/pgsql/functions/pg-field-prtlen.xml
+++ b/reference/pgsql/functions/pg-field-prtlen.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
   <refentry id="function.pg-field-prtlen">
    <refnamediv>
@@ -11,8 +11,8 @@
      <methodsynopsis>
       <type>int</type><methodname>pg_field_prtlen</methodname>
       <methodparam><type>resource</type><parameter>result</parameter></methodparam>
-      <methodparam><type>int</type><parameter>row_number</parameter></methodparam>
-      <methodparam><type>string</type><parameter>field_name</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>row_number</parameter></methodparam>
+      <methodparam><type>mixed</type><parameter>field_name_or_number</parameter></methodparam>
      </methodsynopsis>
     <para>
      <function>pg_field_prtlen</function> returns the actual printed
@@ -20,6 +20,12 @@
      <parameter>result</parameter>.  Row numbering starts at 0.  This
      function will return -1 on an error.
     </para>
+    <para>
+     <parameter>field_name_or_number</parameter> can be passed either as an
+     <type>integer</type> or as a <type>string</type>. If it is passed as an
+     <type>integer</type>, PHP recognises it as the field number, otherwise as
+     field name.
+    </para>
     <para>
      See the example given at the <function>pg_field_name</function> page.
     </para>
diff --git a/reference/pgsql/reference.xml b/reference/pgsql/reference.xml
index b4be7a5335..72f7cde0a1 100644
--- a/reference/pgsql/reference.xml
+++ b/reference/pgsql/reference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.20 $ -->
+<!-- $Revision: 1.21 $ -->
  <reference id="ref.pgsql">
   <title>PostgreSQL Functions</title>
   <titleabbrev>PostgreSQL</titleabbrev>
@@ -263,6 +263,13 @@ export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCOD
 ]]>
      </programlisting>
     </example>
+    <note>
+     <para>
+      PostgreSQL automatically folds all identifiers (e.g. table/column names)
+      to lower-case values. To get it to recognize upper-case values, you must
+      always wrap the identifier in quotes.
+     </para>
+    </note>
    </section>
 
    &reference.pgsql.constants;