Upgrade to Test-Harness-3.17

[p5sagit/p5-mst-13.2.git] / ext / Test-Harness / bin / prove

diff --git a/ext/Test-Harness/bin/prove b/ext/Test-Harness/bin/prove
index cde1b9b..a592a80 100644 (file)
--- a/ext/Test-Harness/bin/prove
+++ b/ext/Test-Harness/bin/prove
@@ -31,7 +31,8 @@ Boolean options:
       --nocount     Disable the X/Y test count.
  -D   --dry         Dry run. Show test that would have run.
       --ext         Set the extension for tests (default '.t')
- -f,  --failures    Only show failed tests.
+ -f,  --failures    Show failed tests.
+ -o,  --comments    Show comments.
       --fork        Fork to run harness in multiple processes.
       --ignore-exit Ignore exit status from test scripts.
  -m,  --merge       Merge test scripts' STDERR with their STDOUT.
@@ -42,6 +43,7 @@ Boolean options:
  -p,  --parse       Show full list of TAP parse errors, if any.
       --directives  Only show results with TODO or SKIP directives.
       --timer       Print elapsed time after each test.
+      --normalize   Normalize TAP output in verbose output
  -T                 Enable tainting checks.
  -t                 Enable tainting warnings.
  -W                 Enable fatal warnings.
@@ -106,6 +108,10 @@ Color support requires L<Term::ANSIColor> on Unix-like platforms and
 L<Win32::Console> windows. If the necessary module is not installed
 colored output will not be available.
 
+=head2 Exit Code
+
+If the tests fail C<prove> will exit with non-zero status.
+
 =head2 Arguments to Tests
 
 It is possible to supply arguments to tests. To do so separate them from
@@ -248,6 +254,15 @@ The C<--state> switch may be used more than once.
 
     $ prove -b --state=hot --state=all,save
 
+=head2 @INC
+
+prove introduces a separation between "options passed to the perl which
+runs prove" and "options passed to the perl which runs tests"; this
+distinction is by design. Thus the perl which is running a test starts
+with the default C<@INC>. Additional library directories can be added
+via the C<PERL5LIB> environment variable, via -Ifoo in C<PERL5OPT> or
+via the C<-Ilib> option to F<prove>.
+
 =head2 Taint Mode
 
 Normally when a Perl program is run in taint mode the contents of the