Files that must be read before building nmh should not go in the docs

[mmh] / MACHINES

diff --git a/MACHINES b/MACHINES
index 2fe31b5..01cd849 100644 (file)
--- a/MACHINES
+++ b/MACHINES
@@ -9,14 +9,23 @@
 FreeBSD:
 OpenBSD:
 NetBSD:
-Mac OS X/Rhapsody 5:
 
 Some BSD4.4 machines have problems when running nmh's configure script.
 They will be unable to find the location of vi and sendmail.  This is
 due to POSIX features (breakage?) in the shell sh.  The solution is to
-run the configure script under the shell `bash'
+run the configure script under the shell `bash':
+
+    % bash configure
+
+--------------------------------------
+Mac OS X/Rhapsody 5:
+
+Version 5.3 at least has the same sh/bash bug as the *BSD systems
+above. This appears to be fixed in 5.5.
 
-bash configure
+Will not compile correctly unless you configure with the --enable-debug
+option. It appears to find conflicts in the headers only when debugging
+is disabled. With debugging enabled, it compiles and runs happily.
 
 --------------------------------------
 
@@ -29,9 +38,9 @@ It is highly recommended that you use `gcc' instead.
 Also, new versions of HPUX (10.20?) will core dump in `scan' because
 of some workaround code in zotnet/tws/lexstring.c.  This workaround is
 needed for older versions of HPUX, but causes problems on newer versions.
-The solution is the added the line
+The solution is the added line (minus our indentation):
 
-#undef hpux
+    #undef hpux
 
 after line 15 of the file zotnet/tws/lexstring.c.
 
@@ -90,8 +99,8 @@ running configure.
 
 Solaris:
 
-With --enable-nmh-debug you'll see a lot of warnings. This is even
-worse when compiling using the Sun Workshop compiler since it issues a
+With --enable-debug you'll see a lot of warnings. This is even worse
+when compiling using the Sun Workshop compiler since it issues a
 warning for every instance of a problem instead of summarizing them.
 The main one concerns arrays with an index of type char. This is ok.
 The array itself is a hash of chars, so the array size and the type
@@ -109,6 +118,6 @@ SunOS 4.1.1/4.1.3/4.1.4:
 
 You can't use the C compiler that comes with SunOS 4 since
 it isn't ANSI C.  But nmh builds just fine with gcc. With
---enable-nmh-debug you will see a lot of warnings. 
+--enable-debug you will see a lot of warnings. 
 
 --------------------------------------