From 4cf9520cf213c37351b45ee9773bd3ff5470faef Mon Sep 17 00:00:00 2001
From: Antony Dovgal <tony2001@php.net>
Date: Thu, 25 Mar 2004 08:24:12 +0000
Subject: [PATCH] fix bug #27672 (oci_parse doesn't validate query indeed, it
 only prepares and returns statement identifier)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@154543 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/oci8/functions/oci-parse.xml | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/reference/oci8/functions/oci-parse.xml b/reference/oci8/functions/oci-parse.xml
index 6dd7122133..de6e6b8a98 100644
--- a/reference/oci8/functions/oci-parse.xml
+++ b/reference/oci8/functions/oci-parse.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id="function.oci-parse">
    <refnamediv>
     <refname>oci_parse</refname>
-    <refpurpose>Parses a query and returns an Oracle statement identifier</refpurpose>
+    <refpurpose>Prepares Oracle statement for execution</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -13,12 +13,20 @@
       <methodparam><type>string</type><parameter>query</parameter></methodparam>
      </methodsynopsis>
     <para>
-     <function>oci_parse</function> parses the <parameter>query</parameter>
+     <function>oci_parse</function> prepares the <parameter>query</parameter>
      using <parameter>connection</parameter> and returns the statement
-     identifier if the <parameter>query</parameter> is valid or &false; if not. 
-     The <parameter>query</parameter> can be any valid SQL statement or PL/SQL
-     block.
+     identifier, which can be used with
+     <function>oci_bind_by_name</function>, <function>oci_execute</function>
+     and other functions.
     </para>
+    <note>
+     <para>
+      This function <emphasis>does not</emphasis> validate
+      <parameter>query</parameter>. The only way to find out if
+      <parameter>query</parameter> is valid SQL or PL/SQL statement - is to
+      execute it.
+     </para>
+    </note>
     <para>
      <function>oci_parse</function> returns &false; on error.
     </para>