From 2cdbc6e3703044816f042ee2f734fca05d7b5a33 Mon Sep 17 00:00:00 2001
From: "Titus von Boxberg\"" <titus@v9g.de>
Date: Mon, 22 Aug 2011 09:36:30 +0200
Subject: 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>

diff --git a/docs/C - Misc. tutorials.txt b/docs/C - Misc. tutorials.txt
index 6e7d463..4ad04a4 100644
--- a/docs/C - Misc. tutorials.txt	
+++ b/docs/C - Misc. tutorials.txt	
@@ -55,7 +55,7 @@ toolchain on MacOS as host.
    mount somewhere.
 
 2) Install macports (or similar easy means of installing 3rd party software),
-   make sure that macport's bin dir is in your PATH.
+   make sure that macport's bin dir is in the front (!) of your PATH.
    Furtheron assuming it is /opt/local/bin.
 
 3) Install (at least) the following macports
@@ -65,11 +65,25 @@ toolchain on MacOS as host.
    gsed
    gawk
    gcc43 (only necessary for Leopard OSX 10.5)
+   gcc_select (only necessary for OSX 10.5, or Xcode > 4)
 
+4) Prerequisites
    On Leopard, make sure that the macport's gcc is called with the default
-   commands (gcc, g++,...), e.g. via macport gcc_select
-
-4) run ct-ng's configure with the following tool configuration
+   commands (gcc, g++,...), via macport's gcc_select
+
+   On OSX 10.7 Lion / when using Xcode >= 4 make sure that the default commands
+   (gcc, g++, etc.) point to gcc-4.2, NOT llvm-gcc-4.2
+   by using macport's gcc_select feature. With MacPorts >= 1.9.2
+   the command is: "sudo port select --set gcc gcc42"
+   This also requires (like written above) that macport's bin dir
+   comes before standard directories in your PATH environment variable
+   because the gcc symlink is installed in /opt/local/bin and the default /usr/bin/gcc
+   is not removed by the gcc select command!
+   Explanation: llvm-gcc-4.2 (with Xcode 4.1 it is on my machine
+   "gcc version 4.2.1 (Based on Apple Inc. build 5658) (LLVM build 2335.15.00)")
+   cannot boostrap gcc. See http://llvm.org/bugs/show_bug.cgi?id=9571
+
+5) run ct-ng's configure with the following tool configuration
    (assuming you have installed the tools via macports in /opt/local):
    ./configure --with-sed=/opt/local/bin/gsed                 \
                --with-libtool=/opt/local/bin/glibtool         \
@@ -79,7 +93,7 @@ toolchain on MacOS as host.
                --with-readelf=/opt/local/bin/greadelf         \
                [...other configure parameters as you like...]
 
-5) proceed as described in standard documentation
+6) proceed as described in standard documentation
 
 -----
 
-- 
cgit v0.10.2-6-g49f6