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