Mention parallel testing in INSTALL and perl5110delta.pod
authorNicholas Clark <nick@ccl4.org>
Wed, 24 Jun 2009 16:20:15 +0000 (17:20 +0100)
committerDavid Mitchell <davem@iabyn.com>
Sat, 27 Jun 2009 16:04:21 +0000 (17:04 +0100)
(cherry-picked from commit 5ee651a9b9216a117835eca06b01232a8e3ac4a1,
but with using the 5101 perdelta, rather than 5110)

INSTALL
pod/perl5101delta.pod

diff --git a/INSTALL b/INSTALL
index c85b304..d278bd7 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1945,6 +1945,18 @@ about the various security aspects of temporary files.
 
 =back
 
+The core distribution can now run its regression tests in parallel on
+Unix-like platforms. Instead of running C<make test>, set C<TEST_JOBS> in
+your environment to the number of tests to run in parallel, and run
+C<make test_harness>. On a Bourne-like shell, this can be done as
+
+    TEST_JOBS=3 make test_harness  # Run 3 tests in parallel
+
+An environment variable is used, rather than parallel make itself, because
+L<TAP::Harness> needs to be able to schedule individual non-conflicting test
+scripts itself, and there is no standard interface to C<make> utilities to
+interact with their job schedulers.
+
 =head1 make install
 
 This will put perl into the public directory you specified to
index a37cdda..b406322 100644 (file)
@@ -183,6 +183,20 @@ more information.
 This pragma allows you to lexically disable or enable overloading
 for some or all operations. (Yuval Kogman)
 
+=head2 Parallel tests
+
+The core distribution can now run its regression tests in parallel on
+Unix-like platforms. Instead of running C<make test>, set C<TEST_JOBS> in
+your environment to the number of tests to run in parallel, and run
+C<make test_harness>. On a Bourne-like shell, this can be done as
+
+    TEST_JOBS=3 make test_harness  # Run 3 tests in parallel
+
+An environment variable is used, rather than parallel make itself, because
+L<TAP::Harness> needs to be able to schedule individual non-conflicting test
+scripts itself, and there is no standard interface to C<make> utilities to
+interact with their job schedulers.
+
 XXX do we now have dtrace?
 
 =head1 Modules and Pragmata