Mercurial > emacs
annotate admin/nt/README.W32 @ 94409:e0901c47caf2
Massive changes in all parts of the documentation.
author | Carsten Dominik <dominik@science.uva.nl> |
---|---|
date | Sun, 27 Apr 2008 18:18:27 +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. |