From e45f6d9babc19d31dad521d8afc864456c874f7f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= Date: Thu, 1 Feb 2018 14:39:42 +0100 Subject: [PATCH] doc: mention potential annoyances with Emscripten build. --- doc/building.dox | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/doc/building.dox b/doc/building.dox index 5ab099967..80f96f17b 100644 --- a/doc/building.dox +++ b/doc/building.dox @@ -705,9 +705,7 @@ pass it explicitly on command-line using `-DEMSCRIPTEN_PREFIX`. Default is porting and they are generally slower, thus `BUILD_STATIC` is implicitly enabled. -Then create build directory and run `cmake` and the build command in it. Be -sure to set `CMAKE_INSTALL_PREFIX` to a path contained in -`EMSCRIPTEN_TOOLCHAIN_PATH`. +Then create build directory and run `cmake` and the build command in it. WebGL 1.0 (GLES 2.0 equivalent) is enabled by default, switch to 2.0 (GLES 3.0 equivalent) by disabling `TARGET_GLES2`. @@ -723,6 +721,17 @@ cmake .. \ cmake --build . @endcode +@note + If you set `CMAKE_INSTALL_PREFIX` to a path contained in + `EMSCRIPTEN_TOOLCHAIN_PATH` and dependencies are installed there as well, + things should "just work". Otherwise you might get the following error: +@note 
CMake Error at .../Modules/FindPackageHandleStandardArgs.cmake:138 (message):
+  Could NOT find Corrade (missing: CORRADE_INCLUDE_DIR
+  _CORRADE_CONFIGURE_FILE)
+@note + This can be solved by adding the location where Corrade is installed to + `CMAKE_PREFIX_PATH` or `CMAKE_FIND_ROOT_PATH`. + Then you can install the library using @cb{.sh} cmake --build . --target install @ce to make it available to depending projects.