php · jordikroon · Jun 22, 2026 · Jun 22, 2026 · Jun 23, 2026 · Jun 23, 2026
diff --git a/language/predefined/attributes/allowdynamicproperties.xml b/language/predefined/attributes/allowdynamicproperties.xml
@@ -27,7 +27,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_CLASS)]</modifier>
      <modifier>final</modifier>
      <classname>AllowDynamicProperties</classname>
     </ooclass>

diff --git a/language/predefined/attributes/attribute.xml b/language/predefined/attributes/attribute.xml
@@ -23,7 +23,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_CLASS)]</modifier>
      <modifier>final</modifier>
      <classname>Attribute</classname>
     </ooclass>

diff --git a/language/predefined/attributes/delayedtargetvalidation.xml b/language/predefined/attributes/delayedtargetvalidation.xml
@@ -29,7 +29,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_ALL)]</modifier>
      <modifier>final</modifier>
      <classname>DelayedTargetValidation</classname>
     </ooclass>

diff --git a/language/predefined/attributes/deprecated.xml b/language/predefined/attributes/deprecated.xml
@@ -18,7 +18,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION | \Attribute::TARGET_CLASS_CONSTANT | \Attribute::TARGET_CONSTANT | \Attribute::TARGET_CLASS)]</modifier>
      <modifier>final</modifier>
      <classname>Deprecated</classname>
     </ooclass>

diff --git a/language/predefined/attributes/nodiscard.xml b/language/predefined/attributes/nodiscard.xml
@@ -52,7 +52,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION)]</modifier>
      <modifier>final</modifier>
      <classname>NoDiscard</classname>
     </ooclass>

diff --git a/language/predefined/attributes/override.xml b/language/predefined/attributes/override.xml
@@ -29,7 +29,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY)]</modifier>
      <modifier>final</modifier>
      <classname>Override</classname>
     </ooclass>

diff --git a/language/predefined/attributes/returntypewillchange.xml b/language/predefined/attributes/returntypewillchange.xml
@@ -36,7 +36,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_METHOD)]</modifier>
      <modifier>final</modifier>
      <classname>ReturnTypeWillChange</classname>
     </ooclass>

diff --git a/language/predefined/attributes/sensitiveparameter.xml b/language/predefined/attributes/sensitiveparameter.xml
@@ -19,7 +19,7 @@
 
    <classsynopsis class="class">
     <ooclass>
-     <modifier role="attribute">#[\Attribute]</modifier>
+     <modifier role="attribute">#[\Attribute(\Attribute::TARGET_PARAMETER)]</modifier>
      <modifier>final</modifier>
      <classname>SensitiveParameter</classname>
     </ooclass>

diff --git a/reference/curl/functions/curl-close.xml b/reference/curl/functions/curl-close.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier>
    <type>void</type><methodname>curl_close</methodname>
    <methodparam><type>CurlHandle</type><parameter>handle</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/curl/functions/curl-share-close.xml b/reference/curl/functions/curl-share-close.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier>
    <type>void</type><methodname>curl_share_close</methodname>
    <methodparam><type>CurlShareHandle</type><parameter>share_handle</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/datetime/datetimeinterface/wakeup.xml b/reference/datetime/datetimeinterface/wakeup.xml
@@ -15,17 +15,17 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTime">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTime::__wakeup</methodname>
    <void/>
   </methodsynopsis>
   <methodsynopsis role="DateTimeImmutable">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTimeImmutable::__wakeup</methodname>
    <void/>
   </methodsynopsis>
   <methodsynopsis role="DateTimeInterface">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()')]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTimeInterface::__wakeup</methodname>
    <void/>
   </methodsynopsis>

diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml
@@ -19,7 +19,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use date_sun_info() instead')]</modifier>
    <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname>
    <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>

diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml
@@ -21,7 +21,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use date_sun_info() instead')]</modifier>
    <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname>
    <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>

diff --git a/reference/datetime/functions/gmstrftime.xml b/reference/datetime/functions/gmstrftime.xml
@@ -17,7 +17,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use IntlDateFormatter::format() instead')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>

diff --git a/reference/datetime/functions/strftime.xml b/reference/datetime/functions/strftime.xml
@@ -17,7 +17,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use IntlDateFormatter::format() instead')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>

diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml
@@ -15,7 +15,7 @@
    <refsect1 role="description">
     &reftitle.description;
     <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.2', message: 'use date_parse_from_format() (for locale-independent parsing), or IntlDateFormatter::parse() (for locale-dependent parsing) instead')]</modifier>
    <type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname>
    <methodparam><type>string</type><parameter>timestamp</parameter></methodparam>
    <methodparam><type>string</type><parameter>format</parameter></methodparam>

diff --git a/reference/enchant/functions/enchant-broker-free-dict.xml b/reference/enchant/functions/enchant-broker-free-dict.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free-dict">
+<refentry xml:id="function.enchant-broker-free-dict" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>enchant_broker_free_dict</refname>
   <refpurpose>Free a dictionary resource</refpurpose>
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as EnchantDictionary objects are freed automatically')]</modifier>
    <type>bool</type><methodname>enchant_broker_free_dict</methodname>
    <methodparam><type>EnchantDictionary</type><parameter>dictionary</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/enchant/functions/enchant-broker-free.xml b/reference/enchant/functions/enchant-broker-free.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free">
+<refentry xml:id="function.enchant-broker-free" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>enchant_broker_free</refname>
   <refpurpose>Free the broker resource and its dictionaries</refpurpose>
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as EnchantBroker objects are freed automatically')]</modifier>
    <type>bool</type><methodname>enchant_broker_free</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/enchant/functions/enchant-broker-get-dict-path.xml b/reference/enchant/functions/enchant-broker-get-dict-path.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-get-dict-path">
