Skip to content

Commit a4d84db

Browse files
committed
Clarify usage of @deprecated annotation in stubs
To indicate that this was used prior to the \Deprecated attribute being usable on those symbols.
1 parent 414e521 commit a4d84db

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

docs/source/miscellaneous/stubs.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -224,6 +224,7 @@ The generated ``class_Atmosphere_methods`` must be used when registering the ``A
224224
Additional meta information can be attached to functions, with the following PHPDoc tags:
225225

226226
- ``@deprecated``: Triggers the usual deprecation notice when the function/method is called.
227+
As of PHP 8.4.0 the `#[\Deprecated]` attribute should be used instead.
227228

228229
- ``@alias``: If a function/method is an alias of another function/method, then the aliased
229230
function/method name has to be provided as value. E.g. the function ``sizeof()`` has the ``@alias
@@ -453,6 +454,7 @@ with ``@cvalue M_PI`` to the C-level constant ``M_PI`` (define by PHP's internal
453454
Constants can take the following extra meta information passed via PHPDoc tags:
454455

455456
- ``@deprecated``: Triggers a deprecation notice when the constant is used.
457+
As of PHP 8.5.0 the `#[\Deprecated]` attribute should be used instead.
456458

457459
- ``@genstubs-expose-comment-block``: By adding this tag at the beginning of a PHPDoc block, the
458460
content of the PHPDoc block will be exposed for `ReflectionClass::getDocComment()`. This feature

0 commit comments

Comments
 (0)