annotate admin/nt/README-ftp-server @ 78461:90683ffc924a

Update for Emacs 22.2, including libxpm.
author Jason Rumney <jasonr@gnu.org>
date Tue, 07 Aug 2007 20:21:42 +0000
parents fadb06e1e355
children 90e7bc7fb7a3 424b655804ca
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
1 Precompiled Distributions of
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
2 Emacs for Windows
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
3
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
4 Version 22.2
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 39011
diff changeset
5
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
6 May 22, 2007
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
7
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
8 This directory contains source and precompiled distributions for GNU
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
9 Emacs on Windows NT/2000/XP and Windows 95/98/Me. This port is a
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
10 part of the standard GNU Emacs distribution from the Free Software
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
11 Foundation; the precompiled distributions are provided here for
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
12 convenience since the majority of Windows users are not accustomed
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
13 to compiling programs themselves.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
14
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
15 If you have access to the World Wide Web, I would recommend pointing
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
16 your favorite web browser to the following document (if you haven't
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
17 already):
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
18
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
19 http://www.gnu.org/software/emacs/windows/ntemacs.html
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
20
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
21 The above web document is a far more complete version of this README
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
22 file. If you don't have access to the Web, however, then read on.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
23
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
24
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
25 * IMPORTANT LEGAL REMINDER
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
26
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
27 If you want to redistribute any of the precompiled distributions of
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
28 Emacs, be careful to check the implications of the GPL. For instance,
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
29 if you put the emacs-22.2-bin-i386.tar.gz file from this directory on
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
30 an Internet site, you must arrange to distribute the source files of
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
31 the SAME version (i.e. ../emacs-22.2.tar.gz).
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
32
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
33 Making a link to our copy of the source is NOT sufficient, since we
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
34 might upgrade to a new version while you are still distributing the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
35 old binaries.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
36
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
37
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
38 * Files in this directory
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
39
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
40 + emacs-22.2-bin-i386.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
41 Windows binaries of Emacs-22.2, with all lisp code and documentation
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
42 included.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
43
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
44 Download this file if you want a single installation package, and
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
45 are not interested in the C source code for Emacs. After
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
46 unpacking, you can optionally run the file bin/addpm.exe to have
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
47 Emacs add icons to the Start Menu.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
48
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
49 If you need the C source code at a later date, it will be safe to
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
50 unpack the source distribution on top of this installation.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
51
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
52 + emacs-22.2-barebin-i386.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
53 Windows binaries of Emacs-22.2, without lisp code or documentation.
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
54
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
55 Download this file if you already have the source distribution, or
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
56 if you need to redump the emacs.exe executable.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
57
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
58 Unpack this over the top of either the source distribution or the
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
59 bin distribution above. It contains the bin subdirectory and etc/DOC
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
60 file, plus temacs.exe and dump.bat, which are required if you want to
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
61 redump emacs without recompiling it.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
62
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
63 + libxpm-src.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
64 Source code for libXpm-X11R7.2-3.5.6 modified to compile on Windows.
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
65 This corresponds to the libXpm.dll in emacs-22.2-bin-i386.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
66 and emacs-22.2-barebin-i386.zip.
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
67
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
68
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
69 The following are provided for users who require older versions.
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
70
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
71 + emacs-22.1-bin-i386.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
72 + emacs-22-1-barebin-i386.zip
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
73 Windows binaries of Emacs 22.1, contents as above.
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
74
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
75 + emacs-21.3-bin-i386.tar.gz
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
76 Windows binaries of Emacs 21.3, with compiled lisp code and some
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
77 documentation included.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
78
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
79 + emacs-21.3-leim.tar.gz
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
80 Compiled lisp input methods. This optional addition to Emacs-21.3
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
81 is required if you want to enter languages that are not directly
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
82 supported by your keyboard.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
83
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
84 * Image support
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
85
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
86 Emacs 22.2 contains support for images, however for most image formats
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
87 supporting libraries are required. This distribution has been tested
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
88 with the libraries that are distributed with GTK for Windows, and the
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
89 libraries found at http://gnuwin32.sourceforge.net/. The following image
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
90 formats are supported:
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
91
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
92 PBM/PGM/PPM: Supported natively by Emacs. This format is used for
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
93 the black and white versions of the toolbar icons.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
94
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
95 XPM: a Windows port of the XPM library corresponding to the x.org
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
96 release of X11R7.2 is included with the binary distribution, but
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
97 can be replaced by other versions with the name xpm4.dll,
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
98 libxpm-nox4.dll or libxpm.dll.
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
99
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
100 PNG: requires the PNG reference library 1.2 or later, which will
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
101 be named libpng13d.dll, libpng13.dll, libpng12d.dll, libpng12.dll
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
102 or libpng.dll. LibPNG requires zlib, which should come from the same
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
103 source as you got libpng.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
104
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
105 JPEG: requires the Independant JPEG Group's libjpeg 6b or later,
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
106 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
107
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
108 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
109 or libtiff.dll.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
110
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
111 GIF: requires libungif or giflib 4.1 or later, which will be
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
112 called giflib4.dll, libungif4.dll or libungif.dll.
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
113
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
114 * Distributions in .tar.gz and .zip format
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
115
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
116 Emacs is distributed primarily as source code in a large gzipped tar file
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
117 (*.tar.gz). Because Emacs is quite large and therefore difficult to
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
118 download over unreliable connections, the Windows binaries are provided
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
119 in several combinations, ranging from the complete source plus executables,
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
120 to just the minimal amount needed to run without any source, plus a
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
121 couple of optional packages. Formerly, we used the same .tar.gz format
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
122 but since there are no longer legal problems with .zip files, and the
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
123 latest versions of Windows support these natively, the Windows binaries
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
124 of Emacs are now distributed as .zip files.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
125
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
126 * Distributions for non-x86 platforms
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
127
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
128 Distributions for non-x86 platforms are no longer supplied. Older
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
129 platforms supported by Windows NT no longer seem to be in demand,
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
130 and Emacs is yet to be ported to 64bit Windows platforms. If you are
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
131 willing to help port Emacs 23 to 64bit versions of Windows, your
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
132 contribution will be welcome on the emacs-devel mailing list.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
133
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
134 * Unpacking distributions
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
135
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
136 Ports of GNU gzip and GNU tar for handling the source distribution file
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
137 format can be found in several places that distribute ports of GNU
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
138 programs, for example:
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
139
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
140 Cygwin: http://www.cygwin.com/
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
141 GnuWin32: http://gnuwin32.sourceforge.net/
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
142
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
143 Many other popular file compression utilities for Windows are also
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
144 able to handle gzipped tar files.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
145
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
146 Open a command prompt (MSDOS) window. Decide on a directory in which
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
147 to place Emacs. Move the distribution to that directory, and then
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
148 unpack it as follows.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
149
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
150 If you have the gzipped tar version, use gunzip to uncompress the tar
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
151 file on the fly, and pipe the output through tar with the "xvf" flags
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
152 to extract the files from the tar file:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
153
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
154 % gunzip -c some.tar.gz | tar xvf -
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
155
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
156 You may see messages from tar about not being able to change the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
157 modification time on directories, and from gunzip complaining about a
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
158 broken pipe. These messages are harmless and you can ignore them. On
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
159 Windows NT, unpacking tarballs this way leaves them in compressed
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
160 form, taking up less space on disk. Unfortunately, on Windows 95 and
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
161 98, a large temporary file is created, so it is better to use the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
162 djtarnt.exe program, which performs the equivalent operation in one
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
163 step:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
164
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
165 % djtarnt -x some.tar.gz
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
166
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
167 You may be prompted to rename or overwrite directories when using
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
168 djtarnt: simply type return to continue (this is harmless).
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
169
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
170 Zip files can be unpacked using unzip.exe from info-zip.org
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
171 if you do not already have other tools to do this.
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
172
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
173 % unzip some.zip
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
174
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
175 Once you have unpacked a precompiled distribution of Emacs, it should
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
176 have the following subdirectories:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
177
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
178 bin etc info lisp site-lisp
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
179
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
180
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
181 * Unpacking with other tools
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
182
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
183 If you do use other utility programs to unpack the distribution, check
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
184 the following to be sure the distribution was not corrupted:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
185
77782
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
186 + Be sure to disable the CR/LF translation or the executables will
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
187 be unusable. Older versions of WinZip would enable this
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
188 translation by default when unpacking .tar files. If you are
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
189 using WinZip, disable it. (I don't have WinZip myself, and I do
bde249020282 Transfer changes to branch
Jason Rumney <jasonr@gnu.org>
parents: 75183
diff changeset
190 not know the specific commands necessary to disable it.)
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
191
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
192 + Check that filenames were not truncated to 8.3. For example, there
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
193 should be a file lisp/abbrevlist.el; if this has been truncated to
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
194 abbrevli.el, your distribution has been corrupted while unpacking
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
195 and Emacs will not start.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
196
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
197 + I've also had reports that some older "gnuwin32" port of tar
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
198 corrupts the executables. Use the latest version from the gnuwin32
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
199 site or another port of tar instead.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
200
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
201 If you believe you have unpacked the distributions correctly and are
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
202 still encountering problems, see the section on Further Information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
203 below.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
204
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
205
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
206 * Compiling from source
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
207
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
208 If you would like to compile Emacs from source, download the source
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
209 distribution, unpack it in the same manner as a precompiled
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
210 distribution, and look in the file nt/INSTALL for detailed
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
211 directions. You can either use the Microsoft compiler included with
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
212 Visual C++ 2003 or earlier, or GCC 2.95 or later with MinGW support,
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
213 to compile the source. The port of GCC included in Cygwin is
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
214 supported, but check the nt/INSTALL file if you have trouble since
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
215 some builds of GNU make aren't supported.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
216
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
217
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
218 * Further information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
219
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
220 If you have access to the World Wide Web, I would recommend pointing
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
221 your favorite web browser to following the document (if you haven't
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
222 already):
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
223
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
224 http://www.gnu.org/software/emacs/windows/ntemacs.html
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
225
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
226 This document serves as an FAQ and a source for further information
77866
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
227 about the Windows port and related software packages. Note that as
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
228 of writing, most of the information in that FAQ was for Emacs-21.3
fadb06e1e355 Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents: 77782
diff changeset
229 and earlier versions, so some information may not be relevant to
78461
90683ffc924a Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents: 77866
diff changeset
230 Emacs-22.2.
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
231
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
232 In addition to the FAQ, there is a mailing list for discussing issues
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
233 related to the Windows port of Emacs. For information about the
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
234 list, see this Web page:
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
235
69705
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50665
diff changeset
236 http://lists.gnu.org/mailman/listinfo/help-emacs-windows
50665
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
237
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
238 To ask questions on the mailing list, send email to
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
239 help-emacs-windows@gnu.org. (You don't need to subscribe for that.)
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
240 To subscribe to the list or unsubscribe from it, fill the form you
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
241 find at http://mail.gnu.org/mailman/listinfo/help-emacs-windows as
c5452f417c65 Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents: 49600
diff changeset
242 explained there.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
243
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
244 Another valuable source of information and help which should not be
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
245 overlooked is the various Usenet news groups dedicated to Emacs.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
246 These are particuarly good for help with general issues which aren't
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
247 specific to the Windows port of Emacs. The main news groups to use
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
248 for seeking help are:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
249
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
250 gnu.emacs.help
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
251 comp.emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
252
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
253 There are also fairly regular postings and announcements of new or
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
254 updated Emacs packages on this group:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
255
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
256 gnu.emacs.sources
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
257
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
258 Enjoy!
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
259
75172
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
260 Jason Rumney
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
261 (jasonr@gnu.org)
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
262
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
263 Most of this README was contributed by former maintainer Andrew Innes
24c1f680a7fa Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
264 (andrewi@gnu.org)