Skip to content

Commit 52c177b

Browse files
authored
[Docs] Mention asserts builds (#24484)
1 parent 45c5002 commit 52c177b

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

site/source/docs/tools_reference/emsdk.rst

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -121,8 +121,9 @@ The following topics explain how to perform both common and advanced maintenance
121121
.. _emsdk-get-latest-sdk:
122122

123123

124-
How do I just get the latest SDK?
125-
---------------------------------
124+
How do I just get the latest SDK release?
125+
-----------------------------------------
126+
126127
Use the ``update`` argument to fetch the current registry of available tools, and then specify the ``latest`` install target to get the most recent SDK: ::
127128

128129
# Fetch the latest registry of available tools.
@@ -134,7 +135,23 @@ Use the ``update`` argument to fetch the current registry of available tools, an
134135
# Set up the compiler configuration to point to the "latest" SDK.
135136
./emsdk activate latest
136137

138+
How do I install a specific version?
139+
------------------------------------
140+
141+
Use the commands above, replacing ``latest`` with the version you want, for example: ::
142+
143+
./emsdk install 4.0.7
144+
./emsdk activate 4.0.7
145+
146+
(you may need to do ``./emsdk update`` before).
147+
148+
Each release also has an *asserts version* which is built with more runtime
149+
checks in LLVM and Binaryen. This can be useful if you think you have encountered a bug in one of these tools. The names of
150+
asserts versions are the same as release versions, with an added suffix of
151+
``-asserts``, e.g. ``4.0.7-asserts``, which you can use with: ::
137152

153+
./emsdk install 4.0.7-asserts
154+
./emsdk activate 4.0.7-asserts
138155

139156
How do I use emsdk?
140157
-------------------

0 commit comments

Comments
 (0)