This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
utf8.c: Slight code simplification
[perl5.git] / t / README
index b4b1f53..97ba6fd 100644 (file)
--- a/t/README
+++ b/t/README
@@ -1,8 +1,11 @@
-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/).
+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.
@@ -13,7 +16,7 @@ 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
+        ./perl harness
 This method pinpoints failed tests automatically.
 
 If you come up with new tests, please send them to perlbug@perl.org.
@@ -23,6 +26,10 @@ 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/.
+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/.
+
+Tests in t/perf/ are designed to test performance and optimisations,
+and also contain additional tools and files designed to run outside
+of the test suite