path: root/docs
diff options
authorGravatar Samuel MARTIN <s.martin49@gmail.com>2012-02-08 23:20:54 +0100
committerGravatar Peter Korsgaard <jacmet@sunsite.dk>2012-02-09 23:23:42 +0100
commit2c4de62b14cf5c661ea6f999a031e9a4f115782e (patch)
treec920b2a85987f91527fef3118fbeb48b1372c284 /docs
parentfd10b42ab8db0cd5d2f3c9076d54244c6e0e60a8 (diff)
docs: Add customizing toolchain section
Signed-off-by: Samuel MARTIN <s.martin49@gmail.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Acked-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
Diffstat (limited to 'docs')
3 files changed, 48 insertions, 0 deletions
diff --git a/docs/manual/customize-toolchain.txt b/docs/manual/customize-toolchain.txt
new file mode 100644
index 0000000000..a54e2e2202
--- /dev/null
+++ b/docs/manual/customize-toolchain.txt
@@ -0,0 +1,45 @@
+Customizing the toolchain
+There are three distinct types of toolchain backend supported in Buildroot,
+available under the menu +Toolchain+, invoking +make menuconfig+.
+Using the external toolchain backend
+There is no way of tuning an external toolchain since Buildroot does not
+generate it.
+It also requires to set the Buildroot settings according to the toolchain ones
+(see xref:external-toolchain[]).
+Using the internal Buildroot toolchain backend
+The internal Buildroot toolchain backend *only* allows to generate
+*http://www.uclibc.org/[uClibc]-based toolchains*.
+However, it allows to tune major settings, such as:
+* Linux header version
+* http://www.uclibc.org/[uClibc] configuration (see xref:uclibc-custom[uClibc])
+* Binutils, GCC, Gdb and toolchain options
+This is directly avaiblable after selecting the +Buildroot toolchain+ type in
+the menu +Toolchain+.
+Using the Crosstool-NG backend
+The http://crosstool-ng.org[crosstool-NG] toolchain backend enables a rather
+limited set of settings under the Buildroot +Toolchain+ menu (ie. when invoking
++make menuconfig+); mostly:
+* The http://crosstool-ng.org[crosstool-NG] configuration file
+* Gdb and some toolchain options
+Then, the toolchain can be finely tuned invoking +make ctng-menuconfig+.
diff --git a/docs/manual/customize.txt b/docs/manual/customize.txt
index c9f4dfd41a..e8235dee86 100644
--- a/docs/manual/customize.txt
+++ b/docs/manual/customize.txt
@@ -8,3 +8,5 @@ include::customize-busybox-config.txt[]
diff --git a/docs/manual/external-toolchain.txt b/docs/manual/external-toolchain.txt
index 20eebdb202..62eb0a386f 100644
--- a/docs/manual/external-toolchain.txt
+++ b/docs/manual/external-toolchain.txt
@@ -1,5 +1,6 @@
Using an external toolchain
Using an already existing toolchain is useful for different