Commit Graph

116 Commits

Author SHA1 Message Date
Yann E. MORIN"
00a590e696 docs: rename chapter 9
Rename the file so that it is the same name as the chapter.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-02-27 15:27:54 +01:00
Yann E. MORIN"
638565ee4a docs: add chapter 9 to ToC
Missed in the previous commit... :-/

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-02-24 22:38:08 +01:00
Yann E. MORIN"
dd6ea2508a docs: add an in-depth explanations of the build steps
The build process is quite complex: gcc is built three times, there are
two C library steps, there are those companion libraries...

People often wonder what all these steps do, and why they are needed.

Recently, someone proposed a tutorial on the crossgcc mailing list:
  http://sourceware.org/ml/crossgcc/2011-01/msg00059.html

This meant that there was a need for such a tutorial, and explanations
on how a toolchain is built. So i decide to extend my answers:
  http://sourceware.org/ml/crossgcc/2011-01/msg00060.html
  http://sourceware.org/ml/crossgcc/2011-01/msg00125.html

into proper documentation in crosstool-NG.

Thanks go to Francesco for suggesting this. He has a fine tutorial
for beginners there:
  http://fturco.org/wiki/doku.php?id=debian:cross-compiler

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-02-24 22:31:15 +01:00
Yann E. MORIN"
94be1f470c config: add an option to name the sysroot directory
Depending on local policies, some users have expressed a need to
have the sysroot be named differently than the hard-coded name.

Add an option for that.
Default to 'sysroot' to match the existing literature.

While at it, replace 'sys-root' with 'sysroot' everywhere we
reference the sysroot.

Reported-by: Alexey Kuznetsov <Alexey.KUZNETSOV@youtransactor.com>
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-01-25 20:31:16 +01:00
Yann E. MORIN"
6ef2caf1d3 docs: overview.txt is gone, point to the new documentation
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2010-12-22 00:34:56 +01:00
Yann E. MORIN"
1b17d874c5 docs: move the Mercurial tutorial to the tutorials section
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2010-08-14 20:26:23 +02:00
Yann E. MORIN"
a211f4100d docs: split into multiple files
The overview.txt file has evolved into more than just an overview.
Split it into chapters, and include the misc tutorials.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2010-08-14 16:37:11 +02:00
Yann E. MORIN"
0c771a45d4 docs: update known-issues 2010-08-01 13:39:10 +02:00
Yann E. MORIN"
a8fa17de9f docs/known-issues: document the "error compiling FC test program" issue 2010-07-22 23:33:17 +02:00
Titus von Boxberg
979c2abb86 docs/README.freebsd.txt: Short intro for FreeBSD
Provide short README for FreeBSD as a host OS for ct-ng.
2010-05-22 14:11:27 +02:00
Titus von Boxberg
e4f10fbdf4 docs/README.macos.txt: Provide hints section
Hints for building tool chains.
2010-05-30 12:11:39 +02:00
Yann E. MORIN"
3c351b899d docs: update credtis, point to the repository log
The docs/CREDITS file dates back to the SVN repository.
Now that we use Mercurial, the repository stores appropriate
authorship for each commit. Say so in the CREDITS.
2010-05-30 18:19:05 +02:00
Titus von Boxberg
9bc6e2e625 docs: Provide new Readme for MacOS
Short README for usage of ct-ng under MacOS.
Remove obsolete MacOS-X.txt

yann.morin.1998@anciens.enib.fr:
Make it 80-columns clean, plus a few fixes
2010-05-25 18:25:11 +02:00
Titus von Boxberg
d6d670bac2 docs/overview.txt: Provide short mercurial HOWTO
The usage of hg mq is imho not very well documented.
Give a short intro for the most important use cases
for contributions to ct-ng.

