comparison admin/nt/README-ftp-server @ 80764:8c1de2106017

Update based on current directory layout and recommended tools.
author Jason Rumney <jasonr@gnu.org>
date Wed, 27 Aug 2008 16:53:46 +0000
parents db96eae9d737
children ed69d4f0f7b9 ab6494b53df0
comparison
equal deleted inserted replaced
80763:e9944bf78cbc 80764:8c1de2106017
3 See the end of the file for license conditions. 3 See the end of the file for license conditions.
4 4
5 Precompiled Distributions of 5 Precompiled Distributions of
6 Emacs for Windows 6 Emacs for Windows
7 7
8 Version 22.2 8 PRETEST Version 22.2.91
9 9
10 March 26, 2008 10 August 27, 2008
11 11
12 This directory contains source and precompiled distributions for GNU 12 This directory contains precompiled distributions for GNU Emacs
13 Emacs on Windows NT/2000/XP and Windows 95/98/Me. This port is a 13 on Windows NT/2000/XP/Vista and Windows 95/98/Me. This port is a
14 part of the standard GNU Emacs distribution from the Free Software 14 part of the standard GNU Emacs distribution from the Free Software
15 Foundation; the precompiled distributions are provided here for 15 Foundation; the precompiled distributions are provided here for
16 convenience since the majority of Windows users are not accustomed 16 convenience since the majority of Windows users are not accustomed
17 to compiling programs themselves. 17 to compiling programs themselves. Corresponding source can be found
18 in the parent directory in emacs-22.2.91.tar.gz.
18 19
19 If you have access to the World Wide Web, I would recommend pointing 20 If you have access to the World Wide Web, I would recommend pointing
20 your favorite web browser to the following document (if you haven't 21 your favorite web browser to the following document (if you haven't
21 already): 22 already):
22 23
23 http://www.gnu.org/software/emacs/windows/ntemacs.html 24 http://www.gnu.org/software/emacs/windows/ntemacs.html
24 25
25 The above web document is a far more complete version of this README
26 file. If you don't have access to the Web, however, then read on.
27
28
29 * IMPORTANT LEGAL REMINDER 26 * IMPORTANT LEGAL REMINDER
30 27
31 If you want to redistribute any of the precompiled distributions of 28 If you want to redistribute any of the precompiled distributions of
32 Emacs, be careful to check the implications of the GPL. For instance, 29 Emacs, be careful to check the implications of the GPL. For instance,
33 if you put the emacs-22.2-bin-i386.tar.gz file from this directory on 30 if you put the emacs-22.2.91-bin-i386.tar.gz file from this directory on
34 an Internet site, you must arrange to distribute the source files of 31 an Internet site, you must arrange to distribute the source files of
35 the SAME version (i.e. ../emacs-22.2.tar.gz). 32 the SAME version (i.e. ../emacs-22.2.91.tar.gz).
36 33
37 Making a link to our copy of the source is NOT sufficient, since we 34 Making a link to our copy of the source is NOT sufficient, since we
38 might upgrade to a new version while you are still distributing the 35 might upgrade to a new version while you are still distributing the
39 old binaries. 36 old binaries.
40 37
41 38
42 * Files in this directory 39 * Files in this directory
43 40
44 + emacs-22.2-bin-i386.zip 41 + emacs-22.2.91-bin-i386.zip
45 Windows binaries of Emacs-22.2, with all lisp code and documentation 42 Windows binaries of Emacs-22.2.91, with all lisp code and documentation
46 included. 43 included.
47 44
48 Download this file if you want a single installation package, and 45 Download this file if you want a single installation package, and
49 are not interested in the C source code for Emacs. After 46 are not interested in the C source code for Emacs. After
50 unpacking, you can optionally run the file bin/addpm.exe to have 47 unpacking, you can optionally run the file bin/addpm.exe to have
51 Emacs add icons to the Start Menu. 48 Emacs add icons to the Start Menu.
52 49
53 If you need the C source code at a later date, it will be safe to 50 If you need the C source code at a later date, it will be safe to
54 unpack the source distribution on top of this installation. 51 unpack the source distribution on top of this installation.
55 52
56 + emacs-22.2-barebin-i386.zip 53 + emacs-22.2.91-barebin-i386.zip
57 Windows binaries of Emacs-22.2, without lisp code or documentation. 54 Windows binaries of Emacs-22.2.91, without lisp code or documentation.
58 55
59 Download this file if you already have the source distribution, or 56 Download this file if you already have the source distribution, or
60 if you need to redump the emacs.exe executable. 57 if you need to redump the emacs.exe executable.
61 58
62 Unpack this over the top of either the source distribution or the 59 Unpack this over the top of either the source distribution or the
67 + libxpm-3.5.7-w32-src.zip 64 + libxpm-3.5.7-w32-src.zip
68 Source code required to compile libXpm-3.5.7 on Windows. Contains 65 Source code required to compile libXpm-3.5.7 on Windows. Contains
69 a basic Makefile for compiling with mingw32 and a .def file for 66 a basic Makefile for compiling with mingw32 and a .def file for
70 generating a DLL with the appropriate exports in addition to the 67 generating a DLL with the appropriate exports in addition to the
71 source code to provide the subset of functionality Emacs uses from 68 source code to provide the subset of functionality Emacs uses from
72 libXpm. This corresponds to the libXpm.dll in emacs-22.2-bin-i386.zip 69 libXpm. This corresponds to the libXpm.dll in emacs-22.2.91-bin-i386.zip
73 and emacs-22.2-barebin-i386.zip. 70 and emacs-22.2.91-barebin-i386.zip.
74
75
76 The following are provided for users who require older versions.
77
78 + emacs-22.1-bin-i386.zip
79 + emacs-22-1-barebin-i386.zip
80 Windows binaries of Emacs 22.1, contents as above.
81
82 + emacs-21.3-bin-i386.tar.gz
83 Windows binaries of Emacs 21.3, with compiled lisp code and some
84 documentation included.
85
86 + emacs-21.3-leim.tar.gz
87 Compiled lisp input methods. This optional addition to Emacs-21.3
88 is required if you want to enter languages that are not directly
89 supported by your keyboard.
90 71
91 * Image support 72 * Image support
92 73
93 Emacs 22.2 contains support for images, however for most image formats 74 Emacs 22.2.91 contains support for images, however for most image formats
94 supporting libraries are required. This distribution has been tested 75 supporting libraries are required. This distribution has been tested
95 with the libraries that are distributed with GTK for Windows, and the 76 with the libraries that are distributed with GTK for Windows, and the
96 libraries found at http://gnuwin32.sourceforge.net/. The following image 77 libraries found at http://gnuwin32.sourceforge.net/. The following image
97 formats are supported: 78 formats are supported:
98 79
118 GIF: requires libungif or giflib 4.1 or later, which will be 99 GIF: requires libungif or giflib 4.1 or later, which will be
119 called giflib4.dll, libungif4.dll or libungif.dll. 100 called giflib4.dll, libungif4.dll or libungif.dll.
120 101
121 * Distributions in .tar.gz and .zip format 102 * Distributions in .tar.gz and .zip format
122 103
123 Emacs is distributed primarily as source code in a large gzipped tar file 104 Emacs is distributed primarily as source code in a large gzipped tar
124 (*.tar.gz). Because Emacs is quite large and therefore difficult to 105 file (*.tar.gz). Because Emacs is quite large and therefore
125 download over unreliable connections, the Windows binaries are provided 106 difficult to download over unreliable connections, the Windows
126 in several combinations, ranging from the complete source plus executables, 107 binaries are provided in two combinations. The complete lisp source
127 to just the minimal amount needed to run without any source, plus a 108 plus executables (bin), and executables only (barebin) for unpacking
128 couple of optional packages. Formerly, we used the same .tar.gz format 109 over the top of the source distribution. Formerly, we used the same
129 but since there are no longer legal problems with .zip files, and the 110 .tar.gz format but since there are no longer legal problems with
130 latest versions of Windows support these natively, the Windows binaries 111 .zip files, and the latest versions of Windows support these
131 of Emacs are now distributed as .zip files. 112 natively, the Windows binaries of Emacs are now distributed as .zip
113 files.
132 114
133 * Distributions for non-x86 platforms 115 * Distributions for non-x86 platforms
134 116
135 Distributions for non-x86 platforms are no longer supplied. Older 117 Distributions for non-x86 platforms are no longer supplied. Older
136 platforms supported by Windows NT no longer seem to be in demand, 118 platforms supported by Windows NT no longer seem to be in demand,
137 and Emacs is yet to be ported to 64bit Windows platforms. If you are 119 and Emacs is yet to be ported to 64 bit Windows platforms. If you
138 willing to help port Emacs 23 to 64bit versions of Windows, your 120 are willing to help port Emacs 23 to 64 bit versions of Windows,
139 contribution will be welcome on the emacs-devel mailing list. 121 your contribution will be welcome on the emacs-devel mailing list.
140 122
141 * Unpacking distributions 123 * Unpacking distributions
142 124
143 Ports of GNU gzip and GNU tar for handling the source distribution file 125 Ports of GNU gzip and GNU tar for handling the source distribution file
144 format can be found in several places that distribute ports of GNU 126 format can be found in several places that distribute ports of GNU
146 128
147 Cygwin: http://www.cygwin.com/ 129 Cygwin: http://www.cygwin.com/
148 GnuWin32: http://gnuwin32.sourceforge.net/ 130 GnuWin32: http://gnuwin32.sourceforge.net/
149 131
150 Many other popular file compression utilities for Windows are also 132 Many other popular file compression utilities for Windows are also
151 able to handle gzipped tar files. 133 able to handle gzipped tar files. 7zip is one free Windows graphical
134 program that is able to handle many archive formats.
152 135
153 Open a command prompt (MSDOS) window. Decide on a directory in which 136 Open a command prompt (MSDOS) window. Decide on a directory in which
154 to place Emacs. Move the distribution to that directory, and then 137 to place Emacs. Move the distribution to that directory, and then
155 unpack it as follows. 138 unpack it as follows.
156 139
199 + Check that filenames were not truncated to 8.3. For example, there 182 + Check that filenames were not truncated to 8.3. For example, there
200 should be a file lisp/abbrevlist.el; if this has been truncated to 183 should be a file lisp/abbrevlist.el; if this has been truncated to
201 abbrevli.el, your distribution has been corrupted while unpacking 184 abbrevli.el, your distribution has been corrupted while unpacking
202 and Emacs will not start. 185 and Emacs will not start.
203 186
187 + Check that filenames were not changed by your web-browser. Some
188 proprietary web-browsers save .tar.gz files as .tar.tar. You might
189 like to consider switching to a Free modern browser if your browser
190 has this bug.
191
204 + I've also had reports that some older "gnuwin32" port of tar 192 + I've also had reports that some older "gnuwin32" port of tar
205 corrupts the executables. Use the latest version from the gnuwin32 193 corrupts the executables. Use the latest version from the gnuwin32
206 site or another port of tar instead. 194 site or another port of tar instead.
207 195
208 If you believe you have unpacked the distributions correctly and are 196 If you believe you have unpacked the distributions correctly and are
213 * Compiling from source 201 * Compiling from source
214 202
215 If you would like to compile Emacs from source, download the source 203 If you would like to compile Emacs from source, download the source
216 distribution, unpack it in the same manner as a precompiled 204 distribution, unpack it in the same manner as a precompiled
217 distribution, and look in the file nt/INSTALL for detailed 205 distribution, and look in the file nt/INSTALL for detailed
218 directions. You can either use the Microsoft compiler included with 206 directions. It is recommended to use GCC 2.95 or later with MinGW
219 Visual C++ 2003 or earlier, or GCC 2.95 or later with MinGW support, 207 support to compile the source. The port of GCC included in Cygwin
220 to compile the source. The port of GCC included in Cygwin is 208 is supported, but check the nt/INSTALL file if you have trouble
221 supported, but check the nt/INSTALL file if you have trouble since 209 since some builds of GNU make aren't supported.
222 some builds of GNU make aren't supported.
223 210
224 211
225 * Further information 212 * Further information
226 213
227 If you have access to the World Wide Web, I would recommend pointing 214 If you have access to the World Wide Web, I would recommend pointing
232 219
233 This document serves as an FAQ and a source for further information 220 This document serves as an FAQ and a source for further information
234 about the Windows port and related software packages. Note that as 221 about the Windows port and related software packages. Note that as
235 of writing, most of the information in that FAQ was for Emacs-21.3 222 of writing, most of the information in that FAQ was for Emacs-21.3
236 and earlier versions, so some information may not be relevant to 223 and earlier versions, so some information may not be relevant to
237 Emacs-22.2. 224 Emacs-22.2.91.
238 225
239 In addition to the FAQ, there is a mailing list for discussing issues 226 In addition to the FAQ, there is a mailing list for discussing issues
240 related to the Windows port of Emacs. For information about the 227 related to the Windows port of Emacs. For information about the
241 list, see this Web page: 228 list, see this Web page:
242 229