[Libreoffice-commits] core.git: Branch 'feature/wasm' - README.wasm

[Thorsten Behrens (via logerrit)]

 README.wasm |   31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

New commits:
commit 01294829e3dd84522d2cf909bcadce3ce13eeae9
Author:     Thorsten Behrens <thorsten.behrens at allotropia.de>
AuthorDate: Mon Mar 15 00:17:41 2021 +0100
Commit:     Thorsten Behrens <thorsten.behrens at allotropia.de>
CommitDate: Mon Mar 15 00:17:41 2021 +0100

    Add docs for container build setup
    
    Change-Id: Ib250ae58e0dc36169125707a8c523d59239cabf6

diff --git a/README.wasm b/README.wasm
index b27c863b99f3..53774549a46c 100644
--- a/README.wasm
+++ b/README.wasm
@@ -21,6 +21,7 @@ change later to a newer emscripten.
 
 Qt WASM is not yet used with LO, just if you're wondering!
 
+ ++ See below under Docker build for another build option ++
 
 == Setup emscripten ==
 
@@ -112,6 +113,36 @@ QT5DIR=/dir/of/git_qt5/qtbase
 Many will also be encoded in configure.ac at some point, some already is.
 
 
+== Using Docker to cross-build with emscripten ==
+
+If you prefer a controlled environment (sadly emsdk install/activate
+is _not_ stable over time, as e.g. nodejs versions evolve), that is
+easy to replicate across different machines - consider the docker
+images we're providing.
+
+Config/setup file see
+https://git.libreoffice.org/lode/+/ccb36979563635b51215477455953252c99ec013
+
+Run
+
+ docker-compose build
+
+in the lode/docker dir to get the container prepared. Run
+
+ PARALLELISM=4 BUILD_OPTIONS= BUILD_TARGET=build docker-compose run --rm -e PARALLELISM -e BUILD_TARGET -e BUILD_OPTIONS builder
+
+to perform an actual srcdir != buildir build; the container mounts
+checked-out git repo and output dir via docker-compose.yml (so make
+sure the path names there match your setup):
+
+The lode setup expects, inside the lode/docker subdir, the following directories:
+
+- core (git checkout)
+- workdir (the output dir - gets written into)
+- cache (ccache tree)
+- tarballs (external project tarballs gets written and cached there)
+
+
 = Ideas for an UNO bridge implementation =
 
 My post to Discord #emscripten: "I'm looking for a way to do an abstract call