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(-)
This commit is contained in:
Yann E. MORIN" 2008-06-25 14:06:49 +00:00
parent 988e11fc08
commit 1b6adf776f
2 changed files with 28 additions and 27 deletions

View File

@ -64,12 +64,6 @@ with the target tuple they represent.
Builds the configured toolchain.
."
.TP
.B liststeps
Lists all build steps available (see
.BR ENVIRONMENT,
below).
."
.TP
.B clean
Remove files generated by
.B crosstool-NG
@ -114,7 +108,7 @@ Respectively stops and restarts the build just before this step. To restart a
step, a previous build should have run at least to that step, or further.
The list of steps is vailable with the action
.BR liststeps .
.BR list-steps .
."
.SH EXIT VALUE
The
@ -152,16 +146,6 @@ although
will refuse to install toolchains in some well known critical directories.
."
.SH AUTHORS
.MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" ""
.URL "http://ymorin.is-a-geek.org" "" ""
reordered
.B crosstool
(see section titled
.BR "SEE ALSO" )
scripts to be more easily maintainable, added the Kconfig configurator, some
patches, support for linux headers installation, and support for uClibc-based
toolchains.
Please consult the file
.I @@CT_DOCDIR@@/CREDITS
for a list of contributors.

View File

@ -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,