From 4b5c276559d236490ea05c733c8f784c1d50208b Mon Sep 17 00:00:00 2001
From: Markus Fischer <mfischer@php.net>
Date: Fri, 6 Sep 2002 13:02:32 +0000
Subject: [PATCH] - Document the "changes database and not back" behaviour. -
 Incooperate user comment about insert/select/delete queries from
 ceo@l-i-e.com

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@94890 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mysql/functions/mysql-db-query.xml | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

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>.