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