Skip to content

Clarify usage of @deprecated annotation in stubs - #19562

Merged
Girgias merged 2 commits into
php:masterfrom
Girgias:stubs-docs-fixes
Aug 24, 2025
Merged

Clarify usage of @deprecated annotation in stubs#19562
Girgias merged 2 commits into
php:masterfrom
Girgias:stubs-docs-fixes

Conversation

@Girgias

@Girgias Girgias commented Aug 23, 2025

Copy link
Copy Markdown
Member

To indicate that this was used prior to the \Deprecated attribute being usable on those symbols.

@Girgias
Girgias marked this pull request as ready for review August 23, 2025 12:33

@DanielEScherzer DanielEScherzer left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall makes sense, small issue inline

Comment thread docs/source/miscellaneous/stubs.rst Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

there wasn't an 8.4.0 release, it got skipped and we went with 8.4.1 - maybe just say "8.4"?

And if you do switch to "8.4", then below should use "8.5" for consistency

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The thing is for @genstubs-expose-comment-block it says that the feature is only available since 8.4.0.
So I reformatted all of them to get rid of the final .0

To indicate that this was used prior to the \Deprecated attribute being usable on those symbols.
@Girgias
Girgias merged commit 9b27fdb into php:master Aug 24, 2025
3 checks passed
@Girgias
Girgias deleted the stubs-docs-fixes branch August 24, 2025 11:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants