README
author Bryan Hundven <bryanhundven@gmail.com>
Sun Jun 26 03:26:54 2011 -0700 (2011-06-26)
changeset 2515 364b06df9e3a
parent 1575 eb92c99b17cd
child 2725 32aa23619dfd
permissions -rw-r--r--
glibc: Refactor startfiles/headers into do_libc_backend()

Refactor the contents of 'do_libc_start_files()' and 'do_libc()' into a
parameterized 'do_libc_backend()'. 'do_libc_start_files()' and 'do_libc()'
call 'do_libc_backend()' with either 'libc_mode=startfiles' or
'libc_mode=final' (respectively) so that the startfiles/headers and
the final libc builds are configured and built with the same options.

One example of where this is needed is when building a mips toolchain.
Previously, if you were building an n32 toolchain, you wouldn't have
noticed an issue, because if '-mabi' is not in CFLAGS, n32 is the
default:

http://sourceware.org/git/?p=glibc-ports.git;a=blob;f=sysdeps/mips/preconfigure;hb=HEAD

But when trying to build an o32 or n64 toolchain the build would
have failed. This is because (e)glibc expects "-mabi={o32,n32,n64}" to be
in CFLAGS, but was not previously provided in 'do_libc_start_files()'.
The build failure would happen in the shared-core gcc when it tries to
configure an n64 or o32 gcc with an n32 libc.

A simpler solution would have been to just add TARGET_CFLAGS to configure
in 'do_libc_start_files()', but this way makes configure and make
consistent for both steps.

Signed-off-by: Bryan Hundven <bryanhundven@gmail.com>
     1 This is the README for crosstool-NG
     2 
     3 Crosstool-NG follows the autoconf dance. So, to get you
     4 kick-started, just run:
     5   ./configure --help
     6 
     7 You will find the documentation in the directory 'docs'.
     8 Here is a quick overview of what you'll find there:
     9   0 - Table of content
    10   1 - Introduction
    11   2 - Installing crosstool-NG
    12   3 - Configuring a toolchain
    13   4 - Building the toolchain
    14   5 - Using the toolchain
    15   6 - Toolchain types
    16   7 - Contributing
    17   8 - Internals
    18   A - Credits
    19   B - Known issues
    20   C - Misc. tutorials
    21 
    22 You can also point your browser at:
    23   http://ymorin.is-a-geek.org/projects/crosstool
    24 
    25 Aloha!