summaryrefslogtreecommitdiff
path: root/docs/overview.txt
diff options
context:
space:
mode:
authorYann E. MORIN" <yann.morin.1998@anciens.enib.fr>2008-06-25 14:06:49 (GMT)
committerYann E. MORIN" <yann.morin.1998@anciens.enib.fr>2008-06-25 14:06:49 (GMT)
commit1b6adf776fb2c13673a0ba72b1100f7073956781 (patch)
treeed7bc87422bc0a235f49ddf3ce87a5916630d844 /docs/overview.txt
parent988e11fc08ff7ed7e8925d5f012634b5b62077f2 (diff)
Update documentation.
/trunk/docs/overview.txt | 37 27 10 0 +++++++++++++++++++++++++++---------- /trunk/docs/ct-ng.1.in | 18 1 17 0 +----------------- 2 files changed, 28 insertions(+), 27 deletions(-)
Diffstat (limited to 'docs/overview.txt')
-rw-r--r--docs/overview.txt37
1 files changed, 27 insertions, 10 deletions
diff --git a/docs/overview.txt b/docs/overview.txt
index 8515a11..8cc507e 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -135,14 +135,28 @@ Some people contibuted code that couldn't get merged for various reasons. This
code is available as patches in the contrib/ sub-directory. These patches are
to be applied to the source of crosstool-NG, prior to installing.
+An easy way to use contributed code is to pass the --with-contrib= option to
+./configure. The possible values depend upon which contributions are packaged
+with your version, but you can get with it with passing one of those two
+special values:
+ --with-contrib=list
+ will list all available contributions
+
+ --with-contrib=all
+ will select all avalaible contributions
+
+There is no guarantee that a particuliar contribution applies to the current
+version of crosstool-ng, or that it will work at all. Use contributions at
+your own risk.
+
____________________________
/
Configuring crosstool-NG /
_________________________/
-crosstool-NG is configured by a configurator presenting a menu-stuctured set of
-options. These options let you specify the way you want your toolchain built,
-where you want it installed, what architecture and specific processor it
+crosstool-NG is configured with a configurator presenting a menu-stuctured set
+of options. These options let you specify the way you want your toolchain
+built, where you want it installed, what architecture and specific processor it
will support, the version of the components you want to use, etc... The
value for those options are then stored in a configuration file.
@@ -230,13 +244,16 @@ to create a new toolchain. That needs a very little bit of effort on your side
but is quite easy. The options to build a toolchain are saved in the build log
file that is saved within the toolchain. crosstool-NG can extract those options
to recreate a new configuration:
- ct-ng extractconfig </path/to/your/build.log
+ ct-ng extractconfig </path/to/your/build.log >.config
will extract those options, prompt you for the new ones, which you can later
edit with menuconfig.
Of course, if your build log was compressed, you'd have to use something like:
- bzcat /path/to/your/build.log.bz2 |ct-ng extractconfig
+ bzcat /path/to/your/build.log.bz2 |ct-ng extractconfig >.config
+
+Then, once the configuration has been extracted, run:
+ ct-ng oldconfig
________________________
/
@@ -271,7 +288,7 @@ debugging, you can pass the RESTART variable to make:
Alternatively, you can call make with the name of a step to just do that step:
ct-ng libc_headers
is equivalent to:
- ct-ng RESTART=libs_headers STOP=libc_headers
+ ct-ng RESTART=libc_headers STOP=libc_headers
The shortcuts +step_name and step_name+ allow to respectively stop or restart
at that step. Thus:
@@ -325,14 +342,14 @@ or
and so on...
It is strongly advised not to use the toolchain sys-root directory as an
-install directory for your programms/packages. If you do so, you will not be
+install directory for your programs/packages. If you do so, you will not be
able to use your toolchain for another project. It is even strongly advised
that your toolchain is chmod-ed to read-only once successfully build, so that
-you don't go polluting your toolchain with your programms/packages' files.
+you don't go polluting your toolchain with your programs/packages' files.
Thus, when you build a program/package, install it in a separate directory,
eg. /your/root. This directory is the /image/ of what would be in the root file
-system of your target, and will contain all that your programms/packages have
+system of your target, and will contain all that your programs/packages have
installed.
When your root directory is ready, it is still missing some important bits: the
@@ -562,7 +579,7 @@ The "functions" file API:
- default to:
see above.
-Adding a new version of a conponent |
+Adding a new version of a component |
------------------------------------+
When a new component, such as the Linux kernel, gcc or any other is released,