about summary refs log tree commit diff
diff options
context:
space:
mode:
authorJoseph Myers <joseph@codesourcery.com>2012-10-31 20:43:54 +0000
committerJoseph Myers <joseph@codesourcery.com>2012-10-31 20:43:54 +0000
commit0eb69512575e1e2ccfec4c4489fa3fb6201d38d1 (patch)
tree9877d34e5925c4bdfc313f3498e811b1b81b9d7e
parent84097ebac3fe750617b900de3e14b2f11af6e75b (diff)
downloadglibc-0eb69512575e1e2ccfec4c4489fa3fb6201d38d1.tar.gz
glibc-0eb69512575e1e2ccfec4c4489fa3fb6201d38d1.tar.xz
glibc-0eb69512575e1e2ccfec4c4489fa3fb6201d38d1.zip
Document general use of test-wrapper and test-wrapper-env.
-rw-r--r--ChangeLog4
-rw-r--r--INSTALL11
-rw-r--r--manual/install.texi11
3 files changed, 26 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index d5eefa6ee5..fd72f40445 100644
--- 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 9c62786de0..d70019883a 100644
--- 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 c82b918ca7..4802e699fe 100644
--- 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