From daca7d6672db1c4c03c00b916888eeb176422ede Mon Sep 17 00:00:00 2001
From: "Yann E. MORIN\"" <yann.morin.1998@anciens.enib.fr>
Date: Fri, 5 Mar 2010 09:19:56 +0100
Subject: 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 --git a/config/global/ct-behave.in b/config/global/ct-behave.in
index 49f76ac..53f4adf 100644
--- a/config/global/ct-behave.in
+++ b/config/global/ct-behave.in
@@ -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 --git a/docs/overview.txt b/docs/overview.txt
index a0e1222..1a48728 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -21,6 +21,7 @@ Installing crosstool-NG
 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 @@ toolchain with this configuration, just redirect the output to the
 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).
+
 
 ________________________
                        /
-- 
cgit v0.10.2-6-g49f6