yann.morin.1998@anciens.enib.fr:
Slightly rewrote the explanations for the introductory message.
2010-05-22 18:48:50 +02:00
Yann E. MORIN"
76b459919f docs: update the known issues 2010-04-30 14:33:07 +02:00
Yann E. MORIN"
52304e2e56 docs: update the section about the wrapper
The wrapper is no longer needed when building
non-shared companion libraries. Document that.
2010-04-28 22:24:01 +02:00
Yann E. MORIN"
24cb85167d kconfig: silence a warning about undefined env variable
When using an environment variable to set a config entry,
don'twarn if it is not defined. Update doc accordingly.
2010-03-05 09:43:00 +01:00
Yann E. MORIN"
daca7d6672 config: prepare for build-system backend
When acting as a backend for a build-system, we should not build
any application that runs on the target, that is:
- no native gdb
- no companion libraries
- no binutils libraries
- no debug tools (save for gdbserver)
- ...

Here, we simply prepare the (hidden) config option that will detect
that we are acting as a back-end.

Update doc accordingly.
2010-03-05 09:19:56 +01:00
Yann E. MORIN"
013230cda9 scripts: add action to extract config from a build.log file
That got removed quite some time ago, but is really usefull to get the
configuration from a build.log file of a failing build.
2010-02-11 21:28:10 +01:00
Yann E. MORIN"
0e2fb72a75 docs: do not document CT_KERNEL_ARCH, it's going away...
Since we merged the 32/64-bit archs, and we explicitly used
the Linux kernel arch name, we can get rid of CT_KERNEL_ARCH.
2010-01-23 16:49:56 +01:00
Richard Strand
652d8eebd9 documentation: Remove refs to seemingly native toolchains issue
Remove references to the seemingly native toolchains do not build
issue as it seems to be fixed.

Signed-off-by: Richard Strand <richard.strand@icomera.com>
2010-01-08 18:48:21 +00:00
Frederic Roussel"
6d9e27b5b7 Fix typos and adjust some documentation. 2009-11-17 10:01:22 -08:00
Yann E. MORIN"
cbbe785842 docs: adding naming conventions for crosstool-NG 2009-10-12 19:31:50 +02:00
Yann E. MORIN"
2fea2229c9 docs: fix chapter spacing 2009-10-12 19:25:41 +02:00
Yann E. MORIN"
a83479174b docs: get rid of any reference to the now long-gone svn repository 2009-10-10 13:12:28 +02:00
Yann E. MORIN"
632d59babd docs: move the "contributing" section to overview.txt 2009-10-10 12:55:17 +02:00
Yann E. MORIN"
3902827e9f docs: configure no longer accepts --with-contrib
It's been a while that configure does not recognise --with-contrib.
Applying contibutions is to be done manually, using patch.
2009-10-10 11:24:31 +02:00
Yann E. MORIN"
1e1f247acc doc: update documentation, mostly eye-candy 2009-10-03 17:23:17 +02:00
Yann E. MORIN"
443f51a2dc libc/glibc: fix building for seemingly native toolchains
Build glibc with -O2 as a fix/workaround to building
seemingly-native toolchains.

See:
- docs/overview.txt
- docs/known-issues.txt
- http://sourceware.org/ml/crossgcc/2009-09/msg00055.html
2009-10-02 22:10:38 +02:00
Blair Burtan
e3cc9d1b27 docs: add a tutorial on how to build a toolchain on Mac OS-X
Add a step-bystep tutorial to build a cross-toolchain on Mac OS-X.
2009-09-07 23:12:25 +02:00
Yann E. MORIN"
33144a6438 docs: typo in overview.txt 2009-09-06 10:45:31 +02:00
Yann E. MORIN"
d811941c9a config: choose whether to use the shell or the C wrapper
Offer a config choice on whether to isntall the script wrapper, or
the compiled C wrapper. Update docs/overview.txt accordingly.
2009-08-30 00:27:12 +02:00
Yann E. MORIN"
7628fa7a08 overview: fix table of content, fix the hacker's way
table of content: add missing entry
the hacker's way: no need to "make install"
2009-08-30 00:30:45 +02:00
Yann E. MORIN
a393a72f5f [populate] enhance documentation
This patch adds explanations on how
populate works internally.
2009-06-14 21:44:33 +02:00
Yann E. MORIN
bdf80a8db9 [populate] fix documentation
This patch fixes the existing documentation:
- document -l and -L
- use syntax more in line with the help entry
2009-06-14 21:43:55 +02:00
Yann E. MORIN"
683d230777 Add a bit more explanations on the meaning of OBSOLETE and EXPERIMENTAL.
-------- diffstat follows --------
 /trunk/config/global/ct-behave.in |   22    13     9     0 +++++++++++++---------
 /trunk/docs/overview.txt          |    8     6     2     0 ++++++--
 2 files changed, 19 insertions(+), 11 deletions(-)
