moved Exception|Error BC Break changes to incompatible.xml part II.

Author: mumumu

appendices/migration85/incompatible.xml

@@ -199,6 +199,12 @@
    The extension now requires at least ICU 57.1.
   </simpara>
 
+  <simpara>
+   <methodname>IntlDateFormatter::setTimeZone</methodname>/<function>datefmt_set_timezone</function>
+   now throws an <exceptionname>IntlException</exceptionname> on uninitialised
+   classes/clone failures.
+  </simpara>
+
   <simpara>
    All <classname>Locale</classname> methods now throw a
    <exceptionname>ValueError</exceptionname> when the locale argument contain null bytes.
@@ -368,22 +374,54 @@
 
  </sect2>
 
+ <sect2 xml:id="migration85.other-changes.functions.pdo-sqlite">
+  <title>PDO_SQLITE</title>
+
+  <simpara>
+   SQLite <methodname>PDO::quote</methodname> will now throw an exception
+   or emit a warning, depending on the error mode, if the string contains
+   a null byte.
+  </simpara>
+
+  <simpara>
+   <methodname>PDO::sqliteCreateCollation</methodname> will now throw an
+   exception if the callback has the wrong return type, making it more
+   in line with <methodname>Pdo\Sqlite::createCollation</methodname> behavior.
+  </simpara>
+
+ </sect2>
+
  <sect2 xml:id="migration85.incompatible.posix">
   <title>POSIX</title>
 
   <simpara>
-   <function>posix_kill</function> throws a <exceptionname>ValueError</exceptionname>
-   when the process_id argument is lower or greater than what the platform
-   supports (signed integer or long range), <function>posix_setpgid</function>
-   throws a <exceptionname>ValueError</exceptionname> when the process_id or
+   <function>posix_kill</function> now throws a
+   <exceptionname>ValueError</exceptionname> when the process_id argument is
+   lower or greater than what the platform supports (signed integer or
+   long range), <function>posix_setpgid</function> now throws a
+   <exceptionname>ValueError</exceptionname> when the process_id or
    the process_group_id is lower than zero or greater than what the platform
    supports.
   </simpara>
 
   <simpara>
-   <function>posix_setrlimit</function> throws a <exceptionname>ValueError</exceptionname>
-   when the hard_limit or soft_limit arguments are lower than -1 or
-   if soft_limit is greater than hard_limit.
+   <function>posix_setrlimit</function> now throws a
+   <exceptionname>ValueError</exceptionname> when the hard_limit or
+   soft_limit arguments are lower than -1 or if soft_limit is greater than
+   hard_limit.
+  </simpara>
+
+ </sect2>
+
+ <sect2 xml:id="migration85.incompatible.reflection">
+  <title>Reflection</title>
+
+  <simpara>
+   <methodname>ReflectionAttribute::newInstance</methodname> can now throw
+   errors for internal attributes if the attribute was applied on an invalid
+   target and the error was delayed from compile time to runtime via the
+   #[\DelayedTargetValidation] attribute.
+   <!-- RFC: https://wiki.php.net/rfc/delayedtargetvalidation_attribute -->
   </simpara>
 
  </sect2>
@@ -399,9 +437,9 @@
 
   <simpara>
    <function>session_start</function> is stricter in regard to the options
-   argument. It throws a <exceptionname>ValueError</exceptionname> if the array is
-   not a hashmap, or a <exceptionname>TypeError</exceptionname> if the
-   read_and_close value is not a valid type compatible with int.
+   argument. It now throws a <exceptionname>ValueError</exceptionname> if
+   the array is not a hashmap, or a <exceptionname>TypeError</exceptionname>
+   if the read_and_close value is not a valid type compatible with int.
   </simpara>
 
  </sect2>
@@ -427,7 +465,7 @@
    <function>snmp2_set</function>,
    <function>snmp3_get</function>,
    <function>snmp3_set</function>
