From 2adb6a10da4fc88a9e22af02d7eeccdec199778b Mon Sep 17 00:00:00 2001
From: Stanislav Malyshev <stas@php.net>
Date: Thu, 13 May 2004 14:36:08 +0000
Subject: [PATCH] document sqlite_exec

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@158499 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/sqlite/functions/sqlite-exec.xml | 41 +++++++++++++++++++---
 1 file changed, 36 insertions(+), 5 deletions(-)

diff --git a/reference/sqlite/functions/sqlite-exec.xml b/reference/sqlite/functions/sqlite-exec.xml
index 22604f46bb..9e11d5339b 100644
--- a/reference/sqlite/functions/sqlite-exec.xml
+++ b/reference/sqlite/functions/sqlite-exec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <refentry id="function.sqlite-exec">
  <refnamediv>
   <refname>sqlite_exec</refname>
@@ -11,12 +11,43 @@
   <title>Description</title>
   <methodsynopsis>
    <type>bool</type><methodname>sqlite_exec</methodname>
+   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
    <methodparam><type>string</type><parameter>query</parameter></methodparam>
-   <methodparam><type>resource</type><parameter>db</parameter></methodparam>
   </methodsynopsis>
-  
-  &warn.undocumented.func;
-
+  <methodsynopsis>
+   <type>bool</type><methodname>sqlite_exec</methodname>
+   <methodparam><type>string</type><parameter>query</parameter></methodparam>
+   <methodparam><type>resource</type><parameter>dbhandle</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Executes an SQL statement given by the <parameter>query</parameter> against
+   a given database handle (specified by the <parameter>dbhandle</parameter> 
+   parameter).
+  </para>
+  <para>
+   This function will return a boolean result; &true; for success or &false; for failure.
+   If you need to run a query that returns rows, see <function>sqlite_query</function>.
+  </para>
+  <note>
+   <simpara>
+    Two alternative syntaxes are supported for compatibility with other
+    database extensions (such as MySQL).
+    The preferred form is the first one, where the
+    <parameter>db</parameter> parameter is the first parameter to the
+    function.
+   </simpara>
+  </note>
+  <warning>
+   <simpara>
+    SQLite <emphasis>will</emphasis> execute multiple queries separated by
+    semicolons, so you can use it to execute a batch of SQL that you have
+    loaded from a file or have embedded in a script.
+   </simpara>
+  </warning>
+  <para>
+   See also <function>sqlite_query</function>, <function>sqlite_unbuffered_query</function> and 
+   <function>sqlite_array_query</function>.
+  </para>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file