@@ -36,16 +36,14 @@ important concepts to help understanding the internals of the SDK:
3636* ** SDK** : A set of tools. For example, 'sdk-1.5.6-32bit' is an SDK consisting
3737 of the tools ` clang-3.2-32bit ` , ` node-0.10.17-32bit ` , ` python-2.7.5.1-32bit `
3838 and ` emscripten-1.5.6 ` .
39- * ** Active Tool/SDK** : Emscripten stores compiler configuration in a
40- user-specific file ** ~ /.emscripten** . This file points to paths for
41- Emscripten, Python, Clang and so on. If the file ~ /.emscripten is configured
42- to point to a Tool in a specific directory, then that tool is denoted as being
43- ** active** . The Emscripten Command Prompt always gives access to the currently
44- active Tools. This mechanism allows switching between different installed SDK
45- versions easily.
39+ * ** Active Tool/SDK** : Emscripten SDK stores compiler configuration in a file
40+ called ` .emscripten ` within the emsdk directory. This file points to paths
41+ for Emscripten, Python, Clang and so on. If the configuration file points to a
42+ Tool in a specific directory, then that tool is denoted as being
43+ ** active** . This mechanism allows switching between different installed
44+ tools and SDKs.
4645* ** emsdk** : This is the name of the manager script that Emscripten SDK is
47- accessed through. Most operations are of the form ` emsdk command ` . To access
48- the emsdk script, launch the Emscripten Command Prompt.
46+ accessed through. Most operations are of the form ` emsdk <command> ` .
4947
5048## System Requirements
5149
@@ -136,11 +134,11 @@ using git, and compile the package on demand.
136134When you run ` emsdk list ` , it will group the Tools and SDKs under these two
137135categories.
138136
139- To obtain and build latest upstream wasm SDK from source, run
137+ To obtain and build latest wasm SDK from source, run
140138
141139```
142- emsdk install sdk-upstream- main-64bit
143- emsdk activate sdk-upstream- main-64bit
140+ emsdk install sdk-main-64bit
141+ emsdk activate sdk-main-64bit
144142```
145143
146144You can use this target for example to bootstrap developing patches to LLVM,
@@ -156,7 +154,7 @@ https://emscripten.org/docs/contributing/developers_guide.html?highlight=develop
156154### When working on git branches compiled from source, how do I update to a newer compiler version?
157155
158156Unlike tags and precompiled versions, a few of the SDK packages are based on
159- "moving" git branches and compiled from source (e.g. sdk-upstream- main,
157+ "moving" git branches and compiled from source (e.g. sdk-main,
160158sdk-main, emscripten-main, binaryen-main). Because of that, the
161159compiled versions will eventually go out of date as new commits are introduced
162160to the development branches. To update an old compiled installation of one of
@@ -179,30 +177,18 @@ activate <tool/sdk name>`. Activating a tool will set up `~/.emscripten` to
179177point to that particular tool. On Windows, you can pass the option ` --permanent ` to
180178the ` activate ` command to register the environment permanently for the current user. Use ` --system ` to do this for all users.
181179
182- ### How do I build multiple projects with different SDK versions in parallel?
183-
184- By default, Emscripten locates all configuration files in the home directory of
185- the user. This may be a problem if you need to simultaneously build with
186- multiple Emscripten compiler versions, since the user home directory can only be
187- configured to point to one compiler at a time. This can be overcome by
188- specifying the '--embedded' option as a parameter to 'emsdk activate', which
189- will signal emsdk to generate the compiler configuration files inside the emsdk
190- root directory instead of the user home directory. Use this option also when it
191- is desirable to run emsdk in a fully portable mode that does not touch any files
192- outside the emsdk directory.
193-
194180### How do I track the latest Emscripten development with the SDK?
195181
196182A common and supported use case of the Emscripten SDK is to enable the workflow
197183where you directly interact with the github repositories. This allows you to
198184obtain new features and latest fixes immediately as they are pushed to the
199185github repository, without having to wait for release to be tagged. You do not
200186need a github account or a fork of Emscripten to do this. To switch to using the
201- latest upstream git development branch ` main ` , run the following:
187+ latest git development branch ` main ` , run the following:
202188
203189 emsdk install git-1.9.4 # Install git. Skip if the system already has it.
204- emsdk install sdk-upstream- main-64bit # Clone+pull the latest emscripten-core/emscripten/main.
205- emsdk activate sdk-upstream- main-64bit # Set the main SDK as the currently active one.
190+ emsdk install sdk-main-64bit # Clone+pull the latest emscripten-core/emscripten/main.
191+ emsdk activate sdk-main-64bit # Set the main SDK as the currently active one.
206192
207193### How do I use my own Emscripten github fork with the SDK?
208194
0 commit comments