-   and <methodname>SNMP::__construct</methodname> throw a
+   and <methodname>SNMP::__construct</methodname> now throw a
    <exceptionname>ValueError</exceptionname> when the hostname
    is too large, contains any null byte or if the port is given
    when negative or greater than 65535, timeout and retries values
@@ -457,26 +495,26 @@
   <simpara>
    <function>socket_create_listen</function>,
    <function>socket_bind</function> and <function>socket_sendto</function>
-   throw a <exceptionname>ValueError</exceptionname> if the port is lower than 0
-   or greater than 65535, and also if any of the hints array entries are
+   now throw a <exceptionname>ValueError</exceptionname> if the port is lower
+   than 0 or greater than 65535, and also if any of the hints array entries are
    indexed numerically.
   </simpara>
 
   <simpara>
-   <function>socket_addrinfo_lookup</function> throws a
-   <exceptionname>TypeError</exceptionname> if any of the hints values cannot be cast
-   to int and can throw a <exceptionname>ValueError</exceptionname> if any of these
-   values overflow.
+   <function>socket_addrinfo_lookup</function> now throws a
+   <exceptionname>TypeError</exceptionname> if any of the hints values cannot
+   be cast to int and can throw a <exceptionname>ValueError</exceptionname> if
+   any of these values overflow.
   </simpara>
 
   <simpara>
    <function>socket_set_option</function> with
    <constant>MCAST_LEAVE_GROUP</constant>/<constant>MCAST_LEAVE_SOURCE_GROUP</constant>
-   options will throw an exception if the value isn't a valid object or array.
+   options now throw an exception if the value isn't a valid object or array.
   </simpara>
 
   <simpara>
-   <function>socket_set_option</function> with multicast context throws a
+   <function>socket_set_option</function> with multicast context now throws a
    <exceptionname>ValueError</exceptionname> when the created socket is not of
    <constant>AF_INET</constant>/<constant>AF_INET6</constant> family.
   </simpara>

appendices/migration85/other-changes.xml

@@ -86,12 +86,6 @@
   <sect3 xml:id="migration85.other-changes.functions.intl">
    <title>Intl</title>
 
-   <simpara>
-    <methodname>IntlDateFormatter::setTimeZone</methodname>/<function>datefmt_set_timezone</function>
-    throws an <exceptionname>IntlException</exceptionname> on uninitialised
-    classes/clone failures.
-   </simpara>
-
    <simpara>
     <function>grapheme_extract</function> properly assigns
     <parameter>$next</parameter> value when skipping over invalid starting bytes.
@@ -199,23 +193,6 @@
 
   </sect3>
 
-  <sect3 xml:id="migration85.other-changes.functions.pdo-sqlite">
-   <title>PDO_SQLITE</title>
-
-   <simpara>
-    SQLite <methodname>PDO::quote</methodname> will now throw an exception
-    or emit a warning, depending on the error mode, if the string contains
-    a null byte.
-   </simpara>
-
-   <simpara>
-    <methodname>PDO::sqliteCreateCollation</methodname> will now throw an
-    exception if the callback has the wrong return type, making it more
-    in line with <methodname>Pdo\Sqlite::createCollation</methodname> behavior.
-   </simpara>
-
-  </sect3>
-
   <sect3 xml:id="migration85.other-changes.functions.pgsql">
    <title>PostgreSQL</title>
 
@@ -272,14 +249,6 @@
     when a class contains hooked properties.
    </simpara>
 
-   <simpara>
-    <methodname>ReflectionAttribute::newInstance</methodname> can now throw
-    errors for internal attributes if the attribute was applied on an invalid
-    target and the error was delayed from compile time to runtime via the
-    #[\DelayedTargetValidation] attribute.
-    <!-- RFC: https://wiki.php.net/rfc/delayedtargetvalidation_attribute -->
-   </simpara>
-
   </sect3>
 
   <sect3 xml:id="migration85.other-changes.functions.sockets">