X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/bbad36071d5a6d4be3588f0f10c88247439076d8..686337f3173d259f9dc05f9d6c19a8c95e2cb00b:/t/README diff --git a/t/README b/t/README index 6fb569b..b4b1f53 100644 --- a/t/README +++ b/t/README @@ -1,4 +1,6 @@ -This is the perl test library. To run all the tests, just type 'TEST'. +This is the perl test library. To run most of the tests, just type './TEST' +(which will not run the tests residing in lib/ or ext/. In order to run +all of the tests type 'make test' from the build direcotory above t/). To add new tests, just look at the current tests and do likewise. @@ -8,9 +10,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/, and t/op/ 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/.