[perl5.git] / t / README

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.

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.
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 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, 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/.
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
774d564b	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
b25e12d2 AD	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/.