annotate nt/PROBLEMS @ 412:697ef44129c6 r21-2-14

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