gdb: add target_ops::supports_displaced_step

[deliverable/binutils-gdb.git] / gdb / testsuite / README

diff --git a/gdb/testsuite/README b/gdb/testsuite/README
index 4795df1f75969fa25b966aabbcc4c419c62eb6fd..fae0c339ccabcf935b3fb2e82754b85505607ea5 100644 (file)
--- a/gdb/testsuite/README
+++ b/gdb/testsuite/README
@@ -197,7 +197,7 @@ a .gdbinit.  For example:
 
 GDB_PARALLEL
 
-To use parallel testing mode without using the the Makefile, set
+To use parallel testing mode without using the Makefile, set
 GDB_PARALLEL on the runtest command line to "yes".  Before starting
 the tests, you must ensure that the directories cache, outputs, and
 temp in the test suite build directory are either empty or have been
@@ -352,6 +352,13 @@ Examples:
        make -j10 check-read1 TESTS="*/paginate-*.exp"
        make -j10 check READ1="1"
 
+Note: While the intention is to detect races and make otherwise passing tests
+fail, it can also have the effect of making otherwise failing tests pass.
+This happens f.i. if the test is trying to match a gdb prompt using an end of
+input marker "${gdb_prompt} $" and there is output after the gdb prompt.  This
+may either pass or fail in normal operation, but using check-read1 will ensure
+that it passes.
+
 Testsuite Configuration
 ***********************