docs: --target versus --host
authorTrevor Woerner <twoerner@gmail.com>
Wed Nov 16 16:06:42 2011 -0500 (2011-11-16)
changeset 2753710fa859bfe6
parent 2752 c4452a1a18fb
child 2754 0cc4d6352c3e
docs: --target versus --host

In the very beginnings, eons ago, autotools also got confused by this
whole build vs. host vs. target, and got it wrong. Now they fixed it,
but they want to keep backward compatibility, so the --target is still
recongised, although ./configure will complain if you do so. It is
better to use --host.

Signed-off-by: "Trevor Woerner" <twoerner@gmail.com>
[yann.morin.1998@anciens.enib.fr: add build/host clarification]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
docs/5 - Using the toolchain.txt
     1.1 --- a/docs/5 - Using the toolchain.txt	Tue Nov 15 19:11:57 2011 +0100
     1.2 +++ b/docs/5 - Using the toolchain.txt	Wed Nov 16 16:06:42 2011 -0500
     1.3 @@ -11,15 +11,20 @@
     1.4  your PATH, such as:
     1.5    export PATH="${PATH}:/your/toolchain/path/bin"
     1.6  
     1.7 -and then using the target tuple to tell the build systems to use your
     1.8 -toolchain:
     1.9 -  ./configure --target=your-target-tuple
    1.10 +and then using the '--host' tuple to tell the build systems to use your
    1.11 +toolchain (if the software package uses the autotools system you should
    1.12 +also pass --build, for completeness):
    1.13 +  ./configure --host=your-host-tuple --build=your-build-tuple
    1.14  or
    1.15 -  make CC=your-target-tuple-gcc
    1.16 +  make CC=your-host-tuple-gcc
    1.17  or
    1.18 -  make CROSS_COMPILE=your-target-tuple-
    1.19 +  make CROSS_COMPILE=your-host-tuple-
    1.20  and so on...
    1.21  
    1.22 +(Note: in the above example, 'host' refers to the host of your program,
    1.23 +not the host of the toolchain; and 'build' refers to the machine where
    1.24 +you build your program, that is the host of the toolchain.)
    1.25 +
    1.26  It is strongly advised not to use the toolchain sysroot directory as an
    1.27  install directory for your programs/packages. If you do so, you will not be
    1.28  able to use your toolchain for another project. It is even strongly advised