docs: Add customizing toolchain section
PATCH 1/1 docs: Add customizing toolchain section
Signed-off-by Samuel MARTIN <[email protected]>
--- docs/manual/customize-toolchain.txt | 45 +++++++++++++++++++++++++++++++++++ docs/manual/customize.txt | 2 + docs/manual/external-toolchain.txt | 1 + 3 files changed, 48 insertions(+), 0 deletions(-) create mode 100644 docs/manual/customize-toolchain.txt
docs/manual/customize-toolchain.txt new file +45 -0
@@ -0,0 +1,45 @@ +Customizing the toolchain +------------------------- +[[toolchain-custom]] + +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+.
docs/manual/customize.txt +2 -0
@@ -8,3 +8,5 @@ include::customize-busybox-config.txt[] include::customize-uclibc-config.txt[] include::customize-kernel-config.txt[] + +include::customize-toolchain.txt[]
docs/manual/external-toolchain.txt +1 -0
@@ -1,5 +1,6 @@ Using an external toolchain =========================== +[[external-toolchain]] Using an already existing toolchain is useful for different reasons:
Signature · 1 line
1.7.9
PATCH 1/1 docs: Add customizing toolchain section
Quoted 2 lines · On Wednesday 08 February 2012 23:20:54 Samuel MARTIN wrote:
Signed-off-by Samuel MARTIN <[email protected]>
Documentation updates, we need more of those! Thanks, Samuel.
[snip]
Quoted 6 lines
docs/manual/customize-toolchain.txt new file +6
-0+Using the internal Buildroot toolchain backend +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The internal Buildroot toolchain backend *only* allows to generate +*http://www.uclibc.org/[uClibc]-based toolchains*. +
docs/manual/customize-toolchain.txt line 32
Quoted 10 lines
docs/manual/customize-toolchain.txt new file +10
-0+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+.
Then, the toolchain can be finely tuned invoking +make uclibc-menuconfig+.
:-)
Regards,
Arnout
Signature · 6 lines
Arnout Vandecappelle arnout at mind be Senior Embedded Software Architect +32-16-286540 Essensium/Mind http://www.mind.be G.Geenslaan 9, 3001 Leuven, Belgium BE 872 984 063 RPR Leuven LinkedIn profile: http://www.linkedin.com/in/arnoutvandecappelle GPG fingerprint: 7CB5 E4CC 6C2E EFD4 6E3D A754 F963 ECAB 2450 2F1F
PATCH 1/1 docs: Add customizing toolchain section
In reply to Samuel MARTINOp 8 feb. 2012 23:21 schreef "Samuel MARTIN" <[email protected]> het volgende:
Quoted 5 lines
Signed-off-by Samuel MARTIN <[email protected]>--- docs/manual/customize-toolchain.txt | 45
+++++++++++++++++++++++++++++++++++
Review
Quoted 6 lines
docs/manual/customize.txt | 2 + docs/manual/external-toolchain.txt | 1 + 3 files changed, 48 insertions(+), 0 deletions(-) create mode 100644 docs/manual/customize-toolchain.txt(quoted diff) +0
-0
b/docs/manual/customize-toolchain.txt
docs/manual/customize-toolchain.txt line 5
Quoted 10 lines
new file mode 100644
index 0000000..a54e2e2docs/manual/customize-toolchain.txt new file +5
-0@@ -0,0 +1,45 @@ +Customizing the toolchain +------------------------- +[[toolchain-custom]] + +There are three distinct types of toolchain backend supported in
Buildroot,
docs/manual/customize-toolchain.txt
Quoted 9 lines
docs/manual/customize-toolchain.txt new file +9
-0+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
docs/manual/customize-toolchain.txt
Quoted 13 lines
docs/manual/customize-toolchain.txt new file +13
-0+(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])
docs/manual/customize-toolchain.txt
Quoted 4 lines
docs/manual/customize-toolchain.txt new file +4
-0+ +* Binutils, GCC, Gdb and toolchain options + +This is directly avaiblable after selecting the +Buildroot toolchain+
type in
available
docs/manual/customize-toolchain.txt
Quoted 6 lines
docs/manual/customize-toolchain.txt new file +6
-0+the menu +Toolchain+. + +Using the Crosstool-NG backend +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The http://crosstool-ng.org[crosstool-NG] toolchain backend enables a
rather
docs/manual/customize-toolchain.txt line 38
Quoted 1 line
docs/manual/customize-toolchain.txt new file +1
-0+limited set of settings under the Buildroot +Toolchain+ menu (ie. when
invoking
Review
Quoted 18 lines
docs/manual/customize-toolchain.txt new file +7
-0++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+.docs/manual/customize.txt +2
-0@@ -8,3 +8,5 @@ include::customize-busybox-config.txt[] include::customize-uclibc-config.txt[] include::customize-kernel-config.txt[] + +include::customize-toolchain.txt[](quoted diff) +0
-0
b/docs/manual/external-toolchain.txt
docs/manual/external-toolchain.txt line 6
Quoted 10 lines
index 20eebdb..62eb0a3 100644
docs/manual/external-toolchain.txt +1
-0@@ -1,5 +1,6 @@ Using an external toolchain =========================== +[[external-toolchain]] Using an already existing toolchain is useful for different reasons:
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.busybox.net/pipermail/buildroot/attachments/20120209/6503264f/attachment.html>
PATCH 1/1 docs: Add customizing toolchain section
In reply to Samuel MARTINQuoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
"Samuel" == Samuel MARTIN <[email protected]> writes:
Samuel> Signed-off-by: Samuel MARTIN <[email protected]>
Committed, thanks.
Signature · 1 line
Bye, Peter Korsgaard