Added INSTALL, NEWS, and README to dist_doc_DATA so that they get installed.
[mmh] / MACHINES
1 #
2 # MACHINE -- operating system specific information
3 #
4
5 nmh is known to compile on the following platforms (save the
6 exceptions noted below), using an ANSI C compiler, such as gcc.
7
8 AIX 4.1.5.0.01
9 Cygwin (setup version 2.763, other versions may be fine)
10 FreeBSD
11 IRIX 6.5
12 Linux 2.2 to current (glibc 2.1 to current)
13 Mac OS X
14 NetBSD 1.4.2
15 OpenBSD
16 Solaris 7 and 8 (sparc,x86)
17 SunOS 4.1
18
19 Known Compilation problems:
20 --------------------------------------
21 Cygwin:
22
23 Be sure to install these Cygwin packages:
24   gdbm
25   libgdbm4
26   libgdbm-devel
27   libncurses10
28   libncurses-devel
29
30 Note that the -link switch to refile cannot be used on FAT32 and
31 similar filesystems.
32
33 --------------------------------------
34 HPUX:
35
36 Lots of problems have been reported with using HPUX `cc'.  In particular,
37 problems with `scan' giving incorrect dates (everything is 01/00).
38 It is highly recommended that you use `gcc' instead.
39
40 Also, new versions of HPUX (10.20?) will core dump in `scan' because
41 of some workaround code in zotnet/tws/lexstring.c.  This workaround is
42 needed for older versions of HPUX, but causes problems on newer versions.
43 The solution is the added line (minus our indentation):
44
45     #undef hpux
46
47 after line 15 of the file zotnet/tws/lexstring.c.
48
49 --------------------------------------
50 Irix (SGI):
51
52 Irix make is notoriously buggy. If you're using it, you should "touch
53 config.h.in" before configuring to prevent a problem where it tries to
54 rebuild targets that shouldn't be rebuilt. (Alternately, you can just
55 use GNU make instead of Irix make.)
56
57 --------------------------------------
58 Linux:
59
60 The configuration script does a test to discover if your vi is broken
61 (if it reports non-zero exit codes on certain pseudo-errors).  This test
62 will hang if the program `ex' on your system is a link to the vi clone
63 `vile'.  The workaround is to replace the command ex as a link to another
64 vi clone such as nvi or elvis.
65
66 --------------------------------------
67 Solaris:
68
69 With --enable-debug you'll see a lot of warnings. This is even worse
70 when compiling using the Sun Workshop compiler since it issues a
71 warning for every instance of a problem instead of summarizing them.
72 The main one concerns arrays with an index of type char. This is ok.
73 The array itself is a hash of chars, so the array size and the type
74 match. There isn't another safe and portable way to do this at the
75 moment. An explicit cast would get rid of the warnings, but I think
76 it's better to leave it complaining for now until we come up with
77 a better solution. The whole thing is probablly going to be chucked
78 with UTF-8 support anyway.
79
80 Other than the warnings, it builds ok.
81
82 --------------------------------------
83 SunOS 4.1.1/4.1.3/4.1.4:
84
85 You can't use the C compiler that comes with SunOS 4 since
86 it isn't ANSI C.  But nmh builds just fine with gcc. With
87 --enable-debug you will see a lot of warnings.
88
89 --------------------------------------
90
91 --
92 The nmh team
93 nmh-workers@nongnu.org