From 0eb69512575e1e2ccfec4c4489fa3fb6201d38d1 Mon Sep 17 00:00:00 2001 From: Joseph Myers Date: Wed, 31 Oct 2012 20:43:54 +0000 Subject: [PATCH] Document general use of test-wrapper and test-wrapper-env. --- ChangeLog | 4 ++++ INSTALL | 11 +++++++++++ manual/install.texi | 11 +++++++++++ 3 files changed, 26 insertions(+) diff --git a/ChangeLog b/ChangeLog index d5eefa6ee5..fd72f40445 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2012-10-31 Joseph Myers + * 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 . (__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