From 4f2b1139461bb4ac0a310807cdf07358f20a4b0e Mon Sep 17 00:00:00 2001
From: Stan Shebs
Date: Mon, 6 Aug 2001 15:58:46 +0000
Subject: [PATCH] * doc/install.texi: Document powerpc-*-darwin* details.
From-SVN: r44662
---
gcc/ChangeLog | 4 ++++
gcc/doc/install.texi | 36 ++++++++++++++++++++++++++++++++++++
2 files changed, 40 insertions(+)
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 2494e14..603ee3e 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2001-08-06 Stan Shebs
+
+ * doc/install.texi: Document powerpc-*-darwin* details.
+
2001-08-06 Daniel Berlin
* 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 8442a59..0ca1703 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*}
@@ -2863,6 +2865,40 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@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
+
+
+@end html
@heading @anchor{powerpc-*-elf}powerpc-*-elf, powerpc-*-sysv4
PowerPC system in big endian mode, running System V.4.
--
2.7.4