Commit | Line | Data |
---|---|---|
ba318903 | 1 | Copyright (C) 2001-2014 Free Software Foundation, Inc. |
892df15e JR |
2 | See the end of the file for license conditions. |
3 | ||
31098a38 | 4 | Precompiled Distributions of |
e53925a5 | 5 | Emacs for Windows |
31098a38 | 6 | |
9dd33e85 | 7 | Version 24.3 |
61939a00 | 8 | |
9dd33e85 | 9 | March 18, 2013 |
177c0ea7 | 10 | |
a3992354 JR |
11 | This directory contains precompiled distributions for GNU Emacs on |
12 | Windows (versions before Windows 95 and NT4 are not supported). | |
13 | This port is a part of the standard GNU Emacs distribution from the | |
14 | Free Software Foundation; the precompiled distributions are provided | |
15 | here for convenience since the majority of Windows users are not | |
16 | accustomed to compiling programs themselves. Corresponding source | |
9dd33e85 | 17 | can be found in the parent directory in emacs-24.3.tar.gz. |
31098a38 | 18 | |
31098a38 AI |
19 | * IMPORTANT LEGAL REMINDER |
20 | ||
21 | If you want to redistribute any of the precompiled distributions of | |
22 | Emacs, be careful to check the implications of the GPL. For instance, | |
9dd33e85 | 23 | if you put the emacs-24.3-bin-i386.zip file from this directory on |
31098a38 | 24 | an Internet site, you must arrange to distribute the source files of |
9dd33e85 | 25 | the SAME version (i.e. ../emacs-24.3.tar.gz). |
31098a38 AI |
26 | |
27 | Making a link to our copy of the source is NOT sufficient, since we | |
28 | might upgrade to a new version while you are still distributing the | |
29 | old binaries. | |
30 | ||
31 | ||
a7ebea8b JR |
32 | * Files in this directory |
33 | ||
9dd33e85 GM |
34 | + emacs-24.3-bin-i386.zip |
35 | Windows binaries of Emacs-24.3, with all lisp code and documentation | |
a7ebea8b JR |
36 | included. |
37 | ||
38 | Download this file if you want a single installation package, and | |
39 | are not interested in the C source code for Emacs. After | |
40 | unpacking, you can optionally run the file bin/addpm.exe to have | |
41 | Emacs add icons to the Start Menu. | |
42 | ||
43 | If you need the C source code at a later date, it will be safe to | |
44 | unpack the source distribution on top of this installation. | |
45 | ||
9dd33e85 GM |
46 | + libXpm-3.5.8-w32-src.zip |
47 | Source code required to compile libXpm-3.5.8 on Windows. Contains | |
68cbe492 JR |
48 | a basic Makefile for compiling with mingw32 and a .def file for |
49 | generating a DLL with the appropriate exports in addition to the | |
50 | source code to provide the subset of functionality Emacs uses from | |
9dd33e85 | 51 | libXpm. This corresponds to the libXpm.dll in emacs-24.3-bin-i386.zip. |
8cedc5ac EZ |
52 | |
53 | * Prerequisites for running Emacs on Windows 9X | |
54 | ||
55 | Using Emacs in GUI mode on Windows 95/98/Me requires the UNICOWS.DLL | |
56 | dynamic library, which provides MSLU, the Microsoft Unicode Layer | |
57 | for Windows 9X. You can freely download it from the Microsoft site. | |
a7ebea8b JR |
58 | |
59 | * Image support | |
60 | ||
9dd33e85 | 61 | Emacs 24.3 contains support for images, however for most image |
b018182c EZ |
62 | formats supporting libraries are required. This distribution has |
63 | been tested with the libraries that are distributed with GTK for | |
64 | Windows (http://www.gtk.org/download/win32.php), and the libraries | |
65 | found at http://gnuwin32.sourceforge.net/. The following image | |
a7ebea8b JR |
66 | formats are supported: |
67 | ||
68 | PBM/PGM/PPM: Supported natively by Emacs. This format is used for | |
69 | the black and white versions of the toolbar icons. | |
70 | ||
1be8283d | 71 | XPM: a Windows port of the XPM library corresponding to the x.org |
68cbe492 | 72 | release of X11R7.3 is included with the binary distribution, but |
1be8283d JR |
73 | can be replaced by other versions with the name xpm4.dll, |
74 | libxpm-nox4.dll or libxpm.dll. | |
a7ebea8b | 75 | |
b018182c EZ |
76 | PNG: requires the PNG reference library 1.4 or later, which will |
77 | be named libpng14.dll or libpng14-14.dll. LibPNG requires zlib, | |
78 | which should come from the same source as you got libpng. | |
79 | Starting with Emacs 23.3, the precompiled Emacs binaries are | |
80 | built with libpng 1.4.x and later, and are incompatible with | |
81 | earlier versions of libpng DLLs. So if you have libpng 1.2.x, | |
82 | the PNG support will not work, and you will have to download | |
83 | newer versions. | |
a7ebea8b | 84 | |
40a8bdf6 | 85 | JPEG: requires the Independent JPEG Group's libjpeg 6b or later, |
a7ebea8b JR |
86 | which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll. |
87 | ||
88 | TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll | |
89 | or libtiff.dll. | |
90 | ||
91 | GIF: requires libungif or giflib 4.1 or later, which will be | |
92 | called giflib4.dll, libungif4.dll or libungif.dll. | |
93 | ||
a3992354 JR |
94 | SVG: not compiled into the binary release, but available if you |
95 | compile Emacs yourself if you have development packages for all the | |
96 | dependencies. Requires many libraries from GTK and Gnome | |
97 | as well as the base librsvg library. Known to crash Emacs on many | |
98 | sample images. | |
99 | ||
9dd33e85 GM |
100 | * XML support |
101 | ||
102 | In order to support XML via libxml2 at runtime, a libxml2-enabled | |
103 | Emacs must be able to find the relevant DLLs during startup; failure | |
104 | to do so is not an error, but libxml2 features won't be available to | |
105 | the running session. | |
106 | ||
107 | You can get pre-built binaries (including any required DLL and the | |
108 | header files) at http://sourceforge.net/projects/ezwinports/files/. | |
109 | ||
5f561867 | 110 | * Distributions in .tar.gz and .zip format |
31098a38 | 111 | |
119437ca JR |
112 | Emacs is distributed primarily as source code in a large gzipped tar |
113 | file (*.tar.gz). Because Emacs is quite large and therefore | |
114 | difficult to download over unreliable connections, the Windows | |
115 | binaries are provided in two combinations. The complete lisp source | |
116 | plus executables (bin), and executables only (barebin) for unpacking | |
117 | over the top of the source distribution. Formerly, we used the same | |
118 | .tar.gz format but since there are no longer legal problems with | |
119 | .zip files, and the latest versions of Windows support these | |
120 | natively, the Windows binaries of Emacs are now distributed as .zip | |
121 | files. | |
31098a38 | 122 | |
31098a38 AI |
123 | * Distributions for non-x86 platforms |
124 | ||
3ad0c616 JR |
125 | Distributions for non-x86 platforms are no longer supplied. Older |
126 | platforms supported by Windows NT no longer seem to be in demand, | |
119437ca | 127 | and Emacs is yet to be ported to 64 bit Windows platforms. If you |
8cedc5ac | 128 | are willing to help port Emacs 24 to 64 bit versions of Windows, |
119437ca | 129 | your contribution will be welcome on the emacs-devel mailing list. |
31098a38 AI |
130 | |
131 | * Unpacking distributions | |
132 | ||
5f561867 JR |
133 | Ports of GNU gzip and GNU tar for handling the source distribution file |
134 | format can be found in several places that distribute ports of GNU | |
3ad0c616 | 135 | programs, for example: |
31098a38 | 136 | |
3ad0c616 JR |
137 | Cygwin: http://www.cygwin.com/ |
138 | GnuWin32: http://gnuwin32.sourceforge.net/ | |
31098a38 | 139 | |
3ad0c616 | 140 | Many other popular file compression utilities for Windows are also |
119437ca JR |
141 | able to handle gzipped tar files. 7zip is one free Windows graphical |
142 | program that is able to handle many archive formats. | |
31098a38 AI |
143 | |
144 | Open a command prompt (MSDOS) window. Decide on a directory in which | |
145 | to place Emacs. Move the distribution to that directory, and then | |
146 | unpack it as follows. | |
147 | ||
148 | If you have the gzipped tar version, use gunzip to uncompress the tar | |
149 | file on the fly, and pipe the output through tar with the "xvf" flags | |
150 | to extract the files from the tar file: | |
151 | ||
152 | % gunzip -c some.tar.gz | tar xvf - | |
153 | ||
154 | You may see messages from tar about not being able to change the | |
155 | modification time on directories, and from gunzip complaining about a | |
156 | broken pipe. These messages are harmless and you can ignore them. On | |
157 | Windows NT, unpacking tarballs this way leaves them in compressed | |
158 | form, taking up less space on disk. Unfortunately, on Windows 95 and | |
159 | 98, a large temporary file is created, so it is better to use the | |
160 | djtarnt.exe program, which performs the equivalent operation in one | |
161 | step: | |
162 | ||
163 | % djtarnt -x some.tar.gz | |
164 | ||
165 | You may be prompted to rename or overwrite directories when using | |
166 | djtarnt: simply type return to continue (this is harmless). | |
167 | ||
a7ebea8b | 168 | Zip files can be unpacked using unzip.exe from info-zip.org |
262be72a MB |
169 | if you do not already have other tools to do this. |
170 | ||
171 | % unzip some.zip | |
172 | ||
5f561867 JR |
173 | The precompiled binaries can be unpacked using unzip.exe from info-zip.org |
174 | if you do not already have other tools to do this. | |
175 | ||
176 | % unzip some.zip | |
177 | ||
31098a38 AI |
178 | Once you have unpacked a precompiled distribution of Emacs, it should |
179 | have the following subdirectories: | |
180 | ||
3ad0c616 | 181 | bin etc info lisp site-lisp |
e53925a5 | 182 | |
31098a38 AI |
183 | |
184 | * Unpacking with other tools | |
185 | ||
186 | If you do use other utility programs to unpack the distribution, check | |
187 | the following to be sure the distribution was not corrupted: | |
188 | ||
5f561867 JR |
189 | + Be sure to disable the CR/LF translation or the executables will |
190 | be unusable. Older versions of WinZip would enable this | |
191 | translation by default when unpacking .tar files. If you are | |
192 | using WinZip, disable it. (I don't have WinZip myself, and I do | |
193 | not know the specific commands necessary to disable it.) | |
31098a38 AI |
194 | |
195 | + Check that filenames were not truncated to 8.3. For example, there | |
196 | should be a file lisp/abbrevlist.el; if this has been truncated to | |
197 | abbrevli.el, your distribution has been corrupted while unpacking | |
198 | and Emacs will not start. | |
199 | ||
119437ca JR |
200 | + Check that filenames were not changed by your web-browser. Some |
201 | proprietary web-browsers save .tar.gz files as .tar.tar. You might | |
202 | like to consider switching to a Free modern browser if your browser | |
203 | has this bug. | |
204 | ||
3ad0c616 JR |
205 | + I've also had reports that some older "gnuwin32" port of tar |
206 | corrupts the executables. Use the latest version from the gnuwin32 | |
207 | site or another port of tar instead. | |
31098a38 AI |
208 | |
209 | If you believe you have unpacked the distributions correctly and are | |
210 | still encountering problems, see the section on Further Information | |
211 | below. | |
212 | ||
213 | ||
214 | * Compiling from source | |
215 | ||
216 | If you would like to compile Emacs from source, download the source | |
217 | distribution, unpack it in the same manner as a precompiled | |
3ad0c616 | 218 | distribution, and look in the file nt/INSTALL for detailed |
119437ca JR |
219 | directions. It is recommended to use GCC 2.95 or later with MinGW |
220 | support to compile the source. The port of GCC included in Cygwin | |
221 | is supported, but check the nt/INSTALL file if you have trouble | |
222 | since some builds of GNU make aren't supported. | |
31098a38 AI |
223 | |
224 | ||
225 | * Further information | |
226 | ||
63e984f8 GM |
227 | The Emacs on MS Windows FAQ is distributed with Emacs (info |
228 | manual "efaq-w32"), and at | |
31098a38 | 229 | |
63e984f8 | 230 | http://www.gnu.org/software/emacs/manual/efaq-w32.html |
e53925a5 AI |
231 | |
232 | In addition to the FAQ, there is a mailing list for discussing issues | |
233 | related to the Windows port of Emacs. For information about the | |
234 | list, see this Web page: | |
235 | ||
6e3645dc | 236 | http://lists.gnu.org/mailman/listinfo/help-emacs-windows |
e53925a5 AI |
237 | |
238 | To ask questions on the mailing list, send email to | |
239 | help-emacs-windows@gnu.org. (You don't need to subscribe for that.) | |
240 | To subscribe to the list or unsubscribe from it, fill the form you | |
241 | find at http://mail.gnu.org/mailman/listinfo/help-emacs-windows as | |
242 | explained there. | |
31098a38 AI |
243 | |
244 | Another valuable source of information and help which should not be | |
245 | overlooked is the various Usenet news groups dedicated to Emacs. | |
e1dbe924 | 246 | These are particularly good for help with general issues which aren't |
31098a38 AI |
247 | specific to the Windows port of Emacs. The main news groups to use |
248 | for seeking help are: | |
249 | ||
250 | gnu.emacs.help | |
251 | comp.emacs | |
252 | ||
253 | There are also fairly regular postings and announcements of new or | |
254 | updated Emacs packages on this group: | |
255 | ||
256 | gnu.emacs.sources | |
257 | ||
31098a38 AI |
258 | Enjoy! |
259 | ||
9dd33e85 GM |
260 | Most of this README was contributed by former maintainers Andrew Innes |
261 | (andrewi@gnu.org) and Jason Rumney (jasonr@gnu.org). | |
892df15e JR |
262 | |
263 | \f | |
264 | This file is part of GNU Emacs. | |
265 | ||
9ad5de0c | 266 | GNU Emacs is free software: you can redistribute it and/or modify |
892df15e | 267 | it under the terms of the GNU General Public License as published by |
9ad5de0c GM |
268 | the Free Software Foundation, either version 3 of the License, or |
269 | (at your option) any later version. | |
892df15e JR |
270 | |
271 | GNU Emacs is distributed in the hope that it will be useful, | |
272 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
273 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
274 | GNU General Public License for more details. | |
275 | ||
276 | You should have received a copy of the GNU General Public License | |
5ca9b80e | 277 | along with GNU Emacs. If not, see http://www.gnu.org/licenses/. |