From: Stan Shebs <shebs@apple.com>
Date: Mon, 6 Aug 2001 15:58:46 +0000 (+0000)
Subject: * doc/install.texi: Document powerpc-*-darwin* details.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=4f2b1139461bb4ac0a310807cdf07358f20a4b0e;p=gcc.git

* doc/install.texi: Document powerpc-*-darwin* details.

From-SVN: r44662
---

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 2494e143386..603ee3ed494 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2001-08-06  Stan Shebs  <shebs@apple.com>
+
+	* doc/install.texi: Document powerpc-*-darwin* details.
+
 2001-08-06  Daniel Berlin  <dan@cgsoftware.com>
 
 	* config/rs6000/aix.h (CPP_CPU_SPEC): Move back to rs6000.h
diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi
index 8442a59fe21..0ca17031ea7 100644
--- a/gcc/doc/install.texi
+++ b/gcc/doc/install.texi
@@ -1354,6 +1354,8 @@ GNU Compiler Collection on your machine.
 @item
 @uref{#powerpc*-*-*,,powerpc*-*-*, powerpc-*-sysv4}
 @item
+@uref{#powerpc-*-darwin*,,powerpc-*-darwin*}
+@item
 @uref{#powerpc-*-elf,,powerpc-*-elf, powerpc-*-sysv4}
 @item
 @uref{#powerpc-*-linux-gnu*,,powerpc-*-linux-gnu*}
@@ -2859,6 +2861,40 @@ binaries of GCC for bootstrapping.
 You can specify a default version for the @option{-mcpu=@var{cpu_type}}
 switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
 
+@html
+</p>
+<hr>
+@end html
+@heading @anchor{powerpc-*-darwin*}powerpc-*-darwin*
+PowerPC running Darwin (Mac OS X kernel).
+
+GCC 3.0 does not support Darwin, but 3.1 and later releases will work.
+
+Pre-installed versions of Mac OS X may not include any developer tools,
+meaning that you will not be able to build GCC from source.  Tool
+binaries are available at
+@uref{http://www.opensource.apple.com/projects/darwin} (free
+registration required).
+
+Versions of the assembler prior to ``cctools-364'' cannot handle the
+4-argument form of rlwinm and related mask-using instructions.  Darwin
+1.3 (Mac OS X 10.0) uses cctools-353 for instance.  To get cctools-364,
+check out @file{cctools} with tag @samp{Apple-364}, build it, and
+install the assembler as @file{usr/bin/as}.  See
+@uref{http://www.opensource.apple.com/tools/cvs/docs.html} for details.
+
+Also, the default stack limit of 512K is too small, and a bootstrap will
+typically fail when self-compiling @file{expr.c}.  Set the stack to 800K
+or more, for instance by doing @samp{limit stack 800}.  It's also
+convenient to use the GNU preprocessor instead of Apple's during the
+first stage of bootstrapping; this is automatic when doing @samp{make
+bootstrap}, but to do it from the toplevel objdir you will need to say
+@samp{make CC='cc -no-cpp-precomp' bootstrap}.
+
+Note that the version of GCC shipped by Apple typically includes a
+number of extensions not available in a standard GCC release.  These
+extensions are generally specific to Mac programming.
+
 @html
 </p>
 <hr>