From cf87a11d25028b3969fb1fd2c607faed69a0cb4f Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <abies@php.net>
Date: Tue, 2 Sep 2003 00:05:00 +0000
Subject: [PATCH] Explain fetch_flag

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@139419 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/ibase/functions/ibase-fetch-assoc.xml  | 15 ++++++++++-----
 reference/ibase/functions/ibase-fetch-object.xml | 10 ++++++++--
 reference/ibase/functions/ibase-fetch-row.xml    | 14 ++++++++++----
 3 files changed, 28 insertions(+), 11 deletions(-)

diff --git a/reference/ibase/functions/ibase-fetch-assoc.xml b/reference/ibase/functions/ibase-fetch-assoc.xml
index 2d9047d4f1..d67055e480 100644
--- a/reference/ibase/functions/ibase-fetch-assoc.xml
+++ b/reference/ibase/functions/ibase-fetch-assoc.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.ibase-fetch-assoc">
    <refnamediv>
     <refname>ibase_fetch_assoc</refname>
@@ -12,11 +12,11 @@
      <methodsynopsis>
       <type>array</type><methodname>ibase_fetch_assoc</methodname>
       <methodparam><type>resource</type><parameter>result</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>blob_flag</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>fetch_flag</parameter></methodparam>
      </methodsynopsis>
     <para>
      <function>ibase_fetch_assoc</function> returns an associative array
-     that corresponds to the fetched row.  Subsequent calls would return 
+     that corresponds to the fetched row.  Subsequent calls will return 
      the next row in the result set, or &false; if there are no more
      rows.
     </para>
@@ -28,10 +28,15 @@
      the result with numeric indices by using
      <function>ibase_fetch_row</function> or use alias names in your query.
     </para>
+    <para>
+    <parameter>fetch_flag</parameter> is a combination of the constants IBASE_TEXT and IBASE_UNIXTIME
+    ORed together. Passing IBASE_TEXT will cause this function to return BLOB contents
+    instead of BLOB ids. Passing IBASE_UNIXTIME will cause this function to return
+    date/time values as UNIX timestamps instead of as formatted strings.
+    </para>
     <para>
      See also
-     <function>ibase_query</function>, 
-     <function>ibase_fetch_row</function>, and 
+     <function>ibase_fetch_row</function> and 
      <function>ibase_fetch_object</function>.
     </para>
    </refsect1>
diff --git a/reference/ibase/functions/ibase-fetch-object.xml b/reference/ibase/functions/ibase-fetch-object.xml
index d905b3fd27..d92ede536f 100644
--- a/reference/ibase/functions/ibase-fetch-object.xml
+++ b/reference/ibase/functions/ibase-fetch-object.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/ibase.xml, last change in rev 1.9 -->
   <refentry id="function.ibase-fetch-object">
    <refnamediv>
@@ -11,7 +11,7 @@
      <methodsynopsis>
       <type>object</type><methodname>ibase_fetch_object</methodname>
       <methodparam><type>resource</type><parameter>result_id</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>blob_flag</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>fetch_flag</parameter></methodparam>
      </methodsynopsis>
     <para>
      Fetches a row as a pseudo-object from a
@@ -39,6 +39,12 @@
      return the next row in the result set, or &false; if there are no
      more rows.
     </para>
+    <para>
+    <parameter>fetch_flag</parameter> is a combination of the constants IBASE_TEXT and IBASE_UNIXTIME
+    ORed together. Passing IBASE_TEXT will cause this function to return BLOB contents
+    instead of BLOB ids. Passing IBASE_UNIXTIME will cause this function to return
+    date/time values as UNIX timestamps instead of as formatted strings.
+    </para>
     <para>
      See also 
      <function>ibase_fetch_row</function> and
diff --git a/reference/ibase/functions/ibase-fetch-row.xml b/reference/ibase/functions/ibase-fetch-row.xml
index 893568749e..e12038d44b 100644
--- a/reference/ibase/functions/ibase-fetch-row.xml
+++ b/reference/ibase/functions/ibase-fetch-row.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/ibase.xml, last change in rev 1.2 -->
   <refentry id="function.ibase-fetch-row">
    <refnamediv>
@@ -11,7 +11,7 @@
      <methodsynopsis>
       <type>array</type><methodname>ibase_fetch_row</methodname>
       <methodparam><type>resource</type><parameter>result_identifier</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>blob_flag</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>fetch_flag</parameter></methodparam>
      </methodsynopsis>
     <para>
      Returns an array that corresponds to the fetched row, or &false;
@@ -25,14 +25,20 @@
      starting at offset 0.
     </para>
     <para>
-     Subsequent call to <function>ibase_fetch_row</function> would
+     Subsequent calls to <function>ibase_fetch_row</function> will
      return the next row in the result set, or &false; if there are no
      more rows.
     </para>
+    <para>
+    <parameter>fetch_flag</parameter> is a combination of the constants IBASE_TEXT and IBASE_UNIXTIME
+    ORed together. Passing IBASE_TEXT will cause this function to return BLOB contents
+    instead of BLOB ids. Passing IBASE_UNIXTIME will cause this function to return
+    date/time values as UNIX timestamps instead of as formatted strings.
+    </para>
     <para>
      See also
      <function>ibase_fetch_assoc</function> and
-     <function>ibase_fetch_row</function>.
+     <function>ibase_fetch_object</function>.
     </para>
    </refsect1>
   </refentry>