Skip to content

docs: add --run-mode=aot to commands that run AOT-compiled files - #323

Merged
hydai merged 2 commits into
WasmEdge:mainfrom
RestitutorX:docs/aot-run-mode
Nov 9, 2026
Merged

hydai merged 2 commits into
WasmEdge:mainfrom
RestitutorX:docs/aot-run-mode

Conversation

@RestitutorX

Copy link
Copy Markdown
Contributor

Explanation

Since 0.17.0, wasmedge runs a compiled AOT WASM in the interpreter unless --run-mode=aot is given (see WasmEdge/WasmEdge#5169). Many pages compile a file with wasmedge compile and then run it without the flag, so readers following them silently get interpreter mode and much slower runs. This is a fix to existing docs.

Related issue

Same fix as WasmEdge/WasmEdge#5530, merged for examples/wasm/README.md.

What type of PR is this

/kind documentation

Proposed Changes

Adds --run-mode=aot to 63 run commands: 29 in 18 English pages, and 34 in 21 pages of the Chinese translation. Every changed command runs a file compiled with wasmedge compile/wasmedgec earlier on the same page. In the Chinese aot.md, quick_start.md and install.md, the commands now match their already-updated English versions.

Verified that every changed line only adds the flag:

$ git diff --stat upstream/main
 39 files changed, 63 insertions(+), 63 deletions(-)

Assisted by: Claude (Anthropic)

Since 0.17.0, wasmedge runs a compiled AOT WASM in the interpreter unless --run-mode=aot is given. These pages compile a file with wasmedge compile and then run it without the flag, so the examples silently run in interpreter mode. Same fix as WasmEdge/WasmEdge#5530.

Assisted-by: Claude (Anthropic)
Signed-off-by: Arin Ahuja <arinsapien@gmail.com>
Same fix as the previous commit, applied to the zh translations. The aot.md, quick_start.md and install.md commands now match their already-updated English versions.

Assisted-by: Claude (Anthropic)
Signed-off-by: Arin Ahuja <arinsapien@gmail.com>
@hydai
hydai merged commit 54431be into WasmEdge:main Nov 9, 2026
6 checks passed
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.

2 participants