trim_stress: Fail test at first frame which doesn't match reference

[apitrace-tests] / trim_stress / README.markdown

diff --git a/trim_stress/README.markdown b/trim_stress/README.markdown
index adab8dcb1b74117d924ba2e7d004633a8a6f2385..5678ceb807d570ed5cf5e2c2b09e02790e4116e1 100644 (file)
--- a/trim_stress/README.markdown
+++ b/trim_stress/README.markdown
@@ -5,15 +5,22 @@ will perform the following operations:
 
 Given <program>.trace:
 
-    1. Generate snapshots of original trace in ./<program>-ref/
+    1. Generate snapshots of original trace in ./<program>-ref/, (this
+       step is skipped if the <program>-ref directory already exists.
+       Simply delete this directory before "make test" to force new
+       generation of reference images.
 
     2. For each frame of the trace:
 
         1. Use "apitrace trim" to trim <program>.trace to a
            single-frame trace in <program>-trim.trace
 
-       2. Generate a snapshot of the trimmed trace to
-          ./<program>-out/<frame>.png
+       2. Generate a snapshot of the trimmed frame to
+          ./<program>-tmp-out/<frame>.png
 
-    3. Use "apitrace diff-images" to compare all snapshots in
-       ./<program>-out with those in ./<program>-ref
+        3. Use "apitrace diff-images" to compare this one frame with
+           the corresponding reference image in ./<program>-ref.  If
+           the images differ the entire process is interrupted here.
+
+        4. Move the frame snapshot from ./<program>-tmp-out to
+           ./<program>-out