annotate admin/nt/README.W32 @ 40039:d576274a42f4

(Text Lines): Describe behavior of `beginning-of-line'/`end-of-line' in the presence of field properties.
author Miles Bader <miles@gnu.org>
date Fri, 19 Oct 2001 06:01:19 +0000
parents dc12250ba65b
children ade47df15864
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
39011
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
1 Emacs for Windows NT and Windows 95/98/2000
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 Version 21.0.104 pretest
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
4
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
5 July 16, 2001
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
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
8 of GNU Emacs for Windows NT and Windows 95/98/2000. This distribution
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
9 can be found on the ftp.gnu.org server and its mirrors:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
10
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
11 ftp://ftp.gnu.org/gnu/windows/emacs/
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
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
19 http or ftp:
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 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
23
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
24 * Preliminaries
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
25
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
26 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
27 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
28 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
29 (*.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
30 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
31 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
32 distribution from the ftp site mentioned above.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
33
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
34 * Setting up Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
35
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
36 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
37 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
38 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
39 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
40 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
41 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
42 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
43
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
44 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
45 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
46 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
47
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
48 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
49 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
50 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
51 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
52 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
53 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
54 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
55
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
56 * Starting Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
57
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
58 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
59 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
60 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
61 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
62 (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
63 different from ordinary Windows applications in many respects.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
64
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
65 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
66 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
67 (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
68 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
69 (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
70 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
71
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
72 * Uninstalling Emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
73
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
74 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
75 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
76 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
77 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
78 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
79 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
80 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
81 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
82 delete the Software\GNU\Emacs key.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
83
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
84 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
85 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
86 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
87 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
88 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
89
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
90 * Troubleshooting
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
91
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
92 Unpacking the distributions
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
93
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
94 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
95 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
96 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
97 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
98 indications that the distribution was not corrupted:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
99
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
100 * 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
101 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
102 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
103 (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
104 commands necessary to disable it.)
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
105
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
106 * 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
107 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
108 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
109 while unpacking and Emacs will not start.
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 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
112 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
113 (it is normally empty).
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 * 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
116 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
117 site instead.
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 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
120 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
121 below.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
122
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
123 Virus scanners
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
124
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
125 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
126 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
127 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
128 scanning" (McAfee exclusion properties).
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
129
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
130 * Further information
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 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
133 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
134 already):
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
135
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
136 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
137
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
138 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
139 about the Windows port and related software packages.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
140
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
141 In addition to the FAQ, there is a mailing list for discussing issues
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
142 related to the Windows port of Emacs. The name of the list is
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
143 "ntemacs-users@cs.washington.edu". For information about the list,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
144 send a message to "ntemacs-users-request@cs.washington.edu" with the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
145 word "info" in the body of the message. To subscribe to the list,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
146 send a message to the same address with the word "subscribe" in the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
147 body of the message; similarly, to unsubscribe from the list, send a
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
148 message with the word "unsubscribe" in the message body.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
149
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
150 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
151 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
152 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
153 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
154 for seeking help are:
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
155
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
156 gnu.emacs.help
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
157 comp.emacs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
158
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
159 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
160 updated Emacs packages on this group:
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 gnu.emacs.sources
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 * Reporting bugs
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
165
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
166 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
167 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
168 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
169 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
170 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
171
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
172 If you decide that it is a bug in Emacs that might be specific to the
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
173 Windows port, send a message to the ntemacs-users@cs.washington.edu
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
174 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
175 using, and the operating system that you are running on (Windows NT,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
176 2000, 95 or 98 including service pack level if known). If the bug is
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
177 related to subprocesses, also specify which shell you are using (e.g.,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
178 include the values of `shell-file-name' and `shell-explicit-file-name'
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
179 in your message).
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 If you think the bug is not specific to the Windows port of Emacs,
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
182 then it is better to mail the bug report to bug-gnu-emacs@gnu.org so
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
183 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
184 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
185 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
186 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
187 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
188
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
189 Enjoy.
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
190
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
191 Andrew Innes
dc12250ba65b add scripts for creating precompiled Windows distributions
Andrew Innes <andrewi@gnu.org>
parents:
diff changeset
192 (andrewi@gnu.org)