Document general use of test-wrapper and test-wrapper-env.

diff --git a/ChangeLog b/ChangeLog
index d5eefa6..fd72f40 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2012-10-31  Joseph Myers  <joseph@codesourcery.com>
 
+       * manual/install.texi (Configuring and compiling): Document
+       general use of test-wrapper and test-wrapper-env.
+       * INSTALL: Regenerated.
+
        * sysdeps/ieee754/dbl-64/s_fma.c: Include <tininess.h>.
        (__fma): Do not extract and scale down low bits on after-rounding
        systems when result rounded to normal precision would have normal

diff --git a/INSTALL b/INSTALL
index 9c62786..d700198 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -204,6 +204,17 @@ HOSTNAME is the host name of a system that can run the newly built
 binaries of the GNU C Library.  The source and build directories must
 be visible at the same locations on both the build system and HOSTNAME.
 
+   In general, when testing the GNU C Library, `test-wrapper' may be set
+to the name and arguments of any program to run newly built binaries.
+This program must preserve the arguments to the binary being run, its
+working directory, all environment variables set as part of testing and
+the standard input, output and error file descriptors.  If
+`TEST-WRAPPER env' will not work to run a program with environment
+variables set, then `test-wrapper-env' must be set to a program that
+runs a newly built program with environment variable assignments in
+effect, those assignments being specified as `VAR=VALUE' before the
+name of the program to be run.
+
 Installing the C Library
 ========================
 

diff --git a/manual/install.texi b/manual/install.texi
index c82b918..4802e69 100644 (file)
--- a/manual/install.texi
+++ b/manual/install.texi
@@ -233,6 +233,17 @@ the newly built binaries of @theglibc{}.  The source and build
 directories must be visible at the same locations on both the build
 system and @var{hostname}.
 
+In general, when testing @theglibc{}, @samp{test-wrapper} may be set
+to the name and arguments of any program to run newly built binaries.
+This program must preserve the arguments to the binary being run, its
+working directory, all environment variables set as part of testing
+and the standard input, output and error file descriptors.  If
+@samp{@var{test-wrapper} env} will not work to run a program with
+environment variables set, then @samp{test-wrapper-env} must be set to
+a program that runs a newly built program with environment variable
+assignments in effect, those assignments being specified as
+@samp{@var{var}=@var{value}} before the name of the program to be run.
+
 
 @node Running make install
 @appendixsec Installing the C Library