bpo-40280: Add --enable-wasm-dynamic-linking (GH-32253)

1 files changed, 26 insertions, 3 deletions

diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst
index debbee7..b46157c 100644
--- a/Doc/using/configure.rst
+++ b/Doc/using/configure.rst
@@ -52,11 +52,13 @@ General Options
    Set the Python executable suffix to *SUFFIX*.
 
    The default suffix is ``.exe`` on Windows and macOS (``python.exe``
-   executable), ``.wasm`` on Emscripten (``python.wasm`` executable), and
-   an empty string on other platforms (``python`` executable).
+   executable), ``.js`` on Emscripten node, ``.html`` on Emscripten browser,
+   ``.wasm`` on WASI, and an empty string on other platforms (``python``
+   executable).
 
    .. versionchanged:: 3.11
-      The default suffix on Emscripten platform is ``.wasm``.
+      The default suffix on WASM platform is one of ``.js``, ``.html``
+      or ``.wasm``.
 
 .. cmdoption:: --with-tzpath=<list of absolute paths separated by pathsep>
 
@@ -141,6 +143,27 @@ General Options
 
    .. versionadded:: 3.11
 
+WebAssemby Options
+------------------
+
+.. cmdoption:: --with-emscripten-target=[browser|node]
+
+   Set build flavor for ``wasm32-emscripten``.
+
+   * ``browser`` (default): preload minimal stdlib, default MEMFS.
+   * ``node``: NODERAWFS and pthread support.
+
+   .. versionadded:: 3.11
+
+.. cmdoption:: --enable-wasm-dynamic-linking
+
+   Turn on dynamic linking support for WASM.
+
+   Dynamic linking enables ``dlopen``. File size of the executable
+   increases due to limited dead code elimination and additional features.
+
+   .. versionadded:: 3.11
+
 
 Install Options
 ---------------