docs/overview.txt
changeset 391 11172b754564
parent 389 0361a83180a2
child 436 ecbb620acaa0
     1.1 --- a/docs/overview.txt	Fri Sep 14 21:58:55 2007 +0000
     1.2 +++ b/docs/overview.txt	Sat Sep 15 21:44:18 2007 +0000
     1.3 @@ -493,24 +493,15 @@
     1.4          the endianness suffixes
     1.5     + return value: 0 upon success, !0 upon failure
     1.6     + provides:
     1.7 -     - the environment variable CT_KERNEL_ARCH
     1.8 -     - optional
     1.9 -     - contains:
    1.10 -       the architecture name as understandable by the Linux kernel build
    1.11 -       system.
    1.12 -       Eg.: "arm" for an ARM
    1.13 -            "powerpc" for a PowerPC
    1.14 -            "i386" for an x86
    1.15 -   + provides:
    1.16 +     - mandatory
    1.17       - the environment variable CT_TARGET_ARCH
    1.18 -     - mandatory
    1.19       - contains:
    1.20         the architecture part of the target tuple.
    1.21         Eg.: "armeb" for big endian ARM
    1.22              "i386" for an i386
    1.23     + provides:
    1.24 +     - optional
    1.25       - the environment variable CT_TARGET_SYS
    1.26 -     - optional
    1.27       - contain:
    1.28         the sytem part of the target tuple.
    1.29         Eg.: "gnu" for glibc on most architectures
    1.30 @@ -519,17 +510,53 @@
    1.31         - for glibc-based toolchain: "gnu"
    1.32         - for uClibc-based toolchain: "uclibc"
    1.33     + provides:
    1.34 -     - the environment variable CT_ARCH_ENDIAN_OPT
    1.35       - optional
    1.36 +     - the environment variable CT_KERNEL_ARCH
    1.37       - contains:
    1.38 -       the compiler option to set the endianness.
    1.39 -       Eg.: "-ml" for a Super-H little endian
    1.40 -            "-mbig-endian" for an ARM big endian
    1.41 -            /empty/ for x86 and x86_64
    1.42 +       the architecture name as understandable by the Linux kernel build
    1.43 +       system.
    1.44 +       Eg.: "arm" for an ARM
    1.45 +            "powerpc" for a PowerPC
    1.46 +            "i386" for an x86
    1.47       - defaults to:
    1.48 -       - for bi-endian big endian architectures: "-mbig-endian"
    1.49 -       - for bi-endian little endian architectures: "-mlittle-endian"
    1.50 -       - for single-endian architectures: /empty/
    1.51 +       ${CT_ARCH}
    1.52 +   + provides:
    1.53 +     - optional
    1.54 +     - the environment variables to configure the cross-gcc
    1.55 +       - CT_ARCH_WITH_ARCH
    1.56 +       - CT_ARCH_WITH_ABI
    1.57 +       - CT_ARCH_WITH_CPU
    1.58 +       - CT_ARCH_WITH_TUNE
    1.59 +       - CT_ARCH_WITH_FPU
    1.60 +       - CT_ARCH_WITH_FLOAT
    1.61 +     - contain (defaults):
    1.62 +       - CT_ARCH_WITH_ARCH    : the gcc ./configure switch to select architecture level         ( "--with-arch=${CT_ARCH_ARCH}"       )
    1.63 +       - CT_ARCH_WITH_ABI     : the gcc ./configure switch to select ABI level                  ( "--with-abi=${CT_ARCH_ARCH}"        )
    1.64 +       - CT_ARCH_WITH_CPU     : the gcc ./configure switch to select CPU instruction set        ( "--with-cpu=${CT_ARCH_ARCH}"        )
    1.65 +       - CT_ARCH_WITH_TUNE    : the gcc ./configure switch to select scheduling                 ( "--with-tune=${CT_ARCH_ARCH}"       )
    1.66 +       - CT_ARCH_WITH_FPU     : the gcc ./configure switch to select FPU type                   ( "--with-fpu=${CT_ARCH_ARCH}"        )
    1.67 +       - CT_ARCH_WITH_FLOAT   : the gcc ./configure switch to select floating point arithmetics ( "--with-float=soft" or /empty/      )
    1.68 +   + provides:
    1.69 +     - optional
    1.70 +     - the environment variables to pass to the cross-gcc to build target binaries
    1.71 +       - CT_ARCH_ARCH_CFLAG
    1.72 +       - CT_ARCH_ABI_CFLAG
    1.73 +       - CT_ARCH_CPU_CFLAG
    1.74 +       - CT_ARCH_TUNE_CFLAG
    1.75 +       - CT_ARCH_FPU_CFLAG
    1.76 +       - CT_ARCH_FLOAT_CFLAG
    1.77 +       - CT_ARCH_ENDIAN_CFLAG
    1.78 +     - contain (defaults):
    1.79 +       - CT_ARCH_ARCH_CFLAG   : the gcc switch to select architecture level                     ( "-march=${CT_ARCH_ARCH}"            )
    1.80 +       - CT_ARCH_ABI_CFLAG    : the gcc switch to select ABI level                              ( "-mabi=${CT_ARCH_AABI}"             )
    1.81 +       - CT_ARCH_CPU_CFLAG    : the gcc switch to select CPU instruction set                    ( "-mcpu=${CT_ARCH_CPU}"              )
    1.82 +       - CT_ARCH_TUNE_CFLAG   : the gcc switch to select scheduling                             ( "-mtune=${CT_ARCH_TUNE}"            )
    1.83 +       - CT_ARCH_FPU_CFLAG    : the gcc switch to select FPU type                               ( "-mfpu=${CT_ARCH_FPU}"              )
    1.84 +       - CT_ARCH_FLOAT_CFLAG  : the gcc switch to choose floating point arithmetics             ( "-msoft-float" or /empty/           )
    1.85 +       - CT_ARCH_ENDIAN_CFLAG : the gcc switch to choose big or little endian                   ( "-mbig-endian" or "-mlittle-endian" )
    1.86 +     - default to:
    1.87 +       see above.
    1.88 +     
    1.89  
    1.90  Build scripts |
    1.91  --------------*