diff --git a/appendices/migration85/incompatible.xml b/appendices/migration85/incompatible.xml
index 3300e7eeb0..917b68ac9c 100644
--- a/appendices/migration85/incompatible.xml
+++ b/appendices/migration85/incompatible.xml
@@ -442,6 +442,12 @@
    if the read_and_close value is not a valid type compatible with int.
   </simpara>
 
+  <simpara>
+   Passing an integer <literal>0</literal> as the <parameter>locales</parameter>
+   argument to <function>setlocale</function> is no longer supported and now throws
+   a <exceptionname>TypeError</exceptionname>.
+  </simpara>
+
  </sect2>
 
  <sect2 xml:id="migration85.incompatible.simplexml">
diff --git a/reference/strings/functions/setlocale.xml b/reference/strings/functions/setlocale.xml
index b3e25d8eb7..77754db227 100644
--- a/reference/strings/functions/setlocale.xml
+++ b/reference/strings/functions/setlocale.xml
@@ -165,7 +165,29 @@
    </para>
   </note>
  </refsect1>
-
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Passing an integer <literal>0</literal> as the
+       <parameter>locales</parameter> argument is no longer supported and
+       now throws a <classname>TypeError</classname>.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>