2009-04-20 21:30:25 +00:00
Robert P. J. DAY"
6511a7787f Fix obvious "DESTDIR" misspelling. 2009-04-17 20:45:47 +00:00
Yann E. MORIN"
bf830991a6 Document failure to build the uClibc cross-ldd under Cygwin as a known issue.
/trunk/docs/known-issues.txt |   16    15     1     0 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)
2009-03-30 21:06:55 +00:00
Yann E. MORIN"
4462fcd995 Know issues: document the extract and/or patch steps failure under cygwin.
/trunk/docs/known-issues.txt |   16    16     0     0 ++++++++++++++++
 1 file changed, 16 insertions(+)
2009-03-03 17:39:51 +00:00
Yann E. MORIN"
b8b7843bea Get rid of all stuff related to building a /delivery' traball:
- building a delivery tarball has long been broken (since crostool-Ng is installable)
- get rid of implied do_print_filename, that can be mis-leading now tarballs can not be built

 /trunk/scripts/build/kernel/bare-metal.sh  |    4     0     4     0 ----
 /trunk/scripts/build/kernel/linux.sh       |    4     0     4     0 ----
 /trunk/scripts/build/tools/000-template.sh |   11     0    11     0 -----------
 /trunk/scripts/build/tools/100-libelf.sh   |    4     0     4     0 ----
 /trunk/scripts/build/tools/200-sstrip.sh   |   11     1    10     0 +----------
 /trunk/scripts/build/binutils.sh           |    4     0     4     0 ----
 /trunk/scripts/build/cc/gcc.sh             |    5     0     5     0 -----
 /trunk/scripts/build/debug/000-template.sh |   11     0    11     0 -----------
 /trunk/scripts/build/debug/100-dmalloc.sh  |    4     0     4     0 ----
 /trunk/scripts/build/debug/400-ltrace.sh   |    4     0     4     0 ----
 /trunk/scripts/build/debug/300-gdb.sh      |    7     0     7     0 -------
 /trunk/scripts/build/debug/500-strace.sh   |    4     0     4     0 ----
 /trunk/scripts/build/debug/200-duma.sh     |    4     0     4     0 ----
 /trunk/scripts/build/libc/none.sh          |    5     0     5     0 -----
 /trunk/scripts/build/libc/glibc.sh         |   10     0    10     0 ----------
 /trunk/scripts/build/libc/uClibc.sh        |    6     0     6     0 ------
 /trunk/scripts/build/libc/eglibc.sh        |   10     0    10     0 ----------
 /trunk/scripts/build/gmp.sh                |    6     0     6     0 ------
 /trunk/scripts/build/mpfr.sh               |    6     0     6     0 ------
 /trunk/docs/overview.txt                   |    9     0     9     0 ---------
 20 files changed, 1 insertion(+), 128 deletions(-)
2009-01-03 21:11:41 +00:00
Yann E. MORIN"
4cfd308098 Move toolchain-config.in from tools/ to scripts/
Small documentation fix.

 /trunk/scripts/crosstool.sh |    2     1     1     0 +-
 /trunk/docs/overview.txt    |    1     1     0     0 +
 2 files changed, 2 insertions(+), 1 deletion(-)
2008-12-11 18:21:18 +00:00
Yann E. MORIN"
488f5d1e76 Move addToolsVersion.sh from tools/ to scripts/
/trunk/docs/overview.txt |    2     1     1     0 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
2008-12-11 18:12:04 +00:00
Yann E. MORIN"
f15b8ade72 Get rid of the local-test in Makefile.
/trunk/Makefile.in       |   30    19    11     0 +++++++++++++++++++-----------
 /trunk/docs/overview.txt |   25    13    12     0 +++++++++++++------------
 2 files changed, 32 insertions(+), 23 deletions(-)
