Commit Graph

136 Commits

Author SHA1 Message Date
Yann E. MORIN"
c8e39d6d29 configure: use autoconf to generate configure
Create configure.ac, an autoconf script to generate ./configure
This will be needed by a subsequent patch to properly handle
--build and --host, and more tests, when the kconfig stuff will
be installed pre-built.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-11-07 22:28:40 +01:00
Yann E. MORIN"
5f41858c75 docs: credit Konrad EISELE for the initial multilib support
Konrad submitted an initial patch adding multlib support:
    http://sourceware.org/ml/crossgcc/2011-11/msg00040.html

The patch was full of good ideas, but had a few issues, so
I (Yann E. MORIN) started it all from scatch, re-using part
of the original patch. This got implemented in this series:
    hg log -r 446a17b5dd1e:e47d17391ae3

As I forgot to credit Konrad in these changelogs, update the
docs so that the work by Konrad gets credited. Without his
initial effort, we would probably not have had multlib support
so soon. Thank you Konrad!

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-12-31 18:47:37 +01:00
Yann E. MORIN"
81e06b9e15 docs: Add strategies for assembling root filesystems.
Expand the documentation for using a crosstool-NG-generated toolchain for
building a root filesystem for a target device.

Signed-off-by: "Trevor Woerner" <twoerner@gmail.com>
yann.morin.1998@anciens.enib.fr: some eye-candy]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-11-16 17:36:17 -05:00
Yann E. MORIN"
949254a2e7 docs: --target versus --host
In the very beginnings, eons ago, autotools also got confused by this
whole build vs. host vs. target, and got it wrong. Now they fixed it,
but they want to keep backward compatibility, so the --target is still
recongised, although ./configure will complain if you do so. It is
better to use --host.

Signed-off-by: "Trevor Woerner" <twoerner@gmail.com>
[yann.morin.1998@anciens.enib.fr: add build/host clarification]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
2011-11-16 16:06:42 -05: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