X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?p=pintos-anon;a=blobdiff_plain;f=doc%2Fthreads.texi;fp=doc%2Fthreads.texi;h=bf8546e20526523a22fec5da30b76d68ddf9364a;hp=5a18ec49d9fa2a59b88710121204d7adc63a4833;hb=30343d465a99bcfafefb4334a9e080a4499f0b48;hpb=83855d769a0a09dd9f2bfdd74f1b5f8a23a1bd7e

diff --git a/doc/threads.texi b/doc/threads.texi
index 5a18ec4..bf8546e 100644
--- a/doc/threads.texi
+++ b/doc/threads.texi
@@ -643,6 +643,17 @@ to cause many of the tests to fail.
 
 @xref{Testing}.
 
+@item Should I try running the tests with jitter?
+
+Using the jitter feature in Bochs (@pxref{Debugging versus Testing})
+is a great way to discover bugs that are timing dependent. However,
+the following tests are known to
+fail with jitter even if your code is correct: @code{alarm-simultaneous},
+@code{mlfqs-recent-1}, @code{mlfqs-fair-2}, @code{mlfqs-fair-20},
+@code{mlfqs-nice-2}, @code{mlfqs-nice-10}, and @code{priority-fifo}.
+The behavior of these tests can sometimes vary based on timing (e.g.,
+if a timer interrupt arrives at an inconvenient time).
+
 @item Why do I get a test failure in @func{pass}?
 
 @anchor{The pass function fails}