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