If a pager isn't specified with configure --with-pager, look in order
[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 FreeBSD:
22 OpenBSD:
23 NetBSD:
24
25 Some BSD4.4 machines have problems when running nmh's configure script.
26 They will be unable to find the location of vi and sendmail.  This is
27 due to POSIX features (breakage?) in the shell sh.  The solution is to
28 run the configure script under the shell `bash':
29
30     % bash configure
31
32 --------------------------------------
33 Mac OS X/Rhapsody 5:
34
35 Version 5.3 at least has the same sh/bash bug as the *BSD systems
36 above. This appears to be fixed in 5.5.
37
38 Will not compile correctly unless you configure with the --enable-debug
39 option. It appears to find conflicts in the headers only when debugging
40 is disabled. With debugging enabled, it compiles and runs happily.
41
42 --------------------------------------
43 Cygwin:
44
45 Be sure to install Cygwin package libncurses-devel, in the Devel or
46 Libs category.  And libncurses10 or later in the Lib category.
47
48 You may notice a few (three) compile warnings:  they can be ignored.
49
50 If send, post, and whom fail, the cause might be a \ in your username.
51 To avoid this, either add a Signature profile entry (see the
52 mh-profile(5) man page) or set/export your SIGNATURE environment
53 variable.  The value can be just the short form of your username, such
54 as that displayed by "id -nu".
55
56 --------------------------------------
57 HPUX:
58
59 Lots of problems have been reported with using HPUX `cc'.  In particular,
60 problems with `scan' giving incorrect dates (everything is 01/00).
61 It is highly recommended that you use `gcc' instead.
62
63 Also, new versions of HPUX (10.20?) will core dump in `scan' because
64 of some workaround code in zotnet/tws/lexstring.c.  This workaround is
65 needed for older versions of HPUX, but causes problems on newer versions.
66 The solution is the added line (minus our indentation):
67
68     #undef hpux
69
70 after line 15 of the file zotnet/tws/lexstring.c.
71
72 --------------------------------------
73 Irix (SGI):
74
75 Irix make is notoriously buggy. If you're using it, you should "touch
76 config.h.in" before configuring to prevent a problem where it tries to
77 rebuild targets that shouldn't be rebuilt. (Alternately, you can just
78 use GNU make instead of Irix make.)
79
80 --------------------------------------
81 Linux:
82
83 The configuration script does a test to discover if your vi is broken
84 (if it reports non-zero exit codes on certain pseudo-errors).  This test
85 will hang if the program `ex' on your system is a link to the vi clone
86 `vile'.  The workaround is to replace the command ex as a link to another
87 vi clone such as nvi or elvis.
88
89 --------------------------------------
90 Solaris:
91
92 With --enable-debug you'll see a lot of warnings. This is even worse
93 when compiling using the Sun Workshop compiler since it issues a
94 warning for every instance of a problem instead of summarizing them.
95 The main one concerns arrays with an index of type char. This is ok.
96 The array itself is a hash of chars, so the array size and the type
97 match. There isn't another safe and portable way to do this at the
98 moment. An explicit cast would get rid of the warnings, but I think
99 it's better to leave it complaining for now until we come up with
100 a better solution. The whole thing is probablly going to be chucked
101 with UTF-8 support anyway.
102
103 Other than the warnings, it builds ok.
104 --------------------------------------
105 SunOS 4.1.1/4.1.3/4.1.4:
106
107 You can't use the C compiler that comes with SunOS 4 since
108 it isn't ANSI C.  But nmh builds just fine with gcc. With
109 --enable-debug you will see a lot of warnings.
110 --------------------------------------
111
112 --
113 The nmh team
114 nmh-workers@nongnu.org