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