gdb/testsuite/README: point to default value of INTERNAL_GDBFLAGS
authorPhilippe Blain <levraiphilippeblain@gmail.com>
Sun, 20 Feb 2022 16:49:12 +0000 (11:49 -0500)
committerSimon Marchi <simon.marchi@polymtl.ca>
Tue, 22 Feb 2022 14:32:45 +0000 (09:32 -0500)
The INTERNAL_GDBFLAGS runtest variable was updated in 55c3ad88013
([gdb/testsuite] Prevent pagination in GDB_INTERNALFLAGS, 2020-10-26) to
disable pagination, and in aae1c79a03a (PR python/12227..., 2010-12-07)
to point to the data directory, but its default value mentioned in the
testsuite's README was not kept up to date.

To avoid it getting out of sync even more, point the reader to the
definition of the variable in lib/gdb.exp, and move the explanation of
the different flags there. Also adjust the example in the README
so it follows the flags added in 55c3ad88013.

Change-Id: I3533608a7d6ae5198af09c7dc7743bde24c19ed7

gdb/testsuite/README
gdb/testsuite/lib/gdb.exp

index 7552774c78badc25f6b282feefe7c887e5ba5d49..c2f659a71887933e3a8edf25443140fa90ee1611 100644 (file)
@@ -167,12 +167,7 @@ checks both the installed GDB and GDBserver.
 INTERNAL_GDBFLAGS
 
 Command line options passed to all GDB invocations.
-
-The default is "-nw -nx".
-
-`-nw' disables any of the windowed interfaces.
-`-nx' disables ~/.gdbinit, so that it doesn't interfere with
-the tests.
+The default is set in lib/gdb.exp.
 
 This is actually considered an internal variable, and you
 won't normally want to change it.  However, in some situations,
@@ -193,7 +188,10 @@ a .gdbinit.  For example:
        HOME=`pwd` runtest \
          GDB=/usr/bin/gdb \
          GDBSERVER=/usr/bin/gdbserver \
-         INTERNAL_GDBFLAGS=-nw
+         INTERNAL_GDBFLAGS="-nw -iex 'set height 0' -iex 'set width 0'"
+
+Note that we do not need to specify '-data-directory' here
+as we are testing an installed GDB.
 
 GDB_PARALLEL
 
index a3717a402297866e070ebb51d4b45e0d7d599d36..0cec46731bb0ed90e03aab17e50a2f467eb30c38 100644 (file)
@@ -129,6 +129,10 @@ verbose "using GDBFLAGS = $GDBFLAGS" 2
 set BUILD_DATA_DIRECTORY "[pwd]/../data-directory"
 
 # INTERNAL_GDBFLAGS contains flags that the testsuite requires.
+# `-nw' disables any of the windowed interfaces.
+# `-nx' disables ~/.gdbinit, so that it doesn't interfere with the tests.
+# `-data-directory' points to the data directory in the build directory.
+# `-iex "set {height,width} 0"' disables pagination.
 global INTERNAL_GDBFLAGS
 if ![info exists INTERNAL_GDBFLAGS] {
     set INTERNAL_GDBFLAGS \