aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjgraham <james@hoppipolla.co.uk>2015-06-02 23:24:24 +0100
committerjgraham <james@hoppipolla.co.uk>2015-06-02 23:24:24 +0100
commit45fe69bdefcdc48205cbf1ee28693b5806fd5e3d (patch)
treeb2cbff4b27b8c9765c8d65bf58502384d6c7fd0c
parent93f09b88c4f316804d13deaadac8ee91afedfb3b (diff)
downloadservo-45fe69bdefcdc48205cbf1ee28693b5806fd5e3d.tar.gz
servo-45fe69bdefcdc48205cbf1ee28693b5806fd5e3d.zip
Add documentation of reftest analyzer to wpt README
-rw-r--r--tests/wpt/README.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/tests/wpt/README.md b/tests/wpt/README.md
index 2d3a959f36f..ecd2de1415c 100644
--- a/tests/wpt/README.md
+++ b/tests/wpt/README.md
@@ -134,3 +134,21 @@ The `mozilla` directory contains tests that cannot be upstreamed for some
reason (e.g. because they depend on Servo-specific APIs), as well as some
legacy tests that should be upstreamed at some point. When run they are
mounted on the server under `/_mozilla/`.
+
+Analyzing reftest results
+=========================
+
+Reftest results can be analyzed from a raw log file. To generate this run
+with the `--log-raw` option e.g.
+
+ ./mach test-css --log-raw css.log
+
+This file can then be fed into the
+[reftest analyzer](http://hoppipolla.co.uk/410/reftest-analyser-structured.xhtml)
+which will show all failing tests (not just those with unexpected results).
+Note that this ingests logs in a different format to original version of the
+tool written for gecko reftests.
+
+The reftest analyzer allows pixel-level comparison of the test and reference
+screenshots. Tests that both fail and have an unexpected result are marked
+with a `!`.