From 720a9d0636884985f85e246e4c3b4dacbb927c8a Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
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 | 11 ++++++++---
1 file changed, 8 insertions(+), 3 deletions(-)
diff --git a/docs/README-emscripten.md b/docs/README-emscripten.md
index 2f976d14c1d4a..107d4d1b5b211 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
-
-SDL currently requires at least Emscripten 3.16.0 to build. Newer versions
-are likely to work, as well.
+Use the latest stable Emscripten release!
+
+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: