Added description of @folder format to nmh.man.

[mmh] / MACHINES

diff --git a/MACHINES b/MACHINES
index 509fa7d..a27bfd9 100644 (file)
--- a/MACHINES
+++ b/MACHINES
@@ -1,34 +1,44 @@
 #
-# MACHINE -- operating system specific information
-#
-# $Id$
+# MACHINES -- operating system specific information
 #
 
+nmh is known to compile on the following platforms (save the
+exceptions noted below), using an ANSI C compiler, such as gcc.
+
+AIX 4.1.5.0.01
+Cygwin (setup version 2.763, other versions may be fine)
+FreeBSD
+IRIX 6.5
+Linux 2.2 to current (glibc 2.1 to current)
+Mac OS X
+NetBSD 1.4.2
+OpenBSD
+Solaris 7 and 8 (sparc,x86)
+SunOS 4.1
+
+Known Compilation problems:
 --------------------------------------
+Cygwin:
 
-FreeBSD:
-OpenBSD:
-NetBSD:
-
-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':
+Be sure to install these Cygwin packages:
+  gdbm
+  libgdbm4
+  libgdbm-devel
+  libncurses10
+  libncurses-devel
 
-    % bash configure
+If configuring with --with-cyrus-sasl, install these Cygwin packages:
+  libsasl2
+  libsasl2-devel
 
---------------------------------------
-Mac OS X/Rhapsody 5:
+If configuring with --with-tls, install these Cygwin packages:
+  gnutls-devel
+  libgnutls26
 
-Version 5.3 at least has the same sh/bash bug as the *BSD systems
-above. This appears to be fixed in 5.5.
-
-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.
+Note that the -link switch to refile cannot be used on FAT32 and
+similar filesystems.
 
 --------------------------------------
-
 HPUX:
 
 Lots of problems have been reported with using HPUX `cc'.  In particular,
@@ -45,7 +55,6 @@ The solution is the added line (minus our indentation):
 after line 15 of the file zotnet/tws/lexstring.c.
 
 --------------------------------------
-
 Irix (SGI):
 
 Irix make is notoriously buggy. If you're using it, you should "touch
@@ -54,7 +63,6 @@ rebuild targets that shouldn't be rebuilt. (Alternately, you can just
 use GNU make instead of Irix make.)
 
 --------------------------------------
-
 Linux:
 
 The configuration script does a test to discover if your vi is broken
@@ -64,7 +72,6 @@ will hang if the program `ex' on your system is a link to the vi clone
 vi clone such as nvi or elvis.
 
 --------------------------------------
-
 Solaris:
 
 With --enable-debug you'll see a lot of warnings. This is even worse
@@ -76,16 +83,19 @@ match. There isn't another safe and portable way to do this at the
 moment. An explicit cast would get rid of the warnings, but I think
 it's better to leave it complaining for now until we come up with
 a better solution. The whole thing is probablly going to be chucked
-with UTC-8 support anyway.
+with UTF-8 support anyway.
 
 Other than the warnings, it builds ok.
 
 --------------------------------------
-
 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-debug you will see a lot of warnings. 
+--enable-debug you will see a lot of warnings.
 
 --------------------------------------
+
+--
+The nmh team
+nmh-workers@nongnu.org