diff --git a/doc/platforms-html5.dox b/doc/platforms-html5.dox
index b5edf62b7..b37fc2a7f 100644
--- a/doc/platforms-html5.dox
+++ b/doc/platforms-html5.dox
@@ -75,11 +75,14 @@ of the toolchain files from above:
 @code{.sh}
 mkdir build-emscripten-wasm && cd build-emscripten-wasm
 cmake .. \
-    -DCMAKE_TOOLCHAIN_FILE="../toolchains/generic/Emscripten-wasm.cmake" \
+    -DCMAKE_TOOLCHAIN_FILE="path/to/toolchains/generic/Emscripten-wasm.cmake" \
     -DCMAKE_BUILD_TYPE=Release
 cmake --build .
 @endcode
 
+Note that the `CMAKE_TOOLCHAIN_FILE` path needs to be absolute --- otherwise
+CMake will silently ignore it and continue compiling natively.
+
 After that you can run the generated JavaScript file using Node.js. Note that
 it looks for the corresponding `*.wasm` file in the current directory, so you
 need to @cb{.sh} cd @ce there first: