(cal-menu-goto-menu): Use "Go To".
[emacs.git] / etc / MACHINES
blob0e55fa76ead0130bacb9916fed6ccb3c13fd8811
1 Emacs machines list
3 Copyright (C) 1989, 1990, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
4   2005, 2006, 2007, 2008  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.
27 Some obsolete platforms are unsupported beginning with Emacs 23.1, see
28 the full list at the end of this file.
31 Here are the configurations Emacs is intended to work with, with the
32 corresponding configuration names.  You can postpend version numbers
33 to operating system names (i.e. sunos4.1) or architecture names (i.e.
34 hppa1.1).  If you leave out the version number, the `configure' script
35 will configure Emacs for the latest version it knows about.
37 Alpha (DEC) running GNU/Linux (alpha-dec-linux-gnu)
39   DEC C compiler version 5.9 (DEC C V5.9-005 on Digital UNIX V4.0f)
40   is reported to produce bogus binaries of Emacs 21.2 when the
41   command-line switches "-O4 -arch ev6 -tune ev6" are used.  Using
42   just -O4 produces a good executable.
44   For 4.0 revision 564, and 4.0A and 4.0B, Emacs 20 seems to work
45   with no special configuration options.  However, if you use GCC as
46   your compiler, you will need version 2.8.1 or later, as older
47   versions fail to build with a message "Invalid dimension for the
48   charset-ID 160".
50   Note that the X11 libraries on GNU/Linux systems for the Alpha are
51   said to have bugs that prevent Emacs from working with X (as of
52   November 1995).  Recent releases work (July 2000).
54 Apple Macintosh running Mac OS X
56   For installation on all versions of the Mac OS platform, see the file
57   mac/INSTALL.
59 Apple PowerPC Macintosh running GNU/Linux
61   There are special considerations for a variety of this system which
62   is known as the ``Yellow Dog [GNU/]Linux'': Emacs may crash during
63   dumping.  To solve this, edit the header file src/m/macppc.h in the
64   Emacs distribution, and remove the "#if 0" and "#endif" directives
65   which surround the following block near the end of the file:
67     #if 0  /* This breaks things on PPC GNU/Linux except for Yellowdog,
68               even with identical GCC, as, ld.  Let's take it out until we
69               know what's really going on here.  */
70     /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to
71        0x10000000.  */
72     #if defined __linux__
73     #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
74     #define DATA_SEG_BITS  0x10000000
75     #endif
76     #endif
77     #endif /* 0 */
79   After that, reconfigure and rebuild Emacs.  It should now build
80   successfully.
82 Cubix QBx/386 (i386-cubix-sysv)
84   Changes merged in 19.1.  Systems before 2/A/0 may fail to compile etags.c
85   due to a compiler bug.
87 DECstation (mips-dec-ultrix or mips-dec-osf)
89   This machine is the older Mips-based DECstation.
90   Emacs should now work on the Alpha CPU.
92   19.25 works on Ultrix 4.2.  The 19.26 pretest was reported to work
93   on Ultrix 4.2a and on 4.4.
95   One user reported 19.25 did not work at all with --with-x-toolkit
96   using X11R5 patch level 10, but worked ok with X11R5 pl26.
98   See under Ultrix for problems using X windows on Ultrix.
99   Note that this is a MIPS machine.
101   For Ultrix versions 4.1 or earlier, you may need to define
102   SYSTEM_MALLOC in `src/m/pmax.h', because XvmsAlloc.o in libX11.a seems
103   to insist on defining malloc itself.
105   For Ultrix versions prior to 4.0, you may need to delete
106   the definition of START_FILES from `src/m/pmax.h'.
108 Motorola Delta 147 (m68k-motorola-sysv)
110   The EMacs 19.26 pretest was reported to work.
112   Motorola Delta boxes running System V/68 release 3.
113   Tested on 147 board with SVR3V7, no X and gcc.
114   Tested on 167 board with SVR3V7, no X, cc, gnucc and gcc.
115   Reports say it works with X too.
117   The installation script chooses the compiler itself.  gnucc is
118   preferred.
120 Fujitsu DS/90 (sparc-fujitsu-sysv4)
122   Changes merged in 20.3.
124 GEC 63 (local-gec63-usg5.2)
126   Changes are partially merged in version 18, but certainly require
127   more work.  Let us know if you get this working, and we'll give it a
128   real configuration name.
130 Harris Power PC (powerpc-harris-powerunix)
132   Patches have been merged in 19.31.
134 Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux
135                                         or m68k-hp-netbsd)
137   These machines are 68000-series CPUs running HP/UX
138   (a derivative of sysV with some BSD features) or BSD 4.3 ported by Utah.
139   The operating system suffix determines which system Emacs is built for.
141   Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade".
143   Version 19 works under BSD.  The 19.26 pretest was reported
144   to work on HPUX 9.  19.31 works on HPUX 10.01, but there are
145   some problems on 10.10 which have not been resolved.  Emacs 19.34
146   works on HPUX 10.20 provided you compile with GCC; with the HP C
147   compiler, subprocess commands do not work.
149   On HPUX 9, Emacs sometimes crashes with SIGBUS or SIGSEGV after you
150   delete a frame.  We think this is due to a bug in the X libraries
151   provided by HP.  With the alternative X libraries in
152   /usr/contrib/mitX11R5/lib, the problem does not happen.
154   If you are running HP/UX release 8.0 or later, you need the optional
155   "C/ANSI C" software in order to build Emacs (older releases of HP/UX
156   do not require any special software).  If the file "/etc/filesets/C"
157   exists on your machine, you have this software, otherwise you do not.
159   Note that HP has used two incompatible assembler syntaxes,
160   and has recently changed the format of C function frames.
161   `src/crt0.c' and `src/alloca.s' have been conditionalised for the new
162   assembler and new function-entry sequence.  You may need to define
163   OLD_HP_ASSEMBLER if you are using an older hpux version.  If you
164   have an official (bought from HP) series 300 machine you have
165   the new assembler.  Kernels that are 5.+ or later have new
166   assembler.  A Series 200 that has been upgraded to a 68010
167   processor and a 5.+ kernel has the new compiler.
169   Define C_SWITCH_MACHINE to be +X to make a version of Emacs that
170   runs on both 68010 and 68020 based HP/UX's.
172   Define HPUX_68010 if you are using the new assembler, for
173   a system that has a 68010 without a 68881.  This is to say,
174   a s200 (upgraded) or s310.
176   Define the symbol HPUX_NET if you have the optional network features
177   that include the `netunam' system call.  This is referred to as
178   Network Services (NS/9000) in HP literature.
180 HP 9000 series 500: not supported.
182   The series 500 has a seriously incompatible memory architecture
183   which relocates data in memory during execution of a program,
184   and support for it would be difficult to implement.
186 HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux
187                                       or ...hpux9shr, or ...-nextstep)
189   Use hppa1.1 for the 700 series and hppa1.0 for the 800
190   series machines.  (Emacs may not actually care which one you use.)
192   Support for NextSTEP was added in 19.31.
194   Emacs 20 may work on HPUX 10.  You need patch PHSS_6202 to install
195   the Xaw and Xmu libraries.  On HPUX 10.20 you may need to compile with GCC;
196   when Emacs was compiled with HP's C compiler, HP92453-01 A.10.32.03,
197   the subprocess features failed to work.
199   19.26 is believed to work on HPUX 9 provided you compile with GCC.
200   As of version 19.16, Emacs was reported to build (using GCC) and run
201   on HP 9000/700 series machines running HP/UX versions 8.07 and 9.01.
202   The HP compiler is known to fail on some versions if you use +O3,
203   but it may work with lower optimization levels.
205   Use hppa1.1-hp-hpux9shr to use shared libraries on HPUX version 9.
206   You may need to create the X libraries libXaw.a and libXmu.a from
207   the MIT X distribute, and you may need to edit src/Makefile's
208   definition of LIBXT to look like this:
210      LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext
212   Some people report trouble using the GNU memory allocator under
213   HP/UX version 9.  The problems often manifest as lots of ^@'s in the
214   buffer.
216   We are told that these problems go away if you obtain the latest
217   patches for the HP/UX C compiler.  James J Dempsey
218   <jjd@spserv.bbn.com> says that this set of versions works for him:
219     /bin/cc:
220             HP92453-01 A.09.28 HP C Compiler
221     /lib/ccom:
222             HP92453-01 A.09.28 HP C Compiler
223              HP-UX SLLIC/OPTIMIZER  HP-UX.09.00.23  02/18/93
224              Ucode Code Generator - HP-UX.09.00.23.5 (patch)  2/18/93
226   For 700 series machines, the HP-UX patch needed is known as
227   PHSS_2653.  (Perhaps for 800 series machines as well; we don't
228   know.)  If you are on the Internet, you should be able to obtain
229   this patch by using telnet to access the machine
230   support.mayfield.hp.com and logging in as "hpslreg" and following
231   the instructions there.  Or you may be able to use this
232   web site:
234     HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html
235     HP Support Line: http://support.mayfield.hp.com
237   Please do not ask FSF for further support on this.  If you have any
238   trouble obtaining the patch, contact HP Software Support.
240   If your buffer fills up with nulls (^@) at some point, it could well
241   be that problem.  That problem does not happen when people use GCC
242   to compile Emacs.  On the other hand, the HP compiler version 9.34
243   was reported to work for the 19.26 pretest.  9.65 was also reported to work.
245   If you turn on the DSUSP character (delayed suspend),
246   Emacs 19.26 does not know how to turn it off on HPUX.
247   You need to turn it off manually.
249   If you are running HP/UX release 8.0 or later, you need the optional
250   "C/ANSI C" software in order to build Emacs (older releases of HP/UX
251   do not require any special software).  If the file "/etc/filesets/C"
252   exists on your machine, you have this software, otherwise you do not.
254 IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)
256   Changes merged in version 19.  You may need to copy
257   /usr/lib/samples/hft/hftctl.c to the Emacs src directory.
259   i386-ibm-aix1.1 may not work with certain new X window managers, and
260   may be suboptimal.
262 IBM RS/6000 (rs6000-ibm-aix*)
264   Emacs 19.26 is believed to work; its pretest was tested.
266   Compiling with the system's `cc' and CFLAGS containing `-O5' might
267   fail because libXbsd isn't found.  This is a compiler bug;
268   re-configure Emacs so that it isn't compiled with `-O5'.
270   On AIX 4.3.x and 4.4, compiling with /bin/c89 fails because it
271   treats certain warnings as errors.  Use `cc' instead.
273   At last report, Emacs didn't run well on terminals.  Informed
274   persons say that the tty VMIN and VTIME settings have been
275   corrupted; if you have a fix, please send it to us.
277   Compiling with -O using the IBM compiler has been known
278   to make Emacs work incorrectly.  It's reported that on
279   AIX 3.2.5 with an IBM compiler earlier than 1.03.00.14,
280   cc -O fails for some files.  You need to install any
281   PTF containing APAR #IX42810 to bring the compiler to
282   the 1.03.00.14 level to allow optimized compiles.
284   There are reports that IBM compiler versions earlier than 1.03.00.02
285   fail even without -O.  However, another report said that compiler
286   version 1.02.01.00 did work, on AIX 3.2.4, with Emacs 19.31.
288   As of 19.11, if you strip the Emacs executable, it ceases to work.
290   If you are using AIX 3.2.3, you may get a core dump when loading
291   ange-ftp.  You may be able to fix the problem by defining LIBS_TERMCAP
292   as -ltermcap -lcurses.  Please tell us if this fails to work.
294   If anyone can fix the above problems, or confirm that they don't happen
295   with certain versions of various programs, we would appreciate it.
297 IBM System/390 running GNU/Linux (s390-*-linux-gnu)
299   As of Emacs 21.2, a 31-bit only version is supported on this
300   system.
302 Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)
304   18.52 said to work on some sort of ISI machine.
305   Version 18.45 worked (running on a Optimum V (VME bus, 68020)
306   BSD 4.2 (3.05e) system).  18.42 is reported to work on
307   a Qbus 68010 system.  Has not been tried on `WorkStation' `Cluster
308   Compute Node' `Cluster WorkStation' or `Server Node'  (Love the
309   StudLYCaps)
311   Compilation with -O is rumored to break something.
313   On recent system versions, you may need to undefine the macro UMAX
314   in `lib-src/loadst.c' and `src/getpagesize.h'.  They stupidly defined this
315   in a system header file, which confuses Emacs (which thinks that UMAX
316   indicates the Umax operating system).
318 Intel 386 (i386-*-bsdi2,        i386-*-freebsd,  i386-*-linux-gnu,
319            i386-*-sol2.4,       i386-*-sysv3,    i386-intsys-sysv,
320            i386-*-sysv4,        i386-*-sysv4.2,
321            i386-*-sysv5.3,      i386-*-bsd4.2,   i386-*-cygwin,
322            i386-*-bsd386,   i386-*-386bsd,
323            i386-*-msdos,        i386-*-windowsnt.
324            i386... can be replaced with i486... or i586...)
326   In the above configurations, * means that the manufacturer's name
327   you specify does not matter, and you can use any name you like
328   (but it should not contain any dashes or stars).
330   When using the ISC configurations, be sure to specify the isc
331         version number - for example, if you're running ISC 3.0, use
332         i386-unknown-isc3.0 as your configuration name.
333   Use i386-*-linux-gnu for GNU/Linux systems; Emacs runs as of version 19.26.
334   Use i386-*-cygwin for Cygwin; Emacs builds as of version 22.1, in both X11
335   and non-X11 modes.  (The Cygwin site has source and binaries for 21.2.)
336   Use i386-intsys-sysv for Integrated Solutions 386 machines.
337   It may also be correct for Microport systems.
339   On GNU/Linux systems, Emacs 19.23 was said to work properly with libc
340   version 4.5.21, but not with 4.5.19.  If your system uses QMAGIC
341   for the executable format, you must edit config.h to define LINUX_QMAGIC.
343   On GNU/Linux, configure may fail to put these definitions in config.h:
345     #define HAVE_GETTIMEOFDAY
346     #define HAVE_MKDIR
347     #define HAVE_RMDIR
348     #define HAVE_XSCREENNUMBEROFSCREEN
350   To work around the problem, add those definitions by hand.
351   It is possible that this problem happens only with X11R6.
352   Newer system versions have fixed it.
354   The 19.26 pretest was reported to work on SVR4.3 and on Freebsd.
356   19.29 is reported to crash when using Motif on Solaris 2.5.
357   The reasons are not yet known.
359   Use i386-*-bsdiN for BSDI BSD/OS version N; Emacs runs as of version 19.23.
360   In some system versions, `make' is broken; use GNU make instead.
361   Shell bugs in version 1.0 of BSD/OS cause configure
362   to do the wrong thing with --with-x-toolkit; the workaround is to edit
363   configure to run another shell such as bash.
365   For System V release 3, use i386-*-sysv3.
366   For System V release 4, use i386-*-sysv4.
367   For System V release 4.2, use i386-*-sysv4.2.
369   If you are using SCO Unix, see notes at end under SCO.
371   On 386bsd, NetBSD and FreeBSD, at one time, it was necessary to use
372   GNU make, not the system's make.  Assuming it's installed as gmake,
373   do `gmake install MAKE=gmake'.  However, more recently it is
374   reported that using the system Make on NetBSD 1.3.1 works ok.
376   If you are using System V release 4.2, you may find that `cc -E'
377   puts spurious spaces in `src/xmakefile'.  If that happens,
378   specify CPP=/lib/cpp as an option when you run make.
379   There is no problem if you compile with GCC.
381   Note that use of Linux with GCC 2.4 and the DLL 4.4 libraries
382   requires the experimental "net 2" network patches (no relation to
383   Berkeley Net 2).  There is a report that (some version of) Linux
384   requires including `/usr/src/linux/include/linux' in buffer.c
385   but no coherent explanation of why that might be so.  If it is so,
386   in current versions of Linux, something else should probably be changed.
388   Some sysV.3 systems seem to have bugs in `opendir';
389   for them, alter `config.h' to define NONSYSTEM_DIR_LIBRARY
390   and undefine SYSV_SYSTEM_DIR.
392   If you use optimization on V.3, you may need the option -W2,'-y 0'
393   to prevent certain faulty optimization.
395   On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
396   to config.h.
398   On SCO, there are problems in regexp matching when Emacs is compiled
399   with the system compiler.  The compiler version is "Microsoft C
400   version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93;
401   Quick C Compiler Version 1.00.46 (Beta).  The solution is to compile
402   with GCC.
404   On ISC systems (2.02 and more recent), don't try to use the versions
405   of X that come with the system; use XFree86 instead.
407   There is no consistency in the handling of certain system header files
408   on V.3.
410   Some versions have sys/sioctl.h, and require it in sysdep.c.
411   But some versions do not have sys/sioctl.h.
412   For a given version of the system, this may depend on whether you have
413   X Windows or TCP/IP.  Define or undefine NO_SIOCTL_H in config.h
414   according to whether you have the file.
416   Likewise, some versions have been known to need sys/ttold.h, sys/stream.h,
417   and sys/ptem.h included in sysdep.c.  If your system has these files,
418   try defining NEED_PTEM_H in config.h if you have trouble without it.
420   You may find that adding -I/usr/X/include or -I/usr/netinclude or both
421   to CFLAGS avoids compilation errors on certain systems.
423   Some versions convince sysdep.c to try to use `struct tchars'
424   but define `struct tc' instead; add `#define tchars tc'
425   to config.h to solve this problem.
427 Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)
429   Version 18 was said to work; use m68k-sgi-iris3.5 for system version 2.5
430   and m68k-sgi-iris3.6 for system version 3.6.
431   Note that the 3030 is the same as the Iris 2500 Turbo.
433 Iris 4D (mips-sgi-irix[456].*)
435   Emacs 21.3 is reported to work on IRIX 6.5.x.
437   You can build a 64-bit executable (with larger maximum buffer size)
438   on Irix 6.5 by specifying the 64-bit ABI using the `-64' compiler
439   flag or otherwise (see cc(1)).  This may work on earlier Irix 6
440   systems if you edit src/s/irix6-0.h following irix6-5.h.
442   If compiling with GCC on Irix 6 yields an error "conflicting types
443   for `initstate'", install GCC 2.95 or a newer version, and this
444   problem should go away.  It is possible that this problem results
445   from upgrading the operating system without reinstalling GCC; so you
446   could also try reinstalling the same version of GCC, and telling us
447   whether that fixes the problem.
449 Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)
451   The C compiler on Riscos 4.51 dumps core trying to optimize
452   parts of Emacs.  Try without optimization or try GCC.
454   Meanwhile, the linker on that system returns success even if
455   there are undefined symbols; as a result, configure gets the
456   wrong answers to various questions.  No work-around is known
457   except to edit src/config.h by hand to indicate which functions
458   don't exist.
460   Use mips-mips-riscos4.0 for RISCOS version 4.
461   Use mips-mips-bsd with the BSD world.
463   Note that the proper configuration names for DECstations are
464   mips-dec-ultrix and mips-dec-osf.
466   If you are compiling with GCC, then you must run fixincludes;
467   the alternative of using -traditional won't work because
468   the definition of SIGN_EXTEND_CHAR uses the keyword `signed'.
470   If the SYSV world is the default, then you probably need the following
471   line in etc/Makefile:
473     CFLAGS= -g -systype bsd43
475   Some operating systems on MIPS machines give SIGTRAP for division by
476   zero instead of the usual signals.  The only real solution is to fix
477   the system to give a proper signal.
479   In the meantime, you can change init_data in data.c if you wish.
480   Change it to handle SIGTRAP as well as SIGFPE.  But this will have a
481   great disadvantage: you will not be able to run Emacs under a
482   debugger.  I think crashing on division by zero is a lesser problem.
484   dsg@mitre.org reported needing to use --x-libraries=/bsd43/usr/lib
485   on a riscos4bsd site.  But it is not clear whether this is needed in
486   general or only because of quirks on a particular site.
488 NCR Intel system (i386-ncr-sysv4.2)
490   This system works in 19.31, but if you don't link it with GNU ld,
491   you may need to set LD_RUN_PATH at link time to specify where
492   to find the X libraries.
494 NEC EWS4800 (mips-nec-sysv4)
496   This system works in 20.4, but you should use the compiler
497   /usr/abiccs/bin/cc (MIPS ABI MODE).
499 NeXT (m68k-next-nextstep)
501   Emacs 19 has not been tested extensively yet, but it seems to work
502   in a NeXTStep 3.0 terminal window, and under the X server called
503   co-Xist.  You may need to specify -traditional when src/Makefile
504   builds xmakefile.
506   NeXT users might want to implement direct operation with NeXTStep,
507   but from the point of view of the GNU project, that is a
508   distraction.
510   Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19.
512 Pmax (DEC Mips)  (mips-dec-ultrix or mips-dec-osf1)
514   See under DECstation, above.
516 Prime EXL (i386-prime-sysv)
518   Minor changes merged in 19.1.
520 Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4)
522   19.33 has changes to support ptx 4 (a modified SVR4).
524   Emacs 19 should work on Dynix (BSD).  However, if you compile with
525   the Sequent compiler, you may find Emacs does not restore the
526   terminal settings on exit.  If this happens, compile with GCC.
528   Emacs 19.27 contains patches that should support
529   DYNIX/ptx 1.4 and 2.1 with the native cc compiler.
531   GCC can't compile src/process.c due to a non-standard Sequent asm
532   keyword extension supported by cc and used for the network byte/word
533   swapping functions in the PTX /usr/include/netinet/in.h file.  GCC
534   2.5.8 includes the file <sys/byteorder.h> which can be included into
535   netinet/in.h to perform these byte/word swapping functions in the
536   same manner.  Patches have been submitted to the FSF against GCC
537   2.6.0 to fix this problem and allow Emacs to be built with GCC.
539   If your machine does not have TCP/IP installed, you will have to edit the
540   src/s/ptx.h file and comment out #define TCPIP_INSTALLED.
542 Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4)
544   Changes merged in 19.29.  The version configured with
545   `--with-x' works without any modifications, but `--with-x-toolkit'
546   works only if the Athena library and the Toolkit library are linked
547   statically.  For this, edit `src/Makefile' after the `configure' run
548   and modify the lines with `-lXaw' and `-lXt' as follows:
550     LIBW= /usr/lib/libXaw.a
551     LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
553   In addition, `--with-x-toolkit=motif' works only
554   if the Motif library and the Toolkit library are linked statically.
555   To do this, edit `src/Makefile' after the `configure' run
556   and modify the lines with `-lXm' and `-lXt' as follows:
558     LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a
559     LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
561 SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)
563   18.52 worked.  Use m68k-sony-bsd4.3 for system release 3.
565 SONY News 3000 series (RISC NEWS) (mips-sony-bsd)
567   The 19.26 pretest is reported to work.
569   Some versions of the operating system give SIGTRAP for division by zero
570   instead of the usual signals.  This causes division by zero
571   to make Emacs crash.  The system should be fixed to give the proper signal.
572   Changing Emacs is not a proper solution, because it would prevent
573   Emacs from working under any debugger.  But you can change init_data
574   in data.c if you wish.
576 Sun 3, Sun 4 (sparc), Sun 386 (sparc-sun-solaris2.*,
577                                i386-sun-solaris2.*, sparc*-*-linux-gnu)
579   To build a 32-bit Emacs (i.e. if you are having any sort of problem
580   bootstrapping a 64-bit version), you can use the Sun Studio compiler
581   and configure Emacs with:
582     env CC="cc -xarch=v7" CFLAGS='' ./configure    # on SPARC systems
583     env CC="cc -xarch=386" CFLAGS='' ./configure   # on x86 systems
584   On Solaris 2.10, it is also possible to use /usr/sfw/bin/gcc to build
585   a 32-bit version of Emacs.  Just make sure you point ./configure to
586   the right compiler:
588     env CC='/usr/sfw/bin/gcc -m32' ./configure
590   To build a 64-bit Emacs (with larger maximum buffer size and
591   including large file support) on a Solaris system which supports
592   64-bit executables, use the Sun compiler, configuring something like
593   this (see the cc documentation for information on 64-bit
594   compilation):
596     env CC="cc -xarch=v9" CFLAGS='' ./configure    # on SPARC systems
597     env CC="cc -xarch=amd64" CFLAGS='' ./configure # on x86 systems
599   As of version 2.95, GCC doesn't support the 64-bit ABI properly, but
600   later releases may.
602   Some versions of Solaris 8 have a bug in their XIM (X Input Method)
603   implementation which causes Emacs to dump core when one of several
604   frames is closed.  To avoid this, either install patch 108773-12
605   (for Sparc) or 108874-12 (for x86), or configure Emacs with the
606   `--with-xim=no' switch (you can use Leim input methods instead).
608   On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15
609   C 5.0 failed, apparently with non-default CFLAGS, most probably due to
610   compiler bugs.  Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C
611   release was reported to work without problems.  It worked OK on
612   another system with Solaris 8 using apparently the same 5.0 compiler
613   and the default CFLAGS.
615   Emacs 21.1 and 21.2 built with Sun's ProWorks PC3.0.1 compiler on
616   Intel/Solaris 8 was reported to abort and dump core during startup.
617   Using GCC or a newer SUN compiler (Sun WokShop 6 update 2 C 5.3
618   2001/05/15) solves the problem.
620   Emacs 20.5 and later work on SPARC GNU/Linux with the 32-bit ABI.
621   As of release 2.95, GCC doesn't work properly with the 64-bit ABI
622   (applicable on UltraSPARC), but that isn't the default mode.
624   Emacs 20.3 fails to build on Solaris 2.5 if you use GCC 2.7.2.3.
625   Installing GCC 2.8 fixes the problem.
627   19.32 works on Solaris 2.4 and 2.5.  On Solaris 2.5
628   you may need one of these patches to prevent Emacs from crashing
629   when it starts up:
630         103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes)
631         102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes)
632         103242-04: [README] SunOS 5.5: linker patch (595363 bytes)
634   There are reports that using SunSoft cc with -xO4 -xdepend produces
635   bad code for some part of Emacs.
637   Emacs works ok Sunos 4.1.x
638   provided you completely replace your C shared library
639   using one of the SunOS 4.1.x jumbo replacement patches from Sun.
640   Here are the patch numbers for Sunos 4.1.3:
641    100890-10   SunOS 4.1.3: domestic libc jumbo patch
642    100891-10   SunOS 4.1.3: international libc jumbo patch
644   Some people report that Emacs crashes immediately on startup when
645   used with a non-X terminal, but we think this is due to compiling
646   with GCC and failing to use GCC's "fixed" system header files.
648   Some Sun versions of X windows use the clipboard, not the selections,
649   for transferring text between clients.  The Cut, Paste and Copy items
650   in the menu bar Edit menu work with the clipboard.
652   A user reported irreproducible segmentation faults when using 19.29
653   on Solaris 2.3 and 2.4 after compiling it with the Sun compiler.
654   The problem went away when GCC 2.7.0 was used instead.  We do not know
655   whether anything in Emacs is partly to blame for this.
657   X11R6 is set up to make shared libraries only, on Sunos 4.
658   Therefore, in order to link Emacs, you need to create static X libraries.
659   To do this, rebuild X11 after setting
660     #define ForceNormalLib YES
661     #define SeparateSharedCompile YES
662   in site.def (after #ifdef AfterVendorCF).
664   If you compile with Sun's ANSI compiler acc, you need additional options
665   when linking temacs, such as
666      /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
667   (those should be added just before the libraries) and you need to
668   add -lansi just before -lc.  The precise file names depend on the
669   compiler version, so we cannot easily arrange to supply them.
671   On Solaris 2, you need to install patch 100947-02 to fix a system bug.
672   Presumably this patch comes from Sun.  You must alter the definition of
673   LD_SWITCH_SYSTEM if your X11 libraries are not in /usr/openwin/lib.
674   You must make sure that /usr/ucblib is not in your LD_LIBRARY_PATH.
676   On Solaris 2.2, with a multiprocessor SparcCenter 1000, Emacs 19.17 is
677   reported to hang sometimes if it exits while it has one or more
678   subprocesses (e.g. the `wakeup' subprocess used by `display-time').
679   Emacs and its subprocesses become zombies, and in their zombie state
680   slow down their host and disable rlogin and telnet.  This is most
681   likely due to a bug in Solaris 2.2's multiprocessor support,
682   rather than an Emacs bug.
684   On Solaris, do not use /usr/ucb/cc.  Use /opt/SUNWspro/bin/cc.  Make
685   sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before
686   /usr/ucb.  (Most free software packages have the same requirement on
687   Solaris.)  With this compiler, use `/opt/SUNWspro/bin/cc -E' as the
688   preprocessor.  If this inserts extra whitespace into its output (see
689   the PROBLEMS file) then add the option `-Xs'.
691   If you have trouble using open-network-stream, get the distribution
692   of `bind' (the BSD name-server), build libresolv.a, and link Emacs
693   with -lresolv, by copying the #definition of LIBS_SYSTEM in
694   src/s/sunos4-1.h to src/config.h.  This problem is due to obsolete
695   software in the nonshared standard library.
697   Note that Emacs on a Sun is not really as big as it looks.
698   As dumped, it includes around 200k of zeros between the
699   original text section and the original data section
700   (now remapped as part of the text).  These are never
701   swapped in.
703   To build a single Emacs that will run on Sun 2 and Sun 3
704   HARDWARE, just build it on the Sun 2.
706   On Sunos 4.1.3, the word is that Emacs can loop infinitely
707   on startup with X due perhaps to a bug in Sunos.  Installing all of
708   these Sun patches fixes the problem.  We don't know which of them
709   are really relevant.
711     100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03
712     101080-01 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10
713     101134-01 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02
714     101070-01 101145-01 100173-10 100305-15 100383-06 100513-04 100570-05
715     100689-01 101071-03 101200-02 100178-09 100338-05 100421-03 100536-02
716     100584-05 100784-01 101072-01 101207-01
718 Tadpole 68K (m68k-tadpole-sysv)
720   Changes merged in 19.1.
722   You may need to edit Makefile to change the variables LIBDIR and
723   BINDIR from /usr/local to /usr/contrib.
725   To give movemail access to /usr/mail, you may need to execute
727     chmod 2755 etc/movemail; chgrp mail etc/movemail
729 Tandem Integrity S2 (mips-tandem-sysv)
731   Changes merged in 18.56 but subprocess support is turned off.
732   You will probably want to see if you can make subprocesses work.
734   You must edit `lib-src/Makefile' to define LOADLIBES = -mld.
736 Vaxen running Berkeley Unix (vax-dec-bsd4.1, vax-dec-bsd4.2, vax-dec-bsd4.3),
737               Ultrix (vax-dec-ultrix),
738               System V (vax-dec-sysv0, vax-dec-sysv2), or
739               VMS (vax-dec-vms)
741   Works.
743   See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).
745   18.27 worked on System V rel 2 (vax-dec-sysv2).
747   18.36 worked on System V rel 0 (vax-dec-sysv0).
749   Richard Levitte <levitte@e.kth.se> distributes a set of patches to
750   Emacs 18.59 to make it work nicely under VMS.  Emacs 19 probably
751   won't work very well, or even compile.  Levitte is working on a
752   port, so these problems should be fixed in the near future.
755 Here are notes about some of the systems supported:
757 Berkeley 4.1 (bsd4.1)
759   Works on vaxes.
761 Berkeley 4.2 (bsd4.2)
763   Works on several machines.
765 Berkeley 4.3 (bsd4.3)
767   Works, on Vaxes at least.
769 Linux (actually GNU/Linux)
771   Most of the complete systems which use the Linux kernel are close
772   enough to the GNU system to be considered variant GNU systems.  We
773   call them "Linux-based GNU systems," or GNU/Linux for short.
775   It is not coincidence that many of the other components used with
776   Linux--including GNU Emacs--were developed specifically for the GNU
777   project.  The GNU project was launched in 1984 to develop a free
778   complete Unix-like operating system.  To reach this goal, we had to
779   develop whatever system components were not available as freely
780   redistributable software from some other source.
782   The GNU project wants users of GNU/Linux systems to be aware of how
783   these systems relate to the GNU project, because that will help
784   spread the GNU idea that software should be free--and thus encourage
785   people to write more free software.  See the file LINUX-GNU in this
786   directory for more explanation.
788 Microport
790   See under "Intel 386".
792 MSDOS
794   For installation on MSDOS, see the file INSTALL (search for `MSDOG',
795   near the end of the file).  See the "MS-DOS" chapter of the manual
796   for information about using Emacs on MSDOS.
798 SCO Unix
800   If you are using MMDF instead of sendmail, you need to remove
801   /usr/lib/sendmail or modify lisp/paths.el before compiling.
802   lisp/paths.el (which is loaded during the build) will attempt to use
803   sendmail if it exists.
805   If you are using SMAIL, you need to define the macro
806   SMAIL in config.h.
808 System V rel 0 (usg5.0)
810   Works, on Vaxes and 3bxxx's.
811   There are some problems in 18.37 due to shortnames/cccp problems:
812   use the emacs 17 cpp if you have it.
814 System V rel 2 (usg5.2)
816   Works on various machines.
817   On some (maybe all) machines the library -lPW exists and contains
818   a version of `alloca'.  On these machines, to use it, put
819      #define HAVE_ALLOCA
820      #define LIB_STANDARD -lPW -lc
821   in the `src/m/MACHINENAME.h' file for the machine.
823   If you find that the character Meta-DEL makes Emacs crash,
824   find where function init_sys_modes in sysdep.c sets sg.c_cc[VQUIT]
825   and make it store 7 there.  I have as yet no evidence of whether
826   this problem, known in HP/UX, exists in other system V versions.
828 System V rel 2.2 (usg5.2.2)
830   In 5.2.2 AT&T undid, incompatibly, their previous incompatible
831   change to the way the nlist library is called.  A different s- file
832   is used to enable the other interface.
834   They call themselves the right choice--can't they choose?
836   Emacs version 18 unexec is currently not working properly
837   on 5.2.2.  Nobody knows why yet.  A workaround is to define
838   NO_REMAP.  It is not yet known whether this applies to all
839   machines running 5.2.2.
841 System V rel 3 (usg5.3)
843   Some versions of this system support ptys and BSD-style sockets.
844   On such systems, you should define HAVE_PTYS and HAVE_SOCKETS in config.h.
846   If you want to link Emacs with shared libraries, define
847   USG_SHARED_LIBRARIES.
849   You may have to add ANSI idempotence #-lines to your sys/types.h
850   file to get Emacs to compile correctly.  This may be necessary on
851   other pre-ANSI systems as well.
853   On an AT&T 6386WGS using System V Release 3.2 and X11R3, the X support
854   cannot be made to work.  Whether or not the GNU relocating malloc is
855   used, the symptom is that the first call Emacs makes to sbrk(0) returns
856   (char *)-1.  Sorry, you're stuck with character-only mode.  Try
857   installing XFree86 to fix this.
859 System V rel 4.0.3 and 4.0.4 (usg5.4)
861   Supported, including shared libraries for ELF, but ptys do not work
862   because TIOCGPGRP fails to work on ptys (but Dell 2.2 seems to have
863   fixed this).  This failure is probably due to a misunderstanding of
864   the consequences of the POSIX spec: many system designers mistakenly
865   think that POSIX requires this feature to fail.  This is untrue;
866   ptys are an extension, and POSIX says that extensions *when used*
867   may change the action of standard facilities in any fashion.
869   If you get compilation errors about wrong number of
870   arguments to getpgrp, define GETPGRP_NO_ARG.
872   The standard C preprocessor may generate xmakefile incorrectly.  However,
873   /lib/cpp will work, so use `make CPP=/lib/cpp'.  Standard cpp
874   seems to work OK under Dell 2.2.
876   Some versions 3 and earlier of V.4, on the Intel 386 and 860, had
877   problems in the X11 libraries.  These prevent Emacs from working
878   with X.  You can use Emacs with X provided your copy of X is based
879   on X11 release 4 or newer, or is Dell's 2.2 (which is a 4.0.3).
880   Unfortunately, the only way you can tell whether your X11 library is
881   new enough is to try compiling Emacs to use X.  If emacs runs, your
882   X11 library is new enough.
884   In this context, GSV4 and GSV4i are alternate names for X11R4.
885   OL2.* is X11R3 based.  OL3 is in between X11R3 and X11R4, and may or
886   may not work, depending on who made the Unix system.  If the library
887   libXol is part of the X distribution, then you have X11R3 and Emacs
888   won't work with X.
890   Most versions of V.4 support sockets.  If `/usr/lib/libsocket.so'
891   exists, your system supports them.  If yours does not, you must add
892   #undef HAVE_SOCKETS in config.h, after the inclusion of s-usg5-4.h.
893   (Any system that supports Internet should implement sockets.)
895 Ultrix (bsd4.3)
897   Recent versions of Ultrix appear to support the features of Berkeley 4.3.
898   Ultrix was at the BSD 4.2 level for a long time after BSD 4.3 came out.
900   Ultrix 3.0 has incompatibilities in its X library if you have the
901   Ultrix version of X (UWS version 2.0).  To solve them, you need to
902   prevent XvmsAlloc.o in Xlib from being used.  Israel Pinkas says:
904     I added the following lines to config.h after the X defines:
906     #if defined(ultrix) && defined(X11)
907     #define OBJECTS_SYSTEM calloc.o
908     #endif
910     Then I ran the following:
912     ar x /usr/lib/libc.a calloc.o
914   The problem is said to be gone in UWS version 2.1.
916 VMS (vmsM.N)
918   Richard Levitte <levitte@e.kth.se> distributes a set of patches to
919   Emacs 18.59 to make it work nicely under VMS.  Emacs 19 probably
920   won't work very well, or even compile.  Levitte is working on a
921   port, so these problems should be fixed in the near future.
923   Note that Emacs for VMS is usually distributed in a special VMS
924   distribution.  See the file ../vms/VMSINSTALL for info on moving
925   Unix distributions to VMS, and other VMS-related topics.
927 Windows NT/95/98/ME/2000
929   For installation on all versions of the MS-Windows platform, see the
930   file nt/INSTALL.
932 X86_64 GNU/Linux
934   No special procedures should be needed to build a 64-bit Emacs.  To
935   build a 32-bit Emacs, first ensure that the necessary 32-bit system
936   libraries and include files are installed.  Then use:
938     env CC="gcc -m32" ./configure --build=i386-linux-gnu \
939       --x-libraries=/usr/X11R6/lib
941   (using the location of the 32-bit X libraries on your system).
943 Support for the following obsolete platforms was removed in Emacs 23.1
944 (the names in parentheses state the files in src/ that were removed):
946   Apollo SR10.x (unexapollo.c)
947   Convex (unexconvex.c and m/convex.c)
948   Xenix (unexenix.c and s/xenix.h)
949   Iris  (unexmips.c m/iris4d.h m/irist.h s/iris3-5.h s/iris3-6.h)
950   Gould (m/gould*)
951   Siemens machines running Sinix (unexsni.c)
952   Harris CXUX (s/cxux*)
953   ESIX, a variant of v.5.3 for the 386 (s/esix*)
954   Interactive (ISC) Unix (s/isc*)
955   Sony News (s/newsos*)
956   RTU 3.0, ucb universe (s/rtu.h)
957   UniSoft's UniPlus 5.2 (s/uniplus.h)
958   UMAX (s/umax.h)
959   AT&T UNIX PC model 7300 (m/7300.h)
960   Acorn
961   Alliant (m/alliant*)
962   Amdahl (m/amdahl*)
963   Altos 3068 Unix System V Release 2 (m/altos.h)
964   Apollo (m/apollo.h)
965   AT&T 3b (m/att3b.h)
966   Aviion (m/aviion*)
967   Celerity (m/celerity.h)
968   clipper (m/clipper.h)
969   convergent S series (m/cnvrgnt.h)
970   cydra (m/cydra5.h)
971   Motorola System V/88 machines (m/delta88k.h)
972   Bull DPX/2 range (m/dpx2.h)
973   Dual machines using unisoft port (m/dual.h)
974   Elxsi machine (running enix) (m/elxsi.h)
975   Fujitsu F301 machine (m/f301.h)
976   i860 (m/i860.h)
977   ibm ps/2 aix386 (m/ibmps2-aix.h)
978   ISI 68000's (m/is*)
979   Masscomp 5000 series running RTU, ucb universe (m/masscomp.h)
980   Megatest 68000's (m/mega68.h)
981   Whitechapel Computer Works MG1 (ns16000 based) (m/mg1.h)
982   Harris Night Hawk Series 1200 and Series 3000 (m/nh3000.h m/nh4000.h)
983   ns16000 (m/ns16000.h)
984   National Semiconductor 32000, running Genix (m/ns32000.h)
985   TI Nu machines using system V (m/nu.h)
986   HLH Orion (m/orion.h m/orion105.h)
987   Paragon i860 (m/paragon.h)
988   PFU A-series (m/pfa50.h)
989   Plexus running System V.2 (m/plexus.h)
990   pyramid. (m/pyramid.h)
991   sh3el (m/sh3el.h)
992   Bull SPS-7 (m/sps7.h)
993   Hitachi SR2001/SR2201 (m/sr2k.h)
994   Stride (m/stride.h)
995   Sun 1 (m/sun1.h)
996   Sun 2 (m/sun2.h)
997   SEQUENT SYMMETRY  (m/symmetry.h)
998   Tadpole 68k machines (m/tad68k.h)
999   tahoe (m/tahoe.h)
1000   targon31 (m/targon31.h)
1001   Tektronix* (m/tek4300.h m/tekxd88.h)
1002   NCR Tower 32 running System V.2 (m/tower32.h)
1003   NCR Tower 32 running System V.3 (m/tower32v3.h)
1004   U-station (Nihon Unisys, SS5E; Sumitomo Denkoh, U-Station E30) (m/ustation.h)
1005   Wicat (m/wicat.h)
1006   Honeywell XPS100 running UNIX System V.2 (m/xps100.h)
1007   Data General's DG/UX  (s/dgux*)
1008   Irix before version 6
1009   osf1 (s/osf*)
1010   SunOS4 (s/sunos*)
1011   RISCiX (s/riscix*)
1012   SCO 3.2v4 (s/sco4.h)
1013   SCO 3.2v5 (s/sco5.h)
1014   Sun's 386-based RoadRunner (m/sun386.h)
1015   Sun3 machines (m/sun3*)
1016   Integrated Solutions 386 machine (m/is386.h)
1019 Local variables:
1020 mode: text
1021 fill-prefix: "  "
1022 End:
1024 This file is part of GNU Emacs.
1026 GNU Emacs is free software; you can redistribute it and/or modify
1027 it under the terms of the GNU General Public License as published by
1028 the Free Software Foundation; either version 3, or (at your option)
1029 any later version.
1031 GNU Emacs is distributed in the hope that it will be useful,
1032 but WITHOUT ANY WARRANTY; without even the implied warranty of
1033 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1034 GNU General Public License for more details.
1036 You should have received a copy of the GNU General Public License
1037 along with GNU Emacs; see the file COPYING.  If not, write to the
1038 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
1039 Boston, MA 02110-1301, USA.
1041 arch-tag: 7d2e93c7-e982-40ec-9055-3cd064042473