Commit Graph

122 Commits

Author SHA1 Message Date
Titus von Boxberg
9bc3edf13b docs/C : libncurses is not needed anymore
macports libncurses was required only on SL 10.6.3
2011-07-03 09:20:08 +02:00
Titus von Boxberg
9385520740 docs/C : use new URL in hg tutorial
ct-ng has moved, update documentation
2011-07-03 09:15:54 +02:00
Yann E. MORIN"
43850b301c docs: add a status for know issues
As time passes, a known issues can be no longer applicable (because
the component has been fixed, or a workaround ahs been added in the
crosstool-NG scripts/config...).

Some may also be unconfirmed, with no way to easily trigger the error,
or applies to old versions of components...

Add a status for every known issues.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-04-07 19:21:15 +02:00
Yann E. MORIN"
a5785964b7 docs: use the error message in the known issues titles
This helps users find the appropriate known issue entry.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-04-07 19:17:12 +02:00
Yann E. MORIN"
c52ca838fb docs: add known issues summary in the ToC
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-04-07 19:13:09 +02:00
Yann E. MORIN"
bc35f9a934 docs: add known issue about missing forced unwind support
This has been reported many times, and has become a FAQ.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-04-07 19:02:56 +02:00
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