From 720a9d0636884985f85e246e4c3b4dacbb927c8a Mon Sep 17 00:00:00 2001 From: "Ryan C. Gordon" Date: Wed, 5 Nov 2025 16:12:01 -0500 Subject: [PATCH] README-emscripten: Note that using the latest stable release is a good idea. --- docs/README-emscripten.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/README-emscripten.md b/docs/README-emscripten.md index 2f976d14c1..107d4d1b5b 100644 --- a/docs/README-emscripten.md +++ b/docs/README-emscripten.md @@ -226,9 +226,14 @@ most efficient, consistent, and correct way to run a game in a web browser. ## Building SDL/emscripten +Use the latest stable Emscripten release! -SDL currently requires at least Emscripten 3.16.0 to build. Newer versions -are likely to work, as well. +It's possible to build SDL with older Emscripten releases, such as 3.x, but +several things will be silently broken, as bugs got fixed and web standards +solidified over time. At the time of this writing, Emscripten 4.0.x is the +current stable release. You're encouraged to install the latest stable release +(`emsdk install latest ; emsdk activate latest` if using Emscripten's setup +script), and make sure you're reasonably up to date as time goes on. Build: