+Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
+ Free Software Foundation, Inc.
+See the end of the file for license conditions.
+
Precompiled Distributions of
Emacs for Windows
- Version 21.3
+ Version 22.2
- April 22, 2003
+ March 26, 2008
This directory contains source and precompiled distributions for GNU
- Emacs on Windows NT/2000/XP and Windows 95/98/Me. This port is a part
- of the standard GNU Emacs distribution from the Free Software
+ Emacs on Windows NT/2000/XP and Windows 95/98/Me. This port is a
+ part of the standard GNU Emacs distribution from the Free Software
Foundation; the precompiled distributions are provided here for
- convenience since, unlike Unix, the majority of Windows users do not
- have access to a compiler (and, besides, do you really want to compile
- Emacs when you don't have to?).
+ convenience since the majority of Windows users are not accustomed
+ to compiling programs themselves.
If you have access to the World Wide Web, I would recommend pointing
your favorite web browser to the following document (if you haven't
If you want to redistribute any of the precompiled distributions of
Emacs, be careful to check the implications of the GPL. For instance,
- if you put the emacs-21.3-bin-i386.tar.gz file from this directory on
+ if you put the emacs-22.2-bin-i386.tar.gz file from this directory on
an Internet site, you must arrange to distribute the source files of
- the SAME version (i.e. emacs-21.3-src.tar.gz).
+ the SAME version (i.e. ../emacs-22.2.tar.gz).
Making a link to our copy of the source is NOT sufficient, since we
might upgrade to a new version while you are still distributing the
old binaries.
-* Distributions in .tar.gz format
-
- Emacs is distributed primarily as a set of large gzipped tar files
- (*.tar.gz). Because Emacs is quite large and therefore difficult to
- download over unreliable connections, it is provided in several
- combinations, ranging from the complete source plus executables, to
- just the minimal amount needed to run without any source, plus a
- couple of optional packages. Here are the combinations (i386 in the
- name indicates a tarball contains executables compiled for
- Intel-compatible x86 systems):
-
- + Primary precompiled distribution, including lisp source:
-
- emacs-21.3-fullbin-i386.tar.gz
+* Files in this directory
- + Minimal precompiled distribution, which excludes lisp source:
+ + emacs-22.2-bin-i386.zip
+ Windows binaries of Emacs-22.2, with all lisp code and documentation
+ included.
- emacs-21.3-bin-i386.tar.gz
+ Download this file if you want a single installation package, and
+ are not interested in the C source code for Emacs. After
+ unpacking, you can optionally run the file bin/addpm.exe to have
+ Emacs add icons to the Start Menu.
- You can download emacs-21.3-lisp.tar.gz to get the lisp source, if
- you later decide you want it - it is useful for understanding how
- packages work, and how they can best be setup or customized.
+ If you need the C source code at a later date, it will be safe to
+ unpack the source distribution on top of this installation.
+ + emacs-22.2-barebin-i386.zip
+ Windows binaries of Emacs-22.2, without lisp code or documentation.
- NB. If you just want to run Emacs, get one of the distributions above.
+ Download this file if you already have the source distribution, or
+ if you need to redump the emacs.exe executable.
+ Unpack this over the top of either the source distribution or the
+ bin distribution above. It contains the bin subdirectory and etc/DOC
+ file, plus temacs.exe and dump.bat, which are required if you want to
+ redump emacs without recompiling it.
- + Bare executables, only useful if you want to get the complete source
- release below, but can't compile Emacs yourself:
+ + libxpm-3.5.7-w32-src.zip
+ Source code required to compile libXpm-3.5.7 on Windows. Contains
+ a basic Makefile for compiling with mingw32 and a .def file for
+ generating a DLL with the appropriate exports in addition to the
+ source code to provide the subset of functionality Emacs uses from
+ libXpm. This corresponds to the libXpm.dll in emacs-22.2-bin-i386.zip
+ and emacs-22.2-barebin-i386.zip.
- emacs-21.3-barebin-i386.tar.gz (requires emacs-21.3-src.tar.gz)
- + Undumped executable, only needed for rebuilding Emacs after changing
- certain core lisp files:
+ The following are provided for users who require older versions.
- emacs-21.3-undumped-i386.tar.gz
+ + emacs-22.1-bin-i386.zip
+ + emacs-22-1-barebin-i386.zip
+ Windows binaries of Emacs 22.1, contents as above.
- + Optional package providing the Library of Emacs Input Methods for
- typing non-ascii characters, notably Chinese, Japanese and Korean,
- but also including European and other character sets:
+ + emacs-21.3-bin-i386.tar.gz
+ Windows binaries of Emacs 21.3, with compiled lisp code and some
+ documentation included.
- emacs-21.3-leim.tar.gz
+ + emacs-21.3-leim.tar.gz
+ Compiled lisp input methods. This optional addition to Emacs-21.3
+ is required if you want to enter languages that are not directly
+ supported by your keyboard.
- + The complete official source for Emacs:
+* Image support
- emacs-21.3-src.tar.gz
+ Emacs 22.2 contains support for images, however for most image formats
+ supporting libraries are required. This distribution has been tested
+ with the libraries that are distributed with GTK for Windows, and the
+ libraries found at http://gnuwin32.sourceforge.net/. The following image
+ formats are supported:
- + The complete official source for LEIM:
+ PBM/PGM/PPM: Supported natively by Emacs. This format is used for
+ the black and white versions of the toolbar icons.
- leim-21.3-src.tar.gz
+ XPM: a Windows port of the XPM library corresponding to the x.org
+ release of X11R7.3 is included with the binary distribution, but
+ can be replaced by other versions with the name xpm4.dll,
+ libxpm-nox4.dll or libxpm.dll.
+ PNG: requires the PNG reference library 1.2 or later, which will
+ be named libpng13d.dll, libpng13.dll, libpng12d.dll, libpng12.dll
+ or libpng.dll. LibPNG requires zlib, which should come from the same
+ source as you got libpng.
-* Distributions in multi-file .zip format
+ JPEG: requires the Independant JPEG Group's libjpeg 6b or later,
+ which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
- A second distribution in the form of multiple small .zip files is also
- provided, for the benefit of people who have unreliable internet
- connections, or who need to copy the distribution onto floppy disks:
+ TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll
+ or libtiff.dll.
- em213b*.zip
+ GIF: requires libungif or giflib 4.1 or later, which will be
+ called giflib4.dll, libungif4.dll or libungif.dll.
- This is equivalent to getting emacs-21.3-bin-i386.tar.gz above.
- The lisp source is available as em213l*.zip.
+* Distributions in .tar.gz and .zip format
+ Emacs is distributed primarily as source code in a large gzipped tar file
+ (*.tar.gz). Because Emacs is quite large and therefore difficult to
+ download over unreliable connections, the Windows binaries are provided
+ in several combinations, ranging from the complete source plus executables,
+ to just the minimal amount needed to run without any source, plus a
+ couple of optional packages. Formerly, we used the same .tar.gz format
+ but since there are no longer legal problems with .zip files, and the
+ latest versions of Windows support these natively, the Windows binaries
+ of Emacs are now distributed as .zip files.
* Distributions for non-x86 platforms
- I try to make this port available for all platforms supported by
- Windows (it should build on all supported Windows NT/9x platforms).
- However, I do not always have access to non-x86 platforms, and so I
- cannot guarantee to provide precompiled distributions for the other
- platforms myself. If you find there are no binaries for your
- platform, and you have access to a Microsoft compiler, then you can
- download the source and compile Emacs yourself (and, if you do, please
- consider contributing your executables; send me mail and we can make
- arrangements for making them available on this ftp server.)
-
+ Distributions for non-x86 platforms are no longer supplied. Older
+ platforms supported by Windows NT no longer seem to be in demand,
+ and Emacs is yet to be ported to 64bit Windows platforms. If you are
+ willing to help port Emacs 23 to 64bit versions of Windows, your
+ contribution will be welcome on the emacs-devel mailing list.
* Unpacking distributions
- Programs for handling the distribution file formats can be found in
- the utilities directory:
+ Ports of GNU gzip and GNU tar for handling the source distribution file
+ format can be found in several places that distribute ports of GNU
+ programs, for example:
- http://mirrors.sunsite.dk/gnu/windows/emacs/utilities/
+ Cygwin: http://www.cygwin.com/
+ GnuWin32: http://gnuwin32.sourceforge.net/
- For gzipped tar files, you will need either gunzip.exe and tar.exe
- together, or djtarnt.exe. djtarnt.exe can also unpack .zip files. I
- strongly urge you to use these utilities since they were the ones used
- to create the distributions; the most common problem people have in
- trying to get Emacs to run is due to some other utility program
- corrupting the distribution while unpacking.
+ Many other popular file compression utilities for Windows are also
+ able to handle gzipped tar files.
Open a command prompt (MSDOS) window. Decide on a directory in which
to place Emacs. Move the distribution to that directory, and then
You may be prompted to rename or overwrite directories when using
djtarnt: simply type return to continue (this is harmless).
- If you have the multi-file .zip distribution, use djtarnt to unpack
- all of the .zip files:
+ Zip files can be unpacked using unzip.exe from info-zip.org
+ if you do not already have other tools to do this.
- % djtarnt -x *.zip
-
- Once you have unpacked a precompiled distribution of Emacs, it should
- have the following subdirectories:
+ % unzip some.zip
- bin etc info lisp lock site-lisp
+ The precompiled binaries can be unpacked using unzip.exe from info-zip.org
+ if you do not already have other tools to do this.
- If your utility failed to create the lock directory, then you can
- simply create it by hand (it is initially empty).
+ % unzip some.zip
- One final step is needed only when installing from the multi-file .zip
- distribution, in order to recreate emacs.exe from its fragments (it is
- too big to fit on a floppy even when zipped):
+ Once you have unpacked a precompiled distribution of Emacs, it should
+ have the following subdirectories:
- % cd emacs-21.3\bin
- % stitch
+ bin etc info lisp site-lisp
* Unpacking with other tools
If you do use other utility programs to unpack the distribution, check
the following to be sure the distribution was not corrupted:
- + Be sure to disable the CR/LF translation or the executables will be
- unusable. Older versions of WinZipNT would enable this translation
- by default. If you are using WinZipNT, disable it. (I don't have
- WinZipNT myself, and I do not know the specific commands necessary
- to disable it.)
+ + Be sure to disable the CR/LF translation or the executables will
+ be unusable. Older versions of WinZip would enable this
+ translation by default when unpacking .tar files. If you are
+ using WinZip, disable it. (I don't have WinZip myself, and I do
+ not know the specific commands necessary to disable it.)
+ Check that filenames were not truncated to 8.3. For example, there
should be a file lisp/abbrevlist.el; if this has been truncated to
abbrevli.el, your distribution has been corrupted while unpacking
and Emacs will not start.
- + I've been told that some utilities (WinZip again?) don't create the
- lock subdirectory. The lock subdirectory needs to be created.
-
- + I've also had reports that the "gnu-win32" port of tar corrupts the
- executables. Use the version of tar or djtarnt in the utilities
- directory instead.
+ + I've also had reports that some older "gnuwin32" port of tar
+ corrupts the executables. Use the latest version from the gnuwin32
+ site or another port of tar instead.
If you believe you have unpacked the distributions correctly and are
still encountering problems, see the section on Further Information
If you would like to compile Emacs from source, download the source
distribution, unpack it in the same manner as a precompiled
- distribution, and look in the file nt/INSTALL for detailed directions.
- You can either use the Microsoft compiler included with Visual C++, or
- GCC 2.95 or later with MinGW support, to compile the source. The port
- of GCC included in Cygwin is supported, but check the nt/INSTALL file
- if you have trouble since some builds of GNU make aren't supported.
+ distribution, and look in the file nt/INSTALL for detailed
+ directions. You can either use the Microsoft compiler included with
+ Visual C++ 2003 or earlier, or GCC 2.95 or later with MinGW support,
+ to compile the source. The port of GCC included in Cygwin is
+ supported, but check the nt/INSTALL file if you have trouble since
+ some builds of GNU make aren't supported.
* Further information
http://www.gnu.org/software/emacs/windows/ntemacs.html
This document serves as an FAQ and a source for further information
- about the Windows port and related software packages.
+ about the Windows port and related software packages. Note that as
+ of writing, most of the information in that FAQ was for Emacs-21.3
+ and earlier versions, so some information may not be relevant to
+ Emacs-22.2.
In addition to the FAQ, there is a mailing list for discussing issues
related to the Windows port of Emacs. For information about the
Enjoy!
- Andrew Innes
+ Jason Rumney
+ (jasonr@gnu.org)
+
+ Most of this README was contributed by former maintainer Andrew Innes
(andrewi@gnu.org)
+
+\f
+This file is part of GNU Emacs.
+
+GNU Emacs is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+GNU Emacs is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.