From de268ac04a55a90f703930a34a40a200bd2ae71e Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <abies@php.net>
Date: Mon, 1 Sep 2003 23:59:18 +0000
Subject: [PATCH] Clarify description. Added PHP5 note

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@139418 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/ibase/functions/ibase-execute.xml | 23 +++++++++++++++++++--
 reference/ibase/functions/ibase-query.xml   | 16 ++++++++++----
 2 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/reference/ibase/functions/ibase-execute.xml b/reference/ibase/functions/ibase-execute.xml
index c7e2b6d1c5..8dfff51804 100644
--- a/reference/ibase/functions/ibase-execute.xml
+++ b/reference/ibase/functions/ibase-execute.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-execute">
    <refnamediv>
@@ -14,10 +14,18 @@
       <methodparam choice="opt"><type>int</type><parameter>bind_args</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Execute a query prepared by <function>ibase_prepare</function>.
+     Execute a query prepared by <function>ibase_prepare</function>. If 
+     the query raises an error, returns &false;. If it is successful and 
+     there is a (possibly empty) result set (such as with a SELECT query), 
+     returns a result identifier. If the query was successful and there were 
+     no results, returns &true;.
+    </para>
+    <para>
      This is a lot more effective than using <function>ibase_query</function>
      if you are repeating a same kind of query several times with only
      some parameters changing.
+    </para>
+    <para>
      <example>
       <title><function>ibase_execute</function> example</title>
       <programlisting role="php">
@@ -39,6 +47,17 @@
       </programlisting>
      </example>
     </para>
+    <note>
+      <para>
+      In PHP 5.0.0 and up, this function returns the number of rows affected by
+      the query (if > 0 and applicable to the statement type). A query that succeeded,
+      but did not affect any rows (eg. an UPDATE of a non-existent record) will return
+      &true;.
+      </para>
+    </note>
+    <para>
+    See also <function>ibase_query</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/ibase/functions/ibase-query.xml b/reference/ibase/functions/ibase-query.xml
index 5b7824842c..16a60644b8 100644
--- a/reference/ibase/functions/ibase-query.xml
+++ b/reference/ibase/functions/ibase-query.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-query">
    <refnamediv>
@@ -15,9 +15,9 @@
       <methodparam choice="opt"><type>int</type><parameter>bind_args</parameter></methodparam>
      </methodsynopsis>
     <simpara>
-     Performs a query on an InterBase database. If the query is not
-     successful, returns &false;. If it is successful and there are resulting
-     rows (such as with a SELECT query), returns a result identifier. If
+     Performs a query on an InterBase database. If the query raises an error,
+     returns &false;. If it is successful and there is a (possibly empty)
+     result set (such as with a SELECT query), returns a result identifier. If
      the query was successful and there were no results, returns &true;.
     </simpara>
     <para>
@@ -39,6 +39,14 @@
       </programlisting>
      </example>
     </para>
+    <note>
+      <para>
+      In PHP 5.0.0 and up, this function returns the number of rows affected by
+      the query (if > 0 and applicable to the statement type). A query that succeeded,
+      but did not affect any rows (eg. an UPDATE of a non-existent record) will return
+      &true;.
+      </para>
+    </note>
     <note>
      <para>
       If you get some error like "arithmetic exception, numeric overflow,