From 303e507c2783bb6c43c7c5be2467eaa8a57dadd9 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Mon, 23 Apr 2012 21:43:04 +0200 Subject: [PATCH] doc: fix incorrect and incomplete doc about cross-compilation mode * doc/autoconf.texi (Runtime): Mention the effect of the cross- compilation mode on AC_RUN_IFELSE. (Specifying Target Triplets): Fix description of --host's effects. (Hosts and Cross-Compilation): Remove incorrect statement about --host's effects. Signed-off-by: Eric Blake --- doc/autoconf.texi | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/doc/autoconf.texi b/doc/autoconf.texi index b1295ebe..a6296689 100644 --- a/doc/autoconf.texi +++ b/doc/autoconf.texi @@ -9491,8 +9491,11 @@ available in the shell variable @samp{$?}. This exit status might be that of a failed compilation, or it might be that of a failed program execution. -If the compiler being used does not produce executables that run on the -system where @command{configure} is being run, then the test program is +If cross-compilation mode is enabled (this is the case if either the +compiler being used does not produce executables that run on the system +where @command{configure} is being run, or if the options @code{--build} +and @code{--host} were both specified and their values are different), +then the test program is not run. If the optional shell commands @var{action-if-cross-compiling} are given, those commands are run instead; typically these commands provide pessimistic defaults that allow cross-compilation to work even @@ -21752,8 +21755,9 @@ cross-compilation mode. @item --host=@var{host-type} the type of system on which the package runs. By default it is the -same as the build machine. Specifying it enables cross-compilation -mode. +same as the build machine. Specifying a @var{host-type} that differs +from @var{build-type}, when @var{build-type} was also explicitly +specified, enables cross-compilation mode. @item --target=@var{target-type} the type of system for which any compiler tools in the package @@ -24459,10 +24463,7 @@ and they're different, @command{configure} enters cross compilation mode, so it doesn't run any tests that require execution. Hint: if you mean to override the result of @command{config.guess}, -prefer @option{--build} over @option{--host}. In the future, -@option{--host} will not override the name of the build system type. -Whenever you specify @option{--host}, be sure to specify @option{--build} -too. +prefer @option{--build} over @option{--host}. @sp 1 -- 2.47.2