diff -r 0361a83180a2 -r 11172b754564 docs/overview.txt
--- a/docs/overview.txt	Fri Sep 14 21:58:55 2007 +0000
+++ b/docs/overview.txt	Sat Sep 15 21:44:18 2007 +0000
@@ -493,24 +493,15 @@
         the endianness suffixes
    + return value: 0 upon success, !0 upon failure
    + provides:
-     - the environment variable CT_KERNEL_ARCH
-     - optional
-     - contains:
-       the architecture name as understandable by the Linux kernel build
-       system.
-       Eg.: "arm" for an ARM
-            "powerpc" for a PowerPC
-            "i386" for an x86
-   + provides:
+     - mandatory
      - the environment variable CT_TARGET_ARCH
-     - mandatory
      - contains:
        the architecture part of the target tuple.
        Eg.: "armeb" for big endian ARM
             "i386" for an i386
    + provides:
+     - optional
      - the environment variable CT_TARGET_SYS
-     - optional
      - contain:
        the sytem part of the target tuple.
        Eg.: "gnu" for glibc on most architectures
@@ -519,17 +510,53 @@
        - for glibc-based toolchain: "gnu"
        - for uClibc-based toolchain: "uclibc"
    + provides:
-     - the environment variable CT_ARCH_ENDIAN_OPT
      - optional
+     - the environment variable CT_KERNEL_ARCH
      - contains:
-       the compiler option to set the endianness.
-       Eg.: "-ml" for a Super-H little endian
-            "-mbig-endian" for an ARM big endian
-            /empty/ for x86 and x86_64
+       the architecture name as understandable by the Linux kernel build
+       system.
+       Eg.: "arm" for an ARM
+            "powerpc" for a PowerPC
+            "i386" for an x86
      - defaults to:
-       - for bi-endian big endian architectures: "-mbig-endian"
-       - for bi-endian little endian architectures: "-mlittle-endian"
-       - for single-endian architectures: /empty/
+       ${CT_ARCH}
+   + provides:
+     - optional
+     - the environment variables to configure the cross-gcc
+       - CT_ARCH_WITH_ARCH
+       - CT_ARCH_WITH_ABI
+       - CT_ARCH_WITH_CPU
+       - CT_ARCH_WITH_TUNE
+       - CT_ARCH_WITH_FPU
+       - CT_ARCH_WITH_FLOAT
+     - contain (defaults):
+       - CT_ARCH_WITH_ARCH    : the gcc ./configure switch to select architecture level         ( "--with-arch=${CT_ARCH_ARCH}"       )
+       - CT_ARCH_WITH_ABI     : the gcc ./configure switch to select ABI level                  ( "--with-abi=${CT_ARCH_ARCH}"        )
+       - CT_ARCH_WITH_CPU     : the gcc ./configure switch to select CPU instruction set        ( "--with-cpu=${CT_ARCH_ARCH}"        )
+       - CT_ARCH_WITH_TUNE    : the gcc ./configure switch to select scheduling                 ( "--with-tune=${CT_ARCH_ARCH}"       )
+       - CT_ARCH_WITH_FPU     : the gcc ./configure switch to select FPU type                   ( "--with-fpu=${CT_ARCH_ARCH}"        )
+       - CT_ARCH_WITH_FLOAT   : the gcc ./configure switch to select floating point arithmetics ( "--with-float=soft" or /empty/      )
+   + provides:
+     - optional
+     - the environment variables to pass to the cross-gcc to build target binaries
+       - CT_ARCH_ARCH_CFLAG
+       - CT_ARCH_ABI_CFLAG
+       - CT_ARCH_CPU_CFLAG
+       - CT_ARCH_TUNE_CFLAG
+       - CT_ARCH_FPU_CFLAG
+       - CT_ARCH_FLOAT_CFLAG
+       - CT_ARCH_ENDIAN_CFLAG
+     - contain (defaults):
+       - CT_ARCH_ARCH_CFLAG   : the gcc switch to select architecture level                     ( "-march=${CT_ARCH_ARCH}"            )
+       - CT_ARCH_ABI_CFLAG    : the gcc switch to select ABI level                              ( "-mabi=${CT_ARCH_AABI}"             )
+       - CT_ARCH_CPU_CFLAG    : the gcc switch to select CPU instruction set                    ( "-mcpu=${CT_ARCH_CPU}"              )
+       - CT_ARCH_TUNE_CFLAG   : the gcc switch to select scheduling                             ( "-mtune=${CT_ARCH_TUNE}"            )
+       - CT_ARCH_FPU_CFLAG    : the gcc switch to select FPU type                               ( "-mfpu=${CT_ARCH_FPU}"              )
+       - CT_ARCH_FLOAT_CFLAG  : the gcc switch to choose floating point arithmetics             ( "-msoft-float" or /empty/           )
+       - CT_ARCH_ENDIAN_CFLAG : the gcc switch to choose big or little endian                   ( "-mbig-endian" or "-mlittle-endian" )
+     - default to:
+       see above.
+     
 
 Build scripts |
 --------------*