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

diff --git a/t/README b/t/README
index e2cb308..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 '#'.
 
-Several tests assume you have sucessfully included the POSIX
-extension.  If you have not, lib/[nos]dbm.t will fail.  Try replacing
-the O_CREAT|O_RDWR with either 0x202 or 0x102 in the tie statements
-and run the tests again.
+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 method pinpoints failed tests automatically.
 
-If you come up with new tests, send them to lwall@netlabs.com.
+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/.