diff -r 6b15ef33e8f2 -r af527ad27444 docs/overview.txt --- a/docs/overview.txt Sun Jun 01 21:12:00 2008 +0000 +++ b/docs/overview.txt Wed Jun 25 14:06:49 2008 +0000 @@ -135,14 +135,28 @@ 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 @@ 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 .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 @@ 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 @@ 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 @@ - 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,