From: Ævar Arnfjörð Bjarmason <avar@users.mediawiki.org>
Date: Tue, 9 Jan 2007 03:57:56 +0000 (+0000)
Subject:  r53267@Arsia:  avar | 2007-01-09 03:50:19 +0000
X-Git-Tag: 1.31.0-rc.0~54563
X-Git-Url: http://git.cyclocoop.org/%22.%24h.%22?a=commitdiff_plain;h=a1763431828572694407a22dead170677905fa47;p=lhc%2Fweb%2Fwiklou.git

 r53267@Arsia:  avar | 2007-01-09 03:50:19 +0000
 * Add info on how to use the tests
---

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