79967
|
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
|
|
2 Free Software Foundation, Inc.
|
|
3 See the end of the file for license conditions.
|
|
4
|
50662
|
5 Emacs for Windows
|
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
6
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
7 This README file describes how to set up and run a precompiled version
|
50662
|
8 of GNU Emacs for Windows NT/2000/XP and Windows 95/98/Me. This
|
41243
|
9 distribution can be found on 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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
14 source distribution and the lisp source distribution, as well as older
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
15 releases of Emacs for Windows.
|
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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
21 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
|
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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
25 Along with this file should be six subdirectories (bin, etc, info,
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
26 lisp, lock, site-lisp). Depending on which distribution you have
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
27 installed, the lisp subdirectory might contain both the lisp source
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
28 (*.el) and compiled lisp files (*.elc), or just the compiled lisp
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
29 files. If you don't have the lisp source files, you can obtain them
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
30 by downloading the lisp source distribution or the full source
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
31 distribution from the ftp site mentioned above.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
32
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
33 * Setting up Emacs
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
34
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
35 To install Emacs, simply unpack all the files into a directory of your
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
36 choice, but note that you might encounter minor problems if there is a
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
37 space anywhere in the directory name. To complete the installation
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
38 process, you can optionally run the program addpm.exe in the bin
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
39 subdirectory. This will add some entries to the registry that tell
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
40 Emacs where to find its support files, and put an icon for Emacs in
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
41 the Start Menu under "Start -> Programs -> Gnu Emacs -> Emacs".
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
42
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
43 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
|
44 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
|
45 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
|
46
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
47 Note that running addpm is now an optional step; Emacs is able to
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
48 locate all of its files without needing the information to be set in
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
49 the environment or the registry, although such settings will still be
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
50 obeyed if present. This is convenient for running Emacs on a machine
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
51 which disallows registry changes, or on which software should not be
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
52 installed. For instance, you can now run Emacs directly from a CD
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
53 without copying or installing anything on the machine itself.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
54
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
55 * Starting Emacs
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
56
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
57 To run Emacs, simply select Emacs from the Start Menu, or invoke
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
58 runemacs.exe directly from Explorer or a command prompt. This will
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
59 start Emacs in its default GUI mode, ready to use. If you have never
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
60 used Emacs before, you should follow the tutorial at this point
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
61 (select Emacs Tutorial from the Help menu), since Emacs is quite
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
62 different from ordinary Windows applications in many respects.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
63
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
64 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
|
65 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
|
66 (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
|
67 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
|
68 (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
|
69 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
|
70
|
79982
|
71 * EXE files included
|
|
72
|
|
73 Emacs comes with the following executable files in the bin directory.
|
|
74
|
|
75 + emacs.exe - The main Emacs executable. As this is designed to run
|
|
76 as both a text-mode application (emacs -nw) and as a GUI application,
|
|
77 it will pop up a command prompt window if run directly from Explorer.
|
|
78
|
|
79 + runemacs.exe - A wrapper for running Emacs as a GUI application
|
|
80 without popping up a command prompt window.
|
|
81
|
|
82 + emacsclient.exe - A command-line client program that can
|
|
83 communicate with a running Emacs process. See the `Emacs Server'
|
|
84 node of the Emacs manul.
|
|
85
|
|
86 + emacsclientw.exe - A version of emacsclient that does not open
|
|
87 a command-line window.
|
|
88
|
|
89 + addpm.exe - A basic installer that creates Start Menu icons for Emacs.
|
|
90 Running this is optional.
|
|
91
|
|
92 + cmdproxy.exe - Used internally by Emacs to work around problems with
|
|
93 the native shells in various versions of Windows.
|
|
94
|
|
95 + ctags.exe, etags.exe - Tools for generating tag files. See the
|
|
96 `Tags' node of the Emacs manual.
|
|
97
|
|
98 + ebrowse.exe - A tool for generating C++ browse information. See the
|
|
99 `Ebrowse' manual.
|
|
100
|
|
101 + ddeclient.exe - A tool for interacting with DDE servers.
|
|
102
|
|
103 + hexl.exe - A tool for converting files to hex dumps. See the
|
|
104 `Editing Binary Files' node of the Emacs manual.
|
|
105
|
|
106 + movemail.exe - A helper application for safely moving mail from
|
|
107 a mail spool or POP server to a local user mailbox. See the
|
|
108 `Movemail' node of the Emacs manual.
|
|
109
|
|
110 + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the
|
|
111 built-in documentation.
|
|
112
|
79142
|
113 * Image support
|
|
114
|
|
115 Emacs has built in support for XBM and PPM/PGM/PBM images, and the
|
|
116 libXpm library is bundled, providing XPM support (required for color
|
79979
|
117 toolbar icons and splash screen). Source for libXpm should be available
|
|
118 on the same place as you got this binary distribution from. The version
|
|
119 of libXpm bundled with this version of Emacs is 3.5.7, based on x.org's
|
|
120 libXpm library from X11R7.3.
|
79142
|
121
|
|
122 Emacs can also support some other image formats with appropriate
|
|
123 libraries. These libraries are all available as part of GTK, or from
|
|
124 gnuwin32.sourceforge.net. Emacs will find them if the directory they
|
|
125 are installed in is on the PATH.
|
|
126
|
|
127 PNG: requires the PNG reference library 1.2 or later, which will
|
|
128 be named libpng13d.dll, libpng13.dll, libpng12d.dll, libpng12.dll
|
|
129 or libpng.dll. LibPNG requires zlib, which should come from the same
|
|
130 source as you got libpng.
|
|
131
|
|
132 JPEG: requires the Independant JPEG Group's libjpeg 6b or later,
|
|
133 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
|
|
134
|
|
135 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll
|
|
136 or libtiff.dll.
|
|
137
|
|
138 GIF: requires libungif or giflib 4.1 or later, which will be
|
|
139 called giflib4.dll, libungif4.dll or libungif.dll.
|
|
140
|
|
141
|
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
142 * Uninstalling Emacs
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
143
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
144 If you should need to uninstall Emacs, simply delete all the files and
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
145 subdirectories from the directory where it was unpacked (Emacs does
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
146 not install or update any files in system directories or anywhere
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
147 else). If you ran the addpm.exe program to create the registry
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
148 entries and the Start menu icon, then you can remove the registry
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
149 entries using regedit. All of the settings are written under the
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
150 Software\GNU\Emacs key in HKEY_LOCAL_MACHINE, or if you didn't have
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
151 administrator privileges, the same key in HKEY_CURRENT_USER. Just
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
152 delete the Software\GNU\Emacs key.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
153
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
154 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
|
155 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
|
156 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
|
157 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
|
158 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
|
159
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
160 * Troubleshooting
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
161
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
162 Unpacking the distributions
|
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 If you encounter trouble trying to run Emacs, there are a number of
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
165 possible causes. If you didn't use the versions of tar and gunzip (or
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
166 djtarnt) on the above ftp site, it is possible that the distribution
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
167 became corrupted while it was being unpacked. Check the following for
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
168 indications that the distribution was not corrupted:
|
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 * Be sure to disable the CR/LF translation or the executables will
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
171 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
|
172 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
|
173 (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
|
174 commands necessary to disable it.)
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
175
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
176 * 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
|
177 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
|
178 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
|
179 while unpacking and Emacs will not start.
|
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 * Users have said that some utilities (WinZip again?) don't create
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
182 the lock subdirectory. You can create the lock directory by hand
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
183 (it is normally empty).
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
184
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
185 * Users have also reported that the gnu-win32 tar corrupts the
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
186 executables. Use the version of tar or djtarnt on the ftp.gnu.org
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
187 site instead.
|
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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
203 your favorite web browser to following the document (if you haven't
|
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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
206 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
|
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
|
212 related to the Windows port of Emacs. For information about the
|
|
213 list, see this Web page:
|
|
214
|
69705
|
215 http://lists.gnu.org/mailman/listinfo/help-emacs-windows
|
41243
|
216
|
|
217 To ask questions on the mailing list, send email to
|
|
218 help-emacs-windows@gnu.org. (You don't need to subscribe for that.)
|
|
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
|
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.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
225 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
|
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
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
243 invoking Emacs with the "-q --no-site-file" options.
|
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 If you decide that it is a bug in Emacs that might be specific to the
|
50662
|
246 Windows port, send a message to the "help-emacs-windows@gnu.org"
|
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
247 mailing list describing the bug, the version of Emacs that you are
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
248 using, and the operating system that you are running on (Windows NT,
|
50662
|
249 2000, 95, 98, etc. including service pack level if known). If the bug
|
|
250 is related to subprocesses, also specify which shell you are using
|
|
251 (e.g., include the values of `shell-file-name' and
|
|
252 `shell-explicit-file-name' in your message).
|
39011
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 If you think the bug is not specific to the Windows port of Emacs,
|
50662
|
255 then it is better to mail the bug report to "bug-gnu-emacs@gnu.org" so
|
39011
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
256 that it will be seen by the right people. If Emacs has been set up to
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
257 send mail, you can use the command M-x report-emacs-bug to create and
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
258 send the bug report, but in some cases there is a function to report
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
259 bugs in a specific package; e.g. M-x gnus-bug for Gnus, M-x
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
260 c-submit-bug-report for C/C++/Java mode, etc.
|
dc12250ba65b
add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff
changeset
|
261
|
50661
|
262 Enjoy!
|
79967
|
263
|
|
264
|
|
265 This file is part of GNU Emacs.
|
|
266
|
94830
|
267 GNU Emacs is free software: you can redistribute it and/or modify
|
79967
|
268 it under the terms of the GNU General Public License as published by
|
94830
|
269 the Free Software Foundation, either version 3 of the License, or
|
|
270 (at your option) any later version.
|
79967
|
271
|
|
272 GNU Emacs is distributed in the hope that it will be useful,
|
|
273 but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
274 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
275 GNU General Public License for more details.
|
|
276
|
|
277 You should have received a copy of the GNU General Public License
|
94830
|
278 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|