diff --git a/reference/mysql/functions/mysql-list-dbs.xml b/reference/mysql/functions/mysql-list-dbs.xml
index 6e2dbe20af..d29e5a0f0e 100644
--- a/reference/mysql/functions/mysql-list-dbs.xml
+++ b/reference/mysql/functions/mysql-list-dbs.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.16 -->
   <refentry id="function.mysql-list-dbs">
    <refnamediv>
@@ -20,7 +20,8 @@
      <function>mysql_list_dbs</function> will return a result pointer
      containing the databases available from the current mysql
      daemon. Use the <function>mysql_tablename</function> function to
-     traverse this result pointer, or any function for result tables.
+     traverse this result pointer, or any function for result tables,
+     such as <function>mysql_fetch_array</function>.
     </para>
     <para>
      <example>
diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml
index fd953a7c79..e57381effd 100644
--- a/reference/mysql/functions/mysql-list-tables.xml
+++ b/reference/mysql/functions/mysql-list-tables.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
   <refentry id="function.mysql-list-tables">
    <refnamediv>
@@ -18,10 +18,10 @@
     <para>
      <function>mysql_list_tables</function> takes a database name and
      returns a result pointer much like the
-     <function>mysql_query</function> function. You can use the
-     <function>mysql_tablename</function> function to extract the
-     actual table names from the result pointer, or any other result
-     table function such as <function>mysql_fetch_assoc</function>.
+     <function>mysql_query</function> function. 
+     Use the <function>mysql_tablename</function> function to
+     traverse this result pointer, or any function for result tables,
+     such as <function>mysql_fetch_array</function>.
     </para>
     <para>
      The <parameter>database</parameter> parameter is the name of the 
@@ -34,7 +34,7 @@
      deprecated however and is not recommended.
     </para>
     <example>
-     <title>mysql_list_tables Example</title>
+     <title><function>mysql_list_tables</function> example</title>
      <programlisting role="php">
 <![CDATA[
 <?php
diff --git a/reference/mysql/functions/mysql-tablename.xml b/reference/mysql/functions/mysql-tablename.xml
index f63ee5cc1c..ef0286e71c 100644
--- a/reference/mysql/functions/mysql-tablename.xml
+++ b/reference/mysql/functions/mysql-tablename.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
   <refentry id="function.mysql-tablename">
    <refnamediv>
@@ -19,6 +19,9 @@
      as well as an integer index and returns the name of a table. The
      <function>mysql_num_rows</function> function may be used to
      determine the number of tables in the result pointer.
+     Use the <function>mysql_tablename</function> function to
+     traverse this result pointer, or any function for result tables,
+     such as <function>mysql_fetch_array</function>.
      <example>
       <title><function>mysql_tablename</function> Example</title>
       <programlisting role="php">