Commit Graph

133 Commits

Author SHA1 Message Date
Johannes Stezenbach
b8bbe07c7a docs/known-issues: add note about build issue on x86_64 with 32bit userspace
Signed-off-by: Johannes Stezenbach <js@sig21.net>
(transplanted from da77b5e7cb9f921d0e2a22818b7945906100e704)
2012-02-13 21:10:06 +01:00
Yann E. MORIN"
4ddbf5c7dc doc: document the description line for the commit message
Documented how to format description lines for packages patches.
Added a note on enforcing Signed-off-by lines.

Signed-off-by: Michael Hope <michael.hope@linaro.org>
[yann.morin.1998@anciens.enib.fr: further describe the desc line]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-09-29 15:16:48 +13:00
Yann E. MORIN"
4785e58e42 docs/known-issues: add the infamous "mixed implicit and normal rules"
make-3.82 now refuses to have both normal and implicit rules in the
same definition, so document the issue with a known workaround.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-09-16 17:49:28 +02:00
Titus von Boxberg"
2cdbc6e370 docs: Document usage with Xcode 4.1
With Xcode 4.1 'gcc' is symlinked llvm-gcc-4.2 which cannot bootstrap
other gccs.
See http://llvm.org/bugs/show_bug.cgi?id=9571

On my machine the faulty gcc is
gcc version 4.2.1 (Based on Apple Inc. build 5658) (LLVM build 2335.15.00)

Document a workaround.

Signed-off-by: "Titus von Boxberg" <titus@v9g.de>
2011-08-22 09:36:30 +02:00
Titus von Boxberg"
6b9c9e74b2 configure: require libtoolize, create wrapper to it
libtoolize must be checked_for and there needs to be a wrapper
that points to GNU libtoolize since that may be installed
as glibtoolize.
This fixes a problem with building Cloog/PPL that was

Reported-by: "Pierrick Brossin" <pierrick@bs-network.net>
Signed-off-by: "Titus von Boxberg" <titus@v9g.de>
2011-08-22 09:40:31 +02:00
Yann E. MORIN"
f2f6d799c5 configure: handle --program-prefix
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-08-17 23:05:01 +02:00
Titus von Boxberg
728c23206b docs: add signed-off-by line to sample commit message
Signed-off-by: Titus von Boxberg <titus@v9g.de>
2011-07-28 21:55:30 +02:00
Yann E. MORIN"
4d85f4389d docs: update table of content for known issues
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-07-24 00:24:49 +02:00
Yann E. MORIN"
274a8580eb docs: update known issues
Document the glibc build failures with male-3.82.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-07-20 23:52:39 +02:00
Yann E. MORIN"
c009897aee misc: fix more typos here and there...
Reported-by: "Antony N. Pavlov" <antony@niisi.msk.ru>
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-07-17 16:53:40 +02:00
Yann E. MORIN"
30ad622618 misc: fix typos
Reported-by: "Antony N. Pavlov" <antony@niisi.msk.ru>
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-07-17 16:54:50 +02:00
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