annotate nt/README @ 70651:54d96a288372

(handle_one_xevent): Fix crash in 2006-03-24 change.
author Kim F. Storm <storm@cua.dk>
date Sun, 14 May 2006 00:30:46 +0000
parents 067115a6e738
children cf400b7936d2
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
1 Emacs for Windows NT/2000 and Windows 95/98/ME
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
2
68648
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64890
diff changeset
3 Copyright (C) 2001, 2002, 2003, 2004, 2005,
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64890
diff changeset
4 2006 Free Software Foundation, Inc.
37710
4068826e329f Add copyright notice.
Andrew Innes <andrewi@gnu.org>
parents: 35869
diff changeset
5 See the end of the INSTALL file in this directory for copying permissions.
4068826e329f Add copyright notice.
Andrew Innes <andrewi@gnu.org>
parents: 35869
diff changeset
6
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
7 This directory contains support for compiling and running GNU Emacs on
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
8 Windows NT, Windows 95, and their successors. This port supports all
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
9 of the major functionality of the Unix version, including
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
10 subprocesses, windowing features (fonts, colors, scroll bars, multiple
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
11 frames, etc.), and networking support.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
12
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
13 Precompiled distributions are also available; ftp to
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
14
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
15 ftp://ftp.gnu.org/gnu/windows/emacs/latest/
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
16
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
17 for the latest precompiled distributions.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
18
Dave Love <fx@gnu.org>
parents:
diff changeset
19 * Building and installing
Dave Love <fx@gnu.org>
parents:
diff changeset
20
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
21 See the INSTALL file in this directory for detailed instructions on
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
22 building and installing Emacs on your system.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
23
Dave Love <fx@gnu.org>
parents:
diff changeset
24 * Further information
Dave Love <fx@gnu.org>
parents:
diff changeset
25
39192
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
26 There is a web page that serves as a FAQ for the Windows port of
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
27 Emacs (a.k.a. NTEmacs) at:
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
28
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
29 http://www.gnu.org/software/emacs/windows/ntemacs.html
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
30
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
31 There is also a mailing list for discussing issues related to this
39192
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
32 port of Emacs. For information about the list, see this Web page:
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
33
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
34 http://mail.gnu.org/mailman/listinfo/help-emacs-windows
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
35
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
36 To ask questions on the mailing list, send email to
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
37 help-emacs-windows@gnu.org. (You don't need to subscribe for that.)
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
38 To subscribe to the list or unsubscribe from it, fill the form you
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
39 find at http://mail.gnu.org/mailman/listinfo/help-emacs-windows as
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
40 explained there.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
41
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
42 Another valuable source of information and help which should not be
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
43 overlooked is the various Usenet news groups dedicated to Emacs.
39192
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
44 These are particularly good for help with general issues which aren't
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
45 specific to the Windows port of Emacs. The main news groups to use
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
46 for seeking help are:
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
47
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
48 gnu.emacs.help
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
49 comp.emacs
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
50
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
51 There are also fairly regular postings and announcements of new or
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
52 updated Emacs packages on this group:
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
53
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
54 gnu.emacs.sources
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
55
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
56 * Reporting bugs
Dave Love <fx@gnu.org>
parents:
diff changeset
57
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
58 If you encounter a bug in this port of Emacs, we would like to hear
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
59 about it. First check the file etc/PROBLEMS and the FAQ on the web
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
60 page above to see if the bug is already known and if there are any
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
61 workarounds. If not, then check whether the bug has something to do
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
62 with code in your .emacs file, e.g. by invoking Emacs with the "-q
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
63 --no-site-file" options.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
64
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
65 If you decide that it is a bug in Emacs that might be specific to the
39192
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
66 Windows port, send a message to the help-emacs-windows@gnu.org
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
67 mailing list describing the bug, the version of Emacs that you are
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
68 using, and the operating system that you are running on (Windows NT,
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
69 95 or 98 including service pack level if known). If the bug is
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
70 related to subprocesses, also specify which shell you are using (e.g.,
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
71 include the values of `shell-file-name' and `shell-explicit-file-name'
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
72 in your message).
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
73
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
74 If you think the bug is not specific to the Windows port of Emacs,
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
75 then it is better to mail the bug report to bug-gnu-emacs@gnu.org so
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
76 that it will be seen by the right people. If Emacs has been set up to
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
77 send mail, you can use the command M-x report-emacs-bug to create and
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
78 send the bug report, but in some cases there is a function to report
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
79 bugs in a specific package; e.g. M-x gnus-bug for Gnus, M-x
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
80 c-submit-bug-report for C/C++/Java mode, etc.