aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2014-02-08 12:25:33 +0200
committerEli Zaretskii2014-02-08 12:25:33 +0200
commitc8740fa21b0ff2aeedbcf02e961c53b10f25dcc0 (patch)
treebede7def63526398ed7d146cb99bd569f4aab47f
parent2423c8d576232f0b0fa9fa7b431883f9b3452921 (diff)
downloademacs-c8740fa21b0ff2aeedbcf02e961c53b10f25dcc0.tar.gz
emacs-c8740fa21b0ff2aeedbcf02e961c53b10f25dcc0.zip
Fix bug #14762 with insufficient and outdated w32 installation documentation.
nt/INSTALL: Update for Emacs 24.4. nt/README: Update for Emacs 24.4. nt/README.W32: Update and improve instructions.
-rw-r--r--nt/ChangeLog8
-rw-r--r--nt/INSTALL8
-rw-r--r--nt/README27
-rw-r--r--nt/README.W3263
4 files changed, 66 insertions, 40 deletions
diff --git a/nt/ChangeLog b/nt/ChangeLog
index d3447b504b0..4c20ce5be81 100644
--- a/nt/ChangeLog
+++ b/nt/ChangeLog
@@ -1,3 +1,11 @@
12014-02-08 Eli Zaretskii <eliz@gnu.org>
2
3 * INSTALL: Update for Emacs 24.4.
4
5 * README: Update for Emacs 24.4.
6
7 * README.W32: Update and improve instructions. (Bug#14762)
8
12014-02-08 Lars Ingebrigtsen <larsi@gnus.org> 92014-02-08 Lars Ingebrigtsen <larsi@gnus.org>
2 10
3 * README.W32: Say what GnuTLS and libxml2 does (bug#14762). 11 * README.W32: Say what GnuTLS and libxml2 does (bug#14762).
diff --git a/nt/INSTALL b/nt/INSTALL
index 088c5f9bc0d..6262e961857 100644
--- a/nt/INSTALL
+++ b/nt/INSTALL
@@ -568,6 +568,14 @@ Windows 9X as well).
568 libraries that are known to be compatible with the version given by 568 libraries that are known to be compatible with the version given by
569 `libgif-version'. 569 `libgif-version'.
570 570
571 For JPEG images, you will need libjpeg 6b or later, which will be
572 called libjpeg-N.dll, jpeg62.dll, libjpeg.dll, or jpeg.dll. You can
573 find these on the ezwinports site.
574
575 TIFF images require libTIFF 3.0 or later, which will be called
576 libtiffN.dll or libtiff-N.dll or libtiff.dll. These can be found on
577 the ezwinports site.
578
571 Pre-built versions of librsvg and its dependencies can be found in 579 Pre-built versions of librsvg and its dependencies can be found in
572 one of these places: 580 one of these places:
573 581
diff --git a/nt/README b/nt/README
index bade1ce2d29..14c89a0a17c 100644
--- a/nt/README
+++ b/nt/README
@@ -25,15 +25,17 @@
25 Building and installing Emacs will produce the following executable 25 Building and installing Emacs will produce the following executable
26 files in the bin directory. 26 files in the bin directory.
27 27
28 + emacs.exe - The main Emacs executable. As this is designed to run 28 + emacs.exe - The main Emacs executable. As this is designed to run
29 as both a text-mode application (emacs -nw) and as a GUI application, 29 as both a text-mode application (emacs -nw) and as a GUI application,
30 it will pop up a command prompt window if run directly from Explorer. 30 it will pop up a command prompt window if run directly from Explorer.
31 31
32 + runemacs.exe - A wrapper for running Emacs as a GUI application 32 + runemacs.exe - A wrapper for running Emacs as a GUI application
33 without popping up a command prompt window. 33 without popping up a command prompt window. If you create a
34 desktop shortcut for invoking Emacs, make it point to this
35 executable, not to emacs.exe.
34 36
35 + emacsclient.exe - A command-line client program that can 37 + emacsclient.exe - A command-line client program that can
36 communicate with a running Emacs process. See the `Emacs Server' 38 communicate with a running Emacs process. See the `Emacs Server'
37 node of the Emacs manual. 39 node of the Emacs manual.
38 40
39 + emacsclientw.exe - A version of emacsclient that does not open 41 + emacsclientw.exe - A version of emacsclient that does not open
@@ -42,15 +44,18 @@
42 + addpm.exe - A basic installer that creates Start Menu icons for Emacs. 44 + addpm.exe - A basic installer that creates Start Menu icons for Emacs.
43 Running this is optional. 45 Running this is optional.
44 46
45 + cmdproxy.exe - Used internally by Emacs to work around problems with
46 the native shells in various versions of Windows.
47
48 + ctags.exe, etags.exe - Tools for generating tag files. See the 47 + ctags.exe, etags.exe - Tools for generating tag files. See the
49 `Tags' node of the Emacs manual. 48 `Tags' node of the Emacs manual.
50 49
51 + ebrowse.exe - A tool for generating C++ browse information. See the 50 + ebrowse.exe - A tool for generating C++ browse information. See the
52 `Ebrowse' manual. 51 `Ebrowse' manual.
53 52
53 Several helper programs are installed in a version-specific
54 subdirectory of the libexec directory:
55
56 + cmdproxy.exe - Used internally by Emacs to work around problems with
57 the native shells in various versions of Windows.
58
54 + ddeclient.exe - A tool for interacting with DDE servers. To be 59 + ddeclient.exe - A tool for interacting with DDE servers. To be
55 invoked as "ddeclient SERVER [TOPIC]", where SERVER is the DDE 60 invoked as "ddeclient SERVER [TOPIC]", where SERVER is the DDE
56 server name, and sends each line of its standard input to the DDE 61 server name, and sends each line of its standard input to the DDE
@@ -58,13 +63,19 @@
58 supposed to be invoked via the 'call-process-region' Emacs 63 supposed to be invoked via the 'call-process-region' Emacs
59 primitive. 64 primitive.
60 65
61 + hexl.exe - A tool for converting files to hex dumps. See the 66 + hexl.exe - A tool for producing hex dumps of binary files. See the
62 `Editing Binary Files' node of the Emacs manual. 67 `Editing Binary Files' node of the Emacs manual.
63 68
64 + movemail.exe - A helper application for safely moving mail from 69 + movemail.exe - A helper application for safely moving mail from
65 a mail spool or POP server to a local user mailbox. See the 70 a mail spool or POP server to a local user mailbox. See the
66 `Movemail' node of the Emacs manual. 71 `Movemail' node of the Emacs manual.
67 72
73 + profile.exe - A helper program that generates periodic events for
74 profiling Emacs Lisp code.
75
76 + update-game-score.exe - A utility for updating the score files of
77 Emacs games.
78
68* Further information 79* Further information
69 80
70 The FAQ for the MS Windows port of Emacs is distributed with Emacs 81 The FAQ for the MS Windows port of Emacs is distributed with Emacs
diff --git a/nt/README.W32 b/nt/README.W32
index 4f94b6027a5..c4e4cf351d4 100644
--- a/nt/README.W32
+++ b/nt/README.W32
@@ -10,13 +10,14 @@ See the end of the file for license conditions.
10 ftp://ftp.gnu.org/gnu/emacs/windows/ 10 ftp://ftp.gnu.org/gnu/emacs/windows/
11 11
12 This server contains other distributions, including the full Emacs 12 This server contains other distributions, including the full Emacs
13 source distribution and a barebin distribution which can be installed 13 source distribution, as well as older releases of Emacs for Windows.
14 over it, as well as older releases of Emacs for Windows.
15 14
16 Information on how to compile Emacs from sources on Windows is in 15 Information on how to compile Emacs from sources on Windows is in
17 the files README and INSTALL in this directory. If you received 16 the files README and INSTALL in the nt/ sub-directory of the
18 this file as part of the Emacs source distribution, please read 17 top-level Emacs directory in the source distribution. If you
19 those 2 files and not this one. 18 received this file as part of the Emacs source distribution, and are
19 looking for information on how to build Emacs on MS-Windows, please
20 read those 2 files and not this one.
20 21
21* Preliminaries 22* Preliminaries
22 23
@@ -26,11 +27,10 @@ See the end of the file for license conditions.
26* Setting up Emacs 27* Setting up Emacs
27 28
28 To install Emacs, simply unpack all the files into a directory of 29 To install Emacs, simply unpack all the files into a directory of
29 your choice, but note that you might encounter minor problems if 30 your choice. To complete the installation process, you can
30 there is a space anywhere in the directory name. To complete the 31 optionally run the program addpm.exe in the bin subdirectory. This
31 installation process, you can optionally run the program addpm.exe 32 will put an icon for Emacs in the Start Menu under
32 in the bin subdirectory. This will put an icon for Emacs in the 33 "Start -> Programs -> Gnu Emacs".
33 Start Menu under "Start -> Programs -> Gnu Emacs".
34 34
35 Some users have reported that the Start Menu item is not created for 35 Some users have reported that the Start Menu item is not created for
36 them. If this happens, just create your own shortcut to runemacs.exe, 36 them. If this happens, just create your own shortcut to runemacs.exe,
@@ -52,9 +52,7 @@ See the end of the file for license conditions.
52 downloaded from the Microsoft site, and comes in a form of a single 52 downloaded from the Microsoft site, and comes in a form of a single
53 dynamic library called UNICOWS.DLL. If this library is not 53 dynamic library called UNICOWS.DLL. If this library is not
54 accessible to Emacs, it will pop up a dialog saying that it cannot 54 accessible to Emacs, it will pop up a dialog saying that it cannot
55 find the library, and will refuse to start up a GUI session. 55 find the library, and will refuse to start up.
56 (However, it is still possible to use Emacs in text mode, even
57 without UNICOWS.DLL, by invoking it as "emacs -nw", see below.)
58 56
59* Starting Emacs 57* Starting Emacs
60 58
@@ -130,24 +128,31 @@ See the end of the file for license conditions.
130* Image support 128* Image support
131 129
132 Emacs has built in support for XBM and PPM/PGM/PBM images, and the 130 Emacs has built in support for XBM and PPM/PGM/PBM images, and the
131 libXpm library is bundled, providing XPM support (required for color
132 toolbar icons and splash screen). Source for libXpm should be available
133 from the same place from which you got this binary distribution.
134
135 Emacs can also support some other image formats with appropriate
133 libraries. These libraries are all available on the following sites: 136 libraries. These libraries are all available on the following sites:
134 137
135 1. http://sourceforge.net/projects/ezwinports/files/ 138 1. http://sourceforge.net/projects/ezwinports/files/
136 -- leaner, more up-to-date builds, only for 32-bit Emacs 139 -- leaner, more up-to-date builds, only for 32-bit Emacs
137 2. http://www.gtk.org/download/win32.php 140 2. http://www.gtk.org/download/win32.php
138 http://www.gtk.org/download/win64.php 141 http://www.gtk.org/download/win64.php
139 -- GTK project site; offers much fatter builds, but includes 64-bit 142 -- the GTK project site; offers much fatter builds, but includes
140 DLLs 143 64-bit DLLs (from the 2nd URL)
141 3. GnuWin32 project -- very old builds, not recommended 144 3. GnuWin32 project -- very old builds, not recommended
142 145
143 Emacs will find these libraries if the directory they are installed 146 The libraries to download are mentioned below. Some libraries
144 in is on the PATH. 147 depend on others that need to be downloaded separately from the same
148 site; please consult the download instructions on each site for the
149 details. In general, the ezwinports site mentioned above has all
150 the dependencies bundled in the same zip archive, so installing from
151 there is the easiest.
145 152
146 Emacs can also support some other image formats with appropriate 153 Emacs will find these libraries if the directory they are installed
147 libraries. These libraries are all available as part of GTK 154 in is on the PATH or in the same directory where you have emacs.exe.
148 download for Windows (http://www.gtk.org/download/win32.php), or 155 Here are some specific comments about each image type:
149 from the GnuWin32 project. Emacs will find them if the directory
150 they are installed in is on the PATH.
151 156
152 PNG: requires the PNG reference library 1.4 or later, which will 157 PNG: requires the PNG reference library 1.4 or later, which will
153 be named libpngNN.dll or libpngNN-NN.dll. LibPNG requires zlib, 158 be named libpngNN.dll or libpngNN-NN.dll. LibPNG requires zlib,
@@ -161,8 +166,8 @@ See the end of the file for license conditions.
161 JPEG: requires the Independent JPEG Group's libjpeg 6b or later, 166 JPEG: requires the Independent JPEG Group's libjpeg 6b or later,
162 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll. 167 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
163 168
164 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll 169 TIFF: requires libTIFF 3.0 or later, which will be called libtiffN.dll
165 or libtiff.dll. 170 or libtiff-N.dll or libtiff.dll.
166 171
167 GIF: requires libungif or giflib 4.1 or later, which will be 172 GIF: requires libungif or giflib 4.1 or later, which will be
168 called libgif-6.dll, giflib4.dll, libungif4.dll or libungif.dll. 173 called libgif-6.dll, giflib4.dll, libungif4.dll or libungif.dll.
@@ -171,18 +176,12 @@ See the end of the file for license conditions.
171 librsvg-2-2.dll. SVG also requires several dependency DLLs, 176 librsvg-2-2.dll. SVG also requires several dependency DLLs,
172 such as Pango, Cairo, and Glib, all of them found on the 177 such as Pango, Cairo, and Glib, all of them found on the
173 above-mentioned sites. If you download from the ezwinports 178 above-mentioned sites. If you download from the ezwinports
174 site, you need only librsvg-2.nn.x-bin.zip, it comes with all 179 site, you need only librsvg-2.nn.mm-x-w32-bin.zip, it comes with
175 the other dependencies bundled. 180 all the other dependencies bundled.
176 181
177 If you have image support DLLs under different names, customize the 182 If you have image support DLLs under different names, customize the
178 value of `dynamic-library-alist'. 183 value of `dynamic-library-alist'.
179 184
180 In addition, Emacs can be compiled to support SVG. This precompiled
181 distribution has not been compiled that way, since the SVG library
182 or one or more of its extensive dependencies appear to be
183 unreliable under Windows. See nt/INSTALL in the src distribution if
184 you wish to compile Emacs with SVG support.
185
186* GnuTLS support 185* GnuTLS support
187 186
188 GnuTLS provides SSL/TLS network support for Emacs (https, imaps and 187 GnuTLS provides SSL/TLS network support for Emacs (https, imaps and