Update documentation.
author"Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Wed Jun 25 14:06:49 2008 +0000 (2008-06-25)
changeset 620af527ad27444
parent 619 399b85eeb5be
child 621 e2c8f427c140
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(-)
docs/ct-ng.1.in
docs/overview.txt
     1.1 --- a/docs/ct-ng.1.in	Wed Jun 25 09:04:38 2008 +0000
     1.2 +++ b/docs/ct-ng.1.in	Wed Jun 25 14:06:49 2008 +0000
     1.3 @@ -64,12 +64,6 @@
     1.4  Builds the configured toolchain.
     1.5  ."
     1.6  .TP
     1.7 -.B liststeps
     1.8 -Lists all build steps available (see 
     1.9 -.BR ENVIRONMENT,
    1.10 -below).
    1.11 -."
    1.12 -.TP
    1.13  .B clean
    1.14  Remove files generated by
    1.15  .B crosstool-NG
    1.16 @@ -114,7 +108,7 @@
    1.17  step, a previous build should have run at least to that step, or further.
    1.18  
    1.19  The list of steps is vailable with the action
    1.20 -.BR liststeps .
    1.21 +.BR list-steps .
    1.22  ."
    1.23  .SH EXIT VALUE
    1.24  The
    1.25 @@ -152,16 +146,6 @@
    1.26  will refuse to install toolchains in some well known critical directories.
    1.27  ."
    1.28  .SH AUTHORS
    1.29 -.MTO "yann.morin.1998@anciens.enib.fr" "Yann E. MORIN" ""
    1.30 -.URL "http://ymorin.is-a-geek.org" "" ""
    1.31 -reordered
    1.32 -.B crosstool
    1.33 -(see section titled
    1.34 -.BR "SEE ALSO" )
    1.35 -scripts to be more easily maintainable, added the Kconfig configurator, some
    1.36 -patches, support for linux headers installation, and support for uClibc-based
    1.37 -toolchains.
    1.38 -
    1.39  Please consult the file
    1.40  .I @@CT_DOCDIR@@/CREDITS
    1.41  for a list of contributors.
     2.1 --- a/docs/overview.txt	Wed Jun 25 09:04:38 2008 +0000
     2.2 +++ b/docs/overview.txt	Wed Jun 25 14:06:49 2008 +0000
     2.3 @@ -135,14 +135,28 @@
     2.4  code is available as patches in the contrib/ sub-directory. These patches are
     2.5  to be applied to the source of crosstool-NG, prior to installing.
     2.6  
     2.7 +An easy way to use contributed code is to pass the --with-contrib= option to
     2.8 +./configure. The possible values depend upon which contributions are packaged
     2.9 +with your version, but you can get with it with passing one of those two
    2.10 +special values:
    2.11 +  --with-contrib=list
    2.12 +    will list all available contributions
    2.13 +
    2.14 +  --with-contrib=all
    2.15 +    will select all avalaible contributions
    2.16 +
    2.17 +There is no guarantee that a particuliar contribution applies to the current
    2.18 +version of crosstool-ng, or that it will work at all. Use contributions at
    2.19 +your own risk.
    2.20 +
    2.21  ____________________________
    2.22                             /
    2.23  Configuring crosstool-NG  /
    2.24  _________________________/
    2.25  
    2.26 -crosstool-NG is configured by a configurator presenting a menu-stuctured set of
    2.27 -options. These options let you specify the way you want your toolchain built,
    2.28 -where you want it installed, what architecture and specific processor it
    2.29 +crosstool-NG is configured with a configurator presenting a menu-stuctured set
    2.30 +of options. These options let you specify the way you want your toolchain
    2.31 +built, where you want it installed, what architecture and specific processor it
    2.32  will support, the version of the components you want to use, etc... The
    2.33  value for those options are then stored in a configuration file.
    2.34  
    2.35 @@ -230,13 +244,16 @@
    2.36  but is quite easy. The options to build a toolchain are saved in the build log
    2.37  file that is saved within the toolchain. crosstool-NG can extract those options
    2.38  to recreate a new configuration:
    2.39 -  ct-ng extractconfig </path/to/your/build.log
    2.40 +  ct-ng extractconfig </path/to/your/build.log >.config
    2.41  
    2.42  will extract those options, prompt you for the new ones, which you can later
    2.43  edit with menuconfig.
    2.44  
    2.45  Of course, if your build log was compressed, you'd have to use something like:
    2.46 -  bzcat /path/to/your/build.log.bz2 |ct-ng extractconfig
    2.47 +  bzcat /path/to/your/build.log.bz2 |ct-ng extractconfig >.config
    2.48 +
    2.49 +Then, once the configuration has been extracted, run:
    2.50 +  ct-ng oldconfig
    2.51  
    2.52  ________________________
    2.53                         /
    2.54 @@ -271,7 +288,7 @@
    2.55  Alternatively, you can call make with the name of a step to just do that step:
    2.56    ct-ng libc_headers
    2.57  is equivalent to:
    2.58 -  ct-ng RESTART=libs_headers STOP=libc_headers
    2.59 +  ct-ng RESTART=libc_headers STOP=libc_headers
    2.60  
    2.61  The shortcuts +step_name and step_name+ allow to respectively stop or restart
    2.62  at that step. Thus:
    2.63 @@ -325,14 +342,14 @@
    2.64  and so on...
    2.65  
    2.66  It is strongly advised not to use the toolchain sys-root directory as an
    2.67 -install directory for your programms/packages. If you do so, you will not be
    2.68 +install directory for your programs/packages. If you do so, you will not be
    2.69  able to use your toolchain for another project. It is even strongly advised
    2.70  that your toolchain is chmod-ed to read-only once successfully build, so that
    2.71 -you don't go polluting your toolchain with your programms/packages' files.
    2.72 +you don't go polluting your toolchain with your programs/packages' files.
    2.73  
    2.74  Thus, when you build a program/package, install it in a separate directory,
    2.75  eg. /your/root. This directory is the /image/ of what would be in the root file
    2.76 -system of your target, and will contain all that your programms/packages have
    2.77 +system of your target, and will contain all that your programs/packages have
    2.78  installed.
    2.79  
    2.80  When your root directory is ready, it is still missing some important bits: the
    2.81 @@ -562,7 +579,7 @@
    2.82       - default to:
    2.83         see above.
    2.84       
    2.85 -Adding a new version of a conponent |
    2.86 +Adding a new version of a component |
    2.87  ------------------------------------+
    2.88  
    2.89  When a new component, such as the Linux kernel, gcc or any other is released,