cosmetic changes for the 7.2 migration guide

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

appendices/migration72/deprecated.xml

@@ -11,9 +11,8 @@
    Unquoted strings that are non-existent global constants are taken to be
    strings of themselves. This behaviour used to emit an
    <constant>E_NOTICE</constant>, but will now emit an
-   <constant>E_WARNING</constant>. The manual will be updated to reflect that
-   this behaviour has been deprecated, and in the next major version of PHP, an
-   exception will be thrown instead.
+   <constant>E_WARNING</constant>. In the next major version of PHP, an
+   <classname>Error</classname> exception will be thrown instead.
   </para>
 
   <informalexample>
@@ -38,7 +37,7 @@ string(11) "NONEXISTENT"
   <para>
    The <function>png2wbmp</function> and <function>jpeg2wbmp</function>
    functions from the GD extension have now been deprecated and will be removed
-   in PHP 8.
+   in the next major version of PHP.
   </para>
  </sect2>
 
@@ -83,8 +82,8 @@ string(11) "NONEXISTENT"
 
   <para>
    Given the security issues of this function (being a thin wrapper around
-   <function>eval</function>), and the preferred way of creating closures by
-   defining an anonymous function, this dated function has now been deprecated.
+   <function>eval</function>), this dated function has now been deprecated.
+   The preferred alternative is to use <link linkend="functions.anonymous">anonymous functions</link>.
   </para>
  </sect2>
 
@@ -111,11 +110,11 @@ string(11) "NONEXISTENT"
 
   <para>
    Without the second argument to <function>parse_str</function>, the query
-   string parameters would instead populate the local symbol table instead.
+   string parameters would populate the local symbol table.
    Given the security implications of this, using
    <function>parse_str</function> without a second argument has now been
-   deprecated. The function should always be used with two arguments (the
-   second argument causes the query string to be parsed into an array).
+   deprecated. The function should always be used with two arguments, as the
+   second argument causes the query string to be parsed into an array.
   </para>
  </sect2>
 
@@ -124,8 +123,8 @@ string(11) "NONEXISTENT"
 
   <para>
    This function generates a random number based upon a range that is
-   calculated by an unexposed, platform-specific limb size. Given this facet,
-   this function has now been deprecated. The preferred way of generating a
+   calculated by an unexposed, platform-specific limb size. Because of this,
+   the function has now been deprecated. The preferred way of generating a
    random number using the GMP extension is by
    <function>gmp_random_bits</function> and
    <function>gmp_random_range</function>.
@@ -159,8 +158,8 @@ string(11) "NONEXISTENT"
   <para>
    The <literal>$errcontext</literal> argument contains all local variables of
    the error site. Given its rare usage, and the problems it causes with
-   internal optimisations, it has now been deprecated (with a soft deprecation
-   notice in the manual). A proper debugger should be used instead to retrieve
+   internal optimisations, it has now been deprecated.
+   Instead, a debugger should be used to retrieve
    information on local variables at the error site.
   </para>
  </sect2>
@@ -169,8 +168,8 @@ string(11) "NONEXISTENT"
   <title><function>read_exif_data</function> function</title>
 
   <para>
-   The <function>read_exif_data</function> alias has been deprecated, in favour
-   for the <function>exif_read_data</function> function instead.
+   The <function>read_exif_data</function> alias has been deprecated.
+   The <function>exif_read_data</function> function should be used instead.
   </para>
  </sect2>
 

appendices/migration72/incompatible.xml

@@ -29,7 +29,7 @@ var_dump(number_format(-0.01)); // now outputs string(1) "0" instead of string(2
   <title>Convert numeric keys in object and array casts</title>
 
   <para>
-   Numeric keys are now better handled when casting arrays to object and
+   Numeric keys are now better handled when casting arrays to objects and
    objects to arrays (either from explicit casting or by
    <function>settype</function>).
   </para>
@@ -113,8 +113,7 @@ int(1)
    Previously, passing &null; to the <function>get_class</function> function
    would output the name of the enclosing class. This behaviour has now been
    removed, where an <constant>E_WARNING</constant> will be output instead. To
-   achieve the same behaviour as before, the argument should simply be omitted
-   instead.
+   achieve the same behaviour as before, the argument should simply be omitted.
   </para>
  </sect2>
 

appendices/migration72/new-features.xml

@@ -223,7 +223,7 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL);
  </sect2>
 
  <sect2 xml:id="migration72.new-features.addr-info-in-sockets">
-  <title>Address Information Additions to the <link linkend="book.sockets">Sockets</link> extension</title>
+  <title>Address Information additions to the <link linkend="book.sockets">Sockets</link> extension</title>
 
   <para>
    The sockets extension now has the ability to lookup address information, as
@@ -393,7 +393,7 @@ use Foo\Bar\{
 
   <para>
    The EXIF functions <function>exif_read_data</function> and <function>exif_thumbnail</function> 
-   now supports passing streams as their first argument.
+   now support passing streams as their first argument.
   </para>
  </sect2>
 
@@ -410,7 +410,7 @@ use Foo\Bar\{
  </sect2>
 
  <sect2 xml:id="migration72.new-features.sqlite3">
-  <title><link linkend="book.sqlite3">SQLite3</link> allows to write BLOBs</title>
+  <title><link linkend="book.sqlite3">SQLite3</link> allows writing BLOBs</title>
 
   <para>
    <methodname>SQLite3::openBlob</methodname> now allows to open BLOB fields in
@@ -438,8 +438,7 @@ use Foo\Bar\{
    interface.
   </para>
   <para>
-   The <literal>zip://</literal> stream now supports the passing a password through context options 
-   as <literal>'password'</literal>.
+   The <literal>zip://</literal> stream now accepts a <literal>'password'</literal> context option.
   </para>
  </sect2>