Skip to content

Commit 0630fc7

Browse files
authored
[Docs] Update docs for NO_DYNAMIC_EXECUTION (#15919)
* Quite some time ago we figured out a solution for closure compiler. * Embind just gets slower, it doesn't break (it avoids eval for jitting and does something else).
1 parent 250e9e1 commit 0630fc7

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

src/settings.js

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1198,10 +1198,12 @@ var EXPORT_NAME = 'Module';
11981198
// that is targeting a privileged or a certified execution environment, see
11991199
// Firefox Content Security Policy (CSP) webpage for details:
12001200
// https://developer.mozilla.org/en-US/Apps/Build/Building_apps_for_Firefox_OS/CSP
1201+
//
12011202
// When this flag is set, the following features (linker flags) are unavailable:
1202-
// --closure 1: When using closure compiler, eval() would be needed to locate the Module object.
12031203
// -s RELOCATABLE=1: the function Runtime.loadDynamicLibrary would need to eval().
1204-
// --bind: Embind would need to eval().
1204+
// and some features may fall back to slower code paths when they need to:
1205+
// --bind: Embind uses eval() to jit functions for speed.
1206+
//
12051207
// Additionally, the following Emscripten runtime functions are unavailable when
12061208
// DYNAMIC_EXECUTION=0 is set, and an attempt to call them will throw an exception:
12071209
// - emscripten_run_script(),
@@ -1210,6 +1212,7 @@ var EXPORT_NAME = 'Module';
12101212
// - dlopen(),
12111213
// - the functions ccall() and cwrap() are still available, but they are restricted to only
12121214
// being able to call functions that have been exported in the Module object in advance.
1215+
//
12131216
// When set to -s DYNAMIC_EXECUTION=2 flag is set, attempts to call to eval() are demoted
12141217
// to warnings instead of throwing an exception.
12151218
// [link]

0 commit comments

Comments
 (0)