Skip to content

Seed doc comments for WASM PackedSimd intrinsics#131322

Merged
tannergooding merged 2 commits into
dotnet:mainfrom
tannergooding:tannergooding-silver-engine
Jul 24, 2026
Merged

Seed doc comments for WASM PackedSimd intrinsics#131322
tannergooding merged 2 commits into
dotnet:mainfrom
tannergooding:tannergooding-silver-engine

Conversation

@tannergooding

Copy link
Copy Markdown
Member

Seeds the documentation port for System.Runtime.Intrinsics.Wasm.PackedSimd, the last remaining intrinsics class with undocumented members tracked by #88574. All other Vector/Arm/x86 APIs from the .NET 8.0 batch are already ported; the Wasm APIs were flagged as advanced and shipped without docs.

Each member summary now follows the same shape as the ported Arm/x86 docs -- the C intrinsic prototype on the first <para>, and the WASM instruction on the second:

/// <summary>
///   <para>v128_t wasm_i8x16_splat (int8_t a)</para>
///   <para>i8x16.splat : [i32] -> [v128]</para>
/// </summary>

The C prototypes come from wasm_simd128.h. The instruction line matches the WebAssembly SIMD spec: the mnemonic, its immediate operands (laneidx, memarg), and the stack transition. The three unsigned i64x2 comparisons (lt_u/le_u/gt_u) have no corresponding wasm_* intrinsic, so they carry only the instruction line.

This seeds the runtime-side /// comments; the dotnet-api-docs XML is generated from these via the mddocs flow.

Note

This PR description and the doc-comment text were drafted with GitHub Copilot.

Port the remaining System.Runtime.Intrinsics.Wasm.PackedSimd summaries to match the established Arm/x86 format: the C intrinsic prototype followed by the WASM instruction with its immediate operands and stack transition.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 24, 2026 14:19

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 3 pipeline(s).
13 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@dotnet-policy-service

Copy link
Copy Markdown
Contributor

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

The unsigned i64x2 relative comparisons have no direct WASM instruction and
are lowered as a signed comparison over sign-bit-flipped operands. Document
the instruction that actually executes plus a caveat, matching how the Arm
and x86 docs handle synthetic APIs, rather than naming an instruction that
does not exist.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 24, 2026 19:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.

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.

3 participants