annotate nt/PROBLEMS @ 444:576fb035e263 r21-2-37

Import from CVS: tag r21-2-37
author cvs
date Mon, 13 Aug 2007 11:36:19 +0200
parents abe6d1db359e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1 -*- mode:outline -*-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 This file describes various problems that have been encountered in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4 running XEmacs on Windows 95, 98 and NT. It has been updated for
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5 XEmacs 21.0.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 This is the first release of XEmacs on Windows. In testing it has
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 proved to be extremely stable in general use (but see the gnus and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 subprocess problems below), but not all features or packages work
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 correctly yet.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 Use `C-c C-f' to move to the next equal level of outline, and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 `C-c C-b' to move to previous equal level. `C-h m' will give more
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14 info about the Outline mode.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 Also, Try finding the things you need using one of the search commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 XEmacs provides (e.g. `C-s').
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 General advice:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 Remember your .emacs file! ~\.emacs is your Emacs init file. If
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21 you observe strange problems, invoke XEmacs with the `-q' option
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 and see if you can repeat the problem.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 * Problems with running XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26 ==============================
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 ** Conflicts with FSF NTEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 Depending on how it is installed, FSF NTEmacs may setup various EMACS*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30 variables in your environment. The presence of these variables may
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 cause XEmacs to fail at startup, cause you to see corrupted
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 doc-strings, or cause other random problems.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34 You should remove these variables from your environment. These
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 variables are not required to run FSF NTEmacs if you start it by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36 running emacs.bat.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
37
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 ** XEmacs can't find my .emacs file
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 XEmacs looks for your .emacs in your "home" directory. XEmacs decides
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
41 that your "home" directory is, in order of preference:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
42
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
43 - The value of the HOME environment variable, if the variable exists.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
44 - The value of the HOMEDRIVE and HOMEPATH environment variables, if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45 these variables both exist.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46 - The directory that XEmacs was started from.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
47
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
48 ** XEmacs can't find any packages
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
49
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
50 XEmacs looks for your packages in subdirectories of a directory which
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
51 is set at compile-time, and defaults to C:\Program Files\XEmacs. The
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
52 variable configure-package-path holds the actual path that was
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
53 compiled into your copy of XEmacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
55 The compile-time default location can be overridden by the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
56 EMACSPACKAGEPATH environment variable or by the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
57 SOFTWARE\GNU\XEmacs\EMACSPACKAGEPATH registry entry. You should check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58 that these variables, if they exist, point to the actual location of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59 your package tree.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
60
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
61 ** XEmacs sometimes crashes when using gnus
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
62
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
63 This is a known bug in this release of XEmacs on Windows.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
64
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
65 If you want to use gnus anyway, you should minimize any possible data
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
66 loss by saving any modified buffers before you start and ensuring that
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
67 you haven't set gnus-use-dribble-file to nil or disabled the normal
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
68 XEmacs auto-save mechanism.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
69
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
70 ** XEmacs doesn't die when shutting down Windows 95 or 98
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
71
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
72 When shutting down Windows 95 or 98 you may see a dialog that says
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
73 "xemacs / You must quit this program before you quit Windows".
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
74 It is safe to
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
75 "Click OK to quit the program and Windows",
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
76 but you won't be offered a chance to save any modified XEmacs buffers.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
77
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
78 * Look and feel
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
79 ===============
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
80 ** Key bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
81
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
82 The C-z, C-x, C-c, and C-v keystrokes have traditional uses in both
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
83 emacs and Windows programs. XEmacs binds these keys to their
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
84 traditional emacs uses, and provides Windows 3.x style bindings for
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
85 the Cut, Copy and Paste functions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
86
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
87 Function XEmacs binding
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
88 -------- --------------
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
89 Undo C-_
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 428
diff changeset
90 Cut Sh-Del
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 428
diff changeset
91 Copy C-Insert
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 428
diff changeset
92 Paste Sh-Insert
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
93
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
94 You can rebind keys to make XEmacs more Windows-compatible; for
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
95 example, to bind C-z to undo:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
96
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
97 (global-set-key [(control z)] 'undo)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
98
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
99 Rebindind C-x and C-c is trickier because by default these are prefix
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
100 keys in XEmacs. See the "Key Bindings" node in the XEmacs manual.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
101
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 428
diff changeset
102 ** Behavior of selected regions
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
103
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
104 Selected regions behave differently in XEmacs from typical Windows
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
105 programs. The pc-select package provides various functions to enable
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 428
diff changeset
106 the standard Windows behavior for selected regions (eg mark via
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
107 shift-arrow, self-inserting deletes region, etc).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
108
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
109 ** Limitations on the use of the AltGr key.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
110
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
111 In some locale and OS combinations you can't generate M-AltGr-key or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
112 C-M-AltGr-key sequences at all.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
113
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
114 To generate C-AltGr-key or C-M-AltGr-key sequences you must use the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
115 right-hand Control key and you must press it *after* AltGr.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
116
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
117 These limitations arise from fundamental problems in the way that the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
118 win32 API reports AltGr key events. There isn't anything that XEmacs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
119 can do to work round these problems that it isn't already doing.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
120
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
121 You may want to create alternative bindings if any of the standard
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
122 XEmacs bindings require you to use some combination of Control or Meta
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
123 and AltGr.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
124
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
125
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
126 * Features not fully supported in this release
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
127 ==============================================
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
128 ** Limited support for subprocesses
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
129
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
130 Attempting to use call-process to run a 16bit program gives a
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
131 "Spawning child process: Exec format error". For example shell-command
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
132 fails under Windows 95 and 98 if you use command.com or any other
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
133 16bit program as your shell.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
134
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
135 XEmacs may incorrectly quote your call-process command if it contains
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
136 double quotes, backslashes or spaces.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
137
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
138 start-process and functions that rely on it are supported under Windows 95,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
139 98 and NT. However, starting a 16bit program that requires keyboard input
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
140 may cause XEmacs to hang or crash under Windows 95 and 98, and will leave
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
141 the orphaned 16bit program consuming all available CPU time.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
142
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
143 Sending signals to subprocesses started by call-process or by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
144 start-process fails with a "Cannot send signal to process" error under
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
145 Windows 95 and 98. As a side effect of this, quitting XEmacs while it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
146 is still running subprocesses causes it to crash under Windows 95 and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
147 98.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
148
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
149 ** Changing fonts from the Options menu
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
150
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
151 The "Font" and "Size" entries on the Options menu don't work yet. This
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
152 will be fixed in a future release. In the meantime, you can either
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
153 change face fonts with customize or manually; for example:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
154
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
155 (set-face-font 'default "Lucida Console:Regular:10::Western")
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
156 (set-face-font 'modeline "MS Sans Serif:Regular:10::Western")
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
157
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
158 Font weight and style and character set must be supplied in English as
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
159 above. Common weights and styles are "Regular", "Regular Italic",
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
160 "Bold" and "Bold Italic". Common character sets are "Western",
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
161 "Central European" and "OEM/DOS".
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
162
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
163 Windows 95 only comes with one fixed-width font that is suitable for
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
164 use by XEmacs, namely "Courier New".
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
165
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
166 ** No MULE support
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
167
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
168 This release of XEmacs on Windows does not contain MULE support. MULE
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
169 support has not been a priority for the XEmacs on Windows developers.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
170
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
171 ** Printing
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
172
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
173 This release of XEmacs on Windows does not support printing natively.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
174
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
175 You can use the lpr-command and lpr-switches variables to specify an
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
176 external print program.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
177