This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Integrate mainline
[perl5.git] / t / README
CommitLineData
bd87065d
PP
1This is the perl test library. To run most of the tests, just type './TEST'
2(which will not run the tests residing in lib/ or ext/. In order to run
3all of the tests type 'make test' from the build direcotory above t/).
8d063cd8
LW
4
5To add new tests, just look at the current tests and do likewise.
6
7If a test fails, run it by itself to see if it prints any informative
8diagnostics. If not, modify the test to print informative diagnostics.
9If you put out extra lines with a '#' character on the front, you don't
10have to worry about removing the extra print statements later since TEST
11ignores lines beginning with '#'.
12
774d564b
PP
13If you know that Perl is basically working but expect that some tests
14will fail, you may want to use Test::Harness thusly:
bd87065d 15 cd t
bbad3607 16 ./perl -I../lib harness
774d564b 17This method pinpoints failed tests automatically.
bbad3607 18
e22791c4 19If you come up with new tests, please send them to perlbug@perl.org.
b25e12d2 20
bd87065d 21Tests in the t/base/ directory ought to be runnable with plain miniperl.
b25e12d2
AD
22That is, they should not require Config.pm nor should they require any
23extensions to have been built. TEST will abort if any tests in the
bd87065d
PP
24t/base/ directory fail.
25
26Tests in the t/comp/, t/cmd/, t/run/, t/io/, and t/op/ directories should
27also be runnable by miniperl and not require Config.pm, but failures
28to comply will not cause TEST to abort like for t/base/.