dejagnu
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

PATCH: Improve formatting for option variable table


From: Jacob Bachmeyer
Subject: PATCH: Improve formatting for option variable table
Date: Tue, 22 Jan 2019 21:15:09 -0600
User-agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.8.1.22) Gecko/20090807 MultiZilla/1.8.3.4e SeaMonkey/1.1.17 Mnenhy/0.7.6.0

Previously, some of the variable names overlapped with the descriptions in hardcopy output. This patch fixes the problem and also adjusts the introduction text for the table.

----
ChangeLog entry:
        * doc/dejagnu.texi (Command line option variables): Improve table
        formatting to fix overlapping columns and revise text slightly.
----
patch:
----
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
address@hidden 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
address@hidden 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
address@hidden (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.
-
address@hidden @columnfractions 0.2 0.2 0.6
address@hidden
address@hidden@tab @strong{Tcl address@hidden @strong{Description}
address@hidden {--target_board} {TOOL_EXECUTABLE} {verbosity level greater than 
or equal to 0}
address@hidden
address@hidden Tcl address@hidden Description

@item
-a, address@hidden address@hidden display all test results if set
@@ -1636,7 +1625,7 @@ write such a setting.
address@hidden address@hidden list of target boards to run tests on

@item
address@hidden address@hidden name of tool to test (identifies init, test 
subdirectory)
address@hidden address@hidden name of tool to test (selects tests to run)

@item
address@hidden address@hidden path to the executable to test
----


-- Jacob



reply via email to

[Prev in Thread] Current Thread [Next in Thread]