Mercurial > emacs
annotate admin/nt/README-ftp-server @ 109351:c8a969d13eda
merge trunk
author | Kenichi Handa <handa@etlken> |
---|---|
date | Fri, 09 Jul 2010 15:55:27 +0900 |
parents | 1d1d5d9bd884 |
children | 376148b31b5e |
rev | line source |
---|---|
106815 | 1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 |
79969
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
2 Free Software Foundation, Inc. |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
3 See the end of the file for license conditions. |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
4 |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
5 Precompiled Distributions of |
50665
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
6 Emacs for Windows |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
7 |
104106 | 8 Version 23.1 |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
39011
diff
changeset
|
9 |
104106 | 10 July 29, 2009 |
103488
1543d68c2ba9
Update version and date for pending pretest.
Jason Rumney <jasonr@gnu.org>
parents:
103267
diff
changeset
|
11 |
101733 | 12 This directory contains precompiled distributions for GNU Emacs on |
13 Windows (versions before Windows 95 and NT4 are not supported). | |
14 This port is a part of the standard GNU Emacs distribution from the | |
15 Free Software Foundation; the precompiled distributions are provided | |
16 here for convenience since the majority of Windows users are not | |
17 accustomed to compiling programs themselves. Corresponding source | |
104106 | 18 can be found in the parent directory in emacs-23.1.tar.gz. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
19 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
20 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
|
21 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
|
22 already): |
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 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
|
25 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
26 * IMPORTANT LEGAL REMINDER |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
27 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
28 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
|
29 Emacs, be careful to check the implications of the GPL. For instance, |
104106 | 30 if you put the emacs-23.1-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
|
31 an Internet site, you must arrange to distribute the source files of |
104106 | 32 the SAME version (i.e. ../emacs-23.1.tar.gz). |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
33 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
34 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
|
35 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
|
36 old binaries. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
37 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
38 |
77866
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
39 * 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
|
40 |
104106 | 41 + emacs-23.1-bin-i386.zip |
42 Windows binaries of Emacs-23.1, 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
|
43 included. |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
44 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
45 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
|
46 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
|
47 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
|
48 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
|
49 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
50 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
|
51 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
|
52 |
104106 | 53 + emacs-23.1-barebin-i386.zip |
54 Windows binaries of Emacs-23.1, 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
|
55 |
102864 | 56 Download this file if you already have the source distribution. |
77866
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
57 |
102864 | 58 Unpack this over the top of the source distribution. It contains the |
59 bin subdirectory and etc/DOC file. | |
77866
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
60 |
78828
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
61 + libxpm-3.5.7-w32-src.zip |
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
62 Source code required to compile libXpm-3.5.7 on Windows. Contains |
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
63 a basic Makefile for compiling with mingw32 and a .def file for |
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
64 generating a DLL with the appropriate exports in addition to the |
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
65 source code to provide the subset of functionality Emacs uses from |
104106 | 66 libXpm. This corresponds to the libXpm.dll in emacs-23.1-bin-i386.zip |
67 and emacs-23.1-barebin-i386.zip. | |
77866
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
68 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
69 * Image support |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
70 |
104106 | 71 Emacs 23.1 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
|
72 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
|
73 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
|
74 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
|
75 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
|
76 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
77 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
|
78 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
|
79 |
78461
90683ffc924a
Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents:
77866
diff
changeset
|
80 XPM: a Windows port of the XPM library corresponding to the x.org |
78828
90e7bc7fb7a3
Updated libXpm to 3.5.7 (from x.org X11R7.3)
Jason Rumney <jasonr@gnu.org>
parents:
78461
diff
changeset
|
81 release of X11R7.3 is included with the binary distribution, but |
78461
90683ffc924a
Update for Emacs 22.2, including libxpm.
Jason Rumney <jasonr@gnu.org>
parents:
77866
diff
changeset
|
82 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
|
83 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
|
84 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
85 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
|
86 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
|
87 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
|
88 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
|
89 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
90 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
|
91 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
|
92 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
93 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
|
94 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
|
95 |
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
96 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
|
97 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
|
98 |
101733 | 99 SVG: not compiled into the binary release, but available if you |
100 compile Emacs yourself if you have development packages for all the | |
101 dependencies. Requires many libraries from GTK and Gnome | |
102 as well as the base librsvg library. Known to crash Emacs on many | |
103 sample images. | |
104 | |
77782 | 105 * Distributions in .tar.gz and .zip format |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
106 |
80764
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
107 Emacs is distributed primarily as source code in a large gzipped tar |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
108 file (*.tar.gz). Because Emacs is quite large and therefore |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
109 difficult to download over unreliable connections, the Windows |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
110 binaries are provided in two combinations. The complete lisp source |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
111 plus executables (bin), and executables only (barebin) for unpacking |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
112 over the top of the source distribution. Formerly, we used the same |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
113 .tar.gz format but since there are no longer legal problems with |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
114 .zip files, and the latest versions of Windows support these |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
115 natively, the Windows binaries of Emacs are now distributed as .zip |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
116 files. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
117 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
118 * Distributions for non-x86 platforms |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
119 |
75172
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
120 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
|
121 platforms supported by Windows NT no longer seem to be in demand, |
80764
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
122 and Emacs is yet to be ported to 64 bit Windows platforms. If you |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
123 are willing to help port Emacs 23 to 64 bit versions of Windows, |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
124 your 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
|
125 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
126 * Unpacking distributions |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
127 |
77782 | 128 Ports of GNU gzip and GNU tar for handling the source distribution file |
129 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
|
130 programs, for example: |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
131 |
75172
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
132 Cygwin: http://www.cygwin.com/ |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
133 GnuWin32: http://gnuwin32.sourceforge.net/ |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
134 |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
135 Many other popular file compression utilities for Windows are also |
80764
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
136 able to handle gzipped tar files. 7zip is one free Windows graphical |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
137 program that is able to handle many archive formats. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
138 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
139 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
|
140 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
|
141 unpack it as follows. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
142 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
143 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
|
144 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
|
145 to extract the files from the tar file: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
146 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
147 % gunzip -c some.tar.gz | tar xvf - |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
148 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
149 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
|
150 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
|
151 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
|
152 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
|
153 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
|
154 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
|
155 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
|
156 step: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
157 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
158 % djtarnt -x some.tar.gz |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
159 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
160 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
|
161 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
|
162 |
77866
fadb06e1e355
Changes suggested by Eli to clarify the purpose of the various files,
Jason Rumney <jasonr@gnu.org>
parents:
77782
diff
changeset
|
163 Zip files can be unpacked using unzip.exe from info-zip.org |
77782 | 164 if you do not already have other tools to do this. |
165 | |
166 % unzip some.zip | |
167 | |
90851 | 168 The precompiled binaries can be unpacked using unzip.exe from info-zip.org |
169 if you do not already have other tools to do this. | |
170 | |
171 % unzip some.zip | |
172 | |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
173 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
|
174 have the following subdirectories: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
175 |
75172
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
176 bin etc info lisp site-lisp |
50665
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
177 |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
178 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
179 * Unpacking with other tools |
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 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
|
182 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
|
183 |
77782 | 184 + Be sure to disable the CR/LF translation or the executables will |
185 be unusable. Older versions of WinZip would enable this | |
186 translation by default when unpacking .tar files. If you are | |
187 using WinZip, disable it. (I don't have WinZip myself, and I do | |
188 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
|
189 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
190 + 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
|
191 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
|
192 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
|
193 and Emacs will not start. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
194 |
80764
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
195 + Check that filenames were not changed by your web-browser. Some |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
196 proprietary web-browsers save .tar.gz files as .tar.tar. You might |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
197 like to consider switching to a Free modern browser if your browser |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
198 has this bug. |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
199 |
75172
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
200 + 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
|
201 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
|
202 site or another port of tar instead. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
203 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
204 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
|
205 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
|
206 below. |
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 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
209 * Compiling from source |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
210 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
211 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
|
212 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
|
213 distribution, and look in the file nt/INSTALL for detailed |
80764
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
214 directions. It is recommended to use GCC 2.95 or later with MinGW |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
215 support to compile the source. The port of GCC included in Cygwin |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
216 is supported, but check the nt/INSTALL file if you have trouble |
8c1de2106017
Update based on current directory layout and recommended tools.
Jason Rumney <jasonr@gnu.org>
parents:
80362
diff
changeset
|
217 since 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
|
218 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
219 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
220 * Further information |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
221 |
50665
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
222 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
|
223 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
|
224 already): |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
225 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
226 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
|
227 |
50665
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
228 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
|
229 about the Windows port and related software packages. Note that as |
101733 | 230 most of the information in that FAQ is for earlier versions, so some |
104106 | 231 information may not be relevant to Emacs-23.1. |
50665
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
232 |
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
233 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
|
234 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
|
235 list, see this Web page: |
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
236 |
69705 | 237 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
|
238 |
c5452f417c65
Update wording and version number etc.
Andrew Innes <andrewi@gnu.org>
parents:
49600
diff
changeset
|
239 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
|
240 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
|
241 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
|
242 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
|
243 explained there. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
244 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
245 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
|
246 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
|
247 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
|
248 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
|
249 for seeking help are: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
250 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
251 gnu.emacs.help |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
252 comp.emacs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
253 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
254 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
|
255 updated Emacs packages on this group: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
256 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
257 gnu.emacs.sources |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
258 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
259 Enjoy! |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
260 |
75172
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
261 Jason Rumney |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
262 (jasonr@gnu.org) |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
263 |
24c1f680a7fa
Update URLs and advice about unpacking gzipped tar files.
Jason Rumney <jasonr@gnu.org>
parents:
69705
diff
changeset
|
264 Most of this README was contributed by former maintainer Andrew Innes |
79969
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
265 (andrewi@gnu.org) |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
266 |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
267 |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
268 This file is part of GNU Emacs. |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
269 |
94830
21e11734e56b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93759
diff
changeset
|
270 GNU Emacs is free software: you can redistribute it and/or modify |
79969
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
271 it under the terms of the GNU General Public License as published by |
94830
21e11734e56b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93759
diff
changeset
|
272 the Free Software Foundation, either version 3 of the License, or |
21e11734e56b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93759
diff
changeset
|
273 (at your option) any later version. |
79969
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
274 |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
275 GNU Emacs is distributed in the hope that it will be useful, |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
276 but WITHOUT ANY WARRANTY; without even the implied warranty of |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
277 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
278 GNU General Public License for more details. |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
279 |
4932bb1eee7a
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
78828
diff
changeset
|
280 You should have received a copy of the GNU General Public License |
94830
21e11734e56b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93759
diff
changeset
|
281 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |