From f491b6b95ec706c2f5b300a7379e6d8fe30f10dd Mon Sep 17 00:00:00 2001
From: Ulf Wendel <uw@php.net>
Date: Thu, 22 Sep 2011 16:45:12 +0000
Subject: [PATCH] Upgrade note for 1.1.0, mysqlnd_ms_set_user_pick_server()
 will be gone

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@317158 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mysqlnd_ms/changes.xml | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/reference/mysqlnd_ms/changes.xml b/reference/mysqlnd_ms/changes.xml
index 94a0208d34..d90d826cf2 100644
--- a/reference/mysqlnd_ms/changes.xml
+++ b/reference/mysqlnd_ms/changes.xml
@@ -44,9 +44,19 @@
    Freature changes
    <itemizedlist>
     <listitem>
-     <simpara>
+     <para>
       Introduction of (chainable) filter concept
-     </simpara>
+      <itemizedlist>
+       <listitem>
+         <simpara>
+          BC break: <function>mysqlnd_ms_set_user_pick_server</function>
+          has been removed.
+          The <literal>user</literal> filter has been introduced to replace it.
+          The filter offers almost the same functionality, see below for details.
+         </simpara>
+       </listitem>
+      </itemizedlist>
+     </para>
     </listitem>
     <listitem>
      <simpara>
@@ -80,6 +90,21 @@
     </listitem>
    </itemizedlist>
   </para>
+  <para>
+    Users of the function <function>mysqlnd_ms_set_user_pick_server</function> need to
+    update their code. The function has been removed in favour of a
+    new <literal>user</literal> filter. You can no longer set a callback function
+    using <function>mysqlnd_ms_set_user_pick_server</function> at runtime but have to
+    configure it in the plugins configuration file. The <literal>user</literal>
+    filter will pass the same arguments to the callback as before.
+    Therefore, you can continue to use the same procedural function as a callback.callback
+    It is no longer possibe to use static class methods or class methods of
+    an object instance as a callback. Trying to do so, will make any function
+    executing a statement handled by the plugin
+    emit a <constant>E_RECOVERABLE_ERROR</constant> level error like
+    <literal>(mysqlnd_ms) Specified callback (picker) is not a valid callback</literal>.
+    Please, note that this may halt your application.
+  </para>
  </section>
 
  <section xml:id="mysqlnd-ms.changes_one_o">