2008-11-16 22:19:57 +00:00
Yann E. MORIN"
81f9d4d73e Honor the DESTDIR variable to install out-of-place (Eg. for packaging).
/trunk/configure         |   10    10     0     0 +++++++++
 /trunk/Makefile.in       |   62    36    26     0 +++++++++++++++++++++++++++++++-----------------------
 /trunk/docs/overview.txt |   12    12     0     0 ++++++++++
 3 files changed, 58 insertions(+), 26 deletions(-)
2008-11-16 21:55:46 +00:00
Yann E. MORIN"
301fbac58e Merge 1199 and 1200 from /devel/YEM-build_host_target_cleanup:
- Allow hand-indentation in the kconfig prompts
- Start documenting the kconfig deviations from the kernel's version

 /trunk/kconfig/menu.c    |   10     8     2     0 ++++++++--
 /trunk/docs/overview.txt |    6     6     0     0 ++++++
 2 files changed, 14 insertions(+), 2 deletions(-)
2008-11-13 17:55:16 +00:00
Yann E. MORIN"
f9f70c5ad6 Do not autodetect 64-bit archs, have them tell be 'select'-ing ARCH_64 in the configuration.
/trunk/scripts/crosstool.sh  |   12     5     7     0 +++++-------
 /trunk/docs/overview.txt     |    6     6     0     0 ++++++
 /trunk/config/target.in      |    4     4     0     0 ++++
 /trunk/config/arch/x86_64.in |    1     1     0     0 +
 /trunk/config/arch/ia64.in   |    1     1     0     0 +
 5 files changed, 17 insertions(+), 7 deletions(-)
2008-11-07 08:09:42 +00:00
Yann E. MORIN"
ea9b9ea07b Remove regtest actions, introduce build-all actions:
- regtest was not easy to use
- one may wish to simply build all samples
- introduce a per-sample automatic build

 /trunk/docs/overview.txt  |   19    14     5     0 ++++++++---
 /trunk/samples/samples.mk |   92    49    43     0 ++++++++++++++++++++++++++++-------------------------
 /trunk/ct-ng.comp         |    8     5     3     0 +++--
 3 files changed, 68 insertions(+), 51 deletions(-)
2008-10-31 18:31:01 +00:00
Yann E. MORIN"
1c625d676c Push the calculation of the tuple's kernel part down to kernel's build scripts:
- update the kernel script's API with the function CT_DiKernelTupleValues
- update doc accordingly (also with the architecture change, missing in the previous commit)
- small clean-up in the main script, remove useless test

 /trunk/scripts/build/kernel/bare-metal.sh |    5     5     0     0 +++++
 /trunk/scripts/build/kernel/linux.sh      |    5     5     0     0 +++++
 /trunk/scripts/crosstool.sh               |   31    13    18     0 +++++++++++++------------------
 /trunk/scripts/functions                  |   15     8     7     0 ++++++++-------
 /trunk/docs/overview.txt                  |   13     9     4     0 +++++++++----
 5 files changed, 40 insertions(+), 29 deletions(-)
2008-10-23 13:45:48 +00:00
Yann E. MORIN"
4a1f2bf705 Remove CT_BROKEN.
Only one component is actually BROKEN (libelf), make it depend on EXPERIMENTAL, but state BROKEN in the prompt.
ltrace (which depends on libelf) is now marked as EXPERIMENTAL, with the reference to the BROKEN libelf in the help entry.

 /trunk/docs/overview.txt          |    6     0     6     0 ------
 /trunk/config/debug/ltrace.in     |    7     4     3     0 ++++---
 /trunk/config/global/ct-behave.in |    8     0     8     0 --------
 /trunk/config/tools/libelf.in     |    5     3     2     0 +++--
 4 files changed, 7 insertions(+), 19 deletions(-)
2008-10-09 19:17:49 +00:00
Yann E. MORIN"
b8d189b296 Separate the architecture config file and function script.
/trunk/kconfig/kconfig.mk   |   46    23    23     0 +++++++++++++++++++++++-----------------------
 /trunk/scripts/crosstool.sh |    2     1     1     0 +-
 /trunk/docs/overview.txt    |   28    11    17     0 +++++++++++-----------------
 3 files changed, 35 insertions(+), 41 deletions(-)
2008-10-05 15:32:00 +00:00