Index: msql-data-seek.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/msql/functions/msql-data-seek.xml,v
retrieving revision 1.6
diff -u -r1.6 msql-data-seek.xml
--- msql-data-seek.xml	2 Mar 2004 10:16:06 -0000	1.6
+++ msql-data-seek.xml	18 Feb 2005 06:06:34 -0000
@@ -25,7 +25,10 @@
     </para>
     <para> 
      See also
-     <function>msql_fetch_row</function>.
+     <function>msql_fetch_array</function>,
+     <function>msql_fetch_object</function>,
+     <function>msql_fetch_row</function> and
+     <function>msql_result</function>.
     </para>
    </refsect1>
   </refentry>
Index: msql-fetch-array.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/msql/functions/msql-fetch-array.xml,v
retrieving revision 1.5
diff -u -r1.5 msql-fetch-array.xml
--- msql-fetch-array.xml	2 Mar 2004 10:17:01 -0000	1.5
+++ msql-fetch-array.xml	18 Feb 2005 06:06:34 -0000
@@ -9,8 +9,8 @@
    <refsect1>
     <title>Description</title>
      <methodsynopsis>
-      <type>int</type><methodname>msql_fetch_array</methodname>
-      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
+      <type>array</type><methodname>msql_fetch_array</methodname>
+      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
       <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
      </methodsynopsis>
     <para>
@@ -29,21 +29,55 @@
      take the following values: MSQL_ASSOC, MSQL_NUM, and MSQL_BOTH with
      MSQL_BOTH being the default.
     </para>
-    <para>
-     Be careful if you are retrieving results from a query that may
-     return a record that contains only one field that has a value of
-     0 (or an empty string, or &null;).
-    </para>  
     <para> 
      An important thing to note is that using
      <function>msql_fetch_array</function> is NOT significantly slower
      than using <function>msql_fetch_row</function>, while it provides
      a significant added value.
     </para>  
+    <warning>
+     <simpara>
+      In PHP versions prior to 4.3.11 and 5.0.4 a bug existed
+      when retrieving data from columns containing &null; values.
+      Such columns were not placed into the resulting array.
+     </simpara>
+    </warning>
+    <para>
+     <example>
+      <title><function>msql_fetch_array</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$con = msql_connect();
+if (!$con) {
+    die('Server connection problem: ' . msql_error());
+}
+
+if (!msql_select_db('test', $con)) {
+    die('Database connection problem: ' . msql_error());
+}
+
+$result = msql_query('SELECT id, name FROM people', $con);
+if (!$result) {
+    die('Query execution problem: ' . msql_error());
+}
+
+while ($row = msql_fetch_array($result, MSQL_ASSOC)) {
+    echo $row['id'] . ': ' . $row['name'] . "\n";
+}
+
+msql_free_result($result);
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
     <para>
      See also
-     <function>msql_fetch_row</function> and
-     <function>msql_fetch_object</function>.
+     <function>msql_fetch_row</function>,
+     <function>msql_fetch_object</function>,
+     <function>msql_data_seek</function> and
+     <function>msql_result</function>.
     </para>
    </refsect1>
   </refentry>
Index: msql-fetch-object.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/msql/functions/msql-fetch-object.xml,v
retrieving revision 1.3
diff -u -r1.3 msql-fetch-object.xml
--- msql-fetch-object.xml	2 Mar 2004 10:16:06 -0000	1.3
+++ msql-fetch-object.xml	18 Feb 2005 06:06:34 -0000
@@ -9,8 +9,9 @@
    <refsect1>
     <title>Description</title>
      <methodsynopsis>
-      <type>int</type><methodname>msql_fetch_object</methodname>
-      <methodparam><type>int</type><parameter>query_identifier</parameter></methodparam>
+      <type>object</type><methodname>msql_fetch_object</methodname>
+      <methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>result_type</parameter></methodparam>
      </methodsynopsis>
     <para>
      Returns an object with properties that correspond to the fetched
@@ -24,15 +25,59 @@
      their offsets (numbers are illegal property names).
     </para>  
     <para>
+     The second optional argument <parameter>result_type</parameter>
+     is a constant and can take one of the following values:
+     MSQL_ASSOC, MSQL_NUM, and MSQL_BOTH with MSQL_BOTH being the default.
+    </para>
+    <para>
      Speed-wise, the function is identical to
      <function>msql_fetch_array</function>, and almost as quick as
      <function>msql_fetch_row</function> (the difference is
      insignificant).
     </para>  
+    <warning>
+     <simpara>
+      In PHP versions prior to 4.3.11 and 5.0.4 a bug existed
+      when retrieving data from columns containing &null; values.
+      Such columns were not placed into the resulting array.
+     </simpara>
+    </warning>
+    <para>
+     <example>
+      <title><function>msql_fetch_object</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$con = msql_connect();
+if (!$con) {
+    die('Server connection problem: ' . msql_error());
+}
+
+if (!msql_select_db('test', $con)) {
+    die('Database connection problem: ' . msql_error());
+}
+
+$result = msql_query('SELECT id, name FROM people', $con);
+if (!$result) {
+    die('Query execution problem: ' . msql_error());
+}
+
+while ($row = msql_fetch_object($result, MSQL_ASSOC)) {
+    echo $row->id . ': ' . $row->name . "\n";
+}
+
+msql_free_result($result);
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
     <para>
-     See also:
-     <function>msql_fetch_array</function> and
-     <function>msql_fetch_row</function>.
+     See also
+     <function>msql_fetch_array</function>,
+     <function>msql_fetch_row</function>,
+     <function>msql_data_seek</function> and
+     <function>msql_result</function>.
     </para>
    </refsect1>
   </refentry>
Index: msql-fetch-row.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/msql/functions/msql-fetch-row.xml,v
retrieving revision 1.3
diff -u -r1.3 msql-fetch-row.xml
--- msql-fetch-row.xml	2 Mar 2004 10:16:06 -0000	1.3
+++ msql-fetch-row.xml	18 Feb 2005 06:06:34 -0000
@@ -27,10 +27,48 @@
      return the next row in the result set, or &false; if there are no
      more rows.
     </para>
+    <warning>
+     <simpara>
+      In PHP versions prior to 4.3.11 and 5.0.4 a bug existed
+      when retrieving data from columns containing &null; values.
+      Such columns were not placed into the resulting array.
+     </simpara>
+    </warning>
+    <para>
+     <example>
+      <title><function>msql_fetch_row</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$con = msql_connect();
+if (!$con) {
+    die('Server connection problem: ' . msql_error());
+}
+
+if (!msql_select_db('test', $con)) {
+    die('Database connection problem: ' . msql_error());
+}
+
+$result = msql_query('SELECT id, name FROM people', $con);
+if (!$result) {
+    die('Query execution problem: ' . msql_error());
+}
+
+while ($row = msql_fetch_row($result)) {
+    echo $row[0] . ': ' . $row[1] . "\n";
+}
+
+msql_free_result($result);
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
     <para> 
-     See also: <function>msql_fetch_array</function>,
+     See also
+     <function>msql_fetch_array</function>,
      <function>msql_fetch_object</function>,
-     <function>msql_data_seek</function>, and
+     <function>msql_data_seek</function> and
      <function>msql_result</function>.
     </para>
    </refsect1>