From f4af0cc9e32ee51a3077852df9ed824fc4adf15c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Kochma=C5=84ski?= <daniel@turtleware.eu>
Date: Sat, 9 Dec 2023 09:24:58 +0100
Subject: [PATCH] INSTALL: add an extra hint for emscripten re stack size

Fixes #726.
---
 INSTALL | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/INSTALL b/INSTALL
index 15872bb5f..1b399c0c2 100644
--- a/INSTALL
+++ b/INSTALL
@@ -189,3 +189,13 @@ After that activate the toolchain and configure build flags:
 
 If the output does not show on the webpage then open the javascript console.
 This is a default html website produced by emscripten.
+
+5. Build an external program linked against libecl.a
+
+The default stack size proposed by emscripten is 64KB. This is too little for
+ECL, so when you build a program that is linked against libecl.a, then it is
+imoprtant to specify a different size. For example:
+
+#+begin_src shell-script
+  emcc program.c -sSTACK_SIZE=1048576 lib/*.a -I./include -o program.o
+#+end_src