[DOC-CVS] [doc-en] master: Update function attributes

[email protected] (Tim Düsterhus) Sat, 4 Oct 2025 14:04:40 +0000
Newsgroups	php.doc.cvs
Message-ID	<[email protected]>
Author: Tim Düsterhus (TimWolla)
Date: 2025-10-04T16:04:02+02:00

Commit: https://github.com/php/doc-en/commit/42d5fb01e01e9ab1fdb47612833dd13d9003df6a
Raw diff: https://github.com/php/doc-en/commit/42d5fb01e01e9ab1fdb47612833dd13d9003df6a.diff

Update function attributes

Generated with:

     build/gen_stub.php --replace-methodsynopses **.stub.php ../phpdoc/en/

And then manually picked the changes.

Changed paths:
  M  reference/curl/functions/curl-close.xml
  M  reference/curl/functions/curl-share-close.xml
  M  reference/datetime/datetimeimmutable/add.xml
  M  reference/datetime/datetimeimmutable/modify.xml
  M  reference/datetime/datetimeimmutable/setdate.xml
  M  reference/datetime/datetimeimmutable/setisodate.xml
  M  reference/datetime/datetimeimmutable/settime.xml
  M  reference/datetime/datetimeimmutable/settimestamp.xml
  M  reference/datetime/datetimeimmutable/settimezone.xml
  M  reference/datetime/datetimeimmutable/sub.xml
  M  reference/datetime/datetimeinterface/wakeup.xml
  M  reference/fileinfo/functions/finfo-close.xml
  M  reference/image/functions/imagedestroy.xml
  M  reference/ldap/functions/ldap-connect-wallet.xml
  M  reference/reflection/reflectionmethod/setaccessible.xml
  M  reference/reflection/reflectionproperty/setaccessible.xml
  M  reference/spl/splobjectstorage/attach.xml
  M  reference/spl/splobjectstorage/contains.xml
  M  reference/spl/splobjectstorage/detach.xml
  M  reference/xml/functions/xml-parser-free.xml


Diff:

diff --git a/reference/curl/functions/curl-close.xml b/reference/curl/functions/curl-close.xml
index 3c5df5ec2bfa..1886e12749c8 100644
--- a/reference/curl/functions/curl-close.xml
+++ b/reference/curl/functions/curl-close.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</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
index b081da01b102..b956bdc7d94a 100644
--- a/reference/curl/functions/curl-share-close.xml
+++ b/reference/curl/functions/curl-share-close.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>void</type><methodname>curl_share_close</methodname>
    <methodparam><type>CurlShareHandle</type><parameter>share_handle</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeimmutable/add.xml b/reference/datetime/datetimeimmutable/add.xml
index 0a4a86034da8..1bc730c77242 100644
--- a/reference/datetime/datetimeimmutable/add.xml
+++ b/reference/datetime/datetimeimmutable/add.xml
@@ -11,6 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::add</methodname>
    <methodparam><type>DateInterval</type><parameter>interval</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeimmutable/modify.xml b/reference/datetime/datetimeimmutable/modify.xml
index 9772bcafd6ca..e4958c7a946d 100644
--- a/reference/datetime/datetimeimmutable/modify.xml
+++ b/reference/datetime/datetimeimmutable/modify.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::modify</methodname>
    <methodparam><type>string</type><parameter>modifier</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeimmutable/setdate.xml b/reference/datetime/datetimeimmutable/setdate.xml
index 01191da8b270..1009c22eb1aa 100644
--- a/reference/datetime/datetimeimmutable/setdate.xml
+++ b/reference/datetime/datetimeimmutable/setdate.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setDate</methodname>
    <methodparam><type>int</type><parameter>year</parameter></methodparam>
    <methodparam><type>int</type><parameter>month</parameter></methodparam>
diff --git a/reference/datetime/datetimeimmutable/setisodate.xml b/reference/datetime/datetimeimmutable/setisodate.xml
index 3fb68647f381..fb25fb0ff2ab 100644
--- a/reference/datetime/datetimeimmutable/setisodate.xml
+++ b/reference/datetime/datetimeimmutable/setisodate.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setISODate</methodname>
    <methodparam><type>int</type><parameter>year</parameter></methodparam>
    <methodparam><type>int</type><parameter>week</parameter></methodparam>
diff --git a/reference/datetime/datetimeimmutable/settime.xml b/reference/datetime/datetimeimmutable/settime.xml
index b43e8de44949..62efd51e6562 100644
--- a/reference/datetime/datetimeimmutable/settime.xml
+++ b/reference/datetime/datetimeimmutable/settime.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setTime</methodname>
    <methodparam><type>int</type><parameter>hour</parameter></methodparam>
    <methodparam><type>int</type><parameter>minute</parameter></methodparam>
