This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: Cross-test documentation
On Tue, 30 Oct 2012, Andreas Schwab wrote:
> "Joseph S. Myers" <joseph@codesourcery.com> writes:
>
> > @@ -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, @samp{test-wrapper} may be set when testing @theglibc{} to
> > +the name and arguments of any program to run newly built binaries.
>
> IMHO it'd be better to move "@samp{test-wrapper} may be set" after "when
> testing @theglibc{}".
This version makes that change (but not any other change to ascribe a
purpose to the use of such wrappers).
2012-10-30 Joseph Myers <joseph@codesourcery.com>
* manual/install.texi (Configuring and compiling): Document
general use of test-wrapper and test-wrapper-env.
* INSTALL: Regenerated.
diff --git a/INSTALL b/INSTALL
index 9c62786..d700198 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 c82b918..4802e69 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
--
Joseph S. Myers
joseph@codesourcery.com