mirror of
git://git.sv.gnu.org/autoconf
synced 2025-03-13 14:36:50 +08:00
(Particular Programs): @code{$PATH} -> @env{PATH}.
(Using Autotest, testsuite Scripts, Writing testsuite.at): Reword slightly to avoid some English-language problems noted by Ralf Wildenhues in: http://lists.gnu.org/archive/html/autoconf-patches/2004-11/msg00027.html
This commit is contained in:
parent
3f0a1ceaad
commit
1bf76fd578
@ -3255,7 +3255,7 @@ input before matching. On Solaris 9 @code{/usr/bin/grep} does not
|
||||
understand the @option{-e} option. On NeXT, @code{grep} understands only a
|
||||
single @option{-e} option. This macro looks for @sc{gnu} Grep or
|
||||
else the best available @code{grep} or @code{ggrep} in the user's
|
||||
@code{$PATH} which accepts the longest input lines possible, and which
|
||||
@env{PATH} which accepts the longest input lines possible, and which
|
||||
accepts and respects multiple @option{-e} options. Set the
|
||||
output variable @code{GREP} to whatever is chosen.
|
||||
@end defmac
|
||||
@ -3264,8 +3264,8 @@ output variable @code{GREP} to whatever is chosen.
|
||||
@acindex{PROG_EGREP}
|
||||
@ovindex EGREP
|
||||
Check whether @code{$GREP -E} works, or else search the user's
|
||||
@code{$PATH} for @code{egrep}, and @code{gegrep}, in that order, and set
|
||||
output variable @code{EGREP} to the one which accepts the longest input
|
||||
@env{PATH} for @code{egrep}, and @code{gegrep}, in that order, and set
|
||||
output variable @code{EGREP} to the one that accepts the longest input
|
||||
lines.
|
||||
@end defmac
|
||||
|
||||
@ -3273,8 +3273,8 @@ lines.
|
||||
@acindex{PROG_FGREP}
|
||||
@ovindex FGREP
|
||||
Check whether @code{$GREP -F} works, or else search the user's
|
||||
@code{$PATH} for @code{fgrep}, and @code{gfgrep}, in that order, and set
|
||||
output variable @code{FGREP} to the one which accepts the longest input
|
||||
@env{PATH} for @code{fgrep}, and @code{gfgrep}, in that order, and set
|
||||
output variable @code{FGREP} to the one that accepts the longest input
|
||||
lines.
|
||||
@end defmac
|
||||
|
||||
@ -15136,10 +15136,10 @@ the very platforms that are most likely to torture Autoconf and
|
||||
exhibit deficiencies.
|
||||
|
||||
To circumvent this problem many package maintainers have developed their
|
||||
own testing framework, based on simple shell scripts whose sole output
|
||||
are their exit status: the test succeeded, or failed. In addition, most
|
||||
of these tests share some common patterns, what results in lots of
|
||||
duplicated code, tedious maintenance etc.
|
||||
own testing framework, based on simple shell scripts whose sole outputs
|
||||
are exit status values describing whether the test succeeded. Most of
|
||||
these tests share common patterns, and this can result in lots of
|
||||
duplicated code and tedious maintenance.
|
||||
|
||||
Following exactly the same reasoning that yielded to the inception of
|
||||
Autoconf, Autotest provides a test suite generation frame work, based on
|
||||
@ -15151,7 +15151,7 @@ Autoconf itself has been using Autotest for years, and we do attest that
|
||||
it has considerably improved the strength of the test suite, and the
|
||||
quality of bug reports. Other projects are known to use some generation
|
||||
of Autotest, such as Bison, Free Recode, Free Wdiff, @acronym{GNU} Tar, each of
|
||||
them having different needs, what slowly polishes Autotest as a general
|
||||
them with different needs, and this usage has validated Autotest as a general
|
||||
testing framework.
|
||||
|
||||
Nonetheless, compared to Deja@acronym{GNU}, Autotest is inadequate for
|
||||
@ -15189,16 +15189,16 @@ Each test of the validation suite should be part of some test group. A
|
||||
@dfn{test group} is a sequence of interwoven tests that ought to be
|
||||
executed together, usually because one test in the group creates data
|
||||
files than a later test in the same group needs to read. Complex test
|
||||
groups make later debugging more tedious. It is much better keeping
|
||||
keep only a few tests per test group, and if you can put only one test
|
||||
per test group, this is just ideal.
|
||||
groups make later debugging more tedious. It is much better to
|
||||
keep only a few tests per test group. Ideally there is only one test
|
||||
per test group.
|
||||
|
||||
For all but the simplest packages, some file such as @file{testsuite.at}
|
||||
does not fully hold all test sources, as these are often easier to
|
||||
maintain in separate files. Each of these separate files holds a single
|
||||
test group, or a sequence of test groups all addressing some common
|
||||
functionality in the package. In such cases, file @file{testsuite.at}
|
||||
only initializes the whole validation suite, and sometimes do elementary
|
||||
functionality in the package. In such cases, @file{testsuite.at}
|
||||
merely initializes the validation suite, and sometimes does elementary
|
||||
health checking, before listing include statements for all other test
|
||||
files. The special file @file{package.m4}, containing the
|
||||
identification of the package, is automatically included if found.
|
||||
@ -15231,7 +15231,7 @@ of debugging scripts has the purpose of easing the chase for bugs.
|
||||
@end itemize
|
||||
|
||||
In the ideal situation, none of the tests fail, and consequently, no
|
||||
debugging directory is left out of validation.
|
||||
debugging directory is left behind for validation.
|
||||
|
||||
It often happens in practice that individual tests in the validation
|
||||
suite need to get information coming out of the configuration process.
|
||||
@ -15363,12 +15363,12 @@ new executables, in other words, don't fear registering one program
|
||||
several times.
|
||||
@end defmac
|
||||
|
||||
Autotest test suites rely on the @env{PATH} to find the tested program.
|
||||
This saves from generating the absolute names of the various tools, and
|
||||
makes it possible to test installed programs. Therefore, knowing what
|
||||
programs are being exercised is crucial to understand some problems in
|
||||
Autotest test suites rely on @env{PATH} to find the tested program.
|
||||
This avoids the need to generate absolute names of the various tools, and
|
||||
makes it possible to test installed programs. Therefore, knowing which
|
||||
programs are being exercised is crucial to understanding problems in
|
||||
the test suite itself, or its occasional misuses. It is a good idea to
|
||||
also subscribe foreign programs you depend upon, to ease incompatibility
|
||||
also subscribe foreign programs you depend upon, to avoid incompatible
|
||||
diagnostics.
|
||||
|
||||
@sp 1
|
||||
|
Loading…
x
Reference in New Issue
Block a user