[m-rev.] README.MacOS

[Fergus Henderson]

Estimated hours taken: 0.5
Branches: main

README.MacOS:
	New file.  Documents the powerpc-apple-darwin port.

Workspace: /mnt/ceres/home/ceres/fjh/mercury
Index: README.MacOS
===================================================================
RCS file: README.MacOS
diff -N README.MacOS
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ README.MacOS	11 Sep 2002 14:26:43 -0000
@@ -0,0 +1,20 @@
+This file documents the port of Mercury to PowerPC Macs running MacOS X,
+i.e. the "powerpc-apple-darwin" configuration.
+
+The version of tar in /usr/bin/tar on MacOS (10.1) doesn't work properly --
+it truncates long path names.  Make sure you use GNU tar, which is available
+in /sw/bin/gtar, when unpacking the Mercury source or binary distributions.
+
+Apple's version of gcc includes support for precompiled headers.
+Unfortunately this support seems to be somewhat buggy, causing it
+to sometimes crash with mysterious errors when building Mercury.
+Furthermore, for the kinds of C code that the Mercury compiler generates,
+it results in a very big slow-down, rather than any speedup.
+So you should use `--traditional-cpp' to disable the use of the
+new ``smart'' [sic] preprocessor.  Configure with
+
+	sh configure --with-cc="cc --traditional-cpp"
+
+The configure script will by default choose grade reg.gc.
+You can get better performance by using the hlc.gc grade.
+The fast.gc and asm_fast.gc grades are not supported on PowerPC.

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
The University of Melbourne         |  of excellence is a lethal habit"
WWW: <http://www.cs.mu.oz.au/~fjh>  |     -- the last words of T. S. Garp.
--------------------------------------------------------------------------
mercury-reviews mailing list
post:  mercury-reviews at cs.mu.oz.au
administrative address: owner-mercury-reviews at cs.mu.oz.au
unsubscribe: Address: mercury-reviews-request at cs.mu.oz.au Message: unsubscribe
subscribe:   Address: mercury-reviews-request at cs.mu.oz.au Message: subscribe
--------------------------------------------------------------------------