X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=t%2FREADME;h=c129720ae2e7f88ae480b35d89b6a7c62c067a52;hb=25988e07f3c5c5717930b897625a3e6119c92879;hp=6fb569b98feff052290dc1f70f8393c17e634cd4;hpb=bbad36071d5a6d4be3588f0f10c88247439076d8;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/t/README b/t/README
index 6fb569b..c129720 100644
--- a/t/README
+++ b/t/README
@@ -1,6 +1,11 @@
-This is the perl test library.  To run all the tests, just type 'TEST'.
+This is the perl test library.  To run the test suite, just type './TEST'
+or 'make test' from the build directory above t/.  See also the section
+"Special Make Test Targets" in pod/perlhack.pod to learn about other
+specific test commands.
 
 To add new tests, just look at the current tests and do likewise.
+The library t/test.pl provides some utility functions that you can use
+in most tests, except in the most basic ones.
 
 If a test fails, run it by itself to see if it prints any informative
 diagnostics.  If not, modify the test to print informative diagnostics.
@@ -8,9 +13,19 @@ If you put out extra lines with a '#' character on the front, you don't
 have to worry about removing the extra print statements later since TEST
 ignores lines beginning with '#'.
 
-If you know that "basic" features work and expect that some test are going
-to fail, it is adviced to run tests via Test::Harness thusly:
+If you know that Perl is basically working but expect that some tests
+will fail, you may want to use Test::Harness thusly:
+        cd t
 	./perl -I../lib harness
-This would pinpoint failed tests with better granularity.
+This method pinpoints failed tests automatically.
 
-If you come up with new tests, send them to larry@wall.org.
+If you come up with new tests, please send them to perlbug@perl.org.
+
+Tests in the t/base/ directory ought to be runnable with plain miniperl.
+That is, they should not require Config.pm nor should they require any
+extensions to have been built.  TEST will abort if any tests in the
+t/base/ directory fail.
+
+Tests in the t/comp/, t/cmd/, t/run/, t/io/, t/op/ and t/uni/ directories
+should also be runnable by miniperl and not require Config.pm, but
+failures to comply will not cause TEST to abort like for t/base/.