diff --git a/reference/mysql/functions/mysql-db-query.xml b/reference/mysql/functions/mysql-db-query.xml
index c21ff3912e..8072cdd647 100644
--- a/reference/mysql/functions/mysql-db-query.xml
+++ b/reference/mysql/functions/mysql-db-query.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
   <refentry id="function.mysql-db-query">
    <refnamediv>
@@ -18,7 +18,9 @@
      </methodsynopsis>
     <para>
      Returns a positive MySQL result resource to the query result,
-     or &false; on error.
+     or &false; on error. The function also returns &true;/&false; for
+     <literal>INSERT</literal>/<literal>UPDATE</literal>/<literal>DELETE</literal>
+     queries to indicate success/failure.
     </para>
     <para>
      <function>mysql_db_query</function> selects a database and
@@ -28,6 +30,15 @@
      as if <function>mysql_connect</function> was called with no
      arguments.
     </para>
+    <para>
+     Be aware that this function does <emphasis role="strong">NOT</emphasis>
+     switch back to the database you were connected before. In other words,
+     you can't use this function to <emphasis>temporarily</emphasis> run a
+     sql query on another database, you would have to manually switch back.
+     Users are strongly encouraged to use the
+     <literal>database.table</literal> syntax in their sql queries instead of
+     this function.
+    </para>
     <para>
      See also <function>mysql_connect</function> and
      <function>mysql_query</function>.