From a1763431828572694407a22dead170677905fa47 Mon Sep 17 00:00:00 2001
From: =?utf8?q?=C3=86var=20Arnfj=C3=B6r=C3=B0=20Bjarmason?=
 <avar@users.mediawiki.org>
Date: Tue, 9 Jan 2007 03:57:56 +0000
Subject: [PATCH]  r53267@Arsia:  avar | 2007-01-09 03:50:19 +0000  * Add info
 on how to use the tests

---
 t/README | 48 ++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 46 insertions(+), 2 deletions(-)

diff --git a/t/README b/t/README
index 3141f2c658..2bf42abac7 100644
--- a/t/README
+++ b/t/README
@@ -4,7 +4,51 @@ F<t> - MediaWiki test tree
 
 =head1 DESCRIPTION
 
-This is the MediaWiki test tree (well, one of them), tests here
-produce TAP output, see L<TAP>.
+This is the MediaWiki test tree (well, one of them), tests in this
+directory are self-contained programs that produce TAP output via the
+F<Test.php> module (/trunk/Test/Test.php) (see
+http://search.cpan.org/~petdance/TAP-1.00/TAP.pm#THE_TAP_FORMAT for
+information on the TAP format).
+
+=head1 Running the tests
+
+You'll need F<Test.php> to run the tests, it lives in the
+F<trunk/Test> directory and can be copied or linked to the F<phase3>
+directory.
+
+    ln -s ../Test/Test.php .
+
+Since the tests are self-contained PHP programs you can run them
+(Xml.t here) as:
+
+    php t/inc/Xml.t
+
+That'll give you the raw TAP output, but what you probably want is to
+use a TAP formatter such as L<prove(1)>:
+
+    prove t/inc/Xml.t # add -v for the verbose version
+
+or to run all the tests:
+
+   prove -r t
+
+=head1 TODO
+
+=over
+
+=item *
+
+Rewrite the rest of the F<tests/> stuff to use L<Test.php> and move it
+here
+
+=item *
+
+Make the parsertests use TAP?
+
+=item *
+
+Write unit tests for the entire codebase:)
+
+=back
 
 =cut
-- 
2.20.1