Skip to content

Commit ab3c92e

Browse files
committed
doc: explain parallel make feature
1 parent f5e145d commit ab3c92e

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

README-DEV.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -223,6 +223,22 @@ to specify exact ``rebar eunit`` options::
223223

224224
make eunit EUNIT_OPTS="apps=couch,chttpd"
225225

226+
Running Erlang tests in Parallel
227+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
228+
229+
If you have GNU make (`gmake`) installed, you can supply a `-jN` parameter to
230+
run as many jobs in parallel. To avoid clobbering output, use the
231+
`--output-sync` option.
232+
233+
gmake eunit -j2 --output-sync=target
234+
235+
This runs two test modules in parallel at a time. On a machine with two or more
236+
CPUs, this should reduce the total wall clock time of testing to up to one half.
237+
238+
Higher `N` might also work, but the test suite is still undergoing hardening to
239+
support full parallelism, so spurious errors that do not occur with `-j1` might
240+
show up.
241+
226242
Elixir Integration Tests
227243
~~~~~~~~~~~~~~~~~~~~~~~~
228244

0 commit comments

Comments
 (0)