Skip to content
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

[Serialized diagnostics] Emit category documentation URL #80228

Merged

Conversation

DougGregor
Copy link
Member

Emit the category documentation URL into serialized diagnostics as part of the existing RECORD_CATEGORY, using the form

@

and keeping the existing "category name length" field referring to the length of the category name itself (up to the @). There is a corresponding update to libclang to process such category names correctly and add API, but it isn't strictly necessary: readers that use the category name length field correctly will see no behavior change, whereas readers that ignore it will merely see the extra @<category URL>.

This is a step toward staging out our (mis)use of the "flags" field as the place to stash educational note and diagnostic group documentation URLs.

Emit the category documentation URL into serialized diagnostics as part of
the existing RECORD_CATEGORY, using the form

  <category name>@<category URL>

and keeping the existing "category name length" field referring to the
length of the category name itself (up to the @). There is a corresponding
update to libclang to process such category names correctly and add
API, but it isn't strictly necessary: readers that use the category
name length field correctly will see no behavior change, whereas
readers that ignore it will merely see the extra `@<category URL>`.

This is a step toward staging out our (mis)use of the "flags" field as
the place to stash educational note and diagnostic group documentation
URLs.
@DougGregor
Copy link
Member Author

swiftlang/llvm-project#10326

@swift-ci please smoke test

1 similar comment
@DougGregor
Copy link
Member Author

swiftlang/llvm-project#10326

@swift-ci please smoke test

@DougGregor
Copy link
Member Author

swiftlang/llvm-project#10326

@swift-ci please smoke test Windows

@DougGregor DougGregor merged commit c69cb76 into swiftlang:main Mar 24, 2025
3 checks passed
@DougGregor DougGregor deleted the serialized-category-documentation-url branch March 24, 2025 15:57
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.

1 participant