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