annotate admin/nt/README.W32 @ 96200:5f7a1e1f15c4

(font_find_for_lface): Try the adstyle specified in the property of LFACE_FONT of LFACE (if any).
author Kenichi Handa <handa@m17n.org>
date Sun, 22 Jun 2008 15:06:28 +0000
parents 21e11734e56b
children ce88a631c161
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
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
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
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
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
113 * Image support
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
114
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
115 Emacs has built in support for XBM and PPM/PGM/PBM images, and the
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
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
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
121
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
122 Emacs can also support some other image formats with appropriate
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
123 libraries. These libraries are all available as part of GTK, or from
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
124 gnuwin32.sourceforge.net. Emacs will find them if the directory they
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
125 are installed in is on the PATH.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
126
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
127 PNG: requires the PNG reference library 1.2 or later, which will
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
128 be named libpng13d.dll, libpng13.dll, libpng12d.dll, libpng12.dll
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
129 or libpng.dll. LibPNG requires zlib, which should come from the same
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
130 source as you got libpng.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
131
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
132 JPEG: requires the Independant JPEG Group's libjpeg 6b or later,
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
133 which will be called jpeg62.dll, libjpeg.dll, jpeg-62.dll or jpeg.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
134
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
135 TIFF: requires libTIFF 3.0 or later, which will be called libtiff3.dll
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
136 or libtiff.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
137
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
138 GIF: requires libungif or giflib 4.1 or later, which will be
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
139 called giflib4.dll, libungif4.dll or libungif.dll.
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
140
4fab4ac447b1 Add Image Support section.
Jason Rumney <jasonr@gnu.org>
parents: 69705
diff changeset
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
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
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
296901e2dded updated link(s)
Ramprasad B <ramprasad_i82@yahoo.com>
parents: 50662
diff changeset
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
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
267 GNU Emacs is free software: you can redistribute it and/or modify
79967
297013ef0ae4 Add copyright notice and license.
Jason Rumney <jasonr@gnu.org>
parents: 79142
diff changeset
268 it under the terms of the GNU General Public License as published by
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
269 the Free Software Foundation, either version 3 of the License, or
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
270 (at your option) any later version.
79967
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
94830
21e11734e56b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79982
diff changeset
278 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.