(CFLAGS): Use shell syntax, not Makefile.
[emacs.git] / etc / MACHINES
blobeb86f4c1aa03e109a4c1cb45521fb1e350019459
1 This is a list of the status of GNU Emacs on various machines and systems.
3 For each system and machine, we give the configuration name you should
4 pass to the `configure' script to prepare to build Emacs for that
5 system/machine.
7 The `configure' script uses the configuration name to decide which
8 machine and operating system description files `src/config.h' should
9 include.  The machine description files are all in `src/m', and have
10 names similar to, but not identical to, the machine names used in
11 configuration names.  The operating system files are all in `src/s',
12 and are named similarly.  See the `configure' script if you need to
13 know which configuration names use which machine and operating system
14 description files.
16 If you add support for a new configuration, add a section to this
17 file, and then edit the `configure' script to tell it which
18 configuration name(s) should select your new machine description and
19 system description files.
22 Here are the configurations Emacs is intended to work with, with the
23 corresponding configuration names.  You can postpend version numbers
24 to operating system names (i.e. sunos4.1) or architecture names (i.e.
25 hppa1.1).  If you leave out the version number, the `configure' script
26 will configure Emacs for the latest version it knows about.
28 Alliant (fx80-alliant-bsd):
30   18.52 worked on system version 4.  Previous Emacs versions were
31   known to work on previous system versions.
33   If you are using older versions of their operating system, you may
34   need to edit `src/config.h' to use `m/alliant1.h' (on version 1) or
35   `m/alliant.h' (on versions 2 and 3).
37 Alliant FX/2800 (i860-alliant-bsd)
39   Known to work with 18.58 and OS version 2.2, compiler version 1.3.
41 Altos 3068 (m68k-altos-sysv)
43   18.52 was said to work, provided you don't compile unexec.c with -O.
45 Amdahl UTS (580-amdahl-sysv)
47   Small changes for 18.38 were merged in 18.39.  It is mostly
48   working, but at last report a bug sometimes causes Emacs to
49   grab very large amounts of memory.  No fix or explanation
50   has yet been reported.  It may be possible to find this bug
51   if you find which Emacs command it happens within and then
52   run that command with a breakpoint set at malloc.
54   The 5.2u370 compiler is so brain damaged that it is not
55   even worth trying to use it.  Success was obtained with the
56   uts native C compiler on uts version 5.2.5.
58 Apollo running Domain (m68k-apollo-bsd)
60   18.52 works, to some extent.
61   Code for dumping Emacs has been written, but we cannot distribute it yet.
62   There are reports of bugs in cc -O on this system.
64   In `lib-src/Makefile', don't expect emacsclient and emacsserver to
65   compile.  You might want to remove them from your makefile.
67   Supposedly something in dired.c runs into a compiler bug.
68   Paraphrasing the statement should avoid the problem.  I have not yet
69   received word as to the exact statement this is.
71   The Apollo has a bizarre operating system which does not permit
72   Emacs to be dumped with preloaded pure Lisp code.  Therefore, each
73   time you start Emacs on this system, the standard Lisp code is loaded
74   into it.  Expect it to take a long time.  You can prevent loading of
75   the standard Lisp code by specifying the -nl switch.  It must
76   come at the beginning of the command line; only the -t and -batch
77   switches may come before it.
79   There is one remaining problem on the Apollo.  You must replace
80   the CPP line in src/Makefile with "CPP = /usr/lib/cpp".
81   The C preprocessor lives there rather than in /lib/cpp because the
82   Aegis OS uses the /lib directory as the repository for shared libraries.
85   Here is a design for a method of dumping and reloading the relevant
86   necessary impure areas of Emacs.
88   On dumping, you need to dump only the array `pure' plus the
89   locations that contain values of forwarded Lisp variables or that are
90   protected for garbage collection.  The former can be found by a
91   garbage- collection-like technique, and the latter are in the
92   staticprolist vector (see alloc.c for both things).
94   Reloading would work in an Emacs that has just been started; except
95   when a switch is specified to inhibit this, it would read the dump
96   file and set all the appropriate locations.  The data loaded must be
97   relocated, but that's not hard.  Those locations that are of type
98   Lisp_Object can be found by a technique like garbage-collection, and
99   those of them that point to storage can be relocated.  The other data
100   read from the file will not need to be relocated.
102   The switch to inhibit loading the data base would be used when it
103   is time to dump a new data base.
105   This would take a few seconds, which is much faster than loading
106   the Lisp code of Emacs from scratch.
108 AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv)
110   Emacs will probably not work with certain kernel constants too small. 
112   In param.h CDLIMIT should be at least (1L << 12) in order to allow 
113   processes to write up to 2 Mbyte files.  This parameter is configurable
114   by normal means in /etc/master.d/kernel; examine that file for the
115   symbol CDLIMIT or ULIMIT, and raise it by several powers of 2.  Then
116   do normal kernel rebuild things via "cd /boot; mkboot -k KERNEL" and so
117   forth.
119   In seg.h NSEGP and STACKSEG should be at least 16 and 4 respectively
120   to allow processes with total size of up to 2Mbytes.
121   However, I'm told it is unlikely this would fail to be true.
123   The MAXMEM may also prevent Emacs from running.  The file
124   3B-MAXMEM in this directory explains how to increase MAXMEM.
126 AT&T 7300 or 3b1 (m68k-att-sysv)
128   18.52 worked.  If you have strange troubles with dumping
129   Emacs, delete the last few lines from `src/m/7300.h' and recompile.
130   These lines are supposed to produce a sharable executable.
132   `src/m/7300.h' defines SHORTNAMES because operating system versions
133   older than 3.5 did not support long symbol names.  Version 3.5 does
134   support them, so you can remove the #define SHORTNAMES in that
135   version.
137 Bull sps7 (m68k-bull-sysv)
139   Changes partially merged in version 19, but some fixes are probably required.
141 CCI 5/32, 6/32
143   See "Tahoe".
145 Celerity (celerity-celerity-bsd4.2)
147   Version 18.49 worked.  This configuration name is a hack, because we
148   don't know the processor used by Celerities.  If someone
149   who uses a Celerity could get in touch with us, we can teach
150   config.sub a better name for the configuration.
152 Clipper (clipper-???)
154   Version 19 has support for some brand of clipper system.  If you
155   have successfully built Emacs 19 on some sort of clipper system, let
156   us know so we can flesh out this entry.
158   Note that the Orion 105 is also a clipper, but some system-related
159   parameters are different.
161 Convex (c1-convex-bsd, c2-convex-bsd, c32-convex-bsd, c34-convex-bsd,
162         c38-convex-bsd)
164   18.53 supposedly to work.
166 Cubix QBx/386 (i386-cubix-sysv)
168   Changes merged in 19.1.  Systems before 2/A/0 may fail to compile etags.c
169   due to a compiler bug.
171 Cydra 5 (cydra-cydrome-sysv)
173   18.51 worked in one version of their operating system but stopped
174   working in a newer version.  This has not been fixed.
176 DECstation (mips-dec-ultrix or mips-dec-osf)
178   Version 19 works under Ultrix.
180   See under Ultrix for problems using X windows on Ultrix.
181   Note that this is a MIPS machine.
183   For Ultrix versions 4.1 or earlier, you may need to define
184   SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems
185   to insist on defining malloc itself.
187   For Ultrix versions prior to 4.0, you may need to delete
188   the definition of START_FILES from `src/m/pmax.h'.
190 Motorola Delta 147 (m68k-motorola-sysv)
192   Motorola Delta boxes running System V/68 release 3.
193   (tested on sys1147 with SVR3V5).  Changes merged in 19.1.
195 Motorola Delta 187 (m88k-motorola-sysv or m88k-motorola-m88kbcs)
197   Machine support added in version 19.
198   HAVE_X_MENU does not work due to lack of insque.
200 Dual running System V (m68k-dual-sysv)
202   As of 17.46, this worked except for a few changes
203   needed in unexec.c.
205 Dual running Uniplus (m68k-dual-uniplus)
207   Worked, as of 17.51.
209 Elxsi 6400 (elxsi-elxsi-sysv)
211   Changes for 12.0 release are in 19.1.
212   Dumping should work now.
214 Encore machine (ns16k-encore-bsd)
216   This machine bizarrely uses 4.2BSD modified to use the COFF format
217   for object files.  Works (as of 18.40).  For the APC processor you
218   must enable two lines at the end of `src/s/umax.h', which are commented
219   out in the file as distributed.
221   WARNING: If you compile Emacs with the "-O" compiler switch, you
222   must also use the "-q enter_exits" switch so that all functions have
223   stack frames.  Otherwise routines that call `alloca' all lose.
225   A kernel bug in some system versions causes input characters to be lost
226   occasionally.
228 GEC 63 (local-gec63-usg5.2)
230   Changes are partially merged in version 18, but certainly require
231   more work.  Let us know if you get this working, and we'll give it a
232   real configuration name.
234 Gould Power Node (pn-gould-bsd4.2 or pn-gould-bsd4.3)
236   18.36 worked on versions 1.2 and 2.0 of the operating system.
238   On UTX/32 2.0, use pn-gould-bsd4.3.
240   On UTX/32 1.2 and UTX/32S 1.0, use pn-gould-bsd4.2 and note that
241   compiling `lib-src/sorted-doc' tickles a compiler bug: remove the -g
242   flag to cc in the makefile.
244   UTX/32 1.3 has a bug in the bcopy library routine.  Fix it by 
245   #undef BSTRING in `src/m/gould.h'.
247   Version 19 incorporates support for releases 2.1 and later of UTX/32.
248   A site running a pre-release of 2.1 should #define RELEASE2_1 in config.h.
250 Gould NP1 (np1-gould-bsd)
252   Version 19 supposedly works.
254 Honeywell XPS100 (xps100-honeywell-sysv)
256   Config file added in version 19.
258 HP 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux7.)
260   Version 19 works under BSD.
262   These machines are 68000-series CPUs running HP-UX
263   (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah.
264   The operating system suffix determines which system Emacs is built for.
266   Series 200 HPUX runs Emacs only if it has the "HP-UX upgrade".
268   If you are running HP-UX release 8.0 or later, you need the optional
269   "C/ANSI C" software in order to build Emacs (older releases of HP-UX
270   do not require any special software).  If the file "/etc/filesets/C"
271   exists on your machine, you have this software, otherwise you do not.
273   Note that HP has used two incompatible assembler syntaxes,
274   and has recently changed the format of C function frames.
275   `src/crt0.c' and `src/alloca.s' have been conditionalised for the new
276   assembler and new function-entry sequence.  You may need to define
277   OLD_HP_ASSEMBLER if you are using an older hpux version.  If you
278   have an official (bought from HP) series 300 machine you have
279   the new assembler.  Kernels that are 5.+ or later have new
280   assembler.  A Series 200 that has been upgraded to a 68010
281   processor and a 5.+ kernel has the new compiler.
283   Define C_SWITCH_MACHINE to be +X to make a version of Emacs that
284   runs on both 68010 and 68020 based hp-ux's.
286   Define HPUX_68010 if you are using the new assembler, for
287   a system that has a 68010 without a 68881.  This is to say,
288   a s200 (upgraded) or s310.
290   Define the symbol HPUX_NET if you have the optional network features
291   that include the `netunam' system call.  This is refered to as
292   Network Services (NS/9000) in HP literature.
294 HP 9000 series 500: not supported.
296   The series 500 has a seriously incompatible memory architecture
297   which relocates data in memory during execution of a program,
298   and support for it would be difficult to implement.
300 HP 9000 series 800 (Spectrum) (hppa1.0-hp-hpux)
302   These files support HP's Precision Architecture machines
303   running HP-UX.  It has been moderately tested on the Series
304   840.
306   If you are running HP-UX release 8.0 or later, you need the optional
307   "C/ANSI C" software in order to build Emacs (older releases of HP-UX
308   do not require any special software).  If the file "/etc/filesets/C"
309   exists on your machine, you have this software, otherwise you do not.
311 High Level Hardware Orion (orion-highlevel-bsd)
313   This is the original microprogrammed hardware.
314   Machine description file ought to work.
316 High Level Hardware Orion 1/05 (clipper-highlevel-bsd)
318   Changes merged in 18.52.  This is the one with the Clipper cpu.
319   Note that systems which lack NFS need LOAD_AVE_TYPE changed to `double'.
321   C compiler has a bug; it loops compiling eval.c.
322   Compile it by hand without optimization.
324 IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)
326   Changes merged in version 19.  You may need to copy
327   /usr/lib/samples/hft/hftctl.c to the Emacs src directory.
329   i386-ibm-aix1.1 may not work with certain new X window managers, and
330   may be suboptimal.
332 IBM RS/6000 (rs6000-ibm-aix)
334   Changes merged in version 19.  Currently the configuration
335   does not actually depend on the version of AIX.
337   Compiling with -O using the IBM compiler has been known
338   to make Emacs work incorrectly.
340 IBM RT/PC (romp-ibm-bsd or romp-ibm-aix)
342   18.52 worked on both operating systems.
343   Use romp-ibm-bsd for the 4.2-like system and romp-ibm-aix for AIX.
345   On BSD, if you have trouble, try compiling with a different compiler.
347   On AIX, the file /usr/lib/samples/hft/hftctl.c must be compiled into
348   hftctl.o, with this result left in the src directory (hftctl.c is
349   part of the standard AIX distribution).
351   window.c must not be compiled with -O on AIX.
353 Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)
355   18.52 said to work on some sort of ISI machine.
356   Version 18.45 worked (running on a Optimum V (VME bus, 68020)
357   BSD 4.2 (3.05e) system).  18.42 is reported to work on
358   a Qbus 68010 system.  Has not been tried on `WorkStation' `Cluster
359   Compute Node' `Cluster WorkStation' or `Server Node'  (Love the
360   StudLYCaps) 
362   Compilation with -O is rumored to break something.
364   On recent system versions, you may need to undefine the macro UMAX
365   in `lib-src/loadst.c' and `src/getpagesize.h'.  They stupidly defined this
366   in a system header file, which confuses Emacs (which thinks that UMAX
367   indicates the Umax operating system).
369 Intel 386 (i386-unknown-isc, i386-unknown-esix, i386-unknown-xenix,
370            i386-intsys-sysv, i386-unknown-sysv5.2.2, i386-unknown-sysv5.3,
371            and i386-unknown-bsd4.2)
373   18.58 should support a wide variety of operating systems.
374   Make sure to use i386-unknown-isc2.2 for Interactive 386/ix version
375         2.2 or later.
376   Use i386-unknown-esix for Esix.
377   Use i386-intsys-sysv for Integrated Solutions 386 machines.
378   It may also be correct for Microport systems.
379   It isn't clear what to do on an SCO system.  The system's C
380   preprocessor doesn't seem to handle the src subdirectory's Make
381   trickery, so you will probably need to install the GNU C preprocessor.
383   If you are using Xenix, see notes above under Xenix.
385   Some sysV.3 systems seem to have bugs in `opendir';
386   for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY
387   and undefine SYSV_SYSTEM_DIR.
389   If you use optimization on V.3, you may need the option -W2,'-y 0'
390   to prevent certain faulty optimization.
392   On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
393   to config.h.
395   There is no consistency in the handling of certain system header files
396   on V.3.
398   Some versions have sys/sioctl.h, and require it in sysdep.c.
399   But some versions do not have sys/sioctl.h.
400   For a given version of the system, this may depend on whether you have
401   X Windows or TCP/IP.  Define or undefine NO_SIOCTL_H in config.h
402   according to whether you have the file.
404   Likewise, some versions have been known to need sys/ttold.h, sys/stream.h,
405   and sys/ptem.h included in sysdep.c.  If your system has these files,
406   try defining NEED_PTEM_H in config.h if you have trouble without it.
408   You may find that adding -I/usr/X/include or -I/usr/netinclude or both
409   to CFLAGS avoids compilation errors on certain systems.
411   Some versions convince sysdep.c to try to use `struct tchars'
412   but define `struct tc' instead; add `#define tchars tc'
413   to config.h to solve this problem.
415 Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)
417   Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5
418   and m68k-sgi-iris3.6 for system version 3.6.
419   Note that the 3030 is the same as the Iris 2500 Turbo.
421 Iris 4D (mips-sgi-irix3.3 or mips-sgi-irix4.0)
423   18.58 is known to work on Silicon Graphics 4D series machines
424   with IRIX 3.3 or IRIX 4.0.  Version 19 should support the
425   ANSI C compiler version 3.10.
427   Most irix3.3 systems do not have an ANSI C compiler, but a few do.
428   If you are using the ANSI C compiler, you may need to add
429       #define C_SWITCH_MACHINE -cckr
430   to config.h.
432   There is a bug in IRIX that can sometimes leave ptys owned by
433   root with a permission of 622.  This causes malfunctions in use
434   of subprocesses of Emacs.  This may be fixed in IRIX 4.0.5.
436 Macintosh
438   We are boycotting Apple because of Apple's efforts to take away
439   our freedom to write compatible imitations of existing software.
440   If you value your freedom to write such programs, we urge you
441   not to buy from Apple, not to develop software for Apple, and
442   certainly not to accept a job with Apple.
444   See the file APPLE in this directory for more information.
446 Masscomp (m68k-masscomp-rtu)
448   18.36 worked on a 5500DP running RTU v3.1a and compiler version 3.2
449   with minor fixes that are included in 18.37.  However, bizarre behavior
450   was reported for 18.36 on a Masscomp (model and version unknown but probably
451   a 68020 system).  The report sounds like a compiler bug.
453   A compiler bug affecting statements like 
454     unsigned char k; unsigned char *p;... x = p[k];
455   has been reported for "C version 1.2 under RTU 3.1".  We do not wish
456   to take the time to install the numerous workarounds required to
457   compensate for this bug; go complain to Masscomp.
459   For RTU version 3.1, define FIRST_PTY_LETTER to be 'p' in `src/s/rtu.h'
460   (or #undef and redefine it in config.h) so that ptys will be used.
462   GNU Emacs is said to have no chance of compiling on RTU versions
463   prior to v3.0.
465 Megatest (m68k-megatest-bsd)
467   Emacs 15 worked; do not have any reports about Emacs 16 or 17
468   but any new bugs are probably not difficult.
470 Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)
472   Changes merged in 18.39.  Some fixes in 18.56.
474   Use mips-mips-riscos4.0 for RISCOS version 4.
475   Use mips-mips-bsd with the BSD world.
477   Note that the proper configuration names for DECstations are
478   mips-dec-ultrix and mips-dec-osf.
480   If you are compiling with GCC, then you must run fixincludes;
481   the alternative of using -traditional won't work because
482   the definition of SIGN_EXTEND_CHAR uses the keyword `signed'.
484   If the SYSV world is the default, then you probably need the following
485   line in etc/Makefile:
487     CFLAGS= -g -systype bsd43
489   Some operating systems on MIPS machines give SIGTRAP for division by
490   zero instead of the usual signals.  The only real solution is to fix
491   the system to give a proper signal.
493   In the meantime, you can change init_data in data.c if you wish.
494   Change it to handle SIGTRAP as well as SIGFPE.  But this will have a
495   great disadvantage: you will not be able to run Emacs under a
496   debugger.  I think crashing on division by zero is a lesser problem.
498 National Semiconductor 32000 (ns32k-ns-genix)
500   This is for a complete machine from National Semiconductor,
501   running Genix.  Changes merged in version 19.
503 NCR Tower 32 (m68k-ncr-sysv2 or m68k-ncr-sysv3)
505   If you are running System V release 2, use m68k-ncr-sysv2.
506   If you are running System V release 3, use m68k-ncr-sysv3.
508   These both worked as of 18.56.  If you change `src/ymakefile' so that
509   CFLAGS includes C_OPTIMIZE_SWITCH rather than C_DEBUG_SWITCH, check
510   out the comments in `src/m/tower32.h' (for System V release 2) or
511   `src/m/tower32v3.h' (for System V release 3) about this.
513   There is a report that compilation with -O did not work with 18.54
514   under System V release 2.
516 Nixdorf Targon 31 (m68k-nixdorf-sysv)
518   Machine description file for version 17 is included in 18
519   but whether it works is not known.
520   `src/unexec.c' bombs if compiled with -O.
521   Note that the "Targon 35" is really a Pyramid.
523 Nu (TI or LMI) (m68k-nu-sysv)
525   Version 18 is believed to work.
527 Plexus (m68k-plexus-sysv)
529   Worked as of 17.56.
531 Pmax (DEC Mips)  (mips-dec-ultrix or mips-dec-osf1)
533   See under DECstation, above.
535 Prime EXL (i386-prime-sysv)
537   Minor changes merged in 19.1.
539 Pyramid (pyramid-pyramid-bsd)
541   You need to build Emacs in the Berkeley universe with
542   the `ucb' command, as in `ucb make' or `ucb build-install'.
543   
544   In OSx 4.0, it seems necessary to add the following two lines
545   to `src/m/pyramid.h':
546      #define _longjmp longjmp
547      #define _setjmp setjmp
549   In Pyramid system 2.5 there has been a compiler bug making
550   Emacs crash just after screen-splitting with Qnil containing 0.
551   A compiler that fixes this is Pyramid customer number 8494,
552   internal number 1923.
554   Some versions of the pyramid compiler get fatal
555   errors when the -gx compiler switch is used; if this
556   happens to you, change `src/m/pyramid.h' to define
557   C_DEBUG_SWITCH with an empty definition.
559   Some old system versions may require you to define PYRAMID_OLD
560   in when alloca.s is preprocessed, in order to define _longjmp and _setjmp.
562 Sequent Balance (ns32k-sequent-bsd4.2 or ns32k-sequent-bsd4.3)
564   Emacs 18.51 worked on system version 3.0.  18.52 is said to work.
565   Delete some lines at the end of `src/m/sequent.h' for earlier system
566   versions.
568 Sequent Symmetry (i386-sequent-bsd)
570   Emacs 19 should work.
572 SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)
574   18.52 worked.  Use m68k-sony-bsd4.3 for system release 3.
576 SONY News 3000 series (RISC NEWS) (mips-sony-bsd)
578   Worked, as of 18.56.  Note that this is a MIPS architecture machine.
580   Some versions of the operating system give SIGTRAP for division by zero
581   instead of the usual signals.  This causes division by zero
582   to make Emacs crash.  The system should be fixed to give the proper signal.
583   Changing Emacs is not a proper solution, because it would prevent
584   Emacs from working under any debugger.  But you can change init_data
585   in data.c if you wish.
587 Stardent 1500 or 3000
589   See Titan.
591 Stride (m68k-stride-sysv)
593   Works (most recent news for 18.30) on their release 2.0.
594   For release 2.2, see the end of `src/m/stride.h'.
595   It may be possible to run on their V.1 system but changes
596   in the s- file would be needed.
598 Sun 1, 2 and 3 (m68k-sun-sunos, sparc-sun-sunos, i386-sun-sunos)
600   It's important to include the SunOS version number in the
601   configuration name.  For example, for SunOS release 4.0 on a Sun 3,
602   use `m68k-sun-sunos4.0'; for SunOS release 4.1 on a Sparc, use
603   `sparc-sun-sunos4.1'.
605   Use `m68k' for the 68000-based Sun boxes, `sparc' for Sparcstations,
606   and `i386' for Sun Roadrunners.
608   There are three machine files for the different versions of SunOS
609   that run on the Motorola 68000 processors.  All are derived from
610   Berkeley 4.2.  Emacs 17 has run on all of them.
612   See the file etc/SUNBUG for how to solve problems caused by
613   bugs in the "export" version of SunOS 4.
615   If you have trouble using open-network-stream, get the
616   distribution of `bind' (the BSD name-server), build libresolv.a,
617   and link Emacs with -lresolv.  This problem is due to obsolete
618   software in the nonshared standard library.
620   If you want to use SunWindows, define HAVE_SUN_WINDOWS
621   in config.h to enable a special interface called `emacstool'.
622   The definition must *precede* the #include "machine.h".
623   System version 3.2 is required for this facility to work.
625   We recommend that you instead use the X window system, which
626   has technical advantages, is an industry standard, and is also
627   free software.
629   If you are compiling for X windows, and the X window library was
630   compiled to use the 68881, then you must edit config.h according
631   the comments at the end of `src/m/sun3.h'.
633   Note that Emacs on a Sun is not really as big as it looks.
634   As dumped, it includes around 200k of zeros between the
635   original text section and the original data section
636   (now remapped as part of the text).  These are never
637   swapped in.
639   To build a single Emacs that will run on Sun 2 and Sun 3
640   HARDWARE, just build it on the Sun 2.
642   Changes for the Sparc architecture were merged in 18.50.  Some
643   people say optimizing compilation does not work; some say that -O2
644   (whatever that is) works perhaps with a small change.
646   Changes for the Roadrunner architecture were merged in 18.51.
648   There is a bug in the Export version of SunOS 4.0 shipped outsde the
649   US; it has something to do with Pentagon export restrictions on the
650   DES chips in Suns.  The symptom is that "cc -Bstatic ..." WILL NOT
651   WORK ON SUNOS 4.0 EXPORT without a little help from "ar".  The
652   static C-library is /lib/libc.a, and this is where the problem
653   occurs.  There are a bunch of .o files in there relating to DES
654   stuff (des_crypt.o, des_soft.o, _crypt.o, etc).  All of them will
655   cause cc -Bstatic to die with these errors:
657   > _edata: ld: user attempt to redefine loader-defined symbol
658   > _end: user attempt to redefine loader-defined symbol
659   > _etext: /lib/libc.a(des_crypt.o): multiply defined
661   In order to make cc -Bstatic useful, you must remove all the
662   brain-damaged .o files from /lib/libc.a.  To do this use
664   ar d /lib/libc.a des_crypt.o des_soft.o _crypt.o ....
666   (Make a backup of /lib/libc.a first, you may decide you need the "real"
667   thing someday).  Note that there are a bunch of these files, these may
668   not be  all of them.  You will find them quick enough by trying to
669   compile ANY C program, even one which does NOTHING.
671 Tadpole 68K (m68k-tadpole-sysv)
673   Changes merged in 19.1.
675   You may need to edit Makefile to change the variables LIBDIR and
676   BINDIR from /usr/local to /usr/contrib.
678   To give movemail access to /usr/mail, you may need to execute
680     chmod 2755 etc/movemail; chgrp mail etc/movemail
682 Tahoe (tahoe-tahoe-bsd4.2 or tahoe-tahoe-bsd4.3)
684   18.52 was known to work on some Tahoes, but a compiler bug intervenes
685   on others.  Some Emacs versions have worked in Unisys 1r4
686   (not in 1r3) and CCI I.21.
688   If you have trouble compiling `lib-src/loadst.c', turn off the definition
689   of DKSTAT_HEADER_FILE in `src/m/tahoe.h'.
691 Tandem Integrity S2 (mips-tandem-sysv)
693   Changes merged in 18.56 but subprocess support is turned off.
694   You will probably want to see if you can make subprocesses work.
696   You must edit `lib-src/Makefile' to define LOADLIBES = -mld.
698 Tektronix 16000 box (6130?) (ns16k-tektronix-bsd)
700   Emacs 17.61 worked.
702 Tektronix 4300 (m68k-tektronix-bsd)
704   Emacs 18.51 worked.
706 Titan P2 or P3 (titan-titan-sysv)
708   Changes probably merged in version 19.
710 Ustation E30 (SS5E) (m68k-unisys-unipl)
712   Changes merged in 18.52; don't know whether they work.
714 Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3),
715               Ultrix (vax-dec-ultrix),
716               System V (vax-dec-sysv0, vax-dec-sysv2), or
717               VMS (vax-dec-vms)
719   Works.
721   See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).
723   18.27 worked on System V rel 2 (vax-dec-sysv2).
725   18.36 worked on System V rel 0 (vax-dec-sysv0).
727   18.36 was believed to work on VMS.  Addition of features is necessary
728   to make this Emacs version more usable.
730 Whitechapel MG1 (ns16k-whitechapel-?)
732   May work.  Supposedly no changes were needed except in `src/m/mg1.h'
733   file.  I do not know what Unix version runs on them.
735 Wicat (m68k-wicat-sysv)
737   Changes merged as of 18.6; whether they work is unknown.
738   See comments in `src/m/wicat.h' for things you should change
739   depending on the system and compiler version you have.
741 Here is a summary of the systems supported:
743 Berkeley 4.1 (bsd4.1)
745   Works on vaxes.
747 Berkeley 4.2 (bsd4.2)
749   Works on several machines.
751 Berkeley 4.3 (bsd4.3)
753   Works, on Vaxes at least.
755 Microport
757   See under "Intel 386".
759 System V rel 0 (usg5.0)
761   Works, on Vaxes and 3bxxx's.
762   There are some problems in 18.37 due to shortnames/cccp problems:
763   use the emacs 17 cpp if you have it.
765 System V rel 2 (usg5.2)
767   Works on various machines.
768   On some (maybe all) machines the library -lPW exists and contains
769   a version of `alloca'.  On these machines, to use it, put
770      #define HAVE_ALLOCA
771      #define LIB_STANDARD -lPW -lc
772   in the `src/m/MACHINENAME.h' file for the machine.
774   If you find that the character Meta-DEL makes Emacs crash,
775   find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT]
776   and make it store 7 there.  I have as yet no evidence of whether
777   this problem, known in HP-UX, exists in other system V versions.
779 System V rel 2.2 (usg5.2.2)
781   In 5.2.2 AT&T undid, incompatibly, their previous incompatible
782   change to the way the nlist library is called.  A different s- file
783   is used to enable the other interface.
785   They call themselves the right choice--can't they choose?
787   Emacs version 18 unexec is currently not working properly
788   on 5.2.2.  Nobody knows why yet.  A workaround is to define
789   NO_REMAP.  It is not yet known whether this applies to all
790   machines running 5.2.2.
792 System V rel 3 (usg5.3)
794   Some versions of this system support ptys and BSD-style sockets.
795   On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h.
797   If you want to link Emacs with shared libraries, define
798   USG_SHARED_LIBRARIES.
800   You may have to add ANSI idempotence #-lines to your sys/types.h
801   file to get Emacs to compile correctly.  This may be necessary on
802   other pre-ANSI systems as well.
804   On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support
805   cannot be made to work.  Whether or not the GNU relocating malloc is
806   used, the symptom is that the first call Emacs makes to sbrk(0) returns
807   (char *)-1.  Sorry, you're stuck with character-only mode.  Try
808   installing Xfree86 to fix this.
810 System V rel 4.0.3 and 4.0.4 (usg5.4)
812   Supported, including shared libraries for ELF, but ptys do not work
813   because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have
814   fixed this).  This failure is probably due to a misunderstanding of
815   the consequences of the POSIX spec: many system designers mistakenly
816   think that POSIX requires this feature to fail.  This is untrue;
817   ptys are an extension, and POSIX says that extensions *when used*
818   may change the action of standard facilities in any fashion.
820   The standard C preprocessor may generate xmakefile incorrectly.  However,
821   /lib/cpp will work, so use `make CPP=/lib/cpp'.  Standard cpp
822   seems to work OK under Dell 2.2.
824   Some versions 3 and earlier of V.4, on the Intel 386 and 860, had
825   problems in the X11 libraries.  These prevent Emacs from working
826   with X.  You can use Emacs with X provided your copy of X is based
827   on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3).
828   Unfortunately, the only way you can tell whether your X11 library is
829   new enough is to try compiling Emacs to use X.  If emacs runs, your
830   X11 library is new enough.
832   In this context, GSV4 and GSV4i are alternate names for X11R4.
833   OL2.* is X11R3 based.  OL3 is in between X11R3 and X11R4, and may or
834   may not work, depending on who made the Unix system.  If the library
835   libXol is part of the X distribution, then you have X11R3 and Emacs
836   won't work with X.
838   Most versions of V.4 support sockets.  If `/usr/lib/libsocket.so'
839   exists, your system supports them.  If yours does not, you must add
840   #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h.
841   (Any system that supports Internet should implement sockets.)
843 Ultrix (bsd4.3)
845   Recent versions of Ultrix appear to support the features of Berkeley 4.3.
846   Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out.
848   Ultrix 3.0 has incompatibilities in its X library if you have the
849   Ultrix version of X (UWS version 2.0).  To solve them, you need to
850   prevent XvmsAlloc.o in Xlib from being used.  Israel Pinkas says:
852     I added the following lines to config.h after the X defines:
854     #if defined(ultrix) && defined(X11)
855     #define OBJECTS_SYSTEM calloc.o
856     #endif
858     Then I ran the following:
860     ar x /usr/lib/libc.a calloc.o
862   The problem is said to be gone in UWS version 2.1.
864 Uniplus 5.2 (unipl5.2)
866   Works, on Dual machines at least.
868 VMS (vmsM.N)
870   The config file s/vms5-5.h may be right for some earlier versions;
871   please let us know what happens when you try it in VMS versions 5.0
872   thru 5.4.
874   Note that Emacs for VMS is usually distributed in a special VMS
875   distribution.  See the file ../vms/VMSINSTALL for info on moving
876   Unix distributions to VMS, and other VMS-related topics.
878 Xenix (xenix)
880   Should work in 18.50, but you will need to edit the files
881   `lib-src/Makefile' and `src/ymakefile'
882   (see the comments that mention "Xenix" for what to change.)
883   Compiling Emacs with -O is said not to work.
885   If you want Emacs to work with Smail (installed as /usr/bin/smail)
886   then add the line   #define SMAIL  to config.h.
888   The file etc/XENIX suggests some useful things to do to Xenix
889   to make the Emacs meta key work.
891 Local variables:
892 mode: text
893 fill-prefix: "  "
894 End: