1Emacs machines list
2
3Copyright (C) 1989, 1990, 1992, 1993, 1998, 2001, 2002, 2003, 2004,
4  2005, 2006, 2007  Free Software Foundation, Inc.
5See the end of the file for license conditions.
6
7This is a list of the status of GNU Emacs on various machines and systems.
8
9For each system and machine, we give the configuration name you should
10pass to the `configure' script to prepare to build Emacs for that
11system/machine.
12
13The `configure' script uses the configuration name to decide which
14machine and operating system description files `src/config.h' should
15include.  The machine description files are all in `src/m', and have
16names similar to, but not identical to, the machine names used in
17configuration names.  The operating system files are all in `src/s',
18and are named similarly.  See the `configure' script if you need to
19know which configuration names use which machine and operating system
20description files.
21
22If you add support for a new configuration, add a section to this
23file, and then edit the `configure' script to tell it which
24configuration name(s) should select your new machine description and
25system description files.
26
27
28Here are the configurations Emacs is intended to work with, with the
29corresponding configuration names.  You can postpend version numbers
30to operating system names (i.e. sunos4.1) or architecture names (i.e.
31hppa1.1).  If you leave out the version number, the `configure' script
32will configure Emacs for the latest version it knows about.
33
34Acorn RISCiX (arm-acorn-riscix1.2)
35
36  Emacs 19.29 has changes that ought to support RISCiX 1.2.
37
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).
40
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!
43
44    GNU sed should be configured with:
45
46    env 'DEFS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \
47            -Doptarg=gnu_optarg' ./configure
48
49    GNU make (3.72+) should be configured with:
50
51    env 'CFLAGS=-Dgetopt=gnu_getopt -Dopterr=gnu_opterr -Doptind=gnu_optind \
52              -Doptarg=gnu_optarg' ./configure
53
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:
57
58  LIBW= -lXaw_n
59
60  This ensures that the non-shared widget library is used.
61
62  It is unlikely that this version of emacs will work with RISCiX 1.1.
63
64Alliant (fx80-alliant-bsd):
65
66  18.52 worked on system version 4.  Previous Emacs versions were
67  known to work on previous system versions.
68
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).
72
73Alliant FX/2800 (i860-alliant-bsd)
74
75  Known to work with 19.26 and OS version 2.2, compiler version 1.3.
76
77Alpha (DEC) running OSF/1 or GNU/Linux (alpha-dec-osf1, alpha-dec-linux-gnu)
78
79  For OSF/1 (aka Digital Unix) version 4.0, update 386,
80  it is reported that you need to run configure this way:
81
82      configure --x-includes=/usr/include --x-libraries=/usr/shlib
83
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.
88
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".
94
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).
98
99Altos 3068 (m68k-altos-sysv)
100
101  18.52 was said to work, provided you don't compile unexec.c with -O.
102
103Amdahl UTS (580-amdahl-sysv)
104
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.
111
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.
115
116Apple Macintosh running Mac OS X
117
118  For installation on all versions of the Mac OS platform, see the file
119  mac/INSTALL.
120
121Apple PowerPC Macintosh running GNU/Linux
122
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:
128
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 */
140
141  After that, reconfigure and rebuild Emacs.  It should now build
142  successfully.
143
144Apollo running X Windows (m68k-apollo-bsd)
145
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.
149
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.
154
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.
158
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.
161
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.
166
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.
172
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.
178
179  Check out the file 'lisp/x-apollo.el'.  To use it, add
180
181        (load "x-apollo")
182
183  to your .emacs file.  It provides useful default Apollo function key
184  bindings.
185
186AT&T 3b2, 3b5, 3b15, 3b20 (we32k-att-sysv)
187
188  Emacs will probably not work with certain kernel constants too small.
189
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.
196
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.
200
201  The MAXMEM may also prevent Emacs from running.  The file
202  3B-MAXMEM in this directory explains how to increase MAXMEM.
203
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.
208
209AT&T 7300 or 3b1 (m68k-att-sysv)
210
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.
214
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.
219
220Bull DPX/2 models 2nn or 3nn (m68k-bull-sysv3)
221
222  Minor fixes merged into 19.19, which should work with CC or GCC.
223
224  You should compile with all the POSIX stuff: undef _SYSV and define
225  _POSIX_SOURCE, _XOPEN_SOURCE and _BULL_SOURCE.
226
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.
230
231Bull DPX/20 (rs6000-bull-bosx)
232
233  Version 19 works.
234
235Bull sps7 (m68k-bull-sysv2)
236
237  Changes partially merged in version 19, but some fixes are probably required.
238
239CCI 5/32, 6/32
240
241  See "Tahoe".
242
243Celerity (celerity-celerity-bsd4.2)
244
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.
249
250Clipper (clipper-???)
251
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.
255
256  Note that the Orion 105 is also a clipper, but some system-related
257  parameters are different.
258
259Convex (c1-convex-bsd, c2-convex-bsd, c32-convex-bsd, c34-convex-bsd,
260        c38-convex-bsd)
261
262  Support updated and residual bugs fixed in 19.26.
263
264Cubix QBx/386 (i386-cubix-sysv)
265
266  Changes merged in 19.1.  Systems before 2/A/0 may fail to compile etags.c
267  due to a compiler bug.
268
269Cydra 5 (cydra-cydrome-sysv)
270
271  18.51 worked in one version of their operating system but stopped
272  working in a newer version.  This has not been fixed.
273
274Data General Aviion (m88k-dg-dgux)
275
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.
280
281  DGUX 5.4R3.10 works with 19.29 and 19.30.
282
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.
288
289DECstation (mips-dec-ultrix or mips-dec-osf)
290
291  This machine is the older Mips-based DECstation.
292  Emacs should now work on the Alpha CPU.
293
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.
296
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.
299
300  See under Ultrix for problems using X windows on Ultrix.
301  Note that this is a MIPS machine.
302
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.
306
307  For Ultrix versions prior to 4.0, you may need to delete
308  the definition of START_FILES from `src/m/pmax.h'.
309
310Motorola Delta 147 (m68k-motorola-sysv)
311
312  The EMacs 19.26 pretest was reported to work.
313
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.
318
319  The installation script chooses the compiler itself.  gnucc is
320  preferred.
321
322Motorola Delta 187 (m88k-motorola-sysv,
323		    m88k-motorola-sysvr4, or
324		    m88k-motorola-m88kbcs)
325
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.
330
331  As of version 19.13, Emacs was reported to run under SYSVr3 and SYSVr4.
332
333Dual running System V (m68k-dual-sysv)
334
335  As of 17.46, this worked except for a few changes
336  needed in unexec.c.
337
338Dual running Uniplus (m68k-dual-uniplus)
339
340  Worked, as of 17.51.
341
342Elxsi 6400 (elxsi-elxsi-sysv)
343
344  Changes for 12.0 release are in 19.1.
345  Dumping should work now.
346
347Encore machine (ns16k-encore-bsd)
348
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.
353
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.
357
358  A kernel bug in some system versions causes input characters to be lost
359  occasionally.
360
361Fujitsu DS/90 (sparc-fujitsu-sysv4)
362
363  Changes merged in 20.3.
364
365GEC 63 (local-gec63-usg5.2)
366
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.
370
371Gould Power Node (pn-gould-bsd4.2 or pn-gould-bsd4.3)
372
373  18.36 worked on versions 1.2 and 2.0 of the operating system.
374
375  On UTX/32 2.0, use pn-gould-bsd4.3.
376
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.
380
381  UTX/32 1.3 has a bug in the bcopy library routine.  Fix it by
382  #undef BSTRING in `src/m/gould.h'.
383
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.
386
387Gould NP1 (np1-gould-bsd)
388
389  Version 19 supposedly works.
390
391Harris Night Hawk (m68k-harris-cxux or m88k-harris-cxux)
392
393  This port was added in 19.23.  The configuration actually tested was
394  a Night Hawk 4800 running CX/UX 7.0.
395
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.
398
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.
402
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).
406
407Harris Power PC (powerpc-harris-powerunix)
408
409  Patches have been merged in 19.31.
410
411Honeywell XPS100 (xps100-honeywell-sysv)
412
413  Config file added in version 19.
414
415Hewlett-Packard 9000 series 200 or 300 (m68k-hp-bsd or m68k-hp-hpux
416				        or m68k-hp-netbsd)
417
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.
421
422  Series 200 HPUX runs Emacs only if it has the "HP/UX upgrade".
423
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.
429
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.
434
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.
439
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.
449
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.
452
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.
456
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.
460
461HP 9000 series 500: not supported.
462
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.
466
467HP 9000 series 700 or 800 (Spectrum) (hppa1.0-hp-hpux or hppa1.1-hp-hpux
468				      or ...hpux9shr, or ...-nextstep)
469
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.)
472
473  Support for NextSTEP was added in 19.31.
474
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.
479
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.
485
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:
490
491     LIBXT= $(LIBW) -lXmu -lXt $(LIBXTR6) -lXext
492
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.
496
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
506
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:
514
515    HP Patch Server: http://support.mayfield.hp.com/patches/html/patches.html
516    HP Support Line: http://support.mayfield.hp.com
517
518  Please do not ask FSF for further support on this.  If you have any
519  trouble obtaining the patch, contact HP Software Support.
520
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.
525
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.
529
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.
534
535High Level Hardware Orion (orion-highlevel-bsd)
536
537  This is the original microprogrammed hardware.
538  Machine description file ought to work.
539
540High Level Hardware Orion 1/05 (clipper-highlevel-bsd)
541
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'.
544
545  C compiler has a bug; it loops compiling eval.c.
546  Compile it by hand without optimization.
547
548HITACHI SR2001/SR2201 series (hppa1.1-hitachi-hiuxwe2)
549
550  These machines are based on PA architecture running HI-UX/MPP
551  (based on OSF1. `MPP' stands for `Massively Parallel Processor').
552
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').
556
557  Emacs 20.7 was reported to build on a system whose `uname -rs'
558  output is `HI-UX/MPP 03-04'.
559
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.
563
564IBM PS/2 (i386-ibm-aix1.1 or i386-ibm-aix1.2)
565
566  Changes merged in version 19.  You may need to copy
567  /usr/lib/samples/hft/hftctl.c to the Emacs src directory.
568
569  i386-ibm-aix1.1 may not work with certain new X window managers, and
570  may be suboptimal.
571
572IBM RS/6000 (rs6000-ibm-aix*)
573
574  Emacs 19.26 is believed to work; its pretest was tested.
575
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'.
579
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.
582
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.
586
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.
593
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.
597
598  As of 19.11, if you strip the Emacs executable, it ceases to work.
599
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.
603
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.
606
607IBM RT/PC (romp-ibm-bsd or romp-ibm-aix)
608
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.
611
612  On BSD, if you have trouble, try compiling with a different compiler.
613
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).
617
618  window.c must not be compiled with -O on AIX.
619
620IBM System/390 running GNU/Linux (s390-*-linux-gnu)
621
622  As of Emacs 21.2, a 31-bit only version is supported on this
623  system.
624
625Integrated Solutions `Optimum V' (m68k-isi-bsd4.2 or -bsd4.3)
626
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)
633
634  Compilation with -O is rumored to break something.
635
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).
640
641Intel 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...)
649
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).
653
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.
664
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.
668
669  On GNU/Linux, configure may fail to put these definitions in config.h:
670
671    #define HAVE_GETTIMEOFDAY
672    #define HAVE_MKDIR
673    #define HAVE_RMDIR
674    #define HAVE_XSCREENNUMBEROFSCREEN
675
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.
679
680  The 19.26 pretest was reported to work on SVR4.3 and on Freebsd.
681
682  19.29 is reported to crash when using Motif on Solaris 2.5.
683  The reasons are not yet known.
684
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.
690
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.
694
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.
698
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.
703
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.
708
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.
715
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.
719
720  If you use optimization on V.3, you may need the option -W2,'-y 0'
721  to prevent certain faulty optimization.
722
723  On 386/ix, to link with shared libraries, add #define USG_SHARED_LIBRARIES
724  to config.h.
725
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.
731
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.
734
735  There is no consistency in the handling of certain system header files
736  on V.3.
737
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.
743
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.
747
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.
750
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.
754
755Iris 2500 and Iris 2500 Turbo (m68k-sgi-iris3.5 or m68k-sgi-iris3.6)
756
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.
760
761Iris 4D (mips-sgi-irix[456].*)
762
763  Emacs 21.3 is reported to work on IRIX 6.5.x.
764
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.
769
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.
776
777Masscomp (m68k-masscomp-rtu)
778
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.
783
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.
789
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.
792
793  GNU Emacs is said to have no chance of compiling on RTU versions
794  prior to v3.0.
795
796Megatest (m68k-megatest-bsd)
797
798  Emacs 15 worked; do not have any reports about Emacs 16 or 17
799  but any new bugs are probably not difficult.
800
801Mips (mips-mips-riscos, mips-mips-riscos4.0, or mips-mips-bsd)
802
803  The C compiler on Riscos 4.51 dumps core trying to optimize
804  parts of Emacs.  Try without optimization or try GCC.
805
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.
811
812  Use mips-mips-riscos4.0 for RISCOS version 4.
813  Use mips-mips-bsd with the BSD world.
814
815  Note that the proper configuration names for DECstations are
816  mips-dec-ultrix and mips-dec-osf.
817
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'.
821
822  If the SYSV world is the default, then you probably need the following
823  line in etc/Makefile:
824
825    CFLAGS= -g -systype bsd43
826
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.
830
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.
835
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.
839
840National Semiconductor 32000 (ns32k-ns-genix)
841
842  This is for a complete machine from National Semiconductor,
843  running Genix.  Changes merged in version 19.
844
845NCR Tower 32 (m68k-ncr-sysv2 or m68k-ncr-sysv3)
846
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.
849
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.
854
855  There is a report that compilation with -O did not work with 18.54
856  under System V release 2.
857
858NCR Intel system (i386-ncr-sysv4.2)
859
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.
863
864NEC EWS4800 (mips-nec-sysv4)
865
866  This system works in 20.4, but you should use the compiler
867  /usr/abiccs/bin/cc (MIPS ABI MODE).
868
869NeXT (m68k-next-nextstep)
870
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.
875
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.
879
880  Thanks to Thorsten Ohl for working on the NeXT port of Emacs 19.
881
882Nixdorf Targon 31 (m68k-nixdorf-sysv)
883
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.
888
889Nu (TI or LMI) (m68k-nu-sysv)
890
891  Version 18 is believed to work.
892
893Paragon OSF/1 (i860-intel-osf1)
894
895  Changes merged in 19.29.
896
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:
899
900        pmake MAKE=pmake
901
902Plexus (m68k-plexus-sysv)
903
904  Worked as of 17.56.
905
906Pmax (DEC Mips)  (mips-dec-ultrix or mips-dec-osf1)
907
908  See under DECstation, above.
909
910Prime EXL (i386-prime-sysv)
911
912  Minor changes merged in 19.1.
913
914Pyramid (pyramid-pyramid-bsd)
915
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.
919
920  You need to build Emacs in the Berkeley universe with
921  the `ucb' command, as in `ucb make' or `ucb build-install'.
922
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
927
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.
932
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.
937
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.
940
941Sequent Balance (ns32k-sequent-bsd4.2 or ns32k-sequent-bsd4.3)
942
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.
946
947Sequent Symmetry (i386-sequent-bsd, i386-sequent-ptx, i386-sequent-ptx4)
948
949  19.33 has changes to support ptx 4 (a modified SVR4).
950
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.
954
955  Emacs 19.27 contains patches that should support
956  DYNIX/ptx 1.4 and 2.1 with the native cc compiler.
957
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.
965
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.
968
969Siemens Nixdorf RM600 and RM400 (mips-siemens-sysv4)
970
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:
977
978    LIBW= /usr/lib/libXaw.a
979    LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
980
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:
985
986    LIBW= /usr/lib/libXm.a /usr/ccs/lib/libgen.a
987    LIBXT= $(LIBW) -lXmu /usr/lib/libXt.a $(LIBXTR6) -lXext
988
989SONY News (m68k-sony-bsd4.2 or m68k-sony-bsd4.3)
990
991  18.52 worked.  Use m68k-sony-bsd4.3 for system release 3.
992
993SONY News 3000 series (RISC NEWS) (mips-sony-bsd)
994
995  The 19.26 pretest is reported to work.
996
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.
1003
1004Stardent i860 (i860-stardent-sysv4.0)
1005
1006  19.26 pretest reported to work.
1007
1008Stardent 1500 or 3000
1009
1010  See Titan.
1011
1012Stride (m68k-stride-sysv)
1013
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.
1018
1019Sun 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)
1022
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:
1031
1032    env CC='/usr/sfw/bin/gcc -m32' ./configure
1033
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):
1039
1040    env CC="cc -xarch=v9" CFLAGS='' ./configure    # on SPARC systems
1041    env CC="cc -xarch=amd64" CFLAGS='' ./configure # on x86 systems
1042
1043  As of version 2.95, GCC doesn't support the 64-bit ABI properly, but
1044  later releases may.
1045
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).
1051
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.
1058
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.
1063
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.
1067
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.
1070
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)
1077
1078  There are reports that using SunSoft cc with -xO4 -xdepend produces
1079  bad code for some part of Emacs.
1080
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
1087
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.
1091
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.
1095
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.
1102
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.
1107
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).
1114
1115  Use `m68k' for the 68000-based Sun boxes, `sparc' for Sparcstations,
1116  and `i386' for Sun Roadrunners.  i386 calls for Sunos4.0.
1117
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.
1124
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.
1127
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.
1134
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.
1139
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.
1147
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'.
1154
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.
1160
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.
1165
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.
1171
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'.
1175
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.
1181
1182  To build a single Emacs that will run on Sun 2 and Sun 3
1183  HARDWARE, just build it on the Sun 2.
1184
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.
1189
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
1196
1197Tadpole 68K (m68k-tadpole-sysv)
1198
1199  Changes merged in 19.1.
1200
1201  You may need to edit Makefile to change the variables LIBDIR and
1202  BINDIR from /usr/local to /usr/contrib.
1203
1204  To give movemail access to /usr/mail, you may need to execute
1205
1206    chmod 2755 etc/movemail; chgrp mail etc/movemail
1207
1208Tahoe (tahoe-tahoe-bsd4.2 or tahoe-tahoe-bsd4.3)
1209
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.
1213
1214  If you have trouble compiling `lib-src/loadst.c', turn off the definition
1215  of DKSTAT_HEADER_FILE in `src/m/tahoe.h'.
1216
1217Tandem Integrity S2 (mips-tandem-sysv)
1218
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.
1221
1222  You must edit `lib-src/Makefile' to define LOADLIBES = -mld.
1223
1224Tektronix XD88 (m88k-tektronix-sysv3*)
1225
1226  The 19.26 pretest was reported to work.
1227  Minor changes merged in 19.19.
1228
1229Tektronix 16000 box (6130?) (ns16k-tektronix-bsd)
1230
1231  Emacs 17.61 worked.
1232
1233Tektronix 4300 (m68k-tektronix-bsd)
1234
1235  Emacs 19.26 pretest reported to work.
1236
1237Titan P2 or P3 (titan-titan-sysv)
1238
1239  Changes probably merged in version 19.
1240
1241Ustation E30 (SS5E) (m68k-unisys-unipl)
1242
1243  Changes merged in 18.52; don't know whether they work.
1244
1245Vaxen 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)
1249
1250  Works.
1251
1252  See under Ultrix for problems using X windows on Ultrix (vax-dec-ultrix).
1253
1254  18.27 worked on System V rel 2 (vax-dec-sysv2).
1255
1256  18.36 worked on System V rel 0 (vax-dec-sysv0).
1257
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.
1262
1263Whitechapel MG1 (ns16k-whitechapel-?)
1264
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.
1267
1268Wicat (m68k-wicat-sysv)
1269
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.
1273
1274Here are notes about some of the systems supported:
1275
1276Berkeley 4.1 (bsd4.1)
1277
1278  Works on vaxes.
1279
1280Berkeley 4.2 (bsd4.2)
1281
1282  Works on several machines.
1283
1284Berkeley 4.3 (bsd4.3)
1285
1286  Works, on Vaxes at least.
1287
1288Esix
1289
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.
1292
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.
1301
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.
1306
1307Linux (actually GNU/Linux)
1308
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.
1312
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.
1319
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.
1325
1326Microport
1327
1328  See under "Intel 386".
1329
1330MSDOS
1331
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.
1335
1336SCO Unix
1337  If you have TCP but not X, you need to edit src/s/sco4.h
1338  to define HAVE_SOCKETS.
1339
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.
1344
1345  If you are using SMAIL, you need to define the macro
1346  SMAIL in config.h.
1347
1348System V rel 0 (usg5.0)
1349
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.
1353
1354System V rel 2 (usg5.2)
1355
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.
1362
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.
1367
1368System V rel 2.2 (usg5.2.2)
1369
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.
1373
1374  They call themselves the right choice--can't they choose?
1375
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.
1380
1381System V rel 3 (usg5.3)
1382
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.
1385
1386  If you want to link Emacs with shared libraries, define
1387  USG_SHARED_LIBRARIES.
1388
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.
1392
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.
1398
1399System V rel 4.0.3 and 4.0.4 (usg5.4)
1400
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.
1408
1409  If you get compilation errors about wrong number of
1410  arguments to getpgrp, define GETPGRP_NO_ARG.
1411
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.
1415
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.
1423
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.
1429
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.)
1434
1435Ultrix (bsd4.3)
1436
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.
1439
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:
1443
1444    I added the following lines to config.h after the X defines:
1445
1446    #if defined(ultrix) && defined(X11)
1447    #define OBJECTS_SYSTEM calloc.o
1448    #endif
1449
1450    Then I ran the following:
1451
1452    ar x /usr/lib/libc.a calloc.o
1453
1454  The problem is said to be gone in UWS version 2.1.
1455
1456Uniplus 5.2 (unipl5.2)
1457
1458  Works, on Dual machines at least.
1459
1460VMS (vmsM.N)
1461
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.
1466
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.
1470
1471Windows NT/95/98/ME/2000
1472
1473  For installation on all versions of the MS-Windows platform, see the
1474  file nt/INSTALL.
1475
1476X86_64 GNU/Linux
1477
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:
1481
1482    env CC="gcc -m32" ./configure --build=i386-linux-gnu \
1483      --x-libraries=/usr/X11R6/lib
1484
1485  (using the location of the 32-bit X libraries on your system).
1486
1487Xenix (xenix)
1488
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.
1493
1494  If you want Emacs to work with Smail (installed as /usr/bin/smail)
1495  then add the line   #define SMAIL  to config.h.
1496
1497  The file etc/XENIX suggests some useful things to do to Xenix
1498  to make the Emacs meta key work.
1499
1500Local variables:
1501mode: text
1502fill-prefix: "  "
1503End:
1504
1505This file is part of GNU Emacs.
1506
1507GNU Emacs is free software; you can redistribute it and/or modify
1508it under the terms of the GNU General Public License as published by
1509the Free Software Foundation; either version 2, or (at your option)
1510any later version.
1511
1512GNU Emacs is distributed in the hope that it will be useful,
1513but WITHOUT ANY WARRANTY; without even the implied warranty of
1514MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1515GNU General Public License for more details.
1516
1517You should have received a copy of the GNU General Public License
1518along with GNU Emacs; see the file COPYING.  If not, write to the
1519Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
1520Boston, MA 02110-1301, USA.
1521
1522arch-tag: 7d2e93c7-e982-40ec-9055-3cd064042473
1523