docs/0 - Table of content.txt
author "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Fri Jan 28 22:06:49 2011 +0100 (2011-01-28)
changeset 2284 7ede374110e5
parent 2076 b58109b7b321
child 2321 d896b85e8738
permissions -rw-r--r--
config: add an option not to remove the destination directory

In certain circumstances, removing the destination/installation directory
is a bad idea. For example, when the build environment is already taking
care of sanitising the build tree, and pre-installs stuff in there, it is
a very bad idea to remove the destination directory.

This happens now in buildroot, as the crostool-NG backend now installs the
toolchain in the common host-tools directory, and pre-install there a few
host-utilities (eg. host-automake and host-gawk).

Provide a config knob to turn on/off the removal of the destination
directory, defaulting to 'y' (previous behavior), and forced to 'n' when
used as a backend.

Reported-by: Peter Korsgaard <jacmet@sunsite.dk>
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
     1 File.........: 0 - Table of content.txt
     2 Copyrigth....: (C) 2010 Yann E. MORIN <yann.morin.1998@anciens.enib.fr>
     3 License......: Creative Commons Attribution Share Alike (CC-by-sa), v2.5
     4 
     5 
     6 Table Of Content  /
     7 _________________/
     8 
     9 
    10 1- Introduction
    11     - History
    12     - Referring to crosstool-NG
    13 
    14 2- Installing crosstool-NG
    15     - Install method
    16     - The hacker's way
    17     - Preparing for packaging
    18     - Shell completion
    19     - Contributed code
    20 
    21 3- Configuring a toolchain
    22     - Interesting config options
    23     - Re-building an existing toolchain
    24     - Using as a backend for a build-system
    25 
    26 4- Building the toolchain
    27     - Stopping and restarting a build
    28     - Testing all toolchains at once
    29     - Overriding the number of // jobs
    30     - Note on // jobs
    31     - Tools wrapper
    32 
    33 5- Using the toolchain
    34     - The 'populate' script
    35 
    36 6- Toolchain types
    37     - Seemingly-native toolchains
    38 
    39 7- Contributing
    40     - Sending a bug report
    41     - Sending patches
    42 
    43 8- Internals
    44     - Makefile front-end
    45     - Kconfig parser
    46     - Architecture-specific
    47     - Adding a new version of a component
    48     - Build scripts
    49 
    50 A- Credits
    51 
    52 B- Known issues
    53 
    54 C- Misc. tutorials
    55     - Using crosstool-NG on FreeBSD (and other *BSD)
    56     - Using crosstool-NG on MacOS-X
    57     - Using Mercurial to hack crosstool-NG