Skip to content

Fix ilink XML docs#124102

Merged
gewarren merged 1 commit intodotnet:mainfrom
gewarren:ilink-docs
Feb 7, 2026
Merged

Fix ilink XML docs#124102
gewarren merged 1 commit intodotnet:mainfrom
gewarren:ilink-docs

Conversation

@gewarren
Copy link
Contributor

@gewarren gewarren commented Feb 6, 2026

I was trying to build an assembly with XML docs and the build failed on these ILink docs.

@gewarren gewarren requested a review from sbomer as a code owner February 6, 2026 19:36
Copilot AI review requested due to automatic review settings February 6, 2026 19:36
@github-actions github-actions bot added the area-Tools-ILLink .NET linker development as well as trimming analyzers label Feb 6, 2026
@dotnet-policy-service dotnet-policy-service bot added the linkable-framework Issues associated with delivering a linker friendly framework label Feb 6, 2026
@dotnet-policy-service
Copy link
Contributor

Tagging subscribers to this area: @agocke, @dotnet/illink
See info in area-owners.md if you want to be subscribed.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Fixes malformed/invalid XML documentation comments in ILLink trim analysis sources so builds that emit XML docs don’t fail.

Changes:

  • Replace Nullable<T> text in XML docs with Nullable{T} to avoid invalid XML tags in doc output.
  • Wrap <item> entries in <list> blocks where needed in IntrinsicId enum member summaries.
  • Fix a malformed <see cref="..."> entry and complete a missing <summary> block.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/tools/illink/src/ILLink.Shared/TrimAnalysis/RuntimeTypeHandleForNullableValueWithDynamicallyAccessedMembers.cs Escapes Nullable<T> text in XML docs to valid Nullable{T}.
src/tools/illink/src/ILLink.Shared/TrimAnalysis/RuntimeTypeHandleForNullableSystemTypeValue.cs Escapes Nullable<T> text in XML docs to valid Nullable{T}.
src/tools/illink/src/ILLink.Shared/TrimAnalysis/NullableValueWithDynamicallyAccessedMembers.cs Escapes Nullable<T> text in XML docs to valid Nullable{T}.
src/tools/illink/src/ILLink.Shared/TrimAnalysis/NullableSystemTypeValue.cs Escapes Nullable<T> text in XML docs to valid Nullable{T}.
src/tools/illink/src/ILLink.Shared/TrimAnalysis/IntrinsicId.cs Makes enum XML docs well-formed by adding <list> wrappers, fixing a malformed cref, and closing a missing <summary>.

@gewarren gewarren merged commit e18ee8e into dotnet:main Feb 7, 2026
89 of 92 checks passed
@gewarren gewarren deleted the ilink-docs branch February 7, 2026 00:44
lewing pushed a commit to lewing/runtime that referenced this pull request Feb 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-Tools-ILLink .NET linker development as well as trimming analyzers linkable-framework Issues associated with delivering a linker friendly framework

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants