From: Thomas Wood <thomas.wood@intel.com>
Date: Fri, 11 Jul 2014 09:47:43 +0000 (+0100)
Subject: README: update the test run instructions
X-Git-Tag: intel-gpu-tools-1.8~212
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=d3cfe28a1a4cc39044dbfd494370a903c39f2649;p=platform%2Fupstream%2Fintel-gpu-tools.git

README: update the test run instructions

Describe using the new run-tests.sh script and also update the Piglit
instructions now that using a symlink is no longer supported.

Signed-off-by: Thomas Wood <thomas.wood@intel.com>
---

diff --git a/README b/README
index 5e98565..ee21648 100644
--- a/README
+++ b/README
@@ -24,13 +24,29 @@ tests/
 	changes.  Hopefully this can cover the relevant cases we need to
 	worry about, including backwards compatibility.
 
-	Note: The old automake based testrunner had to be scraped due to
-	upstream changes which broke dynamic creation of the test list. Of
-	course it is still possible to directly run tests, even when not always
-	limiting tests to specific subtests (like piglit does).
+	The test suite can be run using the run-tests.sh script available in
+	the scripts directory. Piglit is used to run the tests and can either
+	be installed from your distribution (if available), or can be
+	downloaded locally for use with the script by running:
 
-	The more comfortable way to run tests is with piglit. First grab piglit
-	from:
+	./scripts/run-tests.sh -d
+
+	run-tests.sh has options for filtering and excluding tests from test
+	runs:
+
+	  -t <regex>      only include tests that match the regular expression
+	  -x <regex>      exclude tests that match the regular expression
+
+	Useful patterns for test filtering are described in
+	tests/NAMING-CONVENTION and the full list of tests and subtests can be
+	produced by passing -l to the run-tests.sh script.
+
+	Results are written to a JSON file and an HTML summary can also be
+	created by passing -s to the run-tests.sh script. Further options are
+	are detailed by using the -h option.
+
+
+	If not using the script, piglit can be obtained from:
 
 	git://anongit.freedesktop.org/piglit
 
@@ -38,14 +54,12 @@ tests/
 	used for running i-g-t tests.
 
 	Set the IGT_TEST_ROOT environment variable to point to the tests
-	directory or link up the i-g-t sources with piglit using a symlink:
-
-	piglit-sources $ cd bin
-	piglit-sources/bin $ ln $i-g-t-sources igt -s
+	directory, or set the path key in the "igt" section of piglit.conf to
+	the intel-gpu-tools root directory.
 
-	In both cases, the tests in the i-g-t sources need to have been built
-	already. Then we can run the testcases with (as usual as root, no other
-	drm clients running):
+	The tests in the i-g-t sources need to have been built already. Then we
+	can run the testcases with (as usual as root, no other drm clients
+	running):
 
 	piglit-sources # ./piglit run igt <results-file>