[m-rev.] diff: document how compile 32-bit Mercury on 64-bit Linux

Julien Fischer jfischer at opturion.com
Thu Jan 10 11:39:28 AEDT 2013

For review by anyone.

Document how to build a 32-bit Mercury compiler on 64-bit Linux.

	As above.


diff --git a/README.Linux b/README.Linux
index 66042a2..d54eb94 100644
--- a/README.Linux
+++ b/README.Linux
@@ -6,3 +6,34 @@ been attempted, but should not be difficult.)

 Linux systems that produce executables in a.out format are not supported by
 the Mercury compiler.
+To build a 32-bit Mercury compiler on 64-bit Linux, follow these steps:
+(1) Ensure that the 32-bit (e.g. i686 etc) packages for the C compiler and
+    libraries are available on the build system.
+(2) Ensure that you have a working Mercury compiler in your PATH
+    to bootstrap from.
+(3) If the Mercury compiler in step (2) is a 64-bit compiler then add
+    the following line to a file named Mmake.params at the top-level
+    of the source tree:
+        MCFLAGS=--cross-compiling
+    If you are bootstrapping from an existing 32-bit compiler you
+    should not need to do this.
+(4) Run aclocal -I m4; autoconf as normal.  Then invoke configure
+    as follows:
+        $ ./configure --host=i686-pc-linux-gnu --with-cc="gcc -m32"
+    NOTE: Mercury's configure script  does _not_ currently support the
+    --target option; using --host, as above, is the correct way to do it.
+(5) Do mmake; mmake install as normal.

More information about the reviews mailing list