1Emacs machines list
2
3Copyright (C) 1989-1990, 1992-1993, 1998, 2001-2021 Free Software
4Foundation, 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
9Information about older releases, and platforms that are no longer
10supported, has been removed.  Consult older versions of this file if
11you are interested in this information.
12
13The 'configure' script uses the configuration name, and the results of
14testing the system, to decide which options to use in src/config.h and
15elsewhere (eg Makefiles).
16
17If you add support for a new configuration, add a section to this
18file, and edit the 'configure.ac' source as needed.
19
20Some obsolete platforms are unsupported beginning with Emacs 23.1.  See
21the list at the end of this file.
22
23
24* Here are notes about some of the systems supported:
25
26** GNU/Linux
27
28  Most of the complete systems which use the Linux kernel are close
29  enough to the GNU system to be considered variant GNU systems.  We
30  call them "Linux-based GNU systems," or GNU/Linux for short.
31
32  It is not coincidence that many of the other components used with
33  Linux--including GNU Emacs--were developed specifically for the GNU
34  project.  The GNU project was launched in 1984 to develop a free
35  complete Unix-like operating system.  To reach this goal, we had to
36  develop whatever system components were not available as freely
37  redistributable software from some other source.
38
39  The GNU project wants users of GNU/Linux systems to be aware of how
40  these systems relate to the GNU project, because that will help
41  spread the GNU idea that software should be free--and thus encourage
42  people to write more free software.  For more information, see
43  <https://www.gnu.org/gnu/linux-and-gnu.html>.
44
45*** 64-bit GNU/Linux
46
47  No special procedures should be needed to build a 64-bit Emacs on a
48  64-bit GNU/Linux system.  To build a 32-bit Emacs, first ensure that
49  the necessary 32-bit system libraries and include files are
50  installed.  Then use:
51
52    ./configure CC='gcc -m32' --build=i386-linux-gnu \
53      --x-libraries=/usr/X11R6/lib
54
55  (using the location of the 32-bit X libraries on your system).
56
57*** IBM System/390 running GNU/Linux (s390-*-linux-gnu)
58
59  As of Emacs 21.2, a 31-bit only version is supported on this system.
60
61*** SuperH (sh[34]*-*-linux-gnu)
62
63  Emacs 23.0.60 was reported to work on GNU/Linux (October 2008).
64  This was tested on a little-endian sh4 system (cpu type SH7751R) running
65  Gentoo Linux 2008.0.
66
67** macOS
68
69  Mac OS X 10.6 or newer.  PowerPC is not supported.
70  For installation instructions see the file nextstep/INSTALL.
71
72** Microsoft Windows
73
74  For installation instructions see the file nt/INSTALL.
75
76** MS-DOS
77
78  For installation instructions see the file msdos/INSTALL.
79  See the "MS-DOS" chapter of the manual for information about using
80  Emacs on MS-DOS.
81
82** Solaris
83
84  On Solaris it is also possible to use either GCC or Solaris Studio
85  to build Emacs, by pointing ./configure to the right compiler:
86
87    ./configure CC='/usr/sfw/bin/gcc'  # GCC
88    ./configure CC='cc'                # Solaris Studio
89
90  On Solaris, do not use /usr/ucb/cc.  Use /opt/SUNWspro/bin/cc.  Make
91  sure that /usr/ccs/bin and /opt/SUNWspro/bin are in your PATH before
92  /usr/ucb.  (Most free software packages have the same requirement on
93  Solaris.)  With this compiler, use '/opt/SUNWspro/bin/cc -E' as the
94  preprocessor.  If this inserts extra whitespace into its output (see
95  the PROBLEMS file) then add the option '-Xs'.
96
97  To build a 64-bit Emacs (with larger maximum buffer size) on a
98  Solaris system which supports 64-bit executables, specify the -m64
99  compiler option.  For example:
100
101    ./configure CC='/usr/sfw/bin/gcc -m64'  # GCC
102    ./configure CC='cc -m64'                # Solaris Studio
103
104
105* Obsolete platforms
106
107Support for many obsolete platforms was removed in Emacs 23.1.
108If for some reason you encounter an ancient machine where current
109Emacs does not compile, try an older release like Emacs 22.3.
110
111
112Local variables:
113mode: outline
114fill-prefix: "  "
115End:
116
117This file is part of GNU Emacs.
118
119GNU Emacs is free software: you can redistribute it and/or modify
120it under the terms of the GNU General Public License as published by
121the Free Software Foundation, either version 3 of the License, or
122(at your option) any later version.
123
124GNU Emacs is distributed in the hope that it will be useful,
125but WITHOUT ANY WARRANTY; without even the implied warranty of
126MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
127GNU General Public License for more details.
128
129You should have received a copy of the GNU General Public License
130along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
131