annotate admin/nt/README.W32 @ 67764:1868b265123d

*** empty log message ***
author Eli Zaretskii <eliz@gnu.org>
date Fri, 23 Dec 2005 15:45:07 +0000
parents 017ff76022bd
children 296901e2dded
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
50662
017ff76022bd Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents: 50661
diff changeset
1 Emacs for Windows
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
2
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
3 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
4 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
5 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
6
50662
017ff76022bd Remove personal email address and update wording.
Andrew Innes <andrewi@gnu.org>
parents: 50661
diff changeset
7 ftp://ftp.gnu.org/gnu/windows/emacs/
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
8
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
9 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
10 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
11 releases of Emacs for Windows.
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 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
14 this port of GNU Emacs and related software packages can be found via
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
15 http or ftp:
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 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
18 ftp://ftp.gnu.org/gnu/windows/emacs/docs/ntemacs.html
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
19
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
20 * Preliminaries
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
21
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
22 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
23 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
24 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
25 (*.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
26 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
27 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
28 distribution from the ftp site mentioned above.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
29
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
30 * Setting up Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
31
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
32 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
33 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
34 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
35 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
36 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
37 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
38 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
39
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
40 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
41 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
42 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
43
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
44 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
45 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
46 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
47 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
48 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
49 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
50 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
51
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
52 * Starting Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
53
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
54 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
55 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
56 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
57 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
58 (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
59 different from ordinary Windows applications in many respects.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
60
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
61 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
62 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
63 (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
64 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
65 (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
66 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
67
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
68 * Uninstalling Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
69
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
70 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
71 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
72 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
73 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
74 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
75 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
76 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
77 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
78 delete the Software\GNU\Emacs key.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
79
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
80 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
81 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
82 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
83 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
84 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
85
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
86 * Troubleshooting
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
87
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
88 Unpacking the distributions
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
89
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
90 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
91 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
92 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
93 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
94 indications that the distribution was not corrupted:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
95
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
96 * 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
97 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
98 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
99 (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
100 commands necessary to disable it.)
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
101
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
102 * 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
103 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
104 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
105 while unpacking and Emacs will not start.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
106
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
107 * 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
108 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
109 (it is normally empty).
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
110
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
111 * 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
112 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
113 site instead.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
114
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
115 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
116 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
117 below.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
118
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
119 Virus scanners
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
120
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
121 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
122 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
123 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
124 scanning" (McAfee exclusion properties).
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
125
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
126 * Further information
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
127
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
128 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
129 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
130 already):
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
131
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
132 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
133
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
134 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
135 about the Windows port and related software packages.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
136
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
137 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
138 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
139 list, see this Web page:
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
140
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
141 http://mail.gnu.org/mailman/listinfo/help-emacs-windows
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
142
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
143 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
144 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
145 To subscribe to the list or unsubscribe from it, fill the form you
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
146 find at http://mail.gnu.org/mailman/listinfo/help-emacs-windows as
ade47df15864 Update for Emacs 21, including the mailing list info.
Eli Zaretskii <eliz@gnu.org>
parents: 39011
diff changeset
147 explained there.
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
148
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
149 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
150 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
151 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
152 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
153 for seeking help are:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
154
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
155 gnu.emacs.help
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
156 comp.emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
157
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
158 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
159 updated Emacs packages on this group:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
160
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
161 gnu.emacs.sources
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
162
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
163 * Reporting bugs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
164
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
165 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
166 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
167 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
168 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
169 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
170
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
171 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
172 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
173 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
174 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
175 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
176 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
177 (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
178 `shell-explicit-file-name' in your message).
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
179
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
180 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
181 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
182 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
183 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
184 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
185 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
186 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
187
50661
e2a7895c7934 Remove personal email address.
Andrew Innes <andrewi@gnu.org>
parents: 42926
diff changeset
188 Enjoy!