From d799d07a7967ea57b28a4e9253477596eb7941ad Mon Sep 17 00:00:00 2001
From: Esen Sagynov <cubrid@php.net>
Date: Tue, 4 Jan 2011 02:18:05 +0000
Subject: [PATCH] update doc for cubrid_fetch_object and
 cubrid_unbuffered_query; fix a spell mistake in doc for cubrid_prepare

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@307053 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../cubrid/functions/cubrid-fetch-object.xml  | 24 +++++++++++++++++--
 reference/cubrid/functions/cubrid-prepare.xml |  2 +-
 .../functions/cubrid-unbuffered-query.xml     | 15 +++++++++---
 3 files changed, 35 insertions(+), 6 deletions(-)

diff --git a/reference/cubrid/functions/cubrid-fetch-object.xml b/reference/cubrid/functions/cubrid-fetch-object.xml
index f6fab41f07..843a1107ae 100644
--- a/reference/cubrid/functions/cubrid-fetch-object.xml
+++ b/reference/cubrid/functions/cubrid-fetch-object.xml
@@ -12,6 +12,8 @@
   <methodsynopsis>
    <type>object</type><methodname>cubrid_fetch_object</methodname>
    <methodparam><type>resource</type><parameter>req_identifier</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
+   <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
   </methodsynopsis>
   <para>
     This function returns an object with the column names of the result set as properties. The values of these properties are extracted from the current row of the result. 
@@ -22,9 +24,27 @@
  &reftitle.parameters;
  <para>
   <variablelist>
+  <varlistentry>
+   <term><parameter>req_identifier</parameter></term>
+   <listitem><para>This is the request identifier.</para></listitem>
+  </varlistentry>
+  <varlistentry>
+    <term><parameter>class_name</parameter></term>
+      <listitem>
+       <para>
+        The name of the class to instantiate, set the properties of and return.
+        If not specified, a <classname>stdClass</classname> object is returned.
+       </para>
+     </listitem>
+   </varlistentry>
     <varlistentry>
-  <term><parameter>req_identifier</parameter></term>
-  <listitem><para>This is the request identifier.</para></listitem>
+     <term><parameter>params</parameter></term>
+      <listitem>
+       <para>
+        An optional <type>array</type> of parameters to pass to the constructor
+        for <parameter>class_name</parameter> objects.
+       </para>
+     </listitem>
    </varlistentry>
   </variablelist>
   </para>
diff --git a/reference/cubrid/functions/cubrid-prepare.xml b/reference/cubrid/functions/cubrid-prepare.xml
index 0a4266518d..a97df61ba7 100644
--- a/reference/cubrid/functions/cubrid-prepare.xml
+++ b/reference/cubrid/functions/cubrid-prepare.xml
@@ -19,7 +19,7 @@
 						The <function>cubrid_prepare</function> function is a sort of API which represents SQL statements compiled previously to a given connection handle. This pre-compiled SQL statement will be included in the <function>cubrid_prepare</function>. 
   </para>
   <para>
-						Accccordingly, you can use this statement effectively to execute several times repeatedly or to process long data. Only a single statement can be used and a parameter may put a question mark (?) to appropriate area in the SQL statement. Add a parameter when you bind a value in the VALUES cluse of INSERT statement or in the WHERE clause. Note that it is allowed to bind a value to a MARK(?) by the <function>cubrid_bind</function> only. 
+						Accccordingly, you can use this statement effectively to execute several times repeatedly or to process long data. Only a single statement can be used and a parameter may put a question mark (?) to appropriate area in the SQL statement. Add a parameter when you bind a value in the VALUES clause of INSERT statement or in the WHERE clause. Note that it is allowed to bind a value to a MARK(?) by the <function>cubrid_bind</function> only. 
   </para>
  </refsect1>
 
diff --git a/reference/cubrid/functions/cubrid-unbuffered-query.xml b/reference/cubrid/functions/cubrid-unbuffered-query.xml
index 7d8e687b6d..915e3c039f 100644
--- a/reference/cubrid/functions/cubrid-unbuffered-query.xml
+++ b/reference/cubrid/functions/cubrid-unbuffered-query.xml
@@ -17,9 +17,6 @@
   <para>
     This function performs a query without fetching the results into memory. 
   </para>
-  <para>
-  Known issue: it currently uses the normal version - the one that fetches the results.  
-  </para>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -51,6 +48,18 @@
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    The benefits of <function>cubrid_unbuffered_query</function> come
+    at a cost: you cannot use <function>cubrid_num_rows</function> and
+    <function>cubrid_data_seek</function> on a result set returned from
+    <function>cubrid_unbuffered_query</function>. 
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>