+<refentry xml:id="function.enchant-broker-get-dict-path" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>enchant_broker_get_dict_path</refname>
   <refpurpose>Get the directory path for a given backend</refpurpose>
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>enchant_broker_get_dict_path</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
    <methodparam><type>int</type><parameter>type</parameter></methodparam>

diff --git a/reference/enchant/functions/enchant-broker-set-dict-path.xml b/reference/enchant/functions/enchant-broker-set-dict-path.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-set-dict-path">
+<refentry xml:id="function.enchant-broker-set-dict-path" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>enchant_broker_set_dict_path</refname>
   <refpurpose>Set the directory path for a given backend</refpurpose>
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0')]</modifier>
    <type>bool</type><methodname>enchant_broker_set_dict_path</methodname>
    <methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
    <methodparam><type>int</type><parameter>type</parameter></methodparam>

diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-close">
+<refentry xml:id="function.finfo-close" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>finfo_close</refname>
   <refpurpose>Close finfo instance</refpurpose>
@@ -12,7 +12,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: 'as finfo objects are freed automatically')]</modifier>
    <type>true</type><methodname>finfo_close</methodname>
    <methodparam><type>finfo</type><parameter>finfo</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/image/functions/imagedestroy.xml b/reference/image/functions/imagedestroy.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.5', message: "as it has no effect since PHP 8.0")]</modifier>
    <type>true</type><methodname>imagedestroy</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/ldap/functions/ldap-connect-wallet.xml b/reference/ldap/functions/ldap-connect-wallet.xml
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: "8.5", message: "as it is broken since PHP 8.0")]</modifier>
    <type class="union"><type>LDAP\Connection</type><type>false</type></type><methodname>ldap_connect_wallet</methodname>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>uri</parameter><initializer>&null;</initializer></methodparam>
    <methodparam><type>string</type><parameter>wallet</parameter></methodparam>

@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as external entity loading is disabled by default')]</modifier>
    <type>bool</type><methodname>libxml_disable_entity_loader</methodname>
    <methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
   </methodsynopsis>

diff --git a/reference/mhash/functions/mhash-count.xml b/reference/mhash/functions/mhash-count.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier>
    <type>int</type><methodname>mhash_count</methodname>
    <void/>
   </methodsynopsis>

diff --git a/reference/mhash/functions/mhash-get-block-size.xml b/reference/mhash/functions/mhash-get-block-size.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier>
    <type class="union"><type>int</type><type>false</type></type><methodname>mhash_get_block_size</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/mhash/functions/mhash-get-hash-name.xml b/reference/mhash/functions/mhash-get-hash-name.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash_get_hash_name</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/mhash/functions/mhash-keygen-s2k.xml b/reference/mhash/functions/mhash-keygen-s2k.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash_keygen_s2k</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
    <methodparam><type>string</type><parameter>password</parameter></methodparam>

diff --git a/reference/mhash/functions/mhash.xml b/reference/mhash/functions/mhash.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1')]</modifier>
    <type class="union"><type>string</type><type>false</type></type><methodname>mhash</methodname>
    <methodparam><type>int</type><parameter>algo</parameter></methodparam>
    <methodparam><type>string</type><parameter>data</parameter></methodparam>

@@ -13,7 +13,7 @@
   <para>&style.oop;</para>
   <fieldsynopsis><type>string</type><varname linkend="mysqli.get-client-info">mysqli-&gt;client_info</varname></fieldsynopsis>
   <methodsynopsis role="mysqli">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'use mysqli_get_client_info() instead')]</modifier>
    <modifier>public</modifier> <type>string</type><methodname>mysqli::get_client_info</methodname>
    <void/>
   </methodsynopsis>

@@ -11,7 +11,7 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.1', message: 'replace calls to parent::init() with parent::__construct()')]</modifier>
    <modifier>public</modifier> <type class="union"><type>bool</type><type>null</type></type><methodname>mysqli::init</methodname>
    <void/>
   </methodsynopsis>

@@ -15,13 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use KILL CONNECTION/QUERY SQL statement instead')]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::kill</methodname>
    <methodparam><type>int</type><parameter>process_id</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use KILL CONNECTION/QUERY SQL statement instead')]</modifier>
    <type>bool</type><methodname>mysqli_kill</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type>int</type><parameter>process_id</parameter></methodparam>

@@ -15,13 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'because the reconnect feature has been removed in PHP 8.2 and this method is now redundant')]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::ping</methodname>
    <void/>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'because the reconnect feature has been removed in PHP 8.2 and this function is now redundant')]</modifier>
    <type>bool</type><methodname>mysqli_ping</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
   </methodsynopsis>

@@ -15,13 +15,13 @@
   &reftitle.description;
   <para>&style.oop;</para>
   <methodsynopsis role="mysqli">
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use FLUSH SQL statement instead')]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>mysqli::refresh</methodname>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
   </methodsynopsis>
   <para>&style.procedural;</para>
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.4', message: 'use FLUSH SQL statement instead')]</modifier>
    <type>bool</type><methodname>mysqli_refresh</methodname>
    <methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>

diff --git a/reference/openssl/functions/openssl-free-key.xml b/reference/openssl/functions/openssl-free-key.xml
@@ -13,7 +13,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier role="attribute">#[\Deprecated]</modifier>
+   <modifier role="attribute">#[\Deprecated(since: '8.0', message: 'as OpenSSLAsymmetricKey objects are freed automatically')]</modifier>
    <type>void</type><methodname>openssl_free_key</methodname>
    <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
   </methodsynopsis>