Skip to content

fix(dev): workaround for phpdoc parsing error with escaped docblock closing tags#9008

Merged
bshaffer merged 3 commits intomainfrom
fix-phpdoc-error
Mar 17, 2026
Merged

fix(dev): workaround for phpdoc parsing error with escaped docblock closing tags#9008
bshaffer merged 3 commits intomainfrom
fix-phpdoc-error

Conversation

@bshaffer
Copy link
Contributor

See phpDocumentor/ReflectionDocBlock#450

Upgrading protobuf has changed the way certain characters are escaped, and this has broken PHPDoc's parsing for docblock closing tags (e.g. */), which are now escaped as {@*}.

This will be fixed in some future version of PHPDoc once the above PR is merged and released, but to prevent our builds from being blocked, I've included a temporary fix in our docs generator which replaces the tag with our previous character set.

@bshaffer bshaffer requested a review from a team as a code owner March 17, 2026 00:16
@bshaffer bshaffer added the next release PRs to be included in the next release label Mar 17, 2026
@bshaffer bshaffer merged commit 0851f8c into main Mar 17, 2026
35 checks passed
@bshaffer bshaffer deleted the fix-phpdoc-error branch March 17, 2026 16:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

next release PRs to be included in the next release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants