X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=t%2FREADME;h=e35af9947adc38155d01a0c4da4adb79ac7f009e;hb=fdf0a293a88d8a14c42b43c2f82c991c50f7dc39;hp=0953026607cc5c0c52002ae9523c8482780d13ac;hpb=e22791c4597f0b034cb48b9cb23e1774820719a6;p=p5sagit%2Fp5-mst-13.2.git diff --git a/t/README b/t/README index 0953026..e35af99 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. @@ -10,7 +15,17 @@ ignores lines beginning with '#'. If you know that Perl is basically working but expect that some tests will fail, you may want to use Test::Harness thusly: - ./perl -I../lib harness + cd t + ./perl harness This method pinpoints failed tests automatically. 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/.