Document the PHP 8.5 core language features

Author: lacatoire

language/constants.xml

@@ -222,6 +222,33 @@ echo ANIMALS_DEF[1] . "\n"; // outputs "cat"
     </para>
    </note>
 
+   <sect2 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>
+         Added support for type casts (e.g. <code>(int)</code>,
+         <code>(string)</code>) in constant expressions.
+         Also added support for
+         <link linkend="functions.anonymous">Closures</link> and
+         <link linkend="functions.first_class_callable_syntax">first-class
+         callables</link> in constant expressions.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </sect2>
+
    <sect2 role="seealso">
     &reftitle.seealso;
     <para>

language/errors/basics.xml

@@ -75,6 +75,30 @@
    as by sending an e-mail.
   </para>
  </sect2>
+
+ <sect2 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>
+       Fatal errors (such as an exceeded maximum execution time) now include
+       a stack trace in their error message.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </sect2>
+
 </sect1>
 
 <!-- Keep this comment at the end of the file

language/functions.xml

@@ -1408,6 +1408,13 @@ Stack trace:
         </row>
        </thead>
        <tbody>
+        <row>
+         <entry>8.5.0</entry>
+         <entry>
+          Closures can now be used in constant expressions (e.g. default
+          property values, attribute parameters, constants).
+         </entry>
+        </row>
         <row>
          <entry>8.3.0</entry>
          <entry>
@@ -1715,6 +1722,29 @@ $obj?->prop->method(...);
      </informalexample>
     </para>
    </note>
+
+   <sect2 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>
+         First-class callables can now be used in constant expressions
+         (e.g. default property values, attribute parameters, constants).
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </sect2>
   </sect1>
 
  </chapter>

language/types/callable.xml

@@ -160,6 +160,8 @@ print implode(' ', $new_numbers);
    scope-independent and can always be invoked, whereas a callable type may be
    scope-dependent and may not be directly invoked.
    <classname>Closure</classname> is the preferred way to create callables.
+   As of PHP 8.5.0, <classname>Closure</classname> is a proper subtype of
+   <type>callable</type>.
   </simpara>
 
   <note>