231
|
1 -*- mode:outline -*-
|
0
|
2 This file describes various problems that have been encountered
|
197
|
3 in compiling, installing and running XEmacs. It has been updated for
|
227
|
4 XEmacs 20.5.
|
0
|
5
|
124
|
6 This file is large, but we have tried to sort the entries by their
|
|
7 respective relevance for XEmacs, but may have not succeeded completely
|
197
|
8 in that task. The file is divided into four parts:
|
124
|
9
|
197
|
10 - Problems with building XEmacs
|
|
11 - Problems with running XEmacs
|
|
12 - Compatibility problems
|
|
13 - Mule issues
|
120
|
14
|
197
|
15 Use `C-c C-f' to move to the next equal level of outline, and
|
223
|
16 `C-c C-b' to move to previous equal level. `C-h m' will give more
|
|
17 info about the Outline mode.
|
120
|
18
|
197
|
19 Also, Try finding the things you need using one of the search commands
|
|
20 XEmacs provides (e.g. `C-s').
|
|
21
|
|
22 A general advice:
|
|
23 WATCH OUT for .emacs file! ~/.emacs is your Emacs init file. If
|
|
24 you observe strange problems, invoke XEmacs with the `-q' option
|
|
25 and see if you can repeat the problem.
|
|
26
|
120
|
27
|
124
|
28 * Problems with building XEmacs
|
197
|
29 ===============================
|
0
|
30
|
229
|
31 ** Don't use -O2 with gcc 2.7.2 under Intel/XXX without also using
|
223
|
32 `-fno-strength-reduce'.
|
124
|
33
|
|
34 gcc will generate incorrect code otherwise. This bug is present in at
|
|
35 least 2.6.x and 2.7.[0-2]. This bug has been fixed in GCC 2.7.2.1 and
|
263
|
36 later. This bug is O/S independent, but is limited to x86 architectures.
|
|
37
|
|
38 This problem is known to be fixed in egcs (or pgcc) 1.0 or later.
|
229
|
39
|
|
40 ** Don't use -O2 with gcc 2.7.2 under Intel architectures without also
|
|
41 using `-fno-caller-saves'.
|
|
42
|
263
|
43 gcc will generate incorrect code otherwise. This bug is still
|
|
44 present in gcc 2.7.2.3. There have been no reports to indicate the
|
|
45 bug is present in egcs 1.0 (or pgcc 1.0) or later. This bug is O/S
|
|
46 independent, but limited to x86 architectures.
|
|
47
|
|
48 This problem is known to be fixed in egcs (or pgcc) 1.0 or later.
|
124
|
49
|
|
50 ** Excessive optimization with pgcc can break XEmacs
|
|
51
|
|
52 It has been reported on some systems that compiling with -O6 can lead
|
|
53 to XEmacs failures. The workaround is to use a lower optimization
|
|
54 level. -O2 and -O4 have been tested extensively.
|
|
55
|
229
|
56 All of this depends heavily on the version of pgcc and the version
|
|
57 of libc. Snapshots near the release of pgcc-1.0 have been tested
|
|
58 extensively and no sign of breakage has been seen on systems using
|
|
59 glibc-2.
|
|
60
|
|
61 ** `compress' and `uncompress' not found and XFree86
|
|
62
|
|
63 XFree86 installs a very old version of libz.a by default ahead of where
|
|
64 more modern version of libz might be installed. This will cause problems
|
|
65 when attempting to link against libMagick. The fix is to remove the old
|
|
66 libz.a in the X11 binary directory.
|
124
|
67
|
|
68 ** Excessive optimization on AIX 4.2 can lead to compiler failure.
|
|
69
|
|
70 Valdis.Kletnieks@vt.edu writes:
|
|
71 At least at the b34 level, and the latest-and-greatest IBM xlc
|
|
72 (3.1.4.4), there are problems with -O3. I haven't investigated
|
|
73 further.
|
|
74
|
|
75 ** Sed problems on Solaris 2.5
|
|
76
|
|
77 There have been reports of Sun sed truncating very lines in the
|
|
78 Makefile during configuration. The workaround is to use GNU sed or,
|
|
79 even better, think of a better way to generate Makefile, and send us a
|
|
80 patch. :-)
|
|
81
|
197
|
82 ** test-distrib says that the distribution has been clobbered
|
|
83 or, temacs prints "Command key out of range 0-127"
|
|
84 or, temacs runs and dumps xemacs, but xemacs totally fails to work.
|
|
85 or, temacs gets errors dumping xemacs
|
|
86
|
|
87 This can be because the .elc files have been garbled. Do not be
|
|
88 fooled by the fact that most of a .elc file is text: these are binary
|
|
89 files and can contain all 256 byte values.
|
|
90
|
|
91 In particular `shar' cannot be used for transmitting GNU Emacs. It
|
|
92 typically truncates "lines". (this does not apply to GNU shar, which
|
|
93 uses uuencode to encode binary files.)
|
|
94
|
|
95 If you have a copy of Emacs that has been damaged in its nonprinting
|
|
96 characters, you can fix them by running:
|
|
97
|
|
98 make all-elc
|
|
99
|
|
100 This will rebuild all the needed .elc files.
|
|
101
|
|
102 ** `Error: No ExtNode to pop!' on Linux systems with Lesstif.
|
|
103
|
|
104 This error message has been observed with lesstif-0.75a. It does not
|
|
105 appear to cause any harm.
|
|
106
|
124
|
107 ** Linking with -rpath on IRIX.
|
|
108
|
|
109 Darrell Kindred <dkindred@cmu.edu> writes:
|
|
110 There are a couple of problems [with use of -rpath with Irix ld], though:
|
|
111
|
|
112 1. The ld in IRIX 5.3 ignores all but the last -rpath
|
|
113 spec, so the patched configure spits out a warning
|
|
114 if --x-libraries or --site-runtime-libraries are
|
|
115 specified under irix 5.x, and it only adds -rpath
|
|
116 entries for the --site-runtime-libraries. This bug was
|
|
117 fixed sometime between 5.3 and 6.2.
|
|
118
|
|
119 2. IRIX gcc 2.7.2 doesn't accept -rpath directly, so
|
|
120 it would have to be prefixed by -Xlinker or "-Wl,".
|
|
121 This would be fine, except that configure compiles with
|
|
122 ${CC-cc} $CFLAGS $LDFLAGS ...
|
|
123 rather than quoting $LDFLAGS with prefix-args, like
|
|
124 src/Makefile does. So if you specify --x-libraries
|
|
125 or --site-runtime-libraries, you must use --use-gcc=no,
|
|
126 or configure will fail.
|
|
127
|
207
|
128 ** On Irix 6.3, the SGI ld quits with segmentation fault when linking temacs
|
|
129
|
|
130 This occurs if you use the SGI linker version 7.1. Installing the
|
|
131 patch SG0001872 fixes this problem.
|
197
|
132
|
124
|
133 ** xemacs: can't resolve symbol '__malloc_hook'
|
|
134
|
|
135 This is a Linux problem where you've compiled the XEmacs binary on a libc
|
|
136 5.4 with version higher than 5.4.19 and attempted to run the binary against
|
|
137 an earlier version. The solution is to upgrade your old library.
|
|
138
|
|
139 ** Compilation errors on VMS.
|
|
140
|
|
141 Sorry, XEmacs does not work under VMS. You might consider working on
|
|
142 the port if you really want to have XEmacs work under VMS.
|
|
143
|
197
|
144 ** On Solaris 2 I get undefined symbols from libcurses.a.
|
124
|
145
|
|
146 You probably have /usr/ucblib/ on your LD_LIBRARY_PATH. Do the link with
|
197
|
147 LD_LIBRARY_PATH unset. Generally, avoid using any ucb* stuff when
|
|
148 building XEmacs.
|
124
|
149
|
197
|
150 ** On Solaris 2 I cannot make alloc.o, glyphs.o or process.o.
|
124
|
151
|
|
152 The SparcWorks C compiler may have difficulty building those modules
|
|
153 with optimization level -xO4. Try using only "-fast" optimization
|
|
154 for just those modules. (Or use gcc).
|
|
155
|
|
156 ** On Digital UNIX, the DEC C compiler might have a problem compiling
|
197
|
157 some files.
|
124
|
158
|
|
159 In particular, src/extents.c and src/faces.c might cause the DEC C
|
|
160 compiler to abort. When this happens: cd src, compile the files by
|
|
161 hand, cd .., and redo the "make" command. When recompiling the files by
|
|
162 hand, use the old C compiler for the following versions of Digital UNIX:
|
|
163 - V3.n: Remove "-migrate" from the compile command.
|
|
164 - V4.n: Add "-oldc" to the compile command.
|
|
165
|
197
|
166 A related compiler bug has been fixed by the DEC compiler team. The
|
|
167 new versions of the compiler should run fine.
|
126
|
168
|
124
|
169 ** On HPUX, the HP C compiler might have a problem compiling some files
|
|
170 with optimization.
|
|
171
|
|
172 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
|
|
173
|
|
174 Had to drop once again to level 2 optimization, at least to
|
|
175 compile lstream.c. Otherwise, I get a "variable is void: \if"
|
|
176 problem while dumping (this is a problem I already reported
|
|
177 with vanilla hpux 10.01 and 9.07, which went away after
|
|
178 applying patches for the C compiler). Trouble is I still
|
|
179 haven't found the same patch for hpux 10.10, and I don't
|
|
180 remember the patch numbers. I think potential XEmacs builders
|
|
181 on HP should be warned about this.
|
|
182
|
|
183 ** I don't have `xmkmf' and `imake' on my HP.
|
|
184
|
|
185 You can get these standard X tools by anonymous FTP to hpcvaaz.cv.hp.com.
|
|
186 Essentially all X programs need these.
|
|
187
|
|
188 ** Solaris 2.3 /bin/sh coredumps during configuration.
|
|
189
|
|
190 This only occurs if you have LANG != C. This is a known bug with
|
197
|
191 /bin/sh fixed by installing Patch-ID# 101613-01. Or, you can use
|
|
192 bash, as a workaround.
|
124
|
193
|
|
194 ** On Irix 6.0, make tries (and fails) to build a program named unexelfsgi
|
|
195
|
|
196 A compiler bug inserts spaces into the string "unexelfsgi . o"
|
|
197 in src/Makefile. Edit src/Makefile, after configure is run,
|
|
198 find that string, and take out the spaces.
|
|
199
|
|
200 Compiler fixes in Irix 6.0.1 should eliminate this problem.
|
|
201
|
|
202 ** Native cc on SCO OpenServer 5 is now OK. Icc may still throw you
|
197
|
203 a curve. Here is what Robert Lipe <robertl@arnet.com> says:
|
124
|
204
|
|
205 Unlike XEmacs 19.13, building with the native cc on SCO OpenServer 5
|
|
206 now produces a functional binary. I will typically build this
|
|
207 configuration for COFF with:
|
|
208
|
197
|
209 /path_to_xemacs_source/configure --with-gcc=no \
|
124
|
210 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
|
|
211 --with-xpm --with-xface --with-sound=nas
|
|
212
|
|
213 This version now supports ELF builds. I highly recommend this to
|
|
214 reduce the in-core footprint of XEmacs. This is now how I compile
|
|
215 all my test releases. Build it like this:
|
|
216
|
|
217 /path_to_XEmacs_source/configure --with-gcc=no \
|
|
218 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
|
|
219 --with-xpm --with-xface --with-sound=nas --dynamic
|
|
220
|
|
221 The compiler known as icc [ supplied with the OpenServer 5 Development
|
|
222 System ] generates a working binary, but it takes forever to generate
|
|
223 XEmacs. ICC also whines more about the code than /bin/cc does. I do
|
|
224 believe all its whining is legitimate, however. Note that you do
|
|
225 have to 'cd src ; make LD=icc' to avoid linker errors.
|
|
226
|
|
227 The way I handle the build procedure is:
|
|
228
|
|
229 /path_to_XEmacs_source/configure --with-gcc=no \
|
|
230 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
|
|
231 --with-xpm --with-xface --with-sound=nas --dynamic --compiler="icc"
|
|
232
|
|
233 NOTE I have the xpm, xface, and audio libraries and includes in
|
|
234 /usr/local/lib, /usr/local/include. If you don't have these,
|
|
235 don't include the "--with-*" arguments in any of my examples.
|
|
236
|
|
237 In previous versions of XEmacs, you had to override the defaults while
|
|
238 compiling font-lock.o and extents.o when building with icc. This seems
|
|
239 to no longer be true, but I'm including this old information in case it
|
|
240 resurfaces. The process I used was:
|
|
241
|
|
242 make -k
|
|
243 [ procure pizza, beer, repeat ]
|
|
244 cd src
|
|
245 make CC="icc -W0,-mP1COPT_max_tree_size=3000" font-lock.o extents.o
|
|
246 make LD=icc
|
|
247
|
|
248 If you want sound support, get the tls566 supplement from
|
|
249 ftp.sco.com:/TLS or any of its mirrors. It works just groovy
|
|
250 with XEmacs.
|
|
251
|
|
252 The M-x manual-entry is known not to work. If you know Lisp and would
|
|
253 like help in making it work, e-mail me at <robertl@dgii.com>.
|
|
254 (UNCHECKED for 19.15 -- it might work).
|
|
255
|
|
256 In earlier releases, gnuserv/gnuclient/gnudoit would open a frame
|
|
257 just fine, but the client would lock up and the server would
|
|
258 terminate when you used C-x # to close the frame. This is now
|
|
259 fixed in XEmacs.
|
|
260
|
|
261 In etc/ there are two files of note. emacskeys.sco and emacsstrs.sco.
|
|
262 The comments at the top of emacskeys.sco describe its function, and
|
|
263 the emacstrs.sco is a suitable candidate for /usr/lib/keyboard/strings
|
|
264 to take advantage of the keyboard map in emacskeys.sco.
|
|
265
|
227
|
266 Note: Much of the above entry is probably not valid for XEmacs 20.5
|
207
|
267 and later.
|
197
|
268
|
124
|
269 ** Under some versions of OSF XEmacs runs fine if built without
|
197
|
270 optimization but will crash randomly if built with optimization.
|
124
|
271
|
|
272 Using 'cc -g' is not sufficient to eliminate all optimization. Try
|
|
273 'cc -g -O0' instead.
|
|
274
|
|
275 ** On SunOS, you get linker errors
|
|
276 ld: Undefined symbol
|
|
277 _get_wmShellWidgetClass
|
|
278 _get_applicationShellWidgetClass
|
|
279
|
|
280 The fix to this is to install patch 100573 for OpenWindows 3.0
|
|
281 or link libXmu statically.
|
|
282
|
|
283 ** On Sunos 4, you get the error ld: Undefined symbol __lib_version.
|
|
284
|
|
285 This is the result of using cc or gcc with the shared library meant
|
|
286 for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete
|
|
287 /usr/lang/SC2.0.1 or some similar directory.
|
|
288
|
|
289 ** On AIX 4.1.2, linker error messages such as
|
|
290 ld: 0711-212 SEVERE ERROR: Symbol .__quous, found in the global symbol table
|
|
291 of archive /usr/lib/libIM.a, was not defined in archive member shr.o.
|
|
292
|
|
293 This is a problem in libIM.a. You can work around it by executing
|
|
294 these shell commands in the src subdirectory of the directory where
|
|
295 you build Emacs:
|
|
296
|
|
297 cp /usr/lib/libIM.a .
|
|
298 chmod 664 libIM.a
|
|
299 ranlib libIM.a
|
|
300
|
|
301 Then change -lIM to ./libIM.a in the command to link temacs (in
|
|
302 Makefile).
|
|
303
|
|
304 ** On Irix 5.2, unexelfsgi.c can't find cmplrs/stsupport.h.
|
|
305
|
|
306 The file cmplrs/stsupport.h was included in the wrong file set in the
|
|
307 Irix 5.2 distribution. You can find it in the optional fileset
|
|
308 compiler_dev, or copy it from some other Irix 5.2 system. A kludgy
|
|
309 workaround is to change unexelfsgi.c to include sym.h instead of
|
|
310 syms.h.
|
|
311
|
|
312 ** Link failure when using acc on a Sun.
|
|
313
|
|
314 To use acc, you need additional options just before the libraries, such as
|
|
315
|
|
316 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
|
|
317
|
|
318 and you need to add -lansi just before -lc.
|
|
319
|
|
320 The precise file names depend on the compiler version, so we
|
|
321 cannot easily arrange to supply them.
|
|
322
|
|
323 ** Link failure on IBM AIX 1.3 ptf 0013.
|
|
324
|
|
325 There is a real duplicate definition of the function `_slibc_free' in
|
|
326 the library /lib/libc_s.a (just do nm on it to verify). The
|
|
327 workaround/fix is:
|
|
328
|
|
329 cd /lib
|
|
330 ar xv libc_s.a NLtmtime.o
|
|
331 ar dv libc_s.a NLtmtime.o
|
|
332
|
|
333 ** Undefined symbols when linking on Sunos 4.1.
|
|
334
|
|
335 If you get the undefined symbols _atowc _wcslen, _iswprint, _iswspace,
|
|
336 _iswcntrl, _wcscpy, and _wcsncpy, then you need to add -lXwchar after
|
|
337 -lXaw in the command that links temacs.
|
|
338
|
|
339 This problem seems to arise only when the international language
|
|
340 extensions to X11R5 are installed.
|
|
341
|
|
342 ** src/Makefile and lib-src/Makefile are truncated--most of the file missing.
|
|
343
|
|
344 This can happen if configure uses GNU sed version 2.03. That version
|
|
345 had a bug. GNU sed version 2.05 works properly.
|
|
346
|
|
347 ** On AIX, you get this compiler error message:
|
|
348
|
|
349 Processing include file ./XMenuInt.h
|
|
350 1501-106: (S) Include file X11/Xlib.h not found.
|
|
351
|
|
352 This means your system was installed with only the X11 runtime i.d
|
|
353 libraries. You have to find your sipo (bootable tape) and install
|
|
354 X11Dev... with smit.
|
|
355
|
|
356 ** C-z just refreshes the screen instead of suspending Emacs.
|
|
357
|
|
358 You are probably using a shell that doesn't support job control, even
|
197
|
359 though the system itself is capable of it. Try using a different
|
|
360 shell.
|
124
|
361
|
|
362 ** On a Sun running SunOS 4.1.1, you get this error message from GNU ld:
|
|
363
|
|
364 /lib/libc.a(_Q_sub.o): Undefined symbol __Q_get_rp_rd referenced from text segment
|
|
365
|
|
366 The problem is in the Sun shared C library, not in GNU ld.
|
|
367
|
|
368 The solution is to install Patch-ID# 100267-03 from Sun.
|
|
369
|
|
370 ** SunOS 4.1.2: undefined symbol _get_wmShellWidgetClass
|
|
371
|
|
372 Apparently the version of libXmu.so.a that Sun ships is hosed: it's missing
|
|
373 some stuff that is in libXmu.a (the static version). Sun has a patch for
|
|
374 this, but a workaround is to use the static version of libXmu, by changing
|
|
375 the link command from "-lXmu" to "-Bstatic -lXmu -Bdynamic". If you have
|
|
376 OpenWindows 3.0, ask Sun for these patches:
|
|
377 100512-02 4.1.x OpenWindows 3.0 libXt Jumbo patch
|
|
378 100573-03 4.1.x OpenWindows 3.0 undefined symbols with shared libXmu
|
|
379
|
|
380 ** Random other SunOS 4.1.[12] link errors.
|
|
381
|
|
382 The X headers and libraries that Sun ships in /usr/{include,lib}/X11 are
|
|
383 broken. Use the ones in /usr/openwin/{include,lib} instead.
|
|
384
|
|
385 ** When using gcc, you get the error message "undefined symbol __fixunsdfsi".
|
197
|
386 When using gcc, you get the error message "undefined symbol __main".
|
124
|
387
|
|
388 This means that you need to link with the gcc library. It may be called
|
|
389 "gcc-gnulib" or "libgcc.a"; figure out where it is, and define LIB_GCC in
|
|
390 config.h to point to it.
|
|
391
|
|
392 It may also work to use the GCC version of `ld' instead of the standard one.
|
|
393
|
|
394 ** When compiling with X11, you get "undefined symbol _XtStrings".
|
|
395
|
|
396 This means that you are trying to link emacs against the X11r4 version of
|
|
397 libXt.a, but you have compiled either Emacs or the code in the lwlib
|
|
398 subdirectory with the X11r5 header files. That doesn't work.
|
|
399
|
|
400 Remember, you can't compile lwlib for r4 and emacs for r5, or vice versa.
|
|
401 They must be in sync.
|
|
402
|
136
|
403 ** Problems finding X11 libraries on Solaris with Openwindows
|
|
404
|
|
405 Some users have reported problems in this area. The reported solution
|
|
406 is to define the environment variable OPENWINHOME, even if you must set
|
|
407 it to `/usr/openwin'.
|
|
408
|
251
|
409 ** Under Linux, you get "too many arguments to function `getpgrp'".
|
|
410
|
|
411 You have probably installed LessTiff under `/usr/local' and `libXm.so'
|
|
412 could not be found when linking `getpgrp()' test program, making XEmacs
|
|
413 think that `getpgrp()' takes an argument. Try adding `/usr/local/lib'
|
|
414 in `/etc/ld.so.conf' and run `ldconfig'. Then run XEmacs's `configure'
|
|
415 again. As with all problems of this type, reading the config.log file
|
|
416 generated from configure and seeing the log of how the test failed can
|
|
417 prove enlightening.
|
|
418
|
197
|
419
|
124
|
420 * Problems with running XEmacs
|
197
|
421 ==============================
|
124
|
422
|
259
|
423 ** `C-z', or `M-x suspend-emacs' hangs instead of suspending.
|
|
424
|
|
425 If you build with `gpm' support on Linux, you cannot suspend XEmacs
|
|
426 because gpm installs a buggy SIGTSTP handler. Either compile with
|
|
427 `--with-gpm=no', or don't suspend XEmacs on the Linux console until
|
|
428 this bug is fixed.
|
|
429
|
124
|
430 ** You type Control-H (Backspace) expecting to delete characters.
|
|
431
|
|
432 Emacs has traditionally used Control-H for help; unfortunately this
|
|
433 interferes with its use as Backspace on TTY's. One way to solve this
|
|
434 problem is to put this in your .emacs:
|
|
435
|
197
|
436 (when (eq tty-erase-char ?\C-h)
|
|
437 (keyboard-translate ?\C-h ?\C-?)
|
|
438 (global-set-key "\M-?" 'help-command))
|
124
|
439
|
197
|
440 This checks whether the TTY erase char is C-h, and if it is, makes
|
|
441 Control-H (Backspace) work sensibly, and moves help to Meta-? (ESC ?).
|
124
|
442
|
|
443 Note that you can probably also access help using F1.
|
|
444
|
197
|
445 ** Mail agents (VM, Gnus, rmail) cannot get new mail
|
|
446
|
|
447 rmail and VM get new mail from /usr/spool/mail/$USER using a program
|
|
448 called `movemail'. This program interlocks with /bin/mail using the
|
|
449 protocol defined by /bin/mail.
|
|
450
|
|
451 There are two different protocols in general use. One of them uses
|
|
452 the `flock' system call. The other involves creating a lock file;
|
|
453 `movemail' must be able to write in /usr/spool/mail in order to do
|
|
454 this. You control which one is used by defining, or not defining, the
|
|
455 macro MAIL_USE_FLOCK in config.h or the m- or s- file it includes. IF
|
|
456 YOU DON'T USE THE FORM OF INTERLOCKING THAT IS NORMAL ON YOUR SYSTEM,
|
|
457 YOU CAN LOSE MAIL!
|
|
458
|
|
459 If your system uses the lock file protocol, and fascist restrictions
|
|
460 prevent ordinary users from writing the lock files in /usr/spool/mail,
|
|
461 you may need to make `movemail' setgid to a suitable group such as
|
|
462 `mail'. To do this, use the following commands (as root) after doing
|
|
463 the make install.
|
|
464
|
|
465 chgrp mail movemail
|
|
466 chmod 2755 movemail
|
|
467
|
|
468 Installation normally copies movemail from the build directory to an
|
|
469 installation directory which is usually under /usr/local/lib. The
|
|
470 installed copy of movemail is usually in the directory
|
|
471 /usr/local/lib/emacs/VERSION/TARGET. You must change the group and
|
|
472 mode of the installed copy; changing the group and mode of the build
|
|
473 directory copy is ineffective.
|
|
474
|
203
|
475 ** XEmacs crashes on Digital Unix when dealing with large compilation
|
|
476 buffers.
|
|
477
|
|
478 This is a known problem with the regexp code, that uses alloca
|
|
479 extensively, and overflows the stack in case of complex regexp
|
|
480 matches. As a workaround, you can recompile with REGEX_MALLOC
|
|
481 defined.
|
|
482
|
124
|
483 ** On Solaris, C-x doesn't get through to Emacs when you use the console.
|
|
484
|
|
485 This is a Solaris feature (at least on Intel x86 cpus). Type C-r
|
|
486 C-r C-t, to toggle whether C-x gets through to Emacs.
|
|
487
|
197
|
488 ** VM appears to hang in large folders.
|
124
|
489
|
|
490 This is normal (trust us) when upgrading to VM-6.22 from earlier
|
|
491 versions. Let VM finish what it is doing and all will be well.
|
|
492
|
|
493 ** Changes made to .el files do not take effect.
|
0
|
494
|
197
|
495 You may have forgotten to recompile them into .elc files. Then the
|
|
496 old .elc files will be loaded, and your changes will not be seen. To
|
|
497 fix this, do `M-x byte-recompile-directory' and specify the directory
|
|
498 that contains the Lisp files.
|
0
|
499
|
197
|
500 Note that you will get a warning when loading a .elc file that is
|
|
501 older than the corresponding .el file.
|
0
|
502
|
197
|
503 ** Things which should be bold or italic (such as the initial
|
|
504 copyright notice) are not.
|
0
|
505
|
197
|
506 The fonts of the "bold" and "italic" faces are generated from the font
|
|
507 of the "default" face; in this way, your bold and italic fonts will
|
|
508 have the appropriate size and family. However, emacs can only be
|
|
509 clever in this way if you have specified the default font using the
|
|
510 XLFD (X Logical Font Description) format, which looks like
|
0
|
511
|
|
512 *-courier-medium-r-*-*-*-120-*-*-*-*-*-*
|
|
513
|
197
|
514 if you use any of the other, less strict font name formats, some of
|
|
515 which look like:
|
|
516
|
0
|
517 lucidasanstypewriter-12
|
|
518 and fixed
|
|
519 and 9x13
|
|
520
|
|
521 then emacs won't be able to guess the names of the "bold" and "italic"
|
|
522 versions. All X fonts can be referred to via XLFD-style names, so you
|
|
523 should use those forms. See the man pages for X(1), xlsfonts(1), and
|
|
524 xfontsel(1).
|
|
525
|
197
|
526 ** The dumped Emacs crashes when run, trying to write pure data.
|
0
|
527
|
|
528 Two causes have been seen for such problems.
|
|
529
|
|
530 1) On a system where getpagesize is not a system call, it is defined
|
|
531 as a macro. If the definition (in both unexec.c and malloc.c) is wrong,
|
|
532 it can cause problems like this. You might be able to find the correct
|
|
533 value in the man page for a.out (5).
|
|
534
|
|
535 2) Some systems allocate variables declared static among the
|
|
536 initialized variables. Emacs makes all initialized variables in most
|
|
537 of its files pure after dumping, but the variables declared static and
|
|
538 not initialized are not supposed to be pure. On these systems you
|
|
539 may need to add "#define static" to the m- or the s- file.
|
|
540
|
124
|
541 ** Reading and writing files is very very slow.
|
0
|
542
|
|
543 Try evaluating the form (setq lock-directory nil) and see if that helps.
|
|
544 There is a problem with file-locking on some systems (possibly related
|
|
545 to NFS) that I don't understand. Please send mail to the address
|
|
546 xemacs@xemacs.org if you figure this one out.
|
|
547
|
124
|
548 ** The Emacs window disappears when you type M-q.
|
|
549
|
|
550 Some versions of the Open Look window manager interpret M-q as a quit
|
|
551 command for whatever window you are typing at. If you want to use
|
|
552 Emacs with that window manager, you should try to configure the window
|
|
553 manager to use some other command. You can disable the
|
|
554 shortcut keys entirely by adding this line to ~/.OWdefaults:
|
|
555
|
|
556 OpenWindows.WindowMenuAccelerators: False
|
|
557
|
|
558 ** The `Alt' key doesn't behave as `Meta' when running DECwindows.
|
|
559
|
|
560 The default DEC keyboard mapping has the Alt keys set up to generate the
|
|
561 keysym `Multi_key', which has a meaning to xemacs which is distinct from that
|
|
562 of the `Meta_L' and `Meta-R' keysyms. A second problem is that certain keys
|
|
563 have the Mod2 modifier attached to them for no adequately explored reason.
|
|
564 The correct fix is to pass this file to xmodmap upon starting X:
|
|
565
|
|
566 clear mod2
|
|
567 keysym Multi_key = Alt_L
|
|
568 add mod1 = Alt_L
|
|
569 add mod1 = Alt_R
|
|
570
|
|
571 ** The Compose key on a DEC keyboard does not work as Meta key.
|
|
572
|
|
573 This shell command should fix it:
|
|
574
|
|
575 xmodmap -e 'keycode 0xb1 = Meta_L'
|
|
576
|
|
577 ** When emacs starts up, I get lots of warnings about unknown keysyms.
|
|
578
|
|
579 If you are running the prebuilt binaries, the Motif library expects to find
|
|
580 certain thing in the XKeysymDB file. This file is normally in /usr/lib/X11/
|
|
581 or in /usr/openwin/lib/. If you keep yours in a different place, set the
|
|
582 environment variable $XKEYSYMDB to point to it before starting emacs. If
|
|
583 you still have the problem after doing that, perhaps your version of X is
|
|
584 too old. There is a copy of the MIT X11R5 XKeysymDB file in the emacs `etc'
|
|
585 directory. Try using that one.
|
|
586
|
|
587 ** My X resources used to work, and now some of them are being ignored.
|
0
|
588
|
124
|
589 Check the resources in .../etc/Emacs.ad (which is the same as the file
|
|
590 sample.Xdefaults). Perhaps some of the default resources built in to
|
|
591 emacs are now overriding your existing resources. Copy and edit the
|
|
592 resources in Emacs.ad as necessary.
|
|
593
|
197
|
594 ** I get complaints about the mapping of my HP keyboard at startup,
|
|
595 but I haven't changed anything.
|
124
|
596
|
|
597 The default HP keymap is set up to have Mod1 assigned to two different keys:
|
|
598 Meta_L and Mode_switch (even though there is not actually a Mode_switch key on
|
|
599 the keyboard -- it uses an "imaginary" keycode.) There actually is a reason
|
|
600 for this, but it's not a good one. The correct fix is to execute this command
|
|
601 upon starting X:
|
|
602
|
|
603 xmodmap -e 'remove mod1 = Mode_switch'
|
|
604
|
197
|
605 ** I have focus problems when I use `M-o' to switch to another screen
|
|
606 without using the mouse.
|
124
|
607
|
197
|
608 The focus issues with a program like XEmacs, which has multiple
|
|
609 homogeneous top-level windows, are very complicated, and as a result,
|
|
610 most window managers don't implement them correctly.
|
0
|
611
|
124
|
612 The R4/R5 version of twm (and all of its descendants) had buggy focus
|
197
|
613 handling. Sufficiently recent versions of tvtwm have been fixed. In
|
|
614 addition, if you're using twm, make sure you have not specified
|
|
615 "NoTitleFocus" in your .tvtwmrc file. The very nature of this option
|
|
616 makes twm do some illegal focus tricks, even with the patch.
|
0
|
617
|
197
|
618 It is known that olwm and olvwm are buggy, and in different ways. If
|
|
619 you're using click-to-type mode, try using point-to-type, or vice
|
|
620 versa.
|
0
|
621
|
197
|
622 In older versions of NCDwm, one could not even type at XEmacs windows.
|
|
623 This has been fixed in newer versions (2.4.3, and possibly earlier).
|
0
|
624
|
197
|
625 (Many people suggest that XEmacs should warp the mouse when focusing
|
|
626 on another screen in point-to-type mode. This is not ICCCM-compliant
|
|
627 behavior. Implementing such policy is the responsibility of the
|
|
628 window manager itself, it is not legal for a client to do this.)
|
0
|
629
|
124
|
630 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
|
0
|
631
|
|
632 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being
|
|
633 used. C-s/C-q flow control is bad for Emacs editors because it takes
|
|
634 away C-s and C-q as user commands. Since editors do not output long
|
|
635 streams of text without user commands, there is no need for a
|
|
636 user-issuable "stop output" command in an editor; therefore, a
|
|
637 properly designed flow control mechanism would transmit all possible
|
|
638 input characters without interference. Designing such a mechanism is
|
|
639 easy, for a person with at least half a brain.
|
|
640
|
|
641 There are three possible reasons why flow control could be taking place:
|
|
642
|
|
643 1) Terminal has not been told to disable flow control
|
|
644 2) Insufficient padding for the terminal in use
|
|
645 3) Some sort of terminal concentrator or line switch is responsible
|
|
646
|
|
647 First of all, many terminals have a set-up mode which controls whether
|
|
648 they generate XON/XOFF flow control characters. This must be set to
|
|
649 "no XON/XOFF" in order for Emacs to work. Sometimes there is an
|
|
650 escape sequence that the computer can send to turn flow control off
|
|
651 and on. If so, perhaps the termcap `ti' string should turn flow
|
|
652 control off, and the `te' string should turn it on.
|
|
653
|
|
654 Once the terminal has been told "no flow control", you may find it
|
|
655 needs more padding. The amount of padding Emacs sends is controlled
|
|
656 by the termcap entry for the terminal in use, and by the output baud
|
|
657 rate as known by the kernel. The shell command `stty' will print
|
|
658 your output baud rate; `stty' with suitable arguments will set it if
|
|
659 it is wrong. Setting to a higher speed causes increased padding. If
|
|
660 the results are wrong for the correct speed, there is probably a
|
|
661 problem in the termcap entry. You must speak to a local Unix wizard
|
|
662 to fix this. Perhaps you are just using the wrong terminal type.
|
|
663
|
|
664 For terminals that lack a "no flow control" mode, sometimes just
|
|
665 giving lots of padding will prevent actual generation of flow control
|
|
666 codes. You might as well try it.
|
|
667
|
|
668 If you are really unlucky, your terminal is connected to the computer
|
|
669 through a concentrator which sends XON/XOFF flow control to the
|
|
670 computer, or it insists on sending flow control itself no matter how
|
|
671 much padding you give it. Unless you can figure out how to turn flow
|
|
672 control off on this concentrator (again, refer to your local wizard),
|
|
673 you are screwed! You should have the terminal or concentrator
|
|
674 replaced with a properly designed one. In the mean time, some drastic
|
|
675 measures can make Emacs semi-work.
|
|
676
|
|
677 You can make Emacs ignore C-s and C-q and let the operating system
|
|
678 handle them. To do this on a per-session basis, just type M-x
|
|
679 enable-flow-control RET. You will see a message that C-\ and C-^ are
|
|
680 now translated to C-s and C-q. (Use the same command M-x
|
|
681 enable-flow-control to turn *off* this special mode. It toggles flow
|
|
682 control handling.)
|
|
683
|
|
684 If C-\ and C-^ are inconvenient for you (for example, if one of them
|
|
685 is the escape character of your terminal concentrator), you can choose
|
|
686 other characters by setting the variables flow-control-c-s-replacement
|
|
687 and flow-control-c-q-replacement. But choose carefully, since all
|
|
688 other control characters are already used by emacs.
|
|
689
|
|
690 IMPORTANT: if you type C-s by accident while flow control is enabled,
|
|
691 Emacs output will freeze, and you will have to remember to type C-q in
|
|
692 order to continue.
|
|
693
|
|
694 If you work in an environment where a majority of terminals of a
|
|
695 certain type are flow control hobbled, you can use the function
|
|
696 `enable-flow-control-on' to turn on this flow control avoidance scheme
|
|
697 automatically. Here is an example:
|
|
698
|
|
699 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
|
|
700
|
|
701 If this isn't quite correct (e.g. you have a mixture of flow-control hobbled
|
|
702 and good vt200 terminals), you can still run enable-flow-control
|
|
703 manually.
|
|
704
|
|
705 I have no intention of ever redesigning the Emacs command set for the
|
|
706 assumption that terminals use C-s/C-q flow control. XON/XOFF flow
|
|
707 control technique is a bad design, and terminals that need it are bad
|
|
708 merchandise and should not be purchased. Now that X is becoming
|
|
709 widespread, XON/XOFF seems to be on the way out. If you can get some
|
|
710 use out of GNU Emacs on inferior terminals, more power to you, but I
|
|
711 will not make Emacs worse for properly designed systems for the sake
|
|
712 of inferior systems.
|
|
713
|
124
|
714 ** Control-S and Control-Q commands are ignored completely.
|
0
|
715
|
|
716 For some reason, your system is using brain-damaged C-s/C-q flow
|
|
717 control despite Emacs's attempts to turn it off. Perhaps your
|
|
718 terminal is connected to the computer through a concentrator
|
|
719 that wants to use flow control.
|
|
720
|
|
721 You should first try to tell the concentrator not to use flow control.
|
|
722 If you succeed in this, try making the terminal work without
|
|
723 flow control, as described in the preceding section.
|
|
724
|
|
725 If that line of approach is not successful, map some other characters
|
|
726 into C-s and C-q using keyboard-translate-table. The example above
|
|
727 shows how to do this with C-^ and C-\.
|
|
728
|
124
|
729 ** Control-S and Control-Q commands are ignored completely on a net
|
197
|
730 connection.
|
0
|
731
|
|
732 Some versions of rlogin (and possibly telnet) do not pass flow
|
|
733 control characters to the remote system to which they connect.
|
|
734 On such systems, emacs on the remote system cannot disable flow
|
|
735 control on the local system.
|
|
736
|
|
737 One way to cure this is to disable flow control on the local host
|
|
738 (the one running rlogin, not the one running rlogind) using the
|
|
739 stty command, before starting the rlogin process. On many systems,
|
120
|
740 `stty start u stop u' will do this.
|
0
|
741
|
|
742 Some versions of tcsh will prevent even this from working. One way
|
|
743 around this is to start another shell before starting rlogin, and
|
|
744 issue the stty command to disable flow control from that shell.
|
|
745
|
|
746 If none of these methods work, the best solution is to type
|
120
|
747 `M-x enable-flow-control' at the beginning of your emacs session, or
|
0
|
748 if you expect the problem to continue, add a line such as the
|
|
749 following to your .emacs (on the host running rlogind):
|
|
750
|
|
751 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
|
|
752
|
|
753 See the entry about spontaneous display of I-search (above) for more
|
|
754 info.
|
|
755
|
197
|
756 ** TTY redisplay is slow.
|
|
757
|
|
758 XEmacs has fairly new TTY redisplay support (beginning from 19.12),
|
|
759 which doesn't include some basic TTY optimizations -- like using
|
|
760 scrolling regions to move around blocks of text. This is why
|
|
761 redisplay on the traditional terminals, or over slow lines can be very
|
|
762 slow.
|
|
763
|
|
764 If you are interested in fixing this, please let us know at
|
|
765 <xemacs@xemacs.org>.
|
|
766
|
124
|
767 ** Screen is updated wrong, but only on one kind of terminal.
|
0
|
768
|
120
|
769 This could mean that the termcap entry you are using for that terminal
|
|
770 is wrong, or it could mean that Emacs has a bug handing the
|
|
771 combination of features specified for that terminal.
|
0
|
772
|
|
773 The first step in tracking this down is to record what characters
|
|
774 Emacs is sending to the terminal. Execute the Lisp expression
|
120
|
775 (open-termscript "./emacs-script") to make Emacs write all terminal
|
|
776 output into the file ~/emacs-script as well; then do what makes the
|
|
777 screen update wrong, and look at the file and decode the characters
|
|
778 using the manual for the terminal. There are several possibilities:
|
0
|
779
|
|
780 1) The characters sent are correct, according to the terminal manual.
|
|
781
|
|
782 In this case, there is no obvious bug in Emacs, and most likely you
|
|
783 need more padding, or possibly the terminal manual is wrong.
|
|
784
|
120
|
785 2) The characters sent are incorrect, due to an obscure aspect of the
|
|
786 terminal behavior not described in an obvious way by termcap.
|
0
|
787
|
120
|
788 This case is hard. It will be necessary to think of a way for Emacs
|
|
789 to distinguish between terminals with this kind of behavior and other
|
|
790 terminals that behave subtly differently but are classified the same
|
|
791 by termcap; or else find an algorithm for Emacs to use that avoids the
|
|
792 difference. Such changes must be tested on many kinds of terminals.
|
0
|
793
|
|
794 3) The termcap entry is wrong.
|
|
795
|
120
|
796 See the file etc/TERMS for information on changes that are known to be
|
|
797 needed in commonly used termcap entries for certain terminals.
|
0
|
798
|
120
|
799 4) The characters sent are incorrect, and clearly cannot be right for
|
|
800 any terminal with the termcap entry you were using.
|
0
|
801
|
120
|
802 This is unambiguously an Emacs bug, and can probably be fixed in
|
197
|
803 termcap.c, terminfo.c, tparam.c, cm.c, redisplay-tty.c,
|
|
804 redisplay-output.c, or redisplay.c.
|
0
|
805
|
124
|
806 ** Your Delete key sends a Backspace to the terminal, using an AIXterm.
|
0
|
807
|
|
808 The solution is to include in your .Xdefaults the lines:
|
|
809
|
|
810 *aixterm.Translations: #override <Key>BackSpace: string(0x7f)
|
|
811 aixterm*ttyModes: erase ^?
|
|
812
|
|
813 This makes your Backspace key send DEL (ASCII 127).
|
|
814
|
124
|
815 ** With certain fonts, when the cursor appears on a character, the
|
197
|
816 character doesn't appear--you get a solid box instead.
|
124
|
817
|
|
818 One user on a Linux system reported that this problem went away with
|
|
819 installation of a new X server. The failing server was XFree86 3.1.1.
|
|
820 XFree86 3.1.2 works.
|
|
821
|
|
822 ** On SunOS 4.1.3, Emacs unpredictably crashes in _yp_dobind_soft.
|
0
|
823
|
124
|
824 This happens if you configure Emacs specifying just `sparc-sun-sunos4'
|
|
825 on a system that is version 4.1.3. You must specify the precise
|
|
826 version number (or let configure figure out the configuration, which
|
|
827 it can do perfectly well for SunOS).
|
|
828
|
|
829 ** On Irix, I don't see the toolbar icons and I'm getting lots of
|
197
|
830 entries in the warnings buffer.
|
0
|
831
|
124
|
832 SGI ships a really old Xpm library in /usr/lib which does not work at
|
|
833 all well with XEmacs. The solution is to install your own copy of the
|
|
834 latest version of Xpm somewhere and then use the --site-includes and
|
|
835 --site-libraries flags to tell configure where to find it.
|
|
836
|
197
|
837 ** On HPUX, you get "poll: Interrupted system call" message in the
|
|
838 window where XEmacs was launched.
|
124
|
839
|
|
840 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
|
0
|
841
|
197
|
842 I get a very strange problem when linking libc.a dynamically: every
|
|
843 event (mouse, keyboard, expose...) results in a "poll: Interrupted
|
|
844 system call" message in the window where XEmacs was
|
|
845 launched. Forcing a static link of libc.a alone by adding
|
|
846 /usr/lib/libc.a at the end of the link line solves this. Note that
|
|
847 my 9.07 build of 19.14b17 and my (old) build of 19.13 both exhibit
|
|
848 the same behaviour. I've tried various hpux patches to no avail. If
|
|
849 this problem cannot be solved before the release date, binary kits
|
|
850 for HP *must* be linked statically against libc, otherwise this
|
|
851 problem will show up. (This is directed at whoever will volunteer
|
|
852 for this kit, as I won't be available to do it, unless 19.14 gets
|
|
853 delayed until mid-june ;-). I think this problem will be an FAQ soon
|
|
854 after the release otherwise.
|
|
855
|
227
|
856 Note: The above entry is probably not valid for XEmacs 20.5 and
|
207
|
857 later.
|
0
|
858
|
124
|
859 ** When Emacs tries to ring the bell, you get an error like
|
|
860
|
|
861 audio: sst_open: SETQSIZE" Invalid argument
|
|
862 audio: sst_close: SETREG MMR2, Invalid argument
|
|
863
|
197
|
864 you have probably compiled using an ANSI C compiler, but with non-ANSI
|
|
865 include files. In particular, on Suns, the file
|
|
866 /usr/include/sun/audioio.h uses the _IOW macro to define the constant
|
|
867 AUDIOSETQSIZE. _IOW in turn uses a K&R preprocessor feature that is
|
|
868 now explicitly forbidden in ANSI preprocessors, namely substitution
|
|
869 inside character constants. All ANSI C compilers must provide a
|
|
870 workaround for this problem. Lucid's C compiler is shipped with a new
|
|
871 set of system include files. If you are using GCC, there is a script
|
|
872 called fixincludes that creates new versions of some system include
|
|
873 files that use this obsolete feature.
|
124
|
874
|
|
875 ** My buffers are full of \000 characters or otherwise corrupt.
|
0
|
876
|
124
|
877 Some compilers have trouble with gmalloc.c and ralloc.c; try recompiling
|
|
878 without optimization. If that doesn't work, try recompiling with
|
|
879 SYSTEM_MALLOC defined, and/or with REL_ALLOC undefined.
|
|
880
|
|
881 ** On AIX 4, some programs fail when run in a Shell buffer
|
197
|
882 with an error message like No terminfo entry for "unknown".
|
124
|
883
|
|
884 On AIX, many terminal type definitions are not installed by default.
|
|
885 `unknown' is one of them. Install the "Special Generic Terminal
|
|
886 Definitions" to make them defined.
|
|
887
|
|
888 ** Emacs exits with "X protocol error" when run with an X server for
|
197
|
889 Windows.
|
0
|
890
|
124
|
891 A certain X server for Windows had a bug which caused this.
|
|
892 Supposedly the newer 32-bit version of this server doesn't have the
|
|
893 problem.
|
|
894
|
|
895 ** A position you specified in .Xdefaults is ignored, using twm.
|
|
896
|
|
897 twm normally ignores "program-specified" positions.
|
|
898 You can tell it to obey them with this command in your `.twmrc' file:
|
0
|
899
|
124
|
900 UsePPosition "on" #allow clents to request a position
|
|
901
|
|
902 ** The right Alt key works wrong on German HP keyboards (and perhaps
|
|
903 other non-English HP keyboards too).
|
|
904
|
|
905 This is because HPUX defines the modifiers wrong in X. Here is a
|
|
906 shell script to fix the problem; be sure that it is run after VUE
|
|
907 configures the X server.
|
0
|
908
|
124
|
909 xmodmap 2> /dev/null - << EOF
|
|
910 keysym Alt_L = Meta_L
|
|
911 keysym Alt_R = Meta_R
|
|
912 EOF
|
|
913
|
|
914 xmodmap - << EOF
|
|
915 clear mod1
|
|
916 keysym Mode_switch = NoSymbol
|
|
917 add mod1 = Meta_L
|
|
918 keysym Meta_R = Mode_switch
|
|
919 add mod2 = Mode_switch
|
|
920 EOF
|
|
921
|
|
922 ** Trouble using ptys on IRIX, or running out of ptys.
|
|
923
|
|
924 The program mkpts (which may be in `/usr/adm' or `/usr/sbin') needs to
|
|
925 be set-UID to root, or non-root programs like Emacs will not be able
|
|
926 to allocate ptys reliably.
|
|
927
|
197
|
928 ** Motif dialog boxes lose on Irix.
|
126
|
929
|
|
930 Larry Auton <lda@control.att.com> writes:
|
|
931 Beware of not specifying
|
|
932
|
|
933 --with-dialogs=athena
|
|
934
|
|
935 if it builds with the motif dialogs [boom!] you're a dead man.
|
|
936
|
|
937 ** Beware of the default image & graphics library on Irix
|
|
938
|
|
939 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
|
|
940 You *have* to compile your own jpeg lib. The one delivered with SGI
|
|
941 systems is a C++ lib, which apparently XEmacs cannot cope with.
|
|
942
|
124
|
943 ** Slow startup on Linux.
|
|
944
|
|
945 People using systems based on the Linux kernel sometimes report that
|
|
946 startup takes 10 to 15 seconds longer than `usual'.
|
|
947
|
|
948 This is because Emacs looks up the host name when it starts.
|
|
949 Normally, this takes negligible time; the extra delay is due to
|
|
950 improper system configuration. This problem can occur for both
|
|
951 networked and non-networked machines.
|
0
|
952
|
124
|
953 Here is how to fix the configuration. It requires being root.
|
|
954
|
|
955 *** Networked Case
|
|
956
|
|
957 First, make sure the files `/etc/hosts' and `/etc/host.conf' both
|
|
958 exist. The first line in the `/etc/hosts' file should look like this
|
|
959 (replace HOSTNAME with your host name):
|
|
960
|
|
961 127.0.0.1 localhost HOSTNAME
|
|
962
|
|
963 Also make sure that the `/etc/host.conf' files contains the following
|
|
964 lines:
|
|
965
|
|
966 order hosts, bind
|
|
967 multi on
|
|
968
|
|
969 Any changes, permanent and temporary, to the host name should be
|
|
970 indicated in the `/etc/hosts' file, since it acts a limited local
|
|
971 database of addresses and names (e.g., some SLIP connections
|
|
972 dynamically allocate ip addresses).
|
|
973
|
|
974 *** Non-Networked Case
|
|
975
|
|
976 The solution described in the networked case applies here as well.
|
|
977 However, if you never intend to network your machine, you can use a
|
|
978 simpler solution: create an empty `/etc/host.conf' file. The command
|
|
979 `touch /etc/host.conf' suffices to create the file. The `/etc/hosts'
|
|
980 file is not necessary with this approach.
|
|
981
|
|
982 ** On Solaris 2.4, Dired hangs and C-g does not work. Or Emacs hangs
|
197
|
983 forever waiting for termination of a subprocess that is a zombie.
|
124
|
984
|
|
985 casper@fwi.uva.nl says the problem is in X11R6. Rebuild libX11.so
|
|
986 after changing the file xc/config/cf/sunLib.tmpl. Change the lines
|
|
987
|
|
988 #if ThreadedX
|
|
989 #define SharedX11Reqs -lthread
|
|
990 #endif
|
|
991
|
|
992 to:
|
|
993
|
|
994 #if OSMinorVersion < 4
|
|
995 #if ThreadedX
|
|
996 #define SharedX11Reqs -lthread
|
|
997 #endif
|
|
998 #endif
|
|
999
|
|
1000 Be sure also to edit x/config/cf/sun.cf so that OSMinorVersion is 4
|
|
1001 (as it should be for Solaris 2.4). The file has three definitions for
|
|
1002 OSMinorVersion: the first is for x86, the second for SPARC under
|
|
1003 Solaris, and the third for SunOS 4. Make sure to update the
|
|
1004 definition for your type of machine and system.
|
|
1005
|
|
1006 Then do `make Everything' in the top directory of X11R6, to rebuild
|
|
1007 the makefiles and rebuild X. The X built this way work only on
|
|
1008 Solaris 2.4, not on 2.3.
|
|
1009
|
|
1010 For multithreaded X to work it necessary to install patch
|
|
1011 101925-02 to fix problems in header files [2.4]. You need
|
|
1012 to reinstall gcc or re-run just-fixinc after installing that
|
|
1013 patch.
|
0
|
1014
|
124
|
1015 However, Frank Rust <frust@iti.cs.tu-bs.de> used a simpler solution:
|
|
1016 he changed
|
|
1017 #define ThreadedX YES
|
|
1018 to
|
|
1019 #define ThreadedX NO
|
|
1020 in sun.cf and did `make World' to rebuild X11R6. Removing all
|
|
1021 `-DXTHREAD*' flags and `-lthread' entries from lib/X11/Makefile and
|
|
1022 typing 'make install' in that directory also seemed to work.
|
|
1023
|
|
1024 ** With M-x enable-flow-control, you need to type C-\ twice to do
|
197
|
1025 incremental search--a single C-\ gets no response.
|
0
|
1026
|
124
|
1027 This has been traced to communicating with your machine via kermit,
|
|
1028 with C-\ as the kermit escape character. One solution is to use
|
|
1029 another escape character in kermit. One user did
|
|
1030
|
|
1031 set escape-character 17
|
|
1032
|
|
1033 in his .kermrc file, to make C-q the kermit escape character.
|
0
|
1034
|
124
|
1035 ** The Motif version of Emacs paints the screen a solid color.
|
|
1036
|
|
1037 This has been observed to result from the following X resource:
|
|
1038
|
|
1039 Emacs*default.attributeFont: -*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*
|
|
1040
|
|
1041 That the resource has this effect indicates a bug in something, but we
|
|
1042 do not yet know what. If it is an Emacs bug, we hope someone can
|
|
1043 explain what the bug is so we can fix it. In the mean time, removing
|
|
1044 the resource prevents the problem.
|
0
|
1045
|
124
|
1046 ** Regular expressions matching bugs on SCO systems.
|
|
1047
|
|
1048 On SCO, there are problems in regexp matching when Emacs is compiled
|
|
1049 with the system compiler. The compiler version is "Microsoft C
|
|
1050 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; Quick
|
|
1051 C Compiler Version 1.00.46 (Beta). The solution is to compile with
|
|
1052 GCC.
|
|
1053
|
|
1054 ** In Shell mode, you get a ^M at the end of every line.
|
|
1055
|
|
1056 This happens to people who use tcsh, because it is trying to be too
|
|
1057 smart. It sees that the Shell uses terminal type `unknown' and turns
|
|
1058 on the flag to output ^M at the end of each line. You can fix the
|
|
1059 problem by adding this to your .cshrc file:
|
|
1060
|
|
1061 if ($?EMACS) then
|
|
1062 if ($EMACS == "t") then
|
|
1063 unset edit
|
|
1064 stty -icrnl -onlcr -echo susp ^Z
|
|
1065 endif
|
|
1066 endif
|
|
1067
|
|
1068 ** An error message such as `X protocol error: BadMatch (invalid
|
|
1069 parameter attributes) on protocol request 93'.
|
|
1070
|
|
1071 This comes from having an invalid X resource, such as
|
|
1072 emacs*Cursor: black
|
|
1073 (which is invalid because it specifies a color name for something
|
|
1074 that isn't a color.)
|
|
1075
|
|
1076 The fix is to correct your X resources.
|
|
1077
|
|
1078 ** Mail is lost when sent to local aliases.
|
0
|
1079
|
124
|
1080 Many emacs mail user agents (VM and rmail, for instance) use the
|
|
1081 sendmail.el library. This library can arrange for mail to be
|
|
1082 delivered by passing messages to the /usr/lib/sendmail (usually)
|
|
1083 program . In doing so, it passes the '-t' flag to sendmail, which
|
|
1084 means that the name of the recipient of the message is not on the
|
|
1085 command line and, therefore, that sendmail must parse the message to
|
|
1086 obtain the destination address.
|
|
1087
|
|
1088 There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail.
|
|
1089 In short, when given the -t flag, the SunOS sendmail won't recognize
|
|
1090 non-local (i.e. NIS) aliases. It has been reported that the Solaris
|
|
1091 2.x versions of sendmail do not have this bug. For those using SunOS
|
|
1092 4.1, the best fix is to install sendmail V8 or IDA sendmail (which
|
|
1093 have other advantages over the regular sendmail as well). At the time
|
|
1094 of this writing, these official versions are available:
|
|
1095
|
|
1096 Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail:
|
|
1097 sendmail.8.6.9.base.tar.Z (the base system source & documentation)
|
|
1098 sendmail.8.6.9.cf.tar.Z (configuration files)
|
|
1099 sendmail.8.6.9.misc.tar.Z (miscellaneous support programs)
|
|
1100 sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript)
|
|
1101
|
|
1102 IDA sendmail on vixen.cso.uiuc.edu in /pub:
|
|
1103 sendmail-5.67b+IDA-1.5.tar.gz
|
|
1104
|
|
1105 ** On AIX, you get this message when running Emacs:
|
0
|
1106
|
124
|
1107 Could not load program emacs
|
|
1108 Symbol smtcheckinit in csh is undefined
|
|
1109 Error was: Exec format error
|
|
1110
|
|
1111 or this one:
|
|
1112
|
|
1113 Could not load program .emacs
|
|
1114 Symbol _system_con in csh is undefined
|
|
1115 Symbol _fp_trapsta in csh is undefined
|
|
1116 Error was: Exec format error
|
|
1117
|
|
1118 These can happen when you try to run on AIX 3.2.5 a program that was
|
|
1119 compiled with 3.2.4. The fix is to recompile.
|
|
1120
|
|
1121 ** After running emacs once, subsequent invocations crash.
|
|
1122
|
|
1123 Some versions of SVR4 have a serious bug in the implementation of the
|
|
1124 mmap () system call in the kernel; this causes emacs to run correctly
|
|
1125 the first time, and then crash when run a second time.
|
|
1126
|
|
1127 Contact your vendor and ask for the mmap bug fix; in the mean time,
|
|
1128 you may be able to work around the problem by adding a line to your
|
|
1129 operating system description file (whose name is reported by the
|
|
1130 configure script) that reads:
|
|
1131 #define SYSTEM_MALLOC
|
|
1132 This makes Emacs use memory less efficiently, but seems to work around
|
|
1133 the kernel bug.
|
|
1134
|
|
1135 ** Inability to send an Alt-modified key, when Emacs is communicating
|
197
|
1136 directly with an X server.
|
0
|
1137
|
124
|
1138 If you have tried to bind an Alt-modified key as a command, and it
|
|
1139 does not work to type the command, the first thing you should check is
|
|
1140 whether the key is getting through to Emacs. To do this, type C-h c
|
|
1141 followed by the Alt-modified key. C-h c should say what kind of event
|
|
1142 it read. If it says it read an Alt-modified key, then make sure you
|
|
1143 have made the key binding correctly.
|
|
1144
|
|
1145 If C-h c reports an event that doesn't have the Alt modifier, it may
|
|
1146 be because your X server has no key for the Alt modifier. The X
|
|
1147 server that comes from MIT does not set up the Alt modifier by
|
|
1148 default.
|
|
1149
|
|
1150 If your keyboard has keys named Alt, you can enable them as follows:
|
0
|
1151
|
124
|
1152 xmodmap -e 'add mod2 = Alt_L'
|
|
1153 xmodmap -e 'add mod2 = Alt_R'
|
|
1154
|
|
1155 If the keyboard has just one key named Alt, then only one of those
|
|
1156 commands is needed. The modifier `mod2' is a reasonable choice if you
|
|
1157 are using an unmodified MIT version of X. Otherwise, choose any
|
|
1158 modifier bit not otherwise used.
|
0
|
1159
|
124
|
1160 If your keyboard does not have keys named Alt, you can use some other
|
|
1161 keys. Use the keysym command in xmodmap to turn a function key (or
|
|
1162 some other 'spare' key) into Alt_L or into Alt_R, and then use the
|
|
1163 commands show above to make them modifier keys.
|
|
1164
|
|
1165 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
|
|
1166 into Meta. This is because of the great importance of Meta in Emacs.
|
|
1167
|
|
1168 ** `Pid xxx killed due to text modification or page I/O error'
|
0
|
1169
|
124
|
1170 On HP/UX, you can get that error when the Emacs executable is on an NFS
|
|
1171 file system. HP/UX responds this way if it tries to swap in a page and
|
|
1172 does not get a response from the server within a timeout whose default
|
|
1173 value is just ten seconds.
|
|
1174
|
|
1175 If this happens to you, extend the timeout period.
|
|
1176
|
197
|
1177 ** `expand-file-name' fails to work on any but the machine you dumped
|
|
1178 Emacs on.
|
124
|
1179
|
|
1180 On Ultrix, if you use any of the functions which look up information
|
|
1181 in the passwd database before dumping Emacs (say, by using
|
|
1182 expand-file-name in site-init.el), then those functions will not work
|
|
1183 in the dumped Emacs on any host but the one Emacs was dumped on.
|
|
1184
|
|
1185 The solution? Don't use expand-file-name in site-init.el, or in
|
|
1186 anything it loads. Yuck - some solution.
|
0
|
1187
|
124
|
1188 I'm not sure why this happens; if you can find out exactly what is
|
|
1189 going on, and perhaps find a fix or a workaround, please let us know.
|
|
1190 Perhaps the YP functions cache some information, the cache is included
|
|
1191 in the dumped Emacs, and is then inaccurate on any other host.
|
|
1192
|
|
1193 ** Emacs fails to understand most Internet host names, even though
|
|
1194 the names work properly with other programs on the same system.
|
197
|
1195 Emacs won't work with X-windows if the value of DISPLAY is HOSTNAME:0.
|
|
1196 Gnus can't make contact with the specified host for nntp.
|
0
|
1197
|
124
|
1198 This typically happens on Suns and other systems that use shared
|
|
1199 libraries. The cause is that the site has installed a version of the
|
|
1200 shared library which uses a name server--but has not installed a
|
|
1201 similar version of the unshared library which Emacs uses.
|
0
|
1202
|
124
|
1203 The result is that most programs, using the shared library, work with
|
|
1204 the nameserver, but Emacs does not.
|
|
1205
|
|
1206 The fix is to install an unshared library that corresponds to what you
|
|
1207 installed in the shared library, and then relink Emacs.
|
0
|
1208
|
124
|
1209 On SunOS 4.1, simply define HAVE_RES_INIT.
|
|
1210
|
|
1211 If you have already installed the name resolver in the file libresolv.a,
|
|
1212 then you need to compile Emacs to use that library. The easiest way to
|
|
1213 do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE
|
|
1214 or LIB_STANDARD which uses -lresolv. Watch out! If you redefine a macro
|
|
1215 that is already in use in your configuration to supply some other libraries,
|
|
1216 be careful not to lose the others.
|
|
1217
|
|
1218 Thus, you could start by adding this to config.h:
|
|
1219
|
|
1220 #define LIBS_SYSTEM -lresolv
|
|
1221
|
|
1222 Then if this gives you an error for redefining a macro, and you see that
|
|
1223 the s- file defines LIBS_SYSTEM as -lfoo -lbar, you could change config.h
|
|
1224 again to say this:
|
|
1225
|
|
1226 #define LIBS_SYSTEM -lresolv -lfoo -lbar
|
|
1227
|
|
1228 ** Trouble using ptys on AIX.
|
0
|
1229
|
124
|
1230 People often install the pty devices on AIX incorrectly.
|
|
1231 Use `smit pty' to reinstall them properly.
|
|
1232
|
|
1233 ** Shell mode on HP/UX gives the message, "`tty`: Ambiguous".
|
|
1234
|
|
1235 christos@theory.tn.cornell.edu says:
|
|
1236
|
|
1237 The problem is that in your .cshrc you have something that tries to
|
197
|
1238 execute `tty`. If you are not running the shell on a real tty then tty
|
|
1239 will print "not a tty". Csh expects one word in some places, but tty
|
|
1240 is giving it back 3.
|
124
|
1241
|
197
|
1242 The solution is to add a pair of quotes around `tty` to make it a
|
|
1243 single word:
|
0
|
1244
|
124
|
1245 if (`tty` == "/dev/console")
|
|
1246
|
|
1247 should be changed to:
|
|
1248
|
|
1249 if ("`tty`" == "/dev/console")
|
|
1250
|
|
1251 Even better, move things that set up terminal sections out of .cshrc
|
|
1252 and into .login.
|
0
|
1253
|
197
|
1254 ** With process-connection-type set to t, each line of subprocess
|
|
1255 output is terminated with a ^M, making ange-ftp and GNUS not work.
|
0
|
1256
|
197
|
1257 On SunOS systems, this problem has been seen to be a result of an
|
|
1258 incomplete installation of gcc 2.2 which allowed some non-ANSI
|
|
1259 compatible include files into the compilation. In particular this
|
|
1260 affected virtually all ioctl() calls.
|
124
|
1261
|
|
1262 ** Once you pull down a menu from the menubar, it won't go away.
|
0
|
1263
|
197
|
1264 It has been claimed that this is caused by a bug in certain very old
|
|
1265 (1990?) versions of the twm window manager. It doesn't happen with
|
|
1266 recent vintages, or with other window managers.
|
124
|
1267
|
|
1268 ** Emacs ignores the "help" key when running OLWM.
|
88
|
1269
|
197
|
1270 OLWM grabs the help key, and retransmits it to the appropriate client
|
|
1271 using XSendEvent. Allowing emacs to react to synthetic events is a
|
|
1272 security hole, so this is turned off by default. You can enable it by
|
|
1273 setting the variable x-allow-sendevents to t. You can also cause fix
|
|
1274 this by telling OLWM to not grab the help key, with the null binding
|
|
1275 "OpenWindows.KeyboardCommand.Help:".
|
124
|
1276
|
|
1277 ** Programs running under terminal emulator do not recognize `emacs'
|
197
|
1278 terminal type.
|
88
|
1279
|
124
|
1280 The cause of this is a shell startup file that sets the TERMCAP
|
|
1281 environment variable. The terminal emulator uses that variable to
|
|
1282 provide the information on the special terminal type that Emacs
|
|
1283 emulates.
|
88
|
1284
|
124
|
1285 Rewrite your shell startup file so that it does not change TERMCAP
|
|
1286 in such a case. You could use the following conditional which sets
|
|
1287 it only if it is undefined.
|
|
1288
|
|
1289 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
|
|
1290
|
|
1291 Or you could set TERMCAP only when you set TERM--which should not
|
|
1292 happen in a non-login shell.
|
|
1293
|
197
|
1294
|
124
|
1295 * Compatibility problems (with Emacs 18, GNU Emacs, or previous XEmacs/lemacs)
|
197
|
1296 ==============================================================================
|
88
|
1297
|
124
|
1298 ** "Symbol's value as variable is void: unread-command-char".
|
197
|
1299 "Wrong type argument: arrayp, #<keymap 143 entries>"
|
|
1300 "Wrong type argument: stringp, [#<keypress-event return>]"
|
88
|
1301
|
124
|
1302 There are a few incompatible changes in XEmacs, and these are the
|
|
1303 symptoms. Some of the emacs-lisp code you are running needs to be
|
|
1304 updated to be compatible with XEmacs.
|
|
1305
|
|
1306 The code should not treat keymaps as arrays (use `define-key', etc.),
|
|
1307 should not use obsolete variables like `unread-command-char' (use
|
197
|
1308 `unread-command-events'). Many (most) of the new ways of doing things
|
124
|
1309 are compatible in GNU Emacs and XEmacs.
|
88
|
1310
|
197
|
1311 Modern Emacs packages (Gnus, VM, W3, efs, etc) are written to support
|
|
1312 GNU Emacs and XEmacs. We have provided modified versions of several
|
|
1313 popular emacs packages (dired, etc) which are compatible with this
|
|
1314 version of emacs. Check to make sure you have not set your load-path
|
|
1315 so that your private copies of these packages are being found before
|
|
1316 the versions in the lisp directory.
|
124
|
1317
|
|
1318 Make sure that your load-path and your $EMACSLOADPATH environment
|
|
1319 variable are not pointing at an Emacs18 lisp directory. This will
|
|
1320 cripple emacs.
|
88
|
1321
|
124
|
1322 ** Some packages that worked before now cause the error
|
223
|
1323 Wrong type argument: arrayp, #<face ... >
|
124
|
1324
|
197
|
1325 Code which uses the `face' accessor functions must be recompiled with
|
|
1326 xemacs 19.9 or later. The functions whose callers must be recompiled
|
|
1327 are: face-font, face-foreground, face-background,
|
|
1328 face-background-pixmap, and face-underline-p. The .elc files
|
|
1329 generated by version 19.9 will work in 19.6 and 19.8, but older .elc
|
|
1330 files which contain calls to these functions will not work in 19.9.
|
124
|
1331
|
|
1332 ** Signaling: (error "Byte code stack underflow (byte compiler bug), pc 38")
|
88
|
1333
|
120
|
1334 This error is given when XEmacs 20 is compiled without MULE support
|
88
|
1335 but is attempting to load a .elc which requires MULE support. The fix
|
|
1336 is to rebytecompile the offending file.
|
|
1337
|
124
|
1338 ** Signaling: (wrong-type-argument ...) when loading mail-abbrevs
|
88
|
1339
|
197
|
1340 The is seen when installing the Insidious Big Brother Data Base (bbdb)
|
|
1341 which includes an outdated copy of mail-abbrevs.el. Remove the copy
|
|
1342 that comes with bbdb and use the one that comes with XEmacs.
|
|
1343
|
144
|
1344
|
|
1345 * MULE issues
|
197
|
1346 =============
|
144
|
1347
|
223
|
1348 ** A reminder: XEmacs/Mule work does not currently receive *any*
|
|
1349 funding, and all work is done by volunteers. If you think you can
|
|
1350 help, please contact the XEmacs maintainers.
|
|
1351
|
|
1352 ** XEmacs/Mule doesn't work on a tty.
|
|
1353
|
|
1354 This is a major problem, which we plan to address in a future release
|
|
1355 of XEmacs. Basically, XEmacs should have primitives to be told
|
|
1356 whether the terminal can handle international output, and which
|
|
1357 locale. Also, it should be able to do approximations of characters to
|
|
1358 the nearest supported by the locale.
|
|
1359
|
197
|
1360 ** Internationalized (Asian) Isearch doesn't work.
|
144
|
1361
|
|
1362 Currently, Isearch doesn't directly support any of the input methods
|
|
1363 that are not XIM based (like egg, canna and quail) (and there are
|
223
|
1364 potential problems with XIM version too...). If you're using egg
|
|
1365 there is a workaround. Hitting <RET> right after C-s to invoke
|
|
1366 Isearch will put Isearch in string mode, where a complete string can
|
|
1367 be typed into the minibuffer and then processed by Isearch afterwards.
|
|
1368 Since egg is now supported in the minibuffer using string mode you can
|
|
1369 now use egg to input your Japanese, Korean or Chinese string, then hit
|
|
1370 return to send that to Isearch and then use standard Isearch commands
|
|
1371 from there.
|
144
|
1372
|
223
|
1373 ** Using egg and mousing around while in 'fence' mode screws up my
|
|
1374 buffer.
|
144
|
1375
|
|
1376 Don't do this. The fence modes of egg and canna are currently very
|
|
1377 modal, and messing with where they expect point to be and what they
|
|
1378 think is the current buffer is just asking for trouble. If you're
|
|
1379 lucky they will realize that something is awry, and simply delete the
|
|
1380 fence, but worst case can trash other buffers too. We've tried to
|
|
1381 protect against this where we can, but there still are many ways to
|
|
1382 shoot yourself in the foot. So just finish what you are typing into
|
|
1383 the fence before reaching for the mouse.
|
223
|
1384
|
|
1385 ** Not all languages in Quail are supported like Devanagari and Indian
|
|
1386 languages, Lao and Tibetan.
|
|
1387
|
|
1388 Quail requires more work and testing. Although it has been ported to
|
|
1389 XEmacs, it works really well for Japanese and for the European
|
|
1390 languages.
|
|
1391
|
|
1392 ** Right-to-left mode is not yet implemented, so languages like
|
|
1393 Arabic, Hebrew and Thai don't work.
|
|
1394
|
|
1395 Getting this right requires more work. It may be implemented in a
|
|
1396 future XEmacs version, but don't hold your breath. If you know
|
|
1397 someone who is ready to implement this, please let us know.
|
|
1398
|
|
1399 ** We need more developers and native language testers. It's extremely
|
|
1400 difficult (and not particularly productive) to address languages that
|
|
1401 nobody is using and testing.
|
|
1402
|
|
1403 ** The kWnn and cWnn support for Chinese and Korean needs developers
|
|
1404 and testers. It probably doesn't work.
|
|
1405
|
|
1406 ** There are no `native XEmacs' TUTORIALs for any Asian languages,
|
|
1407 including Japanese. FSF Emacs and XEmacs tutorials are quite similar,
|
|
1408 so it should be sufficient to skim through the differences and apply
|
|
1409 them to the Japanese version.
|
|
1410
|
|
1411 ** We only have localized menus translated for Japanese, and the
|
|
1412 Japanese menus are developing bitrot (the Mule menu appears in
|
|
1413 English).
|
|
1414
|
|
1415 ** XIM is untested for any language other than Japanese.
|