diff options
| author | Eli Zaretskii | 2014-02-08 12:25:33 +0200 |
|---|---|---|
| committer | Eli Zaretskii | 2014-02-08 12:25:33 +0200 |
| commit | c8740fa21b0ff2aeedbcf02e961c53b10f25dcc0 (patch) | |
| tree | bede7def63526398ed7d146cb99bd569f4aab47f | |
| parent | 2423c8d576232f0b0fa9fa7b431883f9b3452921 (diff) | |
| download | emacs-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/ChangeLog | 8 | ||||
| -rw-r--r-- | nt/INSTALL | 8 | ||||
| -rw-r--r-- | nt/README | 27 | ||||
| -rw-r--r-- | nt/README.W32 | 63 |
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 @@ | |||
| 1 | 2014-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 | |||
| 1 | 2014-02-08 Lars Ingebrigtsen <larsi@gnus.org> | 9 | 2014-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 | ||
| @@ -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 |