From e1a00d71720c1d76b925283125eb544b716b10e8 Mon Sep 17 00:00:00 2001
From: Christoph Michael Becker <cmb@php.net>
Date: Tue, 18 Oct 2016 14:58:41 +0000
Subject: [PATCH] Fix #73267: Order by callback changed

While users are not supposed to rely on a stable sort anyway, it
may be helpful to explicitly mention possible sort order changes
in the migration guides.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@340557 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/migration70/incompatible/other.xml | 15 +++++++++++++++
 appendices/migration71/incompatible.xml       | 14 ++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/appendices/migration70/incompatible/other.xml b/appendices/migration70/incompatible/other.xml
index 5f05dca554..44cea78e14 100644
--- a/appendices/migration70/incompatible/other.xml
+++ b/appendices/migration70/incompatible/other.xml
@@ -359,6 +359,21 @@ switch (1) {
    had been modified. Now, they will always return the current argument values.
   </para>
  </sect3>
+
+ <sect3 xml:id="migration70.incompatible.other.sort-order">
+  <title>Sort order of equal elements</title>
+  <para>
+   The internal sorting algorithm has been improved, what may result in
+   different sort order of elements, which compare as equal, than before.
+  </para>
+  <note>
+   <para>
+    Don't rely on the order of elements which compare as equal; it might change
+    anytime.
+   </para>
+  </note>
+ </sect3>
+
 </sect2>
 
 <!-- Keep this comment at the end of the file
diff --git a/appendices/migration71/incompatible.xml b/appendices/migration71/incompatible.xml
index bf27d2acf1..da5c8c4575 100644
--- a/appendices/migration71/incompatible.xml
+++ b/appendices/migration71/incompatible.xml
@@ -308,6 +308,20 @@ array(2) {
   </informalexample>
  </sect2>
 
+ <sect2 xml:id="migration70.incompatible.sort-order">
+  <title>Sort order of equal elements</title>
+  <para>
+   The internal sorting algorithm has been improved, what may result in
+   different sort order of elements, which compare as equal, than before.
+  </para>
+  <note>
+   <para>
+    Don't rely on the order of elements which compare as equal; it might change
+    anytime.
+   </para>
+  </note>
+ </sect2>
+
 </sect1>
 
 <!-- Keep this comment at the end of the file