Mercurial > emacs
annotate admin/nt/README.W32 @ 80401:52454b9e8627
* url-auth.el (url-digest-auth): Changed an if so that the
interaction between the PROMPT and OVERWRITE arguments can no
longer result in the user being queried twice for the same login
and password information.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Mon, 31 Mar 2008 22:02:08 +0000 |
parents | 416c1a9b8012 |
children | 21e11734e56b |
rev | line source |
---|---|
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
2 Free Software Foundation, Inc. |
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 |
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
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
8 of GNU Emacs for Windows NT/2000/XP and Windows 95/98/Me. This |
41243
ade47df15864
Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents:
39011
diff
changeset
|
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
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
71 * EXE files included |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
72 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
73 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
|
74 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
75 + emacs.exe - The main Emacs executable. As this is designed to run |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
76 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
|
77 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
|
78 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
79 + 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
|
80 without popping up a command prompt window. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
81 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
82 + emacsclient.exe - A command-line client program that can |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
83 communicate with a running Emacs process. See the `Emacs Server' |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
84 node of the Emacs manul. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
85 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
86 + 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
|
87 a command-line window. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
88 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
89 + 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
|
90 Running this is optional. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
91 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
92 + 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
|
93 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
|
94 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
95 + ctags.exe, etags.exe - Tools for generating tag files. See the |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
96 `Tags' node of the Emacs manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
97 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
98 + 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
|
99 `Ebrowse' manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
100 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
101 + 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
|
102 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
103 + 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
|
104 `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
|
105 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
106 + 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
|
107 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
|
108 `Movemail' node of the Emacs manual. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
109 |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
110 + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
111 built-in documentation. |
416c1a9b8012
Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents:
79979
diff
changeset
|
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
643c20b8a0de
Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents:
79967
diff
changeset
|
117 toolbar icons and splash screen). Source for libXpm should be available |
643c20b8a0de
Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents:
79967
diff
changeset
|
118 on the same place as you got this binary distribution from. The version |
643c20b8a0de
Add note about obtaining libXpm source, and its origin.
Jason Rumney <jasonr@gnu.org>
parents:
79967
diff
changeset
|
119 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
|
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
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. |
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
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
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
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
249 2000, 95, 98, etc. including service pack level if known). If the bug |
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
250 is related to subprocesses, also specify which shell you are using |
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
251 (e.g., include the values of `shell-file-name' and |
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
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
017ff76022bd
Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents:
50661
diff
changeset
|
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
e2a7895c7934
Remove personal email address.
Andrew Innes <andrewi@gnu.org>
parents:
42926
diff
changeset
|
262 Enjoy! |
79967
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
263 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
264 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
265 This file is part of GNU Emacs. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
266 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
267 GNU Emacs is free software; you can redistribute it and/or modify |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
268 it under the terms of the GNU General Public License as published by |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
269 the Free Software Foundation; either version 3, or (at your option) |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
270 any later version. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
271 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
272 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
|
273 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
|
274 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
275 GNU General Public License for more details. |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
276 |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
277 You should have received a copy of the GNU General Public License |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
278 along with GNU Emacs; see the file COPYING. If not, write to the |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
279 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
297013ef0ae4
Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents:
79142
diff
changeset
|
280 Boston, MA 02110-1301, USA. |