Skip to content

Generic/LanguageConstructSpacing: fix syntax errors in the XML doc code examples #959

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conversation

rodrigoprimo
Copy link
Contributor

Description

This PR fixes syntax errors in the XML doc code examples.

One of the invalid examples was removed because, besides containing a syntax error, it doesn't trigger the sniff (yieldfrom is tokenized as T_STRING, and this token is not watched by the sniff). The <code> title was updated to reflect the remaining examples.

Suggested changelog entry

Generic.WhiteSpace.LanguageConstructSpacing: minor fixes and improvements to the XML documentation

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
    • This change is only breaking for integrators, not for external standards or end-users.
  • Documentation improvement

PR checklist

  • I have checked there is no other PR open for the same change.
  • I have read the Contribution Guidelines.
  • I grant the project the right to include and distribute the code under the BSD-3-Clause license (and I have the right to grant these rights).
  • I have added tests to cover my changes.
  • I have verified that the code complies with the projects coding standards.
  • [Required for new sniffs] I have added XML documentation for the sniff.

…de examples

One of the invalid examples was removed because, besides containing a
syntax error, it doesn't trigger the sniff (`yieldfrom` is tokenized as
`T_STRING` and this token is not watched by the sniff). The `<code>`
title was updated to reflect the remaining examples.
Copy link
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 for finding this @rodrigoprimo ! LGTM.

@jrfnl jrfnl merged commit 0cc1757 into PHPCSStandards:master Apr 13, 2025
49 of 50 checks passed
@jrfnl jrfnl deleted the documentation-language-construct-spacing branch April 13, 2025 00:50
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