diff --git a/reference/datetime/datetimeimmutable/settimestamp.xml b/reference/datetime/datetimeimmutable/settimestamp.xml
index ae17441f9a6c..17447d61a9de 100644
--- a/reference/datetime/datetimeimmutable/settimestamp.xml
+++ b/reference/datetime/datetimeimmutable/settimestamp.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setTimestamp</methodname>
    <methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeimmutable/settimezone.xml b/reference/datetime/datetimeimmutable/settimezone.xml
index 308ce3b38cdb..46bfd9595091 100644
--- a/reference/datetime/datetimeimmutable/settimezone.xml
+++ b/reference/datetime/datetimeimmutable/settimezone.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::setTimezone</methodname>
    <methodparam><type>DateTimeZone</type><parameter>timezone</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeimmutable/sub.xml b/reference/datetime/datetimeimmutable/sub.xml
index 382cf8de7d43..8c0214b4bad8 100644
--- a/reference/datetime/datetimeimmutable/sub.xml
+++ b/reference/datetime/datetimeimmutable/sub.xml
@@ -11,6 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\NoDiscard]</modifier>
    <modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::sub</methodname>
    <methodparam><type>DateInterval</type><parameter>interval</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/datetime/datetimeinterface/wakeup.xml b/reference/datetime/datetimeinterface/wakeup.xml
index 1992bbced555..2fc07aaf2cc6 100644
--- a/reference/datetime/datetimeinterface/wakeup.xml
+++ b/reference/datetime/datetimeinterface/wakeup.xml
@@ -11,14 +11,17 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="DateTime">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTime::__wakeup</methodname>
    <void/>
   </methodsynopsis>
   <methodsynopsis role="DateTimeImmutable">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTimeImmutable::__wakeup</methodname>
    <void/>
   </methodsynopsis>
   <methodsynopsis role="DateTimeInterface">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>DateTimeInterface::__wakeup</methodname>
    <void/>
   </methodsynopsis>
diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml
index f0de431a0537..550ea55c8ed2 100644
--- a/reference/fileinfo/functions/finfo-close.xml
+++ b/reference/fileinfo/functions/finfo-close.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</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
index fc6de3fe9b6c..afaedd43cfab 100644
--- a/reference/image/functions/imagedestroy.xml
+++ b/reference/image/functions/imagedestroy.xml
@@ -8,6 +8,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</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
index 5e074db442f7..eb2b823be6e8 100644
--- a/reference/ldap/functions/ldap-connect-wallet.xml
+++ b/reference/ldap/functions/ldap-connect-wallet.xml
@@ -8,6 +8,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</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>
diff --git a/reference/reflection/reflectionmethod/setaccessible.xml b/reference/reflection/reflectionmethod/setaccessible.xml
index 80b496690e06..6a85075b183f 100644
--- a/reference/reflection/reflectionmethod/setaccessible.xml
+++ b/reference/reflection/reflectionmethod/setaccessible.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="ReflectionMethod">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>ReflectionMethod::setAccessible</methodname>
    <methodparam><type>bool</type><parameter>accessible</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/reflection/reflectionproperty/setaccessible.xml b/reference/reflection/reflectionproperty/setaccessible.xml
index 86bf9e670331..5e36bceb35d3 100644
--- a/reference/reflection/reflectionproperty/setaccessible.xml
+++ b/reference/reflection/reflectionproperty/setaccessible.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="ReflectionProperty">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::setAccessible</methodname>
    <methodparam><type>bool</type><parameter>accessible</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/spl/splobjectstorage/attach.xml b/reference/spl/splobjectstorage/attach.xml
index a60eb17a8f0c..57b8a55ca580 100644
--- a/reference/spl/splobjectstorage/attach.xml
+++ b/reference/spl/splobjectstorage/attach.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SplObjectStorage">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>SplObjectStorage::attach</methodname>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
    <methodparam choice="opt"><type>mixed</type><parameter>info</parameter><initializer>&null;</initializer></methodparam>
diff --git a/reference/spl/splobjectstorage/contains.xml b/reference/spl/splobjectstorage/contains.xml
index 68c8013094eb..bcd1b0931bcf 100644
--- a/reference/spl/splobjectstorage/contains.xml
+++ b/reference/spl/splobjectstorage/contains.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SplObjectStorage">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>bool</type><methodname>SplObjectStorage::contains</methodname>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/spl/splobjectstorage/detach.xml b/reference/spl/splobjectstorage/detach.xml
index 7cb07533b733..2c84029dfcfe 100644
--- a/reference/spl/splobjectstorage/detach.xml
+++ b/reference/spl/splobjectstorage/detach.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="SplObjectStorage">
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <modifier>public</modifier> <type>void</type><methodname>SplObjectStorage::detach</methodname>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/xml/functions/xml-parser-free.xml b/reference/xml/functions/xml-parser-free.xml
index a7dca0c2b133..0eb3fe1dab16 100644
--- a/reference/xml/functions/xml-parser-free.xml
+++ b/reference/xml/functions/xml-parser-free.xml
@@ -9,6 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>xml_parser_free</methodname>
    <methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
   </methodsynopsis>