(ediff-current-diff-face-A)
[bpt/emacs.git] / etc / MACHINES
CommitLineData
f4b79972
EZ
1This is a list of the status of GNU Emacs on various machines and systems.
2
3For each system and machine, we give the configuration name you should
4pass to the `configure' script to prepare to build Emacs for that
5system/machine.
6
7The `configure' script uses the configuration name to decide which
8machine and operating system description files `src/config.h' should
9include. The machine description files are all in `src/m', and have
10names similar to, but not identical to, the machine names used in
11configuration names. The operating system files are all in `src/s',
12and are named similarly. See the `configure' script if you need to
13know which configuration names use which machine and operating system
14description files.
15
16If you add support for a new configuration, add a section to this
17file, and then edit the `configure' script to tell it which
18configuration name(s) should select your new machine description and
19system description files.
20
21\f
22Here are the configurations Emacs is intended to work with, with the
23corresponding configuration names. You can postpend version numbers
24to operating system names (i.e. sunos4.1) or architecture names (i.e.
25hppa1.1). If you leave out the version number, the `configure' script
26will configure Emacs for the latest version it knows about.
27
28Acorn RISCiX (arm-acorn-riscix1.2)
29
30 Emacs 19.29 has changes that ought to support RISCiX 1.2.
31
32 Due to a bug in the RISCiX C compiler (3.4.5), emacs must
33 be built with gcc (versions 2.5.8 onwards).
34
35 In addition, you will need GNU sed and GNU make, as the RISCiX release
36 versions of these utilities cannot cope with building emacs-19!
37
38 GNU sed should be configured with:
39
40 env 'DEFS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \
41 -Doptarg=gnu_optarg' ./configure
42
43 GNU make (3.72+) should be configured with:
44
45 env 'CFLAGS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \
46 -Doptarg=gnu_optarg' ./configure
47
48 Emacs may be configured to use the X toolkit, by adding --with-x-toolkit
49 to the configure command. If you do this, you will need to edit the line
50 in src/Makefile which defines LIBW (about line 59) to read:
51
52 LIBW= -lXaw_n
53
54 This ensures that the non-shared widget library is used.
55
56 It is unlikely that this version of emacs will work with RISCiX 1.1.
57
58Alliant (fx80-alliant-bsd):
59
60 18.52 worked on system version 4. Previous Emacs versions were
61 known to work on previous system versions.
62
63 If you are using older versions of their operating system, you may
64 need to edit `src/config.h' to use `m/alliant1.h' (on version 1) or
65 `m/alliant.h' (on versions 2 and 3).
66
67Alliant FX/2800 (i860-alliant-bsd)
68
69 Known to work with 19.26 and OS version 2.2, compiler version 1.3.
70
71Alpha (DEC) running OSF/1 or GNU/Linux (alpha-dec-osf1, alpha-dec-linux-gnu)
72
73 For OSF/1 (aka Digital Unix) version 4.0, update 386,
74 it is reported that you need to run configure this way:
75
76 configure --x-includes=/usr/include --x-libraries=/usr/shlib
77
78 For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work
79 with no special configuration options. However, if you use GCC as
80 your compiler, you will need version 2.8.1 or later, as older
81 versions fail to build with a message "Invalid dimension for the
82 charset-ID 160".
83
84 Note that the X11 libraries on GNU/Linux systems for the Alpha are
85 said to have bugs that prevent Emacs from working with X (as of
86 November 1995). Recent releases work (July 2000).
87
88Altos 3068 (m68k-altos-sysv)
89
90 18.52 was said to work, provided you don't compile unexec.c with -O.
91
92Amdahl UTS (580-amdahl-sysv)
93
94 Small changes for 18.38 were merged in 18.39. It is mostly
95 working, but at last report a bug sometimes causes Emacs to
96 grab very large amounts of memory. No fix or explanation
97 has yet been reported. It may be possible to find this bug
98 if you find which Emacs command it happens within and then
99 run that command with a breakpoint set at malloc.
100
101 The 5.2u370 compiler is so brain damaged that it is not
102 even worth trying to use it. Success was obtained with the
103 uts native C compiler on uts version 5.2.5.
104
9ff069a5
EZ
105Apple PowerPC Macintosh running GNU/Linux
106
107 There are special considerations for a variety of this system which
723718ff 108 is known as the ``Yellow Dog [GNU/]Linux'': Emacs may crash during
9ff069a5
EZ
109 dumping. To solve this, edit the header file src/m/macppc.h in the
110 Emacs distribution, and remove the "#if 0" and "#endif" directives
111 which surround the following block near the end of the file:
112
113 #if 0 /* This breaks things on PPC GNU/Linux ecept for Yellowdog,
114 even with identical GCC, as, ld. Let's take it out until we
115 know what's really going on here. */
116 /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to
117 0x10000000. */
118 #if defined __linux__
119 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
120 #define DATA_SEG_BITS 0x10000000
121 #endif
122 #endif
123 #endif /* 0 */
124
125 After that, reconfigure and rebuild Emacs. It should now build
126 successfully.
127
f4b79972
EZ
128Apollo running X Windows (m68k-apollo-bsd)
129
130 Apollo version now supports dumping. It has been tested on SR10.3 and
131 SR10.4. It certainly requires at least SR10.0, and maybe SR10.2. Be sure
132 to build in the BSD environment.
133
134 By default, everything is compiled with the switch "-W0,-opt,2". Don't try
135 to change this to full optimization (-O). The full optimizer (in Domain CC
136 6.7, 6.8 and 6.9) generates some bad code in several modules which causes
137 the emacs window, under X, to be refreshed with each keystroke.
138
139 The configuration stuff should work for the most part. However, some Domain
140 installations may have to edit src/Makefile manually after it is created.
141 There are too many versions of both cc and X to automate this easily.
142
143 In `lib-src/Makefile', emacsclient and emacsserver compile and work fine
144 under CC 6.9. They now probably work under other versions of the compiler,
145 as well.
146
147 The Apollo Domain CC compiler will issue quite a few warning messages,
148 mostly complaining about incompatible pointers. In general, these are
149 harmless and can be ignored. If you discover otherwise, please submit a bug
150 report identifying the problem in detail.
151
152 When you try to dump emacs, you may get the message ".rwdi section needs
153 relocation." This means you are linking with some code that has compressed
154 data sections. In some cases this comes from linking with X libraries. Try
155 using shared X libraries instead. With some versions of Domain/OS this is
156 as simple as removing the "-lX11" from the LIBX line in src/Makefile.
157
158 When running the configure script, use the configuration name
159 "m68k-apollo-bsd". You will also need to use the "-with-gcc=no" and
160 "-with-x" options. Depending upon your site configuration, you may have to
161 use other configure options, as well. Examine the INSTALL file for other
162 configure options.
163
164 Check out the file 'lisp/x-apollo.el'. To use it, add
165
166 (load "x-apollo")
167
168 to your .emacs file. It provides useful default Apollo function key
169 bindings.
170
171AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv)
172
173 Emacs will probably not work with certain kernel constants too small.
174
175 In param.h CDLIMIT should be at least (1L << 12) in order to allow
176 processes to write up to 2 Mbyte files. This parameter is configurable
177 by normal means in /etc/master.d/kernel; examine that file for the
178 symbol CDLIMIT or ULIMIT, and raise it by several powers of 2. Then
179 do normal kernel rebuild things via "cd /boot; mkboot -k KERNEL" and so
180 forth.
181
182 In seg.h NSEGP and STACKSEG should be at least 16 and 4 respectively
183 to allow processes with total size of up to 2Mbytes.
184 However, I'm told it is unlikely this would fail to be true.
185
186 The MAXMEM may also prevent Emacs from running. The file
187 3B-MAXMEM in this directory explains how to increase MAXMEM.
188
189 On some of these machines, you may need to define IN_SCCS_ID
190 in config.h to make Emacs work. Supposedly you can tell whether
191 this is necessary by checking something in /usr/include/sys/time.h;
192 we do not know precisely what.
193
194AT&T 7300 or 3b1 (m68k-att-sysv)
195
196 18.52 worked. If you have strange troubles with dumping
197 Emacs, delete the last few lines from `src/m/7300.h' and recompile.
198 These lines are supposed to produce a sharable executable.
199
200 `src/m/7300.h' defines SHORTNAMES because operating system versions
201 older than 3.5 did not support long symbol names. Version 3.5 does
202 support them, so you can remove the #define SHORTNAMES in that
203 version.
204
205Bull DPX/2 models 2nn or 3nn (m68k-bull-sysv3)
206
207 Minor fixes merged into 19.19, which should work with CC or GCC.
208
209 You should compile with all the POSIX stuff: undef _SYSV and define
210 _POSIX_SOURCE, _XOPEN_SOURCE and _BULL_SOURCE.
211
212 On bos2.00.45 there is a bug that makes the F_SETOWN fcntl
213 call enters in an infinite loop. F_SETOWN_BUG has been defined to avoid
214 calling it.
215
216Bull DPX/20 (rs6000-bull-bosx)
217
218 Version 19 works.
219
220Bull sps7 (m68k-bull-sysv2)
221
222 Changes partially merged in version 19, but some fixes are probably required.
223
224CCI 5/32, 6/32
225
226 See "Tahoe".
227
228Celerity (celerity-celerity-bsd4.2)
229
230 Version 18.49 worked. This configuration name is a hack, because we
231 don't know the processor used by Celerities. If someone
232 who uses a Celerity could get in touch with us, we can teach
233 config.sub a better name for the configuration.
234
235Clipper (clipper-???)
236
237 Version 19 has support for some brand of clipper system. If you
238 have successfully built Emacs 19 on some sort of clipper system, let
239 us know so we can flesh out this entry.
240
241 Note that the Orion 105 is also a clipper, but some system-related
242 parameters are different.
243
244Convex (c1-convex-bsd, c2-convex-bsd, c32-convex-bsd, c34-convex-bsd,
245 c38-convex-bsd)
246
247 Support updated and residual bugs fixed in 19.26.
248
249Cubix QBx/386 (i386-cubix-sysv)
250
251 Changes merged in 19.1. Systems before 2/A/0 may fail to compile etags.c
252 due to a compiler bug.
253
254Cydra 5 (cydra-cydrome-sysv)
255
256 18.51 worked in one version of their operating system but stopped
257 working in a newer version. This has not been fixed.
258
259Data General Aviion (m88k-dg-dgux)
260
261 19.23 works; however, the GCC provided with DGUX 5.4R3.00 fails to
262 compile src/emacs.c. GCC 2.5.8 does work.
263 The 19.26 pretest was reported to work; no word on which compiler.
264 System versions other than DGUX 5.4R3.00 have not been tested.
265
266 DGUX 5.4R3.10 works with 19.29 and 19.30.
267
268 DGUX R4.11 contains changes to the stdio internals and it doesn't work
269 with versions before 20.2 without patches. 20.2 works in interactive
270 mode but usually fails in batch mode. The problem is that using
271 stderr in the dumped emacs usually leads to a segmentation fault.
272 Only m88k has been tested.
273
274DECstation (mips-dec-ultrix or mips-dec-osf)
275
276 This machine is the older Mips-based DECstation.
277 Emacs should now work on the Alpha CPU.
278
279 19.25 works on Ultrix 4.2. The 19.26 pretest was reported to work
280 on Ultrix 4.2a and on 4.4.
281
282 One user reported 19.25 did not work at all with --with-x-toolkit
283 using X11R5 patch level 10, but worked ok with X11R5 pl26.
284
285 See under Ultrix for problems using X windows on Ultrix.
286 Note that this is a MIPS machine.
287
288 For Ultrix versions 4.1 or earlier, you may need to define
289 SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems
290 to insist on defining malloc itself.
291
292 For Ultrix versions prior to 4.0, you may need to delete
293 the definition of START_FILES from `src/m/pmax.h'.
294
295Motorola Delta 147 (m68k-motorola-sysv)
296
297 The EMacs 19.26 pretest was reported to work.
298
299 Motorola Delta boxes running System V/68 release 3.
300 Tested on 147 board with SVR3V7, no X and gcc.
301 Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc.
302 Reports say it works with X too.
303
304 The installation script chooses the compiler itself. gnucc is
305 preferred.
306
307Motorola Delta 187 (m88k-motorola-sysv,
308 m88k-motorola-sysvr4, or
309 m88k-motorola-m88kbcs)
310
311 The 19.26 pretest was reported to run on SVR3. However, if you
312 use --with-x-toolkit on svr3, you will have problems compiling some
313 files because time.h and sys/time.h get included twice.
314 One fix is to edit those files to protect against multiple inclusion.
315
316 As of version 19.13, Emacs was reported to run under SYSVr3 and SYSVr4.
317
318Dual running System V (m68k-dual-sysv)
319
320 As of 17.46, this worked except for a few changes
321 needed in unexec.c.
322
323Dual running Uniplus (m68k-dual-uniplus)
324
325 Worked, as of 17.51.
326
327Elxsi 6400 (elxsi-elxsi-sysv)
328
329 Changes for 12.0 release are in 19.1.
330 Dumping should work now.
331
332Encore machine (ns16k-encore-bsd)
333
334 This machine bizarrely uses 4.2BSD modified to use the COFF format
335 for object files. Works (as of 18.40). For the APC processor you
336 must enable two lines at the end of `src/s/umax.h', which are commented
337 out in the file as distributed.
338
339 WARNING: If you compile Emacs with the "-O" compiler switch, you
340 must also use the "-q enter_exits" switch so that all functions have
341 stack frames. Otherwise routines that call `alloca' all lose.
342
343 A kernel bug in some system versions causes input characters to be lost
344 occasionally.
345
346Fujitsu DS/90 (sparc-fujitsu-sysv4)
347
348 Changes merged in 20.3.
349
350GEC 63 (local-gec63-usg5.2)
351
352 Changes are partially merged in version 18, but certainly require
353 more work. Let us know if you get this working, and we'll give it a
354 real configuration name.
355
356Gould Power Node (pn-gould-bsd4.2 or pn-gould-bsd4.3)
357
358 18.36 worked on versions 1.2 and 2.0 of the operating system.
359
360 On UTX/32 2.0, use pn-gould-bsd4.3.
361
362 On UTX/32 1.2 and UTX/32S 1.0, use pn-gould-bsd4.2 and note that
363 compiling `lib-src/sorted-doc' tickles a compiler bug: remove the -g
364 flag to cc in the makefile.
365
366 UTX/32 1.3 has a bug in the bcopy library routine. Fix it by
367 #undef BSTRING in `src/m/gould.h'.
368
369 Version 19 incorporates support for releases 2.1 and later of UTX/32.
370 A site running a pre-release of 2.1 should #define RELEASE2_1 in config.h.
371
372Gould NP1 (np1-gould-bsd)
373
374 Version 19 supposedly works.
375
376Harris Night Hawk (m68k-harris-cxux or m88k-harris-cxux)
377
378 This port was added in 19.23. The configuration actually tested was
379 a Night Hawk 4800 running CX/UX 7.0.
380
381 If you have GCC ported and want to build with it, you probably need to
382 change things (like compiler switches) defined in the s/cxux.h file.
383
384 If you have X11R6 installed in /usr/lib, configure will fail to find
385 it and may find X11R5 instead. To work around this problem, use
386 --x-libraries=/usr/lib when you run configure.
387
388 With CX/UX 7.0 and later releases, you need to build after setting the
389 SDE_TARGET environment variable to COFF (a port using ELF and shared
390 libraries has not yet been done).
391
392Harris Power PC (powerpc-harris-powerunix)
393
394 Patches have been merged in 19.31.
395
396Honeywell XPS100 (xps100-honeywell-sysv)
397
398 Config file added in version 19.
399
400Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux
401 or m68k-hp-netbsd)
402
403 These machines are 68000-series CPUs running HP/UX
404 (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah.
405 The operating system suffix determines which system Emacs is built for.
406
407 Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade".
408
409 Version 19 works under BSD. The 19.26 pretest was reported
410 to work on HPUX 9. 19.31 works on HPUX 10.01, but there are
411 some problems on 10.10 which have not been resolved. Emacs 19.34
412 works on HPUX 10.20 provided you compile with GCC; with the HP C
413 compiler, subprocess commands do not work.
414
415 On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you
416 delete a frame. We think this is due to a bug in the X libraries
417 provided by HP. With the alternative X libraries in
418 /usr/contrib/mitX11R5/lib, the problem does not happen.
419
420 If you are running HP/UX release 8.0 or later, you need the optional
421 "C/ANSI C" software in order to build Emacs (older releases of HP/UX
422 do not require any special software). If the file "/etc/filesets/C"
423 exists on your machine, you have this software, otherwise you do not.
424
425 Note that HP has used two incompatible assembler syntaxes,
426 and has recently changed the format of C function frames.
427 `src/crt0.c' and `src/alloca.s' have been conditionalised for the new
428 assembler and new function-entry sequence. You may need to define
429 OLD_HP_ASSEMBLER if you are using an older hpux version. If you
430 have an official (bought from HP) series 300 machine you have
431 the new assembler. Kernels that are 5.+ or later have new
432 assembler. A Series 200 that has been upgraded to a 68010
433 processor and a 5.+ kernel has the new compiler.
434
435 Define C_SWITCH_MACHINE to be +X to make a version of Emacs that
436 runs on both 68010 and 68020 based HP/UX's.
437
438 Define HPUX_68010 if you are using the new assembler, for
439 a system that has a 68010 without a 68881. This is to say,
440 a s200 (upgraded) or s310.
441
442 Define the symbol HPUX_NET if you have the optional network features
443 that include the `netunam' system call. This is referred to as
444 Network Services (NS/9000) in HP literature.
445
446HP 9000 series 500: not supported.
447
448 The series 500 has a seriously incompatible memory architecture
449 which relocates data in memory during execution of a program,
450 and support for it would be difficult to implement.
451
452HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux
453 or ...hpux9shr, or ...-nextstep)
454
455 Use hppa1.1 for the 700 series and hppa1.0 for the 800
456 series machines. (Emacs may not actually care which one you use.)
457
458 Support for NextSTEP was added in 19.31.
459
460 Emacs 20 may work on HPUX 10. You need patch PHSS_6202 to install
461 the Xaw and Xmu libraries. On HPUX 10.20 you may need to compile with GCC;
462 when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03,
463 the subprocess features failed to work.
464
465 19.26 is believed to work on HPUX 9 provided you compile with GCC.
466 As of version 19.16, Emacs was reported to build (using GCC) and run
467 on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01.
468 The HP compiler is known to fail on some versions if you use +O3,
469 but it may work with lower optimization levels.
470
471 Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9.
472 You may need to create the X libraries libXaw.a and libXmu.a from
473 the MIT X distribute, and you may need to edit src/Makefile's
474 definition of LIBXT to look like this:
475
476 LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext
477
478 Some people report trouble using the GNU memory allocator under
479 HP/UX version 9. The problems often manifest as lots of ^@'s in the
480 buffer.
481
482 We are told that these problems go away if you obtain the latest
483 patches for the HP/UX C compiler. James J Dempsey
484 <jjd@spserv.bbn.com> says that this set of versions works for him:
485 /bin/cc:
486 HP92453-01 A.09.28 HP C Compiler
487 /lib/ccom:
488 HP92453-01 A.09.28 HP C Compiler
489 HP-UX SLLIC/OPTIMIZER HP-UX.09.00.23 02/18/93
490 Ucode Code Generator - HP-UX.09.00.23.5 (patch) 2/18/93
491
492 For 700 series machines, the HP-UX patch needed is known as
493 PHSS_2653. (Perhaps for 800 series machines as well; we don't
494 know.) If you are on the Internet, you should be able to obtain
495 this patch by using telnet to access the machine
496 support.mayfield.hp.com and logging in as "hpslreg" and following
497 the instructions there. Or you may be able to use this
498 web site:
499
500 HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html
501 HP Support Line: http://support.mayfield.hp.com
502
503 Please do not ask FSF for further support on this. If you have any
504 trouble obtaining the patch, contact HP Software Support.
505
506 If your buffer fills up with nulls (^@) at some point, it could well
507 be that problem. That problem does not happen when people use GCC
508 to compile Emacs. On the other hand, the HP compiler version 9.34
509 was reported to work for the 19.26 pretest. 9.65 was also reported to work.
510
511 If you turn on the DSUSP character (delayed suspend),
512 Emacs 19.26 does not know how to turn it off on HPUX.
513 You need to turn it off manually.
514
515 If you are running HP/UX release 8.0 or later, you need the optional
516 "C/ANSI C" software in order to build Emacs (older releases of HP/UX
517 do not require any special software). If the file "/etc/filesets/C"
518 exists on your machine, you have this software, otherwise you do not.
519
520High Level Hardware Orion (orion-highlevel-bsd)
521
522 This is the original microprogrammed hardware.
523 Machine description file ought to work.
524
525High Level Hardware Orion 1/05 (clipper-highlevel-bsd)
526
527 Changes merged in 18.52. This is the one with the Clipper cpu.
528 Note that systems which lack NFS need LOAD_AVE_TYPE changed to `double'.
529
530 C compiler has a bug; it loops compiling eval.c.
531 Compile it by hand without optimization.
532
533HITACHI SR2001/SR2201 series (hppa1.1-hitachi-hiuxwe2)
534
535 These machines are based on PA architecture running HI-UX/MPP
536 (based on OSF1. `MPP' stands for `Massively Parallel Processor').
537
538 Emacs 19.34 is believed to work; its pretest was tested
539 both on SR2001 (output of `uname -rv' is `00-01-BB 0') and
540 SR2201 (`02-00 0').
541
542 Emacs 20.7 was reported to build on a system whose `uname -rs'
543 output is `HI-UX/MPP 03-04'.
544
545 The machine description file is `src/m/sr2k.h' is based on
546 `src/m/hp800.h'. The system description file is `src/s/hiuxwe2.h'
547 based on `src/s/osf1.h'. Note that this system doesn't use COFF.
548
549IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)
550
551 Changes merged in version 19. You may need to copy
552 /usr/lib/samples/hft/hftctl.c to the Emacs src directory.
553
554 i386-ibm-aix1.1 may not work with certain new X window managers, and
555 may be suboptimal.
556
557IBM RS/6000 (rs6000-ibm-aix*)
558
559 Emacs 19.26 is believed to work; its pretest was tested.
560
561 Compiling with the system's `cc' and CFLAGS containing `-O5' might
562 fail because libXbsd isn't found. This is a compiler bug;
563 re-configure Emacs so that it isn't compiled with `-O5'.
564
a9f66ecb
EZ
565 On AIX 4.3.x and 4.4, compiling with /bin/c89 fails because it
566 treats certain warnings as errors. Use `cc' instead.
567
f4b79972
EZ
568 At last report, Emacs didn't run well on terminals. Informed
569 persons say that the tty VMIN and VTIME settings have been
570 corrupted; if you have a fix, please send it to us.
571
572 Compiling with -O using the IBM compiler has been known
573 to make Emacs work incorrectly. It's reported that on
574 AIX 3.2.5 with an IBM compiler earlier than 1.03.00.14,
575 cc -O fails for some files. You need to install any
576 PTF containing APAR #IX42810 to bring the compiler to
577 the 1.03.00.14 level to allow optimized compiles.
578
579 There are reports that IBM compiler versions earlier than 1.03.00.02
580 fail even without -O. However, another report said that compiler
581 version 1.02.01.00 did work, on AIX 3.2.4, with Emacs 19.31.
582
583 As of 19.11, if you strip the Emacs executable, it ceases to work.
584
585 If you are using AIX 3.2.3, you may get a core dump when loading
586 ange-ftp. You may be able to fix the problem by defining LIBS_TERMCAP
587 as -ltermcap -lcurses. Please tell us if this fails to work.
588
589 If anyone can fix the above problems, or confirm that they don't happen
590 with certain versions of various programs, we would appreciate it.
591
592IBM RT/PC (romp-ibm-bsd or romp-ibm-aix)
593
594 Use romp-ibm-bsd for the 4.2-like system and romp-ibm-aix for AIX.
595 19.22 is reported to work under bsd. We don't know about AIX.
596
597 On BSD, if you have trouble, try compiling with a different compiler.
598
599 On AIX, the file /usr/lib/samples/hft/hftctl.c must be compiled into
600 hftctl.o, with this result left in the src directory (hftctl.c is
601 part of the standard AIX distribution).
602
603 window.c must not be compiled with -O on AIX.
604
cc9458f7
EZ
605IBM System/390 running GNU/Linux (s390-*-linux-gnu)
606
607 As of Emacs 21.2, a 31-bit only version is supported on this
608 system.
609
f4b79972
EZ
610Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)
611
612 18.52 said to work on some sort of ISI machine.
613 Version 18.45 worked (running on a Optimum V (VME bus, 68020)
614 BSD 4.2 (3.05e) system). 18.42 is reported to work on
615 a Qbus 68010 system. Has not been tried on `WorkStation' `Cluster
616 Compute Node' `Cluster WorkStation' or `Server Node' (Love the
617 StudLYCaps)
618
619 Compilation with -O is rumored to break something.
620
621 On recent system versions, you may need to undefine the macro UMAX
622 in `lib-src/loadst.c' and `src/getpagesize.h'. They stupidly defined this
623 in a system header file, which confuses Emacs (which thinks that UMAX
624 indicates the Umax operating system).
625
626Intel 386 (i386-*-isc, i386-*-esix, i386-*-bsdi2,
627 i386-*-xenix, i386-*-freebsd, i386-*-linux-gnu,
628 i386-*-sol2.4, i386-*-sysv3, i386-intsys-sysv,
629 i386-*-sysv4, i386-*-sysv4.2,
630 i386-*-sysv5.3, i386-*-bsd4.2,
631 i386-*-sco3.2v4, i386-*-bsd386, i386-*-386bsd,
632 i386-*-msdos, i386-*-windowsnt.
633 i386... can be replaced with i486... or i586...)
634
635 In the above configurations, * means that the manufacturer's name
636 you specify does not matter, and you can use any name you like
637 (but it should not contain any dashes or stars).
638
639 When using the ISC configurations, be sure to specify the isc
640 version number - for example, if you're running ISC 3.0, use
641 i386-unknown-isc3.0 as your configuration name.
642 Use i386-*-esix for Esix; Emacs runs as of version 19.6.
643 Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26.
644 Use i386-intsys-sysv for Integrated Solutions 386 machines.
645 It may also be correct for Microport systems.
646 Use i386-*-sco3.2v4 for SCO 3.2v4; Emacs runs as of version 19.26.
647
648 On GNU/Linux systems, Emacs 19.23 was said to work properly with libc
649 version 4.5.21, but not with 4.5.19. If your system uses QMAGIC
650 for the executable format, you must edit config.h to define LINUX_QMAGIC.
651
652 On GNU/Linux, configure may fail to put these definitions in config.h:
653
654 #define HAVE_GETTIMEOFDAY
655 #define HAVE_MKDIR
656 #define HAVE_RMDIR
657 #define HAVE_XSCREENNUMBEROFSCREEN
658
659 To work around the problem, add those definitions by hand.
660 It is possible that this problem happens only with X11R6.
661 Newer system versions have fixed it.
662
663 The 19.26 pretest was reported to work on SVR4.3 and on Freebsd.
664
665 19.29 is reported to crash when using Motif on Solaris 2.5.
666 The reasons are not yet known.
667
668 Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23.
669 In some system versions, `make' is broken; use GNU make instead.
670 Shell bugs in version 1.0 of BSD/OS cause configure
671 to do the wrong thing with --with-x-toolkit; the workaround is to edit
672 configure to run another shell such as bash.
673
674 For System V release 3, use i386-*-sysv3.
675 For System V release 4, use i386-*-sysv4.
676 For System V release 4.2, use i386-*-sysv4.2.
677
678 If you are using Xenix, see notes at end under Xenix.
679 If you are using Esix, see notes at end under Esix.
680 If you are using SCO Unix, see notes at end under SCO.
681
682 On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use
683 GNU make, not the system's make. Assuming it's installed as gmake,
684 do `gmake install MAKE=gmake'. However, more recently it is
685 reported that using the system Make on NetBSD 1.3.1 works ok.
686
687 If you are using System V release 4.2, you may find that `cc -E'
688 puts spurious spaces in `src/xmakefile'. If that happens,
689 specify CPP=/lib/cpp as an option when you run make.
690 There is no problem if you compile with GCC.
691
692 Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries
693 requires the experimental "net 2" network patches (no relation to
694 Berkeley Net 2). There is a report that (some version of) Linux
695 requires including `/usr/src/linux/include/linux' in buffer.c
696 but no coherent explanation of why that might be so. If it is so,
697 in current versions of Linux, something else should probably be changed.
698
699 Some sysV.3 systems seem to have bugs in `opendir';
700 for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY
701 and undefine SYSV_SYSTEM_DIR.
702
703 If you use optimization on V.3, you may need the option -W2,'-y 0'
704 to prevent certain faulty optimization.
705
706 On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
707 to config.h.
708
709 On SCO, there are problems in regexp matching when Emacs is compiled
710 with the system compiler. The compiler version is "Microsoft C
711 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93;
712 Quick C Compiler Version 1.00.46 (Beta). The solution is to compile
713 with GCC.
714
715 On ISC systems (2.02 and more recent), don't try to use the versions
716 of X that come with the system; use XFree86 instead.
717
718 There is no consistency in the handling of certain system header files
719 on V.3.
720
721 Some versions have sys/sioctl.h, and require it in sysdep.c.
722 But some versions do not have sys/sioctl.h.
723 For a given version of the system, this may depend on whether you have
724 X Windows or TCP/IP. Define or undefine NO_SIOCTL_H in config.h
725 according to whether you have the file.
726
727 Likewise, some versions have been known to need sys/ttold.h, sys/stream.h,
728 and sys/ptem.h included in sysdep.c. If your system has these files,
729 try defining NEED_PTEM_H in config.h if you have trouble without it.
730
731 You may find that adding -I/usr/X/include or -I/usr/netinclude or both
732 to CFLAGS avoids compilation errors on certain systems.
733
734 Some versions convince sysdep.c to try to use `struct tchars'
735 but define `struct tc' instead; add `#define tchars tc'
736 to config.h to solve this problem.
737
738Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)
739
740 Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5
741 and m68k-sgi-iris3.6 for system version 3.6.
742 Note that the 3030 is the same as the Iris 2500 Turbo.
743
744Iris 4D (mips-sgi-irix[456].*)
745
746 You can build a 64-bit executable (with larger maximum buffer size)
747 on Irix 6.5 by specifying the 64-bit ABI using the `-64' compiler
748 flag or otherwise (see cc(1)). This may work on earlier Irix 6
749 systems if you edit src/s/irix6-0.h following irix6-5.h.
750
4603049d
EZ
751 Building Emacs 21.1 and 21.2 on versions of Irix before 6.5.10,
752 especially when Emacs is built with GCC, was reported to have subtle
753 problems such as being unable to print to stdout under the -batch
754 command-line option. Building with the native compiler or upgrading
755 the OS to a newer version solves these problems. There's evidence
756 that these problems are actually related to the runtime libraries
757 (before IRIX 6.5.10, the IRIX runtimes were based on the MIPSpro 7.2
758 compilers), so installing patches for the runtime from
759 http://www.sgi.com/support/patch_intro.html could solve the problem
760 even without upgrading the OS. The dump process is the crucial
761 step that needs the upgraded runtime, so a workaround is to dump
762 Emacs on a machine with a newer OS, then copy the binary to the
763 older OS.
764
f4b79972
EZ
765 If compiling with GCC on Irix 6 yields an error "conflicting types
766 for `initstate'", install GCC 2.95 or a newer version, and this
767 problem should go away. It is possible that this problem results
768 from upgrading the operating system without reinstalling GCC; so you
769 could also try reinstalling the same version of GCC, and telling us
770 whether that fixes the problem.
771
772 The 19.26 pretest was reported to work on IRIX 4.0.5 and 5.2.
773 19.23 was reported to work on IRIX 5.2, but you may need to install
774 the "compiler_dev.hdr.internal" subsystem in order to compile unexelfsgi.c.
775 19.22 was known to work on all Silicon Graphics machines running
776 IRIX 4.0.5 or IRIX 5.1.
777
778 Compiling with -O using IRIX compilers prior to 3.10.1 may not work.
779 Don't use -O or use GCC instead.
780
781 Most IRIX 3.3 systems do not have an ANSI C compiler, but a few do.
782 Compile Emacs 18 with the -cckr switch on these machines.
783
784 There is a bug in IRIX 3.3 that can sometimes leave ptys owned by root
785 with a permission of 622. This causes malfunctions in use of
786 subprocesses of Emacs. Irix versions 4.0 and later with GNU Emacs
787 versions 18.59 and later fix this bug.
788
789Masscomp (m68k-masscomp-rtu)
790
791 18.36 worked on a 5500DP running RTU v3.1a and compiler version 3.2
792 with minor fixes that are included in 18.37. However, bizarre behavior
793 was reported for 18.36 on a Masscomp (model and version unknown but probably
794 a 68020 system). The report sounds like a compiler bug.
795
796 A compiler bug affecting statements like
797 unsigned char k; unsigned char *p;... x = p[k];
798 has been reported for "C version 1.2 under RTU 3.1". We do not wish
799 to take the time to install the numerous workarounds required to
800 compensate for this bug.
801
802 For RTU version 3.1, define FIRST_PTY_LETTER to be 'p' in `src/s/rtu.h'
803 (or #undef and redefine it in config.h) so that ptys will be used.
804
805 GNU Emacs is said to have no chance of compiling on RTU versions
806 prior to v3.0.
807
808Megatest (m68k-megatest-bsd)
809
810 Emacs 15 worked; do not have any reports about Emacs 16 or 17
811 but any new bugs are probably not difficult.
812
813Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)
814
815 The C compiler on Riscos 4.51 dumps core trying to optimize
816 parts of Emacs. Try without optimization or try GCC.
817
818 Meanwhile, the linker on that system returns success even if
819 there are undefined symbols; as a result, configure gets the
820 wrong answers to various questions. No work-around is known
821 except to edit src/config.h by hand to indicate which functions
822 don't exist.
823
824 Use mips-mips-riscos4.0 for RISCOS version 4.
825 Use mips-mips-bsd with the BSD world.
826
827 Note that the proper configuration names for DECstations are
828 mips-dec-ultrix and mips-dec-osf.
829
830 If you are compiling with GCC, then you must run fixincludes;
831 the alternative of using -traditional won't work because
832 the definition of SIGN_EXTEND_CHAR uses the keyword `signed'.
833
834 If the SYSV world is the default, then you probably need the following
835 line in etc/Makefile:
836
837 CFLAGS= -g -systype bsd43
838
839 Some operating systems on MIPS machines give SIGTRAP for division by
840 zero instead of the usual signals. The only real solution is to fix
841 the system to give a proper signal.
842
843 In the meantime, you can change init_data in data.c if you wish.
844 Change it to handle SIGTRAP as well as SIGFPE. But this will have a
845 great disadvantage: you will not be able to run Emacs under a
846 debugger. I think crashing on division by zero is a lesser problem.
847
848 dsg@mitre.org reported needing to use --x-libraries=/bsd43/usr/lib
849 on a riscos4bsd site. But it is not clear whether this is needed in
850 general or only because of quirks on a particular site.
851
852National Semiconductor 32000 (ns32k-ns-genix)
853
854 This is for a complete machine from National Semiconductor,
855 running Genix. Changes merged in version 19.
856
857NCR Tower 32 (m68k-ncr-sysv2 or m68k-ncr-sysv3)
858
859 If you are running System V release 2, use m68k-ncr-sysv2.
860 If you are running System V release 3, use m68k-ncr-sysv3.
861
862 These both worked as of 18.56. If you change `src/ymakefile' so that
863 CFLAGS includes C_OPTIMIZE_SWITCH rather than C_DEBUG_SWITCH, check
864 out the comments in `src/m/tower32.h' (for System V release 2) or
865 `src/m/tower32v3.h' (for System V release 3) about this.
866
867 There is a report that compilation with -O did not work with 18.54
868 under System V release 2.
869
870NCR Intel system (i386-ncr-sysv4.2)
871
872 This system works in 19.31, but if you don't link it with GNU ld,
873 you may need to set LD_RUN_PATH at link time to specify where
874 to find the X libraries.
875
876NEC EWS4800 (mips-nec-sysv4)
877
878 This system works in 20.4, but you should use the compiler
879 /usr/abiccs/bin/cc (MIPS ABI MODE).
880
881NeXT (m68k-next-nextstep)
882
883 Emacs 19 has not been tested extensively yet, but it seems to work
884 in a NeXTStep 3.0 terminal window, and under the X server called
885 co-Xist. You may need to specify -traditional when src/Makefile
886 builds xmakefile.
887
888 NeXT users might want to implement direct operation with NeXTStep,
889 but from the point of view of the GNU project, that is a
890 distraction.
891
892 Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19.
893
894Nixdorf Targon 31 (m68k-nixdorf-sysv)
895
896 Machine description file for version 17 is included in 18
897 but whether it works is not known.
898 `src/unexec.c' bombs if compiled with -O.
899 Note that the "Targon 35" is really a Pyramid.
900
901Nu (TI or LMI) (m68k-nu-sysv)
902
903 Version 18 is believed to work.
904
905Paragon OSF/1 (i860-intel-osf1)
906
907 Changes merged in 19.29.
908
909 There is a bug in OSF/1 make which claims there is a syntax error
910 in the src/xmakefile. You can successfully build emacs with:
911
912 pmake MAKE=pmake
913
914Plexus (m68k-plexus-sysv)
915
916 Worked as of 17.56.
917
918Pmax (DEC Mips) (mips-dec-ultrix or mips-dec-osf1)
919
920 See under DECstation, above.
921
922Prime EXL (i386-prime-sysv)
923
924 Minor changes merged in 19.1.
925
926Pyramid (pyramid-pyramid-bsd)
927
928 The 19.26 pretest was observed to work on OSx 5.0, but it is necessary
929 to edit gmalloc.c. You must add #include <sys/types.h> at the top,
930 and delete the #define for size_t.
931
932 You need to build Emacs in the Berkeley universe with
933 the `ucb' command, as in `ucb make' or `ucb build-install'.
934
935 In OSx 4.0, it seems necessary to add the following two lines
936 to `src/m/pyramid.h':
937 #define _longjmp longjmp
938 #define _setjmp setjmp
939
940 In Pyramid system 2.5 there has been a compiler bug making
941 Emacs crash just after screen-splitting with Qnil containing 0.
942 A compiler that fixes this is Pyramid customer number 8494,
943 internal number 1923.
944
945 Some versions of the pyramid compiler get fatal
946 errors when the -gx compiler switch is used; if this
947 happens to you, change `src/m/pyramid.h' to define
948 C_DEBUG_SWITCH with an empty definition.
949
950 Some old system versions may require you to define PYRAMID_OLD
951 in when alloca.s is preprocessed, in order to define _longjmp and _setjmp.
952
953Sequent Balance (ns32k-sequent-bsd4.2 or ns32k-sequent-bsd4.3)
954
955 Emacs 18.51 worked on system version 3.0. 18.52 is said to work.
956 Delete some lines at the end of `src/m/sequent.h' for earlier system
957 versions.
958
959Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4)
960
961 19.33 has changes to support ptx 4 (a modified SVR4).
962
963 Emacs 19 should work on Dynix (BSD). However, if you compile with
964 the Sequent compiler, you may find Emacs does not restore the
965 terminal settings on exit. If this happens, compile with GCC.
966
967 Emacs 19.27 contains patches that should support
968 DYNIX/ptx 1.4 and 2.1 with the native cc compiler.
969
970 GCC can't compile src/process.c due to a non-standard Sequent asm
971 keyword extension supported by cc and used for the network byte/word
972 swapping functions in the PTX /usr/include/netinet/in.h file. GCC
973 2.5.8 includes the file <sys/byteorder.h> which can be included into
974 netinet/in.h to perform these byte/word swapping functions in the
975 same manner. Patches have been submitted to the FSF against GCC
976 2.6.0 to fix this problem and allow Emacs to be built with GCC.
977
978 If your machine does not have TCP/IP installed, you will have to edit the
979 src/s/ptx.h file and comment out #define TCPIP_INSTALLED.
980
981Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4)
982
983 Changes merged in 19.29. This configuration should also work for
984 Pyramid MIS Server running DC-OSX 1.x. The version configured with
985 `--with-x' works without any modifications, but `--with-x-toolkit'
986 works only if the Athena library and the Toolkit library are linked
987 statically. For this, edit `src/Makefile' after the `configure' run
988 and modify the lines with `-lXaw' and `-lXt' as follows:
989
990 LIBW= /usr/lib/libXaw.a
991 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
992
993 In addition, `--with-x-toolkit=motif' works only
994 if the Motif library and the Toolkit library are linked statically.
995 To do this, edit `src/Makefile' after the `configure' run
996 and modify the lines with `-lXm' and `-lXt' as follows:
997
998 LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a
999 LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
1000
1001SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)
1002
1003 18.52 worked. Use m68k-sony-bsd4.3 for system release 3.
1004
1005SONY News 3000 series (RISC NEWS) (mips-sony-bsd)
1006
1007 The 19.26 pretest is reported to work.
1008
1009 Some versions of the operating system give SIGTRAP for division by zero
1010 instead of the usual signals. This causes division by zero
1011 to make Emacs crash. The system should be fixed to give the proper signal.
1012 Changing Emacs is not a proper solution, because it would prevent
1013 Emacs from working under any debugger. But you can change init_data
1014 in data.c if you wish.
1015
1016Stardent i860 (i860-stardent-sysv4.0)
1017
1018 19.26 pretest reported to work.
1019
1020Stardent 1500 or 3000
1021
1022 See Titan.
1023
1024Stride (m68k-stride-sysv)
1025
1026 Works (most recent news for 18.30) on their release 2.0.
1027 For release 2.2, see the end of `src/m/stride.h'.
1028 It may be possible to run on their V.1 system but changes
1029 in the s- file would be needed.
1030
1031Sun 3, Sun 4 (sparc), Sun 386 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos,
1032 sparc-sun-sunos4.1.3noshr, sparc-sun-solaris2.*,
1033 i386-sun-solaris2.*, sparc*-*-linux-gnu)
1034
1035 To build a 64-bit Emacs (with larger maximum buffer size and
1036 including large file support) on a Solaris system which supports
1037 64-bit executables, use the Sun compiler, configuring something like
1038 this (see the cc documentation for information on 64-bit
1039 compilation): env CC="cc -xarch=v9" ./configure
1040
1041 As of version 2.95, GCC doesn't support the 64-bit ABI properly, but
1042 later releases may.
1043
1ebfc51b
EZ
1044 Some versions of Solaris 8 have a bug in their XIM (X Input Method)
1045 implementation which causes Emacs to dump core when one of several
1046 frames is closed. To avoid this, either install patch 108773-12
1047 (for Sparc) or 108874-12 (for x86), or configure Emacs with the
1048 `--with-xim=no' switch (you can use Leim input methods instead).
1049
f4b79972
EZ
1050 On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15
1051 C 5.0 failed, apparently with non-default CFLAGS, most probably due to
1052 compiler bugs. Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C
1053 release was reported to work without problems. It worked OK on
1054 another system with Solaris 8 using apparently the same 5.0 compiler
1055 and the default CFLAGS.
1056
9b4505aa
EZ
1057 Emacs 21.1 and 21.2 built with Sun's ProWorks PC3.0.1 compiler on
1058 Intel/Solaris 8 was reported to abort and dump core during startup.
1059 Using GCC or a newer SUN compiler (Sun WokShop 6 update 2 C 5.3
1060 2001/05/15) solves the problem.
1061
f4b79972
EZ
1062 Emacs 20.5 and later work on SPARC GNU/Linux with the 32-bit ABI.
1063 As of release 2.95, GCC doesn't work properly with the 64-bit ABI
1064 (applicable on UltraSPARC), but that isn't the default mode.
1065
1066 Emacs 20.3 fails to build on Solaris 2.5 if you use GCC 2.7.2.3.
1067 Installing GCC 2.8 fixes the problem.
1068
1069 19.32 works on Solaris 2.4 and 2.5. On Solaris 2.5
1070 you may need one of these patches to prevent Emacs from crashing
1071 when it starts up:
1072 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes)
1073 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes)
1074 103242-04: [README] SunOS 5.5: linker patch (595363 bytes)
1075
1076 There are reports that using SunSoft cc with -xO4 -xdepend produces
1077 bad code for some part of Emacs.
1078
1079 Emacs works ok Sunos 4.1.x
1080 provided you completely replace your C shared library
1081 using one of the SunOS 4.1.x jumbo replacement patches from Sun.
1082 Here are the patch numbers for Sunos 4.1.3:
1083 100890-10 SunOS 4.1.3: domestic libc jumbo patch
1084 100891-10 SunOS 4.1.3: international libc jumbo patch
1085
1086 Some people report that Emacs crashes immediately on startup when
1087 used with a non-X terminal, but we think this is due to compiling
1088 with GCC and failing to use GCC's "fixed" system header files.
1089
1090 Some Sun versions of X windows use the clipboard, not the selections,
1091 for transferring text between clients. The Cut, Paste and Copy items
1092 in the menu bar Edit menu work with the clipboard.
1093
1094 It's important to include the SunOS version number in the
1095 configuration name. For example, for SunOS release 4.0 on a Sun 3,
1096 use `m68k-sun-sunos4.0'; for SunOS release 4.1 on a Sparc, use
1097 `sparc-sun-sunos4.1'. For SunOS release 4.1.3 on a Sparc, use
1098 `sparc-sun-sunos4.1.3'. Note that shared libraries are now
1099 used by default on SunOS 4.1.
1100
1101 A user reported irreproducible segmentation faults when using 19.29
1102 on Solaris 2.3 and 2.4 after compiling it with the Sun compiler.
1103 The problem went away when GCC 2.7.0 was used instead. We do not know
1104 whether anything in Emacs is partly to blame for this.
1105
1106 X11R6 is set up to make shared libraries only, on Sunos 4.
1107 Therefore, in order to link Emacs, you need to create static X libraries.
1108 To do this, rebuild X11 after setting
1109 #define ForceNormalLib YES
1110 #define SeparateSharedCompile YES
1111 in site.def (after #ifdef AfterVendorCF).
1112
1113 Use `m68k' for the 68000-based Sun boxes, `sparc' for Sparcstations,
1114 and `i386' for Sun Roadrunners. i386 calls for Sunos4.0.
1115
1116 If you compile with Sun's ANSI compiler acc, you need additional options
1117 when linking temacs, such as
1118 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
1119 (those should be added just before the libraries) and you need to
1120 add -lansi just before -lc. The precise file names depend on the
1121 compiler version, so we cannot easily arrange to supply them.
1122
1123 On SunOS 4.1.1, do not use /usr/5bin/cc. You can use gcc or/usr/bin/cc.
1124 Make sure the environment variable LD_LIBRARY_PATH is not defined.
1125
1126 Some people report crashes on SunOS 4.1.3 if SYSTEM_MALLOC is defined.
1127 Others have reported that Emacs works if SYSTEM_MALLOC is defined, and not
1128 if it is undefined. So far we do not know why results vary in this way.
1129 The sources are set up so that SYSTEM_MALLOC is defined; if that crashes,
1130 or if you want the benefit of the relocating memory allocator, you can
1131 try enabling the #undef SYSTEM_MALLOC in src/s/sunos4-1-3.h.
1132
1133 On Solaris 2, you need to install patch 100947-02 to fix a system bug.
1134 Presumably this patch comes from Sun. You must alter the definition of
1135 LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib.
1136 You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH.
1137
1138 On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is
1139 reported to hang sometimes if it exits while it has one or more
1140 subprocesses (e.g. the `wakeup' subprocess used by `display-time').
1141 Emacs and its subprocesses become zombies, and in their zombie state
1142 slow down their host and disable rlogin and telnet. This is most
1143 likely due to a bug in Solaris 2.2's multiprocessor support,
1144 rather than an Emacs bug.
1145
1146 On Solaris, do not use /usr/ucb/cc. Use /opt/SUNWspro/bin/cc. Make
1147 sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before
1148 /usr/ucb. (Most free software packages have the same requirement on
1149 Solaris.)
1150
1151 If you have trouble using open-network-stream, get the distribution
1152 of `bind' (the BSD name-server), build libresolv.a, and link Emacs
1153 with -lresolv, by copying the #definition of LIBS_SYSTEM in
1154 src/s/sunos4-1.h to src/config.h. This problem is due to obsolete
1155 software in the nonshared standard library.
1156
1157 If you want to use SunWindows, define HAVE_SUN_WINDOWS
1158 in config.h to enable a special interface called `emacstool'.
1159 The definition must *precede* the #include "machine.h".
1160 System version 3.2 is required for this facility to work.
1161
1162 We recommend that you instead use the X window system, which
1163 has technical advantages, is an industry standard, and is also
1164 free software. The FSF does not support the SunWindows code;
1165 we installed it only on the understanding we would not let it
1166 divert our efforts from what we think is important.
1167
1168 If you are compiling for X windows, and the X window library was
1169 compiled to use the 68881, then you must edit config.h according
1170 the comments at the end of `src/m/sun3.h'.
1171
1172 Note that Emacs on a Sun is not really as big as it looks.
1173 As dumped, it includes around 200k of zeros between the
1174 original text section and the original data section
1175 (now remapped as part of the text). These are never
1176 swapped in.
1177
1178 To build a single Emacs that will run on Sun 2 and Sun 3
1179 HARDWARE, just build it on the Sun 2.
1180
1181 On Sunos 4.1.3, the word is that Emacs can loop infinitely
1182 on startup with X due perhaps to a bug in Sunos. Installing all of
1183 these Sun patches fixes the problem. We don't know which of them
1184 are really relevant.
1185
1186 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03
1187 101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10
1188 101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02
1189 101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05
1190 100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02
1191 100584-05 100784-01 101072-01 101207-01
1192
1193Tadpole 68K (m68k-tadpole-sysv)
1194
1195 Changes merged in 19.1.
1196
1197 You may need to edit Makefile to change the variables LIBDIR and
1198 BINDIR from /usr/local to /usr/contrib.
1199
1200 To give movemail access to /usr/mail, you may need to execute
1201
1202 chmod 2755 etc/movemail; chgrp mail etc/movemail
1203
1204Tahoe (tahoe-tahoe-bsd4.2 or tahoe-tahoe-bsd4.3)
1205
1206 18.52 was known to work on some Tahoes, but a compiler bug intervenes
1207 on others. Some Emacs versions have worked in Unisys 1r4
1208 (not in 1r3) and CCI I.21.
1209
1210 If you have trouble compiling `lib-src/loadst.c', turn off the definition
1211 of DKSTAT_HEADER_FILE in `src/m/tahoe.h'.
1212
1213Tandem Integrity S2 (mips-tandem-sysv)
1214
1215 Changes merged in 18.56 but subprocess support is turned off.
1216 You will probably want to see if you can make subprocesses work.
1217
1218 You must edit `lib-src/Makefile' to define LOADLIBES = -mld.
1219
1220Tektronix XD88 (m88k-tektronix-sysv3*)
1221
1222 The 19.26 pretest was reported to work.
1223 Minor changes merged in 19.19.
1224
1225Tektronix 16000 box (6130?) (ns16k-tektronix-bsd)
1226
1227 Emacs 17.61 worked.
1228
1229Tektronix 4300 (m68k-tektronix-bsd)
1230
1231 Emacs 19.26 pretest reported to work.
1232
1233Titan P2 or P3 (titan-titan-sysv)
1234
1235 Changes probably merged in version 19.
1236
1237Ustation E30 (SS5E) (m68k-unisys-unipl)
1238
1239 Changes merged in 18.52; don't know whether they work.
1240
1241Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3),
1242 Ultrix (vax-dec-ultrix),
1243 System V (vax-dec-sysv0, vax-dec-sysv2), or
1244 VMS (vax-dec-vms)
1245
1246 Works.
1247
1248 See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).
1249
1250 18.27 worked on System V rel 2 (vax-dec-sysv2).
1251
1252 18.36 worked on System V rel 0 (vax-dec-sysv0).
1253
1254 Richard Levitte <levitte@e.kth.se> distributes a set of patches to
1255 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably
1256 won't work very well, or even compile. Levitte is working on a
1257 port, so these problems should be fixed in the near future.
1258
1259Whitechapel MG1 (ns16k-whitechapel-?)
1260
1261 May work. Supposedly no changes were needed except in `src/m/mg1.h'
1262 file. I do not know what Unix version runs on them.
1263
1264Wicat (m68k-wicat-sysv)
1265
1266 Changes merged as of 18.6; whether they work is unknown.
1267 See comments in `src/m/wicat.h' for things you should change
1268 depending on the system and compiler version you have.
1269\f
1270Here are notes about some of the systems supported:
1271
1272Berkeley 4.1 (bsd4.1)
1273
1274 Works on vaxes.
1275
1276Berkeley 4.2 (bsd4.2)
1277
1278 Works on several machines.
1279
1280Berkeley 4.3 (bsd4.3)
1281
1282 Works, on Vaxes at least.
1283
1284Esix
1285
1286 The following was written for Emacs 18.59 and has been
1287 slightly adapted for Emacs 19. It may need more change to be correct.
1288
1289 Use s/usg5-4.h for Esix System V 4.0.[34] systems if you also have
1290 XFree86. If you insist on using the Esix X Window libraries, good
1291 luck. s/esix5r4.h provides a starting point, but doesn't seem to
1292 work consistently. The basic problems involve the need to load
1293 -lX11 *last* in the link command, and even then some things break.
1294 You get best results by installing XFree86 and forgetting about the
1295 Esix stuff unless you want to run IXI xdt3, which really only needs
1296 the Esix X11 shared libraries.
1297
1298 To compile with XFree86, make sure that your LD_LIBRARY_PATH
1299 contains /usr/X386/lib. Be careful if you also have the Esix X
1300 Window libraries that /usr/X386/lib appears *first* in the
1301 LD_LIBRARY_PATH. Then define C_SWITCH_X_SYSTEM -I/usr/X386/include.
1302
1303Linux (actually GNU/Linux)
1304
1305 Most of the complete systems which use the Linux kernel are close
1306 enough to the GNU system to be considered variant GNU systems. We
1307 call them "Linux-based GNU systems," or GNU/Linux for short.
1308
1309 It is not coincidence that many of the other components used with
1310 Linux--including GNU Emacs--were developed specifically for the GNU
1311 project. The GNU project was launched in 1984 to develop a free
1312 complete Unix-like operating system. To reach this goal, we had to
1313 develop whatever system components were not available as freely
1314 redistributable software from some other source.
1315
1316 The GNU project wants users of GNU/Linux systems to be aware of how
1317 these systems relate to the GNU project, because that will help
1318 spread the GNU idea that software should be free--and thus encourage
1319 people to write more free software. See the file LINUX-GNU in this
1320 directory for more explanation.
1321
1322Microport
1323
1324 See under "Intel 386".
1325
1326MSDOS
1327
1328 For installation on MSDOS, see the file INSTALL (search for `MSDOG',
1329 near the end of the file). See the "MS-DOS" chapter of the manual
1330 for information about using Emacs on MSDOS.
1331
1332SCO Unix
1333 If you have TCP but not X, you need to edit src/s/sco4.h
1334 to define HAVE_SOCKETS.
1335
1336 If you are using MMDF instead of sendmail, you need to remove
1337 /usr/lib/sendmail or modify lisp/paths.el before compiling.
1338 lisp/paths.el (which is loaded during the build) will attempt to use
1339 sendmail if it exists.
1340
1341 If you are using SMAIL, you need to define the macro
1342 SMAIL in config.h.
1343
1344System V rel 0 (usg5.0)
1345
1346 Works, on Vaxes and 3bxxx's.
1347 There are some problems in 18.37 due to shortnames/cccp problems:
1348 use the emacs 17 cpp if you have it.
1349
1350System V rel 2 (usg5.2)
1351
1352 Works on various machines.
1353 On some (maybe all) machines the library -lPW exists and contains
1354 a version of `alloca'. On these machines, to use it, put
1355 #define HAVE_ALLOCA
1356 #define LIB_STANDARD -lPW -lc
1357 in the `src/m/MACHINENAME.h' file for the machine.
1358
1359 If you find that the character Meta-DEL makes Emacs crash,
1360 find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT]
1361 and make it store 7 there. I have as yet no evidence of whether
1362 this problem, known in HP/UX, exists in other system V versions.
1363
1364System V rel 2.2 (usg5.2.2)
1365
1366 In 5.2.2 AT&T undid, incompatibly, their previous incompatible
1367 change to the way the nlist library is called. A different s- file
1368 is used to enable the other interface.
1369
1370 They call themselves the right choice--can't they choose?
1371
1372 Emacs version 18 unexec is currently not working properly
1373 on 5.2.2. Nobody knows why yet. A workaround is to define
1374 NO_REMAP. It is not yet known whether this applies to all
1375 machines running 5.2.2.
1376
1377System V rel 3 (usg5.3)
1378
1379 Some versions of this system support ptys and BSD-style sockets.
1380 On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h.
1381
1382 If you want to link Emacs with shared libraries, define
1383 USG_SHARED_LIBRARIES.
1384
1385 You may have to add ANSI idempotence #-lines to your sys/types.h
1386 file to get Emacs to compile correctly. This may be necessary on
1387 other pre-ANSI systems as well.
1388
1389 On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support
1390 cannot be made to work. Whether or not the GNU relocating malloc is
1391 used, the symptom is that the first call Emacs makes to sbrk(0) returns
1392 (char *)-1. Sorry, you're stuck with character-only mode. Try
1393 installing Xfree86 to fix this.
1394
1395System V rel 4.0.3 and 4.0.4 (usg5.4)
1396
1397 Supported, including shared libraries for ELF, but ptys do not work
1398 because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have
1399 fixed this). This failure is probably due to a misunderstanding of
1400 the consequences of the POSIX spec: many system designers mistakenly
1401 think that POSIX requires this feature to fail. This is untrue;
1402 ptys are an extension, and POSIX says that extensions *when used*
1403 may change the action of standard facilities in any fashion.
1404
1405 If you get compilation errors about wrong number of
1406 arguments to getpgrp, define GETPGRP_NO_ARG.
1407
1408 The standard C preprocessor may generate xmakefile incorrectly. However,
1409 /lib/cpp will work, so use `make CPP=/lib/cpp'. Standard cpp
1410 seems to work OK under Dell 2.2.
1411
1412 Some versions 3 and earlier of V.4, on the Intel 386 and 860, had
1413 problems in the X11 libraries. These prevent Emacs from working
1414 with X. You can use Emacs with X provided your copy of X is based
1415 on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3).
1416 Unfortunately, the only way you can tell whether your X11 library is
1417 new enough is to try compiling Emacs to use X. If emacs runs, your
1418 X11 library is new enough.
1419
1420 In this context, GSV4 and GSV4i are alternate names for X11R4.
1421 OL2.* is X11R3 based. OL3 is in between X11R3 and X11R4, and may or
1422 may not work, depending on who made the Unix system. If the library
1423 libXol is part of the X distribution, then you have X11R3 and Emacs
1424 won't work with X.
1425
1426 Most versions of V.4 support sockets. If `/usr/lib/libsocket.so'
1427 exists, your system supports them. If yours does not, you must add
1428 #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h.
1429 (Any system that supports Internet should implement sockets.)
1430
1431Ultrix (bsd4.3)
1432
1433 Recent versions of Ultrix appear to support the features of Berkeley 4.3.
1434 Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out.
1435
1436 Ultrix 3.0 has incompatibilities in its X library if you have the
1437 Ultrix version of X (UWS version 2.0). To solve them, you need to
1438 prevent XvmsAlloc.o in Xlib from being used. Israel Pinkas says:
1439
1440 I added the following lines to config.h after the X defines:
1441
1442 #if defined(ultrix) && defined(X11)
1443 #define OBJECTS_SYSTEM calloc.o
1444 #endif
1445
1446 Then I ran the following:
1447
1448 ar x /usr/lib/libc.a calloc.o
1449
1450 The problem is said to be gone in UWS version 2.1.
1451
1452Uniplus 5.2 (unipl5.2)
1453
1454 Works, on Dual machines at least.
1455
1456VMS (vmsM.N)
1457
1458 Richard Levitte <levitte@e.kth.se> distributes a set of patches to
1459 Emacs 18.59 to make it work nicely under VMS. Emacs 19 probably
1460 won't work very well, or even compile. Levitte is working on a
1461 port, so these problems should be fixed in the near future.
1462
1463 Note that Emacs for VMS is usually distributed in a special VMS
1464 distribution. See the file ../vms/VMSINSTALL for info on moving
1465 Unix distributions to VMS, and other VMS-related topics.
1466
1467Windows NT/95/98/ME/2000
1468
1469 For installation on all versions of the MS-Windows platform, see the
1470 file nt/INSTALL.
1471
1472Xenix (xenix)
1473
1474 Should work in 18.50, but you will need to edit the files
1475 `lib-src/Makefile' and `src/ymakefile'
1476 (see the comments that mention "Xenix" for what to change.)
1477 Compiling Emacs with -O is said not to work.
1478
1479 If you want Emacs to work with Smail (installed as /usr/bin/smail)
1480 then add the line #define SMAIL to config.h.
1481
1482 The file etc/XENIX suggests some useful things to do to Xenix
1483 to make the Emacs meta key work.
1484\f
1485Local variables:
1486mode: indented-text
1487fill-prefix: " "
1488End: