From 58cc8f1ad712109b6189ec07158f07362ec88c80 Mon Sep 17 00:00:00 2001
From: Joscha Schmiedt <joscha@schmiedt.dev>
Date: Wed, 7 Feb 2024 20:19:04 +0100
Subject: [PATCH] Add note about test dependencies, WSL and running tests
 non-interactively

---
 README_SETUP.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README_SETUP.md b/README_SETUP.md
index 3a27cb5e..9b8a6457 100644
--- a/README_SETUP.md
+++ b/README_SETUP.md
@@ -63,10 +63,16 @@ See `build.properties.d/00_default.properties` for more information.
 
 ## Test
 
+* See [DEPENDENCIES](DEPENDENCIES#for-unit-testing) for the requirements to run the unit tests.
 * Run `make test` to compile/copy the web interface and the tests to a newly
   created `public` folder.
 * Run `make run-test-server` to start a python http server.
 * The test suite can be started with `firefox http://localhost:8000/`.
+* *On WSL (as of Feb 2024, WSL v2.0.14.0)*, port 8000 is sometimes not properly forwarded to the host
+  resulting in an unreachable test suite. Switching to a different port can be done easily
+  by using the `TEST_PORT` environment variable, e.g. with `TEST_PORT=8111 make
+  run-test-server`. Using the X11 `firefox` from within WSL always works.
+* To run the test suite non-interactively (as in CI/CD) use `make -d run-qunit`
 
 ## Clean
 
-- 
GitLab