Clarify behavior of parameter binding for multiple executions

Based on a patch provided by BohwaZ.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@345969 c90b9560-bf6c-de11-be94-00142212c4b1

Author: cmb69

reference/sqlite3/sqlite3stmt/bindparam.xml

@@ -99,7 +99,6 @@
     </varlistentry>
    </variablelist>
   </para>
-
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -110,6 +109,20 @@
   </para>
  </refsect1>
 
+ <refsect1 role="notes"><!-- {{{ -->
+  &reftitle.notes;
+  <caution>
+   <para>
+    <methodname>SQLite3Stmt::reset</methodname> must be called after the first call to
+    <methodname>SQLite3Stmt::execute</methodname> if you want to see the bound value
+    updated on following calls to <methodname>SQLite3Stmt::execute</methodname>.
+    If <methodname>SQLite3Stmt::reset</methodname> is not called, the bound value will
+    not change, even if the value assigned to the variable passed to
+    <methodname>SQLite3Stmt::bindParam</methodname> has changed.
+   </para>
+  </caution>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

reference/sqlite3/sqlite3stmt/bindvalue.xml

@@ -18,6 +18,10 @@
   <para>
    Binds the value of a parameter to a statement variable.
   </para>
+  <para>
+   Once the statement has been executed, <methodname>SQLite3Stmt::reset</methodname> 
+   needs to be called to be able to change the value of bound parameters.
+  </para>
  </refsect1>
 
  <refsect1 role="parameters">

reference/sqlite3/sqlite3stmt/clear.xml

@@ -14,8 +14,17 @@
    <void />
   </methodsynopsis>
   <para>
-   Clears all current bound parameters.
+   Clears all current bound parameters (sets them to &null;).
   </para>
+  <caution>
+   <para>
+    This method needs to be used with <methodname>SQLite3Stmt::reset</methodname>.
+    If used alone, any call to 
+    <methodname>SQLite3Stmt::bindValue</methodname> or
+    <methodname>SQLite3Stmt::bindParam</methodname> will be of no effect
+    and all bound parameters will have the &null; value.
+   </para>
+  </caution>
  </refsect1>
 
  <refsect1 role="parameters">