Document new gdb_test_timeout global variable.
authorJoel Brobecker <brobecker@gnat.com>
Sat, 13 Feb 2010 04:57:11 +0000 (04:57 +0000)
committerJoel Brobecker <brobecker@gnat.com>
Sat, 13 Feb 2010 04:57:11 +0000 (04:57 +0000)
        * gdbint.texinfo (Testsuite): New section "Testsuite Configuration",
        documenting the gdb_test_timeout variable.

gdb/doc/ChangeLog
gdb/doc/gdbint.texinfo

index 4031a4a43b89d2ccc21b3e5d193a8155c2551f56..1361c3c4072a331bb5bfeb2ba8a2da68e538b5b0 100644 (file)
@@ -1,3 +1,8 @@
+2010-02-13  Joel Brobecker  <brobecker@adacore.com>
+
+       * gdbint.texinfo (Testsuite): New section "Testsuite Configuration",
+       documenting the gdb_test_timeout variable.
+
 2010-02-12  Jakob Engblom  <jakob@virtutech.com>
 
        * gdb.texinfo (MI commands): Added documentation of --reverse
index c90af0534f3b1f0dce74e05ddfbe9fbd7ba803eb..77418557ca90eabebff8766d1415b0cf876b598d 100644 (file)
@@ -7693,6 +7693,38 @@ make site.exp
 runtest TRANSCRIPT=y
 @end smallexample
 
+@section Testsuite Configuration
+@cindex Testsuite Configuration
+
+It is possible to adjust the behavior of the testsuite by defining
+the global variables listed below, either in a @file{site.exp} file,
+or in a board file.
+
+@itemize @bullet
+
+@item @code{gdb_test_timeout}
+
+Defining this variable changes the default timeout duration used during
+communication with @value{GDBN}.  More specifically, the global variable
+used during testing is @code{timeout}, but this variable gets reset to
+@code{gdb_test_timeout} at the beginning of each testcase, making sure
+that any local change to @code{timeout} in a testcase does not affect
+subsequent testcases.
+
+This global variable comes in handy when the debugger is slower than
+normal due to the testing environment, triggering unexpected @code{TIMEOUT}
+test failures.  Examples include when testing on a remote machine, or
+against a system where communications are slow.
+
+If not specifically defined, this variable gets automatically defined
+to the same value as @code{timeout} during the testsuite initialization.
+The default value of the timeout is defined in the file
+@file{gdb/testsuite/config/unix.exp} that is part of the @value{GDBN}
+test suite@footnote{If you are using a board file, it could override
+the test-suite default; search the board file for "timeout".}.
+
+@end itemize
+
 @section Testsuite Organization
 
 @cindex test suite organization