# HG changeset patch
# User "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
# Date 1267777196 -3600
# Node ID 2535545dd45008ddc3f9ff73732eb6cedfd0192f
# Parent  8aa54bcb9b7d92fbb26fec9747dbeddf89446e9e
config: prepare for build-system backend

When acting as a backend for a build-system, we should not build
any application that runs on the target, that is:
- no native gdb
- no companion libraries
- no binutils libraries
- no debug tools (save for gdbserver)
- ...

Here, we simply prepare the (hidden) config option that will detect
that we are acting as a back-end.

Update doc accordingly.

diff -r 8aa54bcb9b7d -r 2535545dd450 config/global/ct-behave.in
--- a/config/global/ct-behave.in	Fri Mar 19 19:02:30 2010 +0100
+++ b/config/global/ct-behave.in	Fri Mar 05 09:19:56 2010 +0100
@@ -2,6 +2,15 @@
 
 comment "crosstool-NG behavior"
 
+config IS_A_BACKEND
+    string
+    option env="CT_IS_A_BACKEND"
+
+config BACKEND
+    bool
+    default y if IS_A_BACKEND =  "y" || IS_A_BACKEND =  "Y"
+    default n if IS_A_BACKEND != "y" && IS_A_BACKEND != "Y"
+
 config OBSOLETE
     bool
     prompt "Use obsolete features"
diff -r 8aa54bcb9b7d -r 2535545dd450 docs/overview.txt
--- a/docs/overview.txt	Fri Mar 19 19:02:30 2010 +0100
+++ b/docs/overview.txt	Fri Mar 05 09:19:56 2010 +0100
@@ -21,6 +21,7 @@
 Configuring crosstool-NG
   Interesting config options
   Re-building an existing toolchain
+  Using as a backend for a build-system
 Running crosstool-NG
   Stopping and restarting a build
   Testing all toolchains at once
@@ -350,6 +351,21 @@
 Then, you can review and change the configuration by running:
   ct-ng menuconfig
 
+Using as a backend for a build-system |
+--------------------------------------+
+
+Crosstool-NG can be used as a backend for an automated build-system. In this
+case, some components that are expected to run on the target (eg. the native
+gdb, ltrace, DUMA...) are not available in the menuconfig, and they are not
+build either, as it is considered the responsibility of the build-system to
+build its own versions of those tools.
+
+If you want to use crosstool-NG as a backend to generate your toolchains for
+your build-system, you have to set and export this environment variable:
+  CT_IS_A_BACKEND=y
+
+(case is not sensitive, you can say Y).
+
 
 ________________________
                        /