tests/README: suggest how to run tests in cross-compile mode

* tests/README (Section "User interface" subsection "Running the
tests"): Briefly explain how to override 'host_alias' at runtime
to force the use of cross-compilers by the testsuite.  Give an
example.

diff --git a/ChangeLog b/ChangeLog
index fd23cb9ef58e1385b4795c1cbcc1abb92ac8fd9b..587490a466390a7bfdb6c017374073b9db4f6352 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2011-05-21  Stefano Lattarini  <stefano.lattarini@gmail.com>
+
+       tests/README: suggest how to run tests in cross-compile mode
+       * tests/README (Section "User interface" subsection "Running the
+       tests"): Briefly explain how to override 'host_alias' at runtime
+       to force the use of cross-compilers by the testsuite.  Give an
+       example.
+
 2011-05-21  Stefano Lattarini  <stefano.lattarini@gmail.com>
 
        test defs: better detection of cross-compile mode

diff --git a/tests/README b/tests/README
index 29c964b6bacee5479d61a8f0e4a973d78dc7f5d7..4d6bbf6451c0ef65b2dc87cbfb2f6dc0afd1ae56 100644 (file)
--- a/tests/README
+++ b/tests/README
@@ -32,6 +32,19 @@ Running the tests
 
     env TESTS="foo.test bar.test" make -e -k check
 
+ To run the tests in cross-compilation mode:
+
+    make -k check host_alias="$host_alias"           (GNU make)
+    env host_alias="$host_alias" make -e -k check    (non-GNU make)
+
+ Here `$host_alias' should be defined to a proper value different from
+ configure-determined `$build_alias', and should refer to a set of
+ cross-compilers you have available on your system; for example, if
+ on Linux you have a set of MinGW-targeted cross-compilers named
+ 'i586-mingw32msvc-cc', 'i586-mingw32msvc-c++', etc., you could use:
+
+   make -k check host_alias='i586-mingw32msvc'
+
 
 Interpretation
 --------------