Mercurial > emacs
annotate nt/README.W32 @ 112098:40af77a50adc
Merge changes from emacs-23 branch
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Sun, 02 Jan 2011 15:28:40 -0500 |
parents | 1529ab88805c |
children | cb7f7a583491 |
rev | line source |
---|---|
111098
1529ab88805c
Replace digest-doc and sorted-doc C programs with Lisp commands.
Glenn Morris <rgm@gnu.org>
parents:
109507
diff
changeset
|
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, |
1529ab88805c
Replace digest-doc and sorted-doc C programs with Lisp commands.
Glenn Morris <rgm@gnu.org>
parents:
109507
diff
changeset
|
2 2010 Free Software Foundation, Inc. |
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
3 See the end of the file for license conditions. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
4 |
50662
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
5 Emacs for Windows |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
6 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
7 This README file describes how to set up and run a precompiled |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
8 version of GNU Emacs for Windows. This distribution can be found on |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
9 the ftp.gnu.org server and its mirrors: |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
10 |
69705 | 11 ftp://ftp.gnu.org/gnu/emacs/windows/ |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
12 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
13 This server contains other distributions, including the full Emacs |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
14 source distribution and a barebin distribution which can be installed |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
15 over it, as well as older releases of Emacs for Windows. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
16 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
17 Answers to frequently asked questions, and further information about |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
18 this port of GNU Emacs and related software packages can be found via |
69705 | 19 http: |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
20 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
21 http://www.gnu.org/software/emacs/windows/ |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
22 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
23 * Preliminaries |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
24 |
102252 | 25 Along with this file should be six subdirectories (bin, etc, info, |
26 lisp, leim, site-lisp). If you have downloaded the barebin | |
27 distribution, then it will contain only the bin directory and the | |
28 built in documentation in etc/DOC-X, the rest of the subdirectories | |
29 are in the src distribution, which the barebin distribution is | |
30 designed to be used with. | |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
31 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
32 * Setting up Emacs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
33 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
34 To install Emacs, simply unpack all the files into a directory of |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
35 your choice, but note that you might encounter minor problems if |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
36 there is a space anywhere in the directory name. To complete the |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
37 installation process, you can optionally run the program addpm.exe |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
38 in the bin subdirectory. This will put an icon for Emacs in the |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
39 Start Menu under "Start -> Programs -> Gnu Emacs". |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
40 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
41 Some users have reported that the Start Menu item is not created for |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
42 them. If this happens, just create your own shortcut to runemacs.exe, |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
43 eg. by dragging it on to the desktop or the Start button. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
44 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
45 Note that running addpm is now an optional step; Emacs is able to |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
46 locate all of its files without needing any information to be set in |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
47 the environment or the registry, although such settings will still |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
48 be obeyed if present. This is convenient for running Emacs on a |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
49 machine which disallows registry changes, or on which software |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
50 should not be installed. For instance, you can now run Emacs |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
51 directly from a CD or USB flash drive without copying or installing |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
52 anything on the machine itself. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
53 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
54 * Starting Emacs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
55 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
56 To run Emacs, simply select Emacs from the Start Menu, or invoke |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
57 runemacs.exe directly from Explorer or from a command prompt. This |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
58 will start Emacs in its default GUI mode, ready to use. If you have |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
59 never used Emacs before, you should follow the tutorial at this |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
60 point (select Emacs Tutorial from the Help menu), since Emacs is |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
61 quite different from ordinary Windows applications in many respects. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
62 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
63 If you want to use Emacs in tty or character mode within a command |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
64 window, you can start it by typing "emacs -nw" at the command prompt. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
65 (Obviously, you need to ensure that the Emacs bin subdirectory is in |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
66 your PATH first, or specify the path to emacs.exe.) The -nw |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
67 (non-windowed) mode of operation is most useful if you have a telnet |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
68 server on your machine, allowing you to run Emacs remotely. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
69 |
79982
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
70 * EXE files included |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
71 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
72 Emacs comes with the following executable files in the bin directory. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
73 |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
74 + emacs.exe - The main Emacs executable. As this is designed to run |
79982
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
75 as both a text-mode application (emacs -nw) and as a GUI application, |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
76 it will pop up a command prompt window if run directly from Explorer. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
77 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
78 + runemacs.exe - A wrapper for running Emacs as a GUI application |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
79 without popping up a command prompt window. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
80 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
81 + emacsclient.exe - A command-line client program that can |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
82 communicate with a running Emacs process. See the `Emacs Server' |
101819
aa1eb92e5930
* nt/README.W32: Fix typo. (Bug#2207)
Juanma Barranquero <lekktu@gmail.com>
parents:
100971
diff
changeset
|
83 node of the Emacs manual. |
79982
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
84 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
85 + emacsclientw.exe - A version of emacsclient that does not open |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
86 a command-line window. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
87 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
88 + addpm.exe - A basic installer that creates Start Menu icons for Emacs. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
89 Running this is optional. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
90 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
91 + cmdproxy.exe - Used internally by Emacs to work around problems with |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
92 the native shells in various versions of Windows. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
93 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
94 + ctags.exe, etags.exe - Tools for generating tag files. See the |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
95 `Tags' node of the Emacs manual. |
79982
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
96 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
97 + ebrowse.exe - A tool for generating C++ browse information. See the |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
98 `Ebrowse' manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
99 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
100 + ddeclient.exe - A tool for interacting with DDE servers. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
101 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
102 + hexl.exe - A tool for converting files to hex dumps. See the |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
103 `Editing Binary Files' node of the Emacs manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
104 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
105 + movemail.exe - A helper application for safely moving mail from |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
106 a mail spool or POP server to a local user mailbox. See the |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
107 `Movemail' node of the Emacs manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
108 |
79142 | 109 * Image support |
110 | |
111 Emacs has built in support for XBM and PPM/PGM/PBM images, and the | |
112 libXpm library is bundled, providing XPM support (required for color | |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
113 toolbar icons and splash screen). Source for libXpm should be available |
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
114 on the same place as you got this binary distribution from. The version |
79979
643c20b8a0de
Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents:
79967
diff
changeset
|
115 of libXpm bundled with this version of Emacs is 3.5.7, based on x.org's |
643c20b8a0de
Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents:
79967
diff
changeset
|
116 libXpm library from X11R7.3. |
79142 | 117 |
118 Emacs can also support some other image formats with appropriate | |
112098
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
119 libraries. These libraries are all available as part of GTK |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
120 download for Windows (http://www.gtk.org/download-windows.html), or |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
121 from the GnuWin32 project. Emacs will find them if the directory |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
122 they are installed in is on the PATH. |
79142 | 123 |
112098
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
124 PNG: requires the PNG reference library 1.4 or later, which will |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
125 be named libpng14.dll or libpng14-14.dll. LibPNG requires zlib, |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
126 which should come from the same source as you got libpng. |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
127 Starting with Emacs 23.3, the precompiled Emacs binaries are |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
128 built with libpng 1.4.x and later, and are incompatible with |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
129 earlier versions of libpng DLLs. So if you have libpng 1.2.x, |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
130 the PNG support will not work, and you will have to download |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
131 newer versions. |
79142 | 132 |
133 JPEG: requires the Independant JPEG Group's libjpeg 6b or later, | |
134 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll. | |
135 | |
136 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll | |
137 or libtiff.dll. | |
138 | |
139 GIF: requires libungif or giflib 4.1 or later, which will be | |
140 called giflib4.dll, libungif4.dll or libungif.dll. | |
141 | |
112098
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
142 If you have image support DLLs under different names, customize the |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
143 value of `image-library-alist'. |
40af77a50adc
Merge changes from emacs-23 branch
Chong Yidong <cyd@stupidchicken.com>
parents:
111098
diff
changeset
|
144 |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
145 In addition, Emacs can be compiled to support SVG. This precompiled |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
146 distribution has not been compiled that way, since the SVG library |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
147 or one or more of its extensive dependencies appear to be |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
148 unreliable under Windows. See nt/INSTALL in the src distribution if |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
149 you wish to compile Emacs with SVG support. |
79142 | 150 |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
151 * Uninstalling Emacs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
152 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
153 If you should need to uninstall Emacs, simply delete all the files |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
154 and subdirectories from the directory where it was unpacked (Emacs |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
155 does not install or update any files in system directories or |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
156 anywhere else). If you ran the addpm.exe program to create the |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
157 registry entries and the Start menu icon, then you can remove the |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
158 registry entries using regedit. All of the settings are written |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
159 under the Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
160 didn't have administrator privileges when you installed, the same |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
161 key in HKEY_CURRENT_USER. Just delete the whole Software\GNU\Emacs |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
162 key. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
163 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
164 The Start menu entry can be removed by right-clicking on the Task bar |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
165 and selecting Properties, then using the Remove option on the Start |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
166 Menu Programs page. (If you installed under an account with |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
167 administrator privileges, then you need to click the Advanced button |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
168 and look for the Gnu Emacs menu item under All Users.) |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
169 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
170 * Troubleshooting |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
171 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
172 Unpacking the distributions |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
173 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
174 If you encounter trouble trying to run Emacs, there are a number of |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
175 possible causes. Check the following for indications that the |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
176 distribution was not corrupted by the tools used to unpack it: |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
177 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
178 * Be sure to disable CR/LF translation or the executables will |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
179 be unusable. Older versions of WinZipNT would enable this |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
180 translation by default. If you are using WinZipNT, disable it. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
181 (I don't have WinZipNT myself, and I do not know the specific |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
182 commands necessary to disable it.) |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
183 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
184 * Check that filenames were not truncated to 8.3. For example, |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
185 there should be a file lisp\abbrevlist.elc; if this has been |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
186 truncated to abbrevli.elc, your distribution has been corrupted |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
187 while unpacking and Emacs will not start. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
188 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
189 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
|
190 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
|
191 below. |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
192 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
193 Virus scanners |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
194 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
195 Some virus scanners interfere with Emacs' use of subprocesses. If you |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
196 are unable to use subprocesses and you use Dr. Solomon's WinGuard or |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
197 McAfee's Vshield, turn off "Scan all files" (WinGuard) or "boot sector |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
198 scanning" (McAfee exclusion properties). |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
199 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
200 * Further information |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
201 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
202 If you have access to the World Wide Web, I would recommend pointing |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
203 your favorite web browser to the following document (if you haven't |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
204 already): |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
205 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
206 http://www.gnu.org/software/emacs/windows/ |
39011
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 This document serves as an FAQ and a source for further information |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
209 about the Windows port and related software packages. |
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 In addition to the FAQ, there is a mailing list for discussing issues |
41243
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
212 related to the Windows port of Emacs. For information about the |
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
213 list, see this Web page: |
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
214 |
69705 | 215 http://lists.gnu.org/mailman/listinfo/help-emacs-windows |
41243
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
216 |
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
217 To ask questions on the mailing list, send email to |
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
218 help-emacs-windows@gnu.org. (You don't need to subscribe for that.) |
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
219 To subscribe to the list or unsubscribe from it, fill the form you |
69705 | 220 find at http://lists.gnu.org/mailman/listinfo/help-emacs-windows as |
41243
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
221 explained there. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
222 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
223 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
|
224 overlooked is the various Usenet news groups dedicated to Emacs. |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
225 These are particularly good for help with general issues which aren't |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
226 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
|
227 for seeking help are: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
228 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
229 gnu.emacs.help |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
230 comp.emacs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
231 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
232 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
|
233 updated Emacs packages on this group: |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
234 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
235 gnu.emacs.sources |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
236 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
237 * Reporting bugs |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
238 |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
239 If you encounter a bug in this port of Emacs, we would like to hear |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
240 about it. First check the FAQ on the web page above to see if the bug |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
241 is already known and if there are any workarounds. Then check whether |
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
242 the bug has something to do with code in your .emacs file, e.g. by |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
243 invoking Emacs with the "-Q" option. |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
244 |
102217
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
245 If you decide that it is a bug in Emacs, use the built in bug |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
246 reporting facility to report it (from the menu; Help -> Send Bug Report). |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
247 If you have not yet configured Emacs for mail, then when you press |
e368bec025a6
Remove ever expanding versions of Windows. Shorten FAQ URL. Remove
Jason Rumney <jasonr@gnu.org>
parents:
101819
diff
changeset
|
248 C-c C-c to send the report, it will ask you to paste the text of the |
102238
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
249 report into your mail client. If the bug is related to subprocesses, |
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
250 also specify which shell you are using (e.g., include the values of |
df4c10114523
* nt/README.W32: Fix typos.
Juanma Barranquero <lekktu@gmail.com>
parents:
102217
diff
changeset
|
251 `shell-file-name' and `explicit-shell-file-name' in your message). |
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
252 |
50661
e2a7895c7934
Remove personal email address.
Andrew Innes <andrewi@gnu.org>
parents:
42926
diff
changeset
|
253 Enjoy! |
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
254 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
255 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
256 This file is part of GNU Emacs. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
257 |
94830
21e11734e56b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79982
diff
changeset
|
258 GNU Emacs is free software: you can redistribute it and/or modify |
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
259 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:
79982
diff
changeset
|
260 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:
79982
diff
changeset
|
261 (at your option) any later version. |
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
262 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
263 GNU Emacs is distributed in the hope that it will be useful, |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
264 but WITHOUT ANY WARRANTY; without even the implied warranty of |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
265 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
266 GNU General Public License for more details. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
267 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
268 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:
79982
diff
changeset
|
269 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |