Repository navigation
docs: document the Wide Arithmetic proposal - #326
Merged
Merged
Conversation
List the --enable-wide-arithmetic flag on the wasmedge, parse, validate, instantiate and compile CLI pages, after --enable-threads to match the order in include/driver/options.h. Add the proposal to the WebAssembly proposals table and add a guide page with CLI, AOT and C API examples. Assisted-by: Claude (Anthropic) Assisted-by: OpenAI Codex Signed-off-by: YE-YU LIN <khjhs102109@gmail.com>
Lewis-panda
marked this pull request as ready for review
November 16, 2026 09:59
Lewis-panda
requested review from
alabulei1,
hydai and
juntao
as code owners
November 16, 2026 09:59
hydai
approved these changes
Nov 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Explanation
This adds documentation for the Wide Arithmetic proposal, which WasmEdge now supports in the interpreter, JIT and AOT modes. Users can enable it with the new
--enable-wide-arithmeticflag (WasmEdge/WasmEdge#5550), but the docs do not mention the proposal or the flag yet.Related issue
Related to WasmEdge/WasmEdge#5331.
What type of PR is this
/kind documentation
Proposed Changes
cli.md,parse.md,validate.md,instantiate.md,aot.md: add--enable-wide-arithmeticafter--enable-threads. This follows the order ininclude/driver/options.h.proposals.md: add Wide Arithmetic to the proposals table after Threads.wide-arithmetic.md: add a guide page with CLI, AOT and C API examples, following the structure of the Garbage Collection page.I assumed the next release is
0.19.0for the "since" version. Please let me know if it should be different.Validation with WasmEdge built from merged commit
d49cd393961ddce8ebb61d6ffdc13d11fa241eb3(Linux x86_64) andwasm-tools1.258.0, using thewide.watexample from the new page:wasmedge --enable-wide-arithmetic --reactor wide.wasm add128 -1 0 1 00and1wasmedge --enable-wide-arithmetic --reactor wide.wasm mul_wide_u -1 2-2and1wasmedge --reactor wide.wasm add128 -1 0 1 0loading failed: illegal opcodewasmedge --enable-all --reactor wide.wasm add128 -1 0 1 00and1wasmedge compile --enable-wide-arithmetic wide.wasm wide_aot.wasm, then run with--run-mode=aot0and1wasmedge parse,validate,instantiatedocusaurus buildcompletes for all locales with no broken links.This contribution was developed with assistance from Claude (Anthropic) and OpenAI Codex.