annotate nt/README @ 102473:1fff65a4070f

* w32-vars.el (w32-list-proportional-fonts): Fix typos in last change.
author Juanma Barranquero <lekktu@gmail.com>
date Tue, 10 Mar 2009 23:48:31 +0000
parents aeceb2460b39
children 1d1d5d9bd884
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
75362
f8f788e27407 Add missing comma in copyright years.
Glenn Morris <rgm@gnu.org>
parents: 75171
diff changeset
3 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006,
100954
aeceb2460b39 Add 2009 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 94795
diff changeset
4 2007, 2008, 2009 Free Software Foundation, Inc.
75769
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
5 See the end of the file for license conditions.
37710
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
75171
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
15 ftp://ftp.gnu.org/gnu/emacs/windows/
35869
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
79983
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
24 * EXE files produced
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
25
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
26 Building and installing Emacs will produce the following executable
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
27 files in the bin directory.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
28
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
29 + emacs.exe - The main Emacs executable. As this is designed to run
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
30 as both a text-mode application (emacs -nw) and as a GUI application,
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
31 it will pop up a command prompt window if run directly from Explorer.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
32
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
33 + runemacs.exe - A wrapper for running Emacs as a GUI application
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
34 without popping up a command prompt window.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
35
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
36 + emacsclient.exe - A command-line client program that can
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
37 communicate with a running Emacs process. See the `Emacs Server'
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
38 node of the Emacs manul.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
39
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
40 + emacsclientw.exe - A version of emacsclient that does not open
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
41 a command-line window.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
42
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
43 + addpm.exe - A basic installer that creates Start Menu icons for Emacs.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
44 Running this is optional.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
45
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
46 + cmdproxy.exe - Used internally by Emacs to work around problems with
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
47 the native shells in various versions of Windows.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
48
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
49 + ctags.exe, etags.exe - Tools for generating tag files. See the
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
50 `Tags' node of the Emacs manual.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
51
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
52 + ebrowse.exe - A tool for generating C++ browse information. See the
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
53 `Ebrowse' manual.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
54
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
55 + ddeclient.exe - A tool for interacting with DDE servers.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
56
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
57 + hexl.exe - A tool for converting files to hex dumps. See the
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
58 `Editing Binary Files' node of the Emacs manual.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
59
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
60 + movemail.exe - A helper application for safely moving mail from
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
61 a mail spool or POP server to a local user mailbox. See the
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
62 `Movemail' node of the Emacs manual.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
63
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
64 + digest-doc.exe, sorted-doc.exe - Tools for rebuilding the
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
65 built-in documentation.
8c0a8321e0a3 Added short descriptions of the exe files.
Jason Rumney <jasonr@gnu.org>
parents: 79730
diff changeset
66
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
67 * Further information
Dave Love <fx@gnu.org>
parents:
diff changeset
68
39192
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
69 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
70 Emacs (a.k.a. NTEmacs) at:
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
71
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
72 http://www.gnu.org/software/emacs/windows/ntemacs.html
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 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
75 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
76
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
77 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
78
ac71b28eccf8 Update the address of the mailing list and subscription instructions.
Eli Zaretskii <eliz@gnu.org>
parents: 37710
diff changeset
79 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
80 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
81 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
82 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
83 explained there.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
84
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
85 Another valuable source of information and help which should not be
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
86 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
87 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
88 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
89 for seeking help are:
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
90
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
91 gnu.emacs.help
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
92 comp.emacs
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
93
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
94 There are also fairly regular postings and announcements of new or
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
95 updated Emacs packages on this group:
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
96
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
97 gnu.emacs.sources
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
98
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
99 * Reporting bugs
Dave Love <fx@gnu.org>
parents:
diff changeset
100
35869
42fcadee88a8 Replace outdated information.
Andrew Innes <andrewi@gnu.org>
parents: 35105
diff changeset
101 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
102 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
103 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
104 workarounds. If not, then check whether the bug has something to do
75171
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
105 with code in your .emacs file, e.g. by invoking Emacs with the "-Q"
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
106 option.
25856
Dave Love <fx@gnu.org>
parents:
diff changeset
107
75171
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
108 Use the built in bug reporting functionality in Emacs so that it
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
109 will be seen by the right people. You can use the command M-x
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
110 report-emacs-bug to create and send the bug report, but in some
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
111 cases there is a function to report bugs in a specific package;
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
112 e.g. M-x gnus-bug for Gnus, M-x c-submit-bug-report for C/C++/Java
cf400b7936d2 Update URLs and advice about reporting bugs.
Jason Rumney <jasonr@gnu.org>
parents: 68648
diff changeset
113 mode, etc.
75769
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
114
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
115
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
116 This file is part of GNU Emacs.
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
117
94795
188974bfdea0 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79983
diff changeset
118 GNU Emacs is free software: you can redistribute it and/or modify
75769
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
119 it under the terms of the GNU General Public License as published by
94795
188974bfdea0 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79983
diff changeset
120 the Free Software Foundation, either version 3 of the License, or
188974bfdea0 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79983
diff changeset
121 (at your option) any later version.
75769
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
122
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
123 GNU Emacs is distributed in the hope that it will be useful,
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
124 but WITHOUT ANY WARRANTY; without even the implied warranty of
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
125 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
126 GNU General Public License for more details.
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
127
92a0e87ff562 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75362
diff changeset
128 You should have received a copy of the GNU General Public License
94795
188974bfdea0 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79983
diff changeset
129 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.