Minor rewrite

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

reference/mysqlnd_ms/changes.xml

@@ -4,15 +4,12 @@
 <chapter xml:id="mysqlnd-ms.changes" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title xmlns="http://docbook.org/ns/docbook">Change History</title>
  <para>
-  The Change History lists major changes users need to be aware if upgrading
-  from one version to another. It is a high level summary of selected changes
-  that may impact applications or might even break backwards compatibility.
-  Please, consult the <filename>CHANGES</filename> file contained in the source
-  distribution for a more complete list of changes. If you are eager to learn
-  about all changes, even smaller ones that do not make it into the
-  <filename>CHANGES</filename> file, you may want to monitor PECL commit messages.
-  To do you, you could, for example, subscribe to the PECL commit message mailing
-  list.
+  This change history is a high level summary of selected changes
+  that may impact applications and/or break backwards compatibility.
+ </para>
+ <para>
+  See also the <filename>CHANGES</filename> file in the source distribution
+  for a complete list of changes. 
  </para>
 
  <section xml:id="mysqlnd-ms.changes_one_one">
@@ -22,7 +19,7 @@
    <itemizedlist>
     <listitem>
      <simpara>
-      Release date: no released yet, planned for 09/2011
+      Release date: no released yet, planned for Q4 2011
      </simpara>
     </listitem>
     <listitem>
@@ -33,12 +30,11 @@
    </itemizedlist>
   </para>
   <para>
-   The 1.1 and 1.0 series expose a similar, although not identical, feature
-   set to the user, as can be guessed from the release motto/theme. Internally,
-   the 1.1 series has been refactored significantly to prepare for future
-   feature additions. A new configuration file format has been introduced
-   and, limitations have been lifted. Code quality and quality assurance
-   have been improved.
+   The 1.1 and 1.0 series expose a similar feature set. Internally,
+   the 1.1 series has been refactored to plan for future feature
+   additions. A new configuration file format has been introduced,
+   and limitations have been lifted. And the code quality and quality 
+   assurance has been improved.
   </para>
   <para>
    Feature changes
@@ -54,8 +50,8 @@
           has been removed. The
           <link linkend="mysqlnd-ms.filter"><literal>user</literal></link>
           filter has been introduced to replace it.
-          The filter offers almost the same functionality, see below for a
-          discussion of differences.
+          The filter offers similar functionality, but see below for an
+          explanation of the differences.
          </simpara>
        </listitem>
       </itemizedlist>
@@ -69,7 +65,7 @@
     <listitem>
      <simpara>
       <link linkend="mysqlnd-ms.pooling">Lazy connections improved</link>:
-      security relevant, state changing commands covered.
+      security relevant, and state changing commands are covered.
      </simpara>
     </listitem>
     <listitem>
@@ -117,25 +113,24 @@
     </listitem>
     <listitem>
      <simpara>
-      Fixed PECL #22784 - Using mysql_connect and mysql_select_db won't work
+      Fixed PECL #22784 - Using mysql_connect and mysql_select_db did not work
      </simpara>
     </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 favor 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>
+    The <function>mysqlnd_ms_set_user_pick_server</function> function was removed, and
+    replaced in favor 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 instead 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 possible 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.
+    It is no longer possible to use static class methods, or class methods of
+    an object instance, as a callback. Doing so will cause the function
+    executing a statement handled by the plugin to emit an
+    <constant>E_RECOVERABLE_ERROR</constant> level error, which might look like:
+    "<literal>(mysqlnd_ms) Specified callback (picker) is not a valid callback</literal>."
+    Note: this may halt your application.
   </para>
  </section>
 
@@ -166,15 +161,15 @@
     </listitem>
     <listitem>
      <simpara>
-      Motto/theme: Cover replication basics to test user feeedback
+      Motto/theme: Cover replication basics to test user feedback
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
   <para>
-   First release of practical use. Features basic automatic read-write splitting,
+   The first release of practical use. It features basic automatic read-write splitting,
    SQL hints to overrule automatic redirection, load balancing of
-   slave requests, lazy connections and, optional, automatic use of the master
+   slave requests, lazy connections, and optional, automatic use of the master
    after the first write.
   </para>
   <para>
@@ -196,8 +191,7 @@
    </itemizedlist>
   </para>
   <para>
-   Initial check-in. At this stage the plugin is hardly of
-   any practical use but a demo of the
+   Initial check-in. Essentially a demo of the
    <link linkend="book.mysqlnd">mysqlnd</link> plugin API.
   </para>
  </section>