aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJacob Bachmeyer <jcb62281@gmail.com>2019-01-23 17:47:45 +1100
committerBen Elliston <bje@gnu.org>2019-01-23 17:47:45 +1100
commit73a9a52f3f5f4b2bf4d74a29a4150fb85e8c4150 (patch)
tree4a973e2cb00227bc454f736ea5584d595887b9ea
parentbe2257674498a97bd600af4f3634bf3275679246 (diff)
downloaddejagnu-73a9a52f3f5f4b2bf4d74a29a4150fb85e8c4150.zip
dejagnu-73a9a52f3f5f4b2bf4d74a29a4150fb85e8c4150.tar.gz
dejagnu-73a9a52f3f5f4b2bf4d74a29a4150fb85e8c4150.tar.bz2
* doc/dejagnu.texi (Command line option variables): Improve table
formatting to fix overlapping columns and revise text slightly. Signed-off-by: Ben Elliston <bje@gnu.org>
-rw-r--r--ChangeLog5
-rw-r--r--doc/dejagnu.texi27
2 files changed, 13 insertions, 19 deletions
diff --git a/ChangeLog b/ChangeLog
index 93c07f9..26abde6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
2019-01-23 Jacob Bachmeyer <jcb62281@gmail.com>
+ * doc/dejagnu.texi (Command line option variables): Improve table
+ formatting to fix overlapping columns and revise text slightly.
+
+2019-01-23 Jacob Bachmeyer <jcb62281@gmail.com>
+
* doc/dejagnu.texi (Global config file): Change example to use the
Tcl "switch" command instead of the deprecated "case" command.
diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi
index 592797d..0f31fee 100644
--- a/doc/dejagnu.texi
+++ b/doc/dejagnu.texi
@@ -1564,10 +1564,10 @@ part of the array.
@node Command line option variables, User configuration file, , Config file values
@subsection Command line option variables
-In the user editable second section of the @ref{User configuration file}
-you can not only override the configuration variables captured in the
-first section, but also specify default values for all on the
-@code{runtest} command line options. Save for @code{--debug},
+In the user editable second section of the @ref{User configuration
+file} you can not only override the configuration variables captured
+in the first section, but also specify default values for all of the
+@code{runtest} command line options. Excepting @code{--debug},
@code{--help}, and @code{--version}, each command line option has an
associated Tcl variable. Use the Tcl @code{set} command to specify a
new default value (as for the configuration variables). The following
@@ -1575,20 +1575,9 @@ table describes the correspondence between command line options and
variables you can set in @file{site.exp}. Refer to @ref{Invoking
runtest}, for explanations of the command-line options.
-The @code{--local_init} and @code{--global_init} options have associated
-Tcl variables, but they influence the search for configuration files and
-overriding them is unlikely to be useful because they are not used after
-the configuration files are loaded. Once the configuration file is
-opened, it is too late for a change to these variables to be effective.
-However, the local init file name is used twice, once relative to
-@code{base_dir} (the directory in which runtest was started) and once
-relative to @code{objdir}. While testsuites should not make assumptions
-about what global init files are available, the user could usefully
-write such a setting.
-
-@multitable @columnfractions 0.2 0.2 0.6
-@item
-@strong{Option}@tab @strong{Tcl variable}@tab @strong{Description}
+@multitable {--target_board} {TOOL_EXECUTABLE} {verbosity level greater than or equal to 0}
+@headitem
+Option@tab Tcl variable@tab Description
@item
-a, --all@tab all_flag@tab display all test results if set
@@ -1636,7 +1625,7 @@ write such a setting.
--target_board@tab target_list@tab list of target boards to run tests on
@item
---tool@tab tool@tab name of tool to test (identifies init, test subdirectory)
+--tool@tab tool@tab name of tool to test (selects tests to run)
@item
--tool_exec@tab TOOL_EXECUTABLE@tab path to the executable to test