Skip to content

PHP 7.3 | Syntax/NewFunctionCallTrailingComma: add XML documentation#2018

Merged
jrfnl merged 2 commits intoPHPCompatibility:developfrom
okkun-sh:docs/Syntax/NewFunctionCallTrailingComma
Dec 8, 2025
Merged

PHP 7.3 | Syntax/NewFunctionCallTrailingComma: add XML documentation#2018
jrfnl merged 2 commits intoPHPCompatibility:developfrom
okkun-sh:docs/Syntax/NewFunctionCallTrailingComma

Conversation

@okkun-sh
Copy link
Copy Markdown
Contributor

@okkun-sh okkun-sh commented Dec 5, 2025

Summary

Add XML documentation for the Syntax/NewFunctionCallTrailingComma sniff.

This contributes to #1285.

Thanks in advance!

Copy link
Copy Markdown
Member

@jrfnl jrfnl left a comment

Choose a reason for hiding this comment

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

@okkun-sh Thanks for the PR, Happy to merge this as-is.

I just have one question for which I'm curious what your reasoning was:
The sniff addresses two different, but closely related changes in PHP, one from PHP 7.3, one from PHP 8.4.
Have you considered having two <standard> blocks, each with their own code comparison, one for each change in PHP ?

The second change could then possibly be placed more in the context in which it was made (exit as a function call RFC) ?

@okkun-sh
Copy link
Copy Markdown
Contributor Author

okkun-sh commented Dec 6, 2025

@jrfnl
Thank you for your review and your question.

I also struggled with how to structure the PHP 7.3 and PHP 8.4 changes in the documentation.
I referred to the previous PR (#2001).

However, separating them into two blocks would be clearer.
I'll update the PR, so please review it again later.

@okkun-sh
Copy link
Copy Markdown
Contributor Author

okkun-sh commented Dec 7, 2025

@jrfnl
Updated based on your feedback!

@okkun-sh okkun-sh requested a review from jrfnl December 7, 2025 16:11
Copy link
Copy Markdown
Member

@jrfnl jrfnl left a comment

Choose a reason for hiding this comment

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

Thanks @okkun-sh ! Looks good to me!

@jrfnl jrfnl merged commit 5a53c1c into PHPCompatibility:develop Dec 8, 2025
37 checks passed
@okkun-sh okkun-sh deleted the docs/Syntax/NewFunctionCallTrailingComma branch December 9, 2025 13:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants