This is an automated email from the ASF dual-hosted git repository.

jan pushed a commit to branch parallel-eunit
in repository https://gitbox.apache.org/repos/asf/couchdb.git

commit a75a12b64ccb3f3f20522a7cb93b512f52648ecd
Author: Jan Lehnardt <[email protected]>
AuthorDate: Thu Dec 4 10:33:59 2025 +0100

    doc: explain parallel make feature
---
 README-DEV.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README-DEV.rst b/README-DEV.rst
index a2eec4b44..6726db005 100644
--- a/README-DEV.rst
+++ b/README-DEV.rst
@@ -223,6 +223,22 @@ to specify exact ``rebar eunit`` options::
 
     make eunit EUNIT_OPTS="apps=couch,chttpd"
 
+Running Erlang tests in Parallel
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you have GNU make (`gmake`) installed, you can supply a `-jN` parameter to
+run as many jobs in parallel. To avoid clobbering output, use the
+`--output-sync` option.
+
+    gmake eunit -j2 --output-sync=target
+
+This runs two test modules in parallel at a time. On a machine with two or more
+CPUs, this should reduce the total wall clock time of testing to up to one 
half.
+
+Higher `N` might also work, but the test suite is still undergoing hardening to
+support full parallelism, so spurious errors that do not occur with `-j1` might
+show up.
+
 Elixir Integration Tests
 ~~~~~~~~~~~~~~~~~~~~~~~~
 

Reply via email to