comparison PROBLEMS @ 124:9b50b4588a93 r20-1b15

Import from CVS: tag r20-1b15
author cvs
date Mon, 13 Aug 2007 09:26:39 +0200
parents cca96a509cfe
children 1370575f1259
comparison
equal deleted inserted replaced
123:c77884c6318d 124:9b50b4588a93
1 -*- mode:outline; minor-mode:outl-mouse -*- 1 -*- mode:outline; minor-mode:outl-mouse -*-
2 This file describes various problems that have been encountered 2 This file describes various problems that have been encountered
3 in compiling, installing and running XEmacs. 3 in compiling, installing and running XEmacs.
4 4
5 (synched up with: 19.30) 5 This file is large, but we have tried to sort the entries by their
6 respective relevance for XEmacs, but may have not succeeded completely
7 in that task. Try finding the things you need using one of the search
8 commands XEmacs provides (e.g. `C-s').
9
6 (updated for 20.1) 10 (updated for 20.1)
7 11
8 * Watch out for .emacs file 12 * Watch out for .emacs file
9 13
10 ~/.emacs is your Emacs init file. If you observe strange problems, 14 ~/.emacs is your Emacs init file. If you observe strange problems,
11 invoke XEmacs with the `-q' option and see if you can repeat the 15 invoke XEmacs with the `-q' option and see if you can repeat the
12 problem. 16 problem.
13 17
14 * "Symbol's value as variable is void: unread-command-char". 18 * Problems with building XEmacs
15 * "Wrong type argument: arrayp, #<keymap 143 entries>" 19
16 * "Wrong type argument: stringp, [#<keypress-event return>]" 20 ** The compiler generates lots and lots of syntax errors.
17
18 There are a few incompatible changes in XEmacs, and these are the
19 symptoms. Some of the emacs-lisp code you are running needs to be
20 updated to be compatible with XEmacs.
21
22 The code should not treat keymaps as arrays (use `define-key', etc.),
23 should not use obsolete variables like `unread-command-char' (use
24 `unread-command-event'). Many (most) of the new ways of doing things
25 are compatible in GNU Emacs and XEmacs.
26
27 Modern Emacs packages (Gnus, VM, etc) are written cleanly, as to
28 support GNU Emacs and XEmacs. We have provided modified versions of
29 several popular emacs packages (dired, etc) which are compatible with
30 this version of emacs. Check to make sure you have not set your
31 load-path so that your private copies of these packages are being
32 found before the versions in the lisp directory.
33
34 Make sure that your load-path and your $EMACSLOADPATH environment
35 variable are not pointing at an Emacs18 lisp directory. This will
36 cripple emacs.
37
38 * On Irix, I don't see the toolbar icons and I'm getting lots of
39 entries in the warnings buffer.
40
41 SGI ships a really old Xpm library in /usr/lib which does not work at
42 all well with XEmacs. The solution is to install your own copy of the
43 latest version of Xpm somewhere and then use the --site-includes and
44 --site-libraries flags to tell configure where to find it.
45
46 * On Digital UNIX, the DEC C compiler might have a problem compiling
47 some files.
48
49 In particular, src/extents.c and src/faces.c might cause the DEC C
50 compiler to abort. When this happens: cd src, compile the files by
51 hand, cd .., and redo the "make" command. When recompiling the files by
52 hand, use the old C compiler for the following versions of Digital UNIX:
53 - V3.n: Remove "-migrate" from the compile command.
54 - V4.n: Add "-oldc" to the compile command.
55
56 * On HPUX, the HP C compiler might have a problem compiling some files
57 with optimization.
58
59 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
60
61 Had to drop once again to level 2 optimization, at least to
62 compile lstream.c. Otherwise, I get a "variable is void: \if"
63 problem while dumping (this is a problem I already reported
64 with vanilla hpux 10.01 and 9.07, which went away after
65 applying patches for the C compiler). Trouble is I still
66 haven't found the same patch for hpux 10.10, and I don't
67 remember the patch numbers. I think potential XEmacs builders
68 on HP should be warned about this.
69
70 * On HPUX, you get "poll: Interrupted system call" message in the window
71 where XEmacs was launched.
72
73 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
74
75 I get a very strange problem when linking libc.a
76 dynamically: every event (mouse, keyboard, expose...) results
77 in a "poll: Interrupted system call" message in the window
78 where XEmacs was launched. Forcing a static link of libc.a
79 alone by adding /usr/lib/libc.a at the end of the link line
80 solves this. Note that my 9.07 build of 19.14b17 and my (old)
81 build of 19.13 both exhibit the same behaviour. I've tried
82 various hpux patches to no avail. If this problem cannot be
83 solved before the release date, binary kits for HP *must* be
84 linked statically against libc, otherwise this problem will
85 show up. (This is directed at whoever will volunteer for this
86 kit, as I won't be available to do it, unless 19.14 gets
87 delayed until mid-june ;-). I think this problem will be an FAQ
88 soon after the release otherwise.
89
90 * Native cc on SCO OpenServer 5 is now OK. Icc may still throw you
91 a curve. Here is what Robert Lipe <robertl@arnet.com> says:
92
93 Unlike XEmacs 19.13, building with the native cc on SCO OpenServer 5
94 now produces a functional binary. I will typically build this
95 configuration for COFF with:
96
97 /path_to_XEmacs_source/configure --with-gcc=no \
98 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
99 --with-xpm --with-xface --with-sound=nas
100
101 This version now supports ELF builds. I highly recommend this to
102 reduce the in-core footprint of XEmacs. This is now how I compile
103 all my test releases. Build it like this:
104
105 /path_to_XEmacs_source/configure --with-gcc=no \
106 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
107 --with-xpm --with-xface --with-sound=nas --dynamic
108
109 The compiler known as icc [ supplied with the OpenServer 5 Development
110 System ] generates a working binary, but it takes forever to generate
111 XEmacs. ICC also whines more about the code than /bin/cc does. I do
112 believe all its whining is legitimate, however. Note that you do
113 have to 'cd src ; make LD=icc' to avoid linker errors.
114
115 The way I handle the build procedure is:
116
117 /path_to_XEmacs_source/configure --with-gcc=no \
118 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
119 --with-xpm --with-xface --with-sound=nas --dynamic --compiler="icc"
120
121 *NOTE* I have the xpm, xface, and audio libraries and includes in
122 /usr/local/lib, /usr/local/include. If you don't have these,
123 don't include the "--with-*" arguments in any of my examples.
124
125 In previous versions of XEmacs, you had to override the defaults while
126 compiling font-lock.o and extents.o when building with icc. This seems
127 to no longer be true, but I'm including this old information in case it
128 resurfaces. The process I used was:
129
130 make -k
131 [ procure pizza, beer, repeat ]
132 cd src
133 make CC="icc -W0,-mP1COPT_max_tree_size=3000" font-lock.o extents.o
134 make LD=icc
135
136 If you want sound support, get the tls566 supplement from
137 ftp.sco.com:/TLS or any of its mirrors. It works just groovy
138 with XEmacs.
139
140 The M-x manual-entry is known not to work. If you know Lisp and would
141 like help in making it work, e-mail me at <robertl@dgii.com>
142
143 In earlier releases, gnuserv/gnuclient/gnudoit would open a frame
144 just fine, but the client would lock up and the server would
145 terminate when you used C-x # to close the frame. This is now
146 fixed in XEmacs.
147
148 In etc/ there are two files of note. emacskeys.sco and emacsstrs.sco.
149 The comments at the top of emacskeys.sco describe its function, and
150 the emacstrs.sco is a suitable candidate for /usr/lib/keyboard/strings
151 to take advantage of the keyboard map in emacskeys.sco.
152
153 * Don't use -O2 with gcc 2.7.2 under Linux without also using
154 -fno-strength-reduce.
155
156 gcc will generate incorrect code otherwise. This bug is present in at
157 least 2.6.x and 2.7.[0-2]. This bug has been fixed in GCC 2.7.2.1 and
158 later.
159
160 * Under some versions of OSF XEmacs runs fine if built without
161 optimization but will crash randomly if built with optimization.
162 Using 'cc -g' is not sufficient to eliminate all optimization. Try
163 'cc -g -O0' instead.
164
165 * On HP/UX configure selects gcc even though it isn't actually present.
166
167 Some versions of SoftBench have an executable called 'gcc' that is not
168 actually the GNU C compiler. Use the --with-gcc=no flag when running
169 configure.
170
171 * When Emacs tries to ring the bell, you get an error like
172
173 audio: sst_open: SETQSIZE" Invalid argument
174 audio: sst_close: SETREG MMR2, Invalid argument
175
176 you have probably compiled using an ANSI C compiler, but with non-ANSI include
177 files. In particular, on Suns, the file /usr/include/sun/audioio.h uses the
178 _IOW macro to define the constant AUDIOSETQSIZE. _IOW in turn uses a K&R
179 preprocessor feature that is now explicitly forbidden in ANSI preprocessors,
180 namely substitution inside character constants. All ANSI C compilers must
181 provide a workaround for this problem. Lucid's C compiler is shipped with a
182 new set of system include files. If you are using GCC, there is a script
183 called fixincludes that creates new versions of some system include files that
184 use this obsolete feature.
185
186 * The `Alt' key doesn't behave as `Meta' when running DECwindows.
187
188 The default DEC keyboard mapping has the Alt keys set up to generate the
189 keysym `Multi_key', which has a meaning to xemacs which is distinct from that
190 of the `Meta_L' and `Meta-R' keysyms. A second problem is that certain keys
191 have the Mod2 modifier attached to them for no adequately explored reason.
192 The correct fix is to pass this file to xmodmap upon starting X:
193
194 clear mod2
195 keysym Multi_key = Alt_L
196 add mod1 = Alt_L
197 add mod1 = Alt_R
198
199 * I get complaints about the mapping of my HP keyboard at startup, but I
200 haven't changed anything.
201
202 The default HP keymap is set up to have Mod1 assigned to two different keys:
203 Meta_L and Mode_switch (even though there is not actually a Mode_switch key on
204 the keyboard -- it uses an "imaginary" keycode.) There actually is a reason
205 for this, but it's not a good one. The correct fix is to execute this command
206 upon starting X:
207
208 xmodmap -e 'remove mod1 = Mode_switch'
209
210 * I have focus problems when I use `M-o' to switch to another screen without
211 using the mouse.
212
213 The focus issues with a program like XEmacs, which has multiple homogeneous
214 top-level windows, are very complicated, and as a result, most window managers
215 don't implement them correctly.
216
217 The R4/R5 version of twm (and all of its descendants) had buggy focus
218 handling; there is a patch in .../xemacs/etc/twm-patch which fixes this.
219 Sufficiently recent versions of tvtwm do not need this patch, but most other
220 versions of twm do. If you need to apply this patch, please try to get it
221 integrated by the maintainer of whichever version of twm you're using.
222
223 In addition, if you're using twm, make sure you have not specified
224 "NoTitleFocus" in your .tvtwmrc file. The very nature of this option makes
225 twm do some illegal focus tricks, even with the patch.
226
227 It is known that olwm and olvwm are buggy, and in different ways. If you're
228 using click-to-type mode, try using point-to-type, or vice versa.
229
230 In older versions of NCDwm, one could not even type at XEmacs windows. This
231 has been fixed in newer versions (2.4.3, and possibly earlier).
232
233 (Many people suggest that XEmacs should warp the mouse when focusing on
234 another screen in point-to-type mode. This is not ICCCM-compliant behavior.
235 Implementing such policy is the responsibility of the window manager itself,
236 it is not legal for a client to do this.)
237
238 * My buffers are full of \000 characters or otherwise corrupt.
239
240 Some compilers have trouble with gmalloc.c and ralloc.c; try recompiling
241 without optimization. If that doesn't work, try recompiling with
242 SYSTEM_MALLOC defined, and/or with REL_ALLOC undefined.
243
244 * Some packages that worked before now cause the error
245 Wrong type argument: arrayp, #<face ... >
246
247 Code which uses the `face' accessor functions must be recompiled with xemacs
248 19.9 or later. The functions whose callers must be recompiled are: face-font,
249 face-foreground, face-background, face-background-pixmap, and face-underline-p.
250 The .elc files generated by version 19.9 will work in 19.6 and 19.8, but older
251 .elc files which contain calls to these functions will not work in 19.9.
252
253 * On Solaris 2.* I get undefined symbols from libcurses.a.
254
255 You probably have /usr/ucblib/ on your LD_LIBRARY_PATH. Do the link with
256 LD_LIBRARY_PATH unset.
257
258 * On Solaris 2.* I cannot make alloc.o, glyphs.o or process.o.
259
260 The SparcWorks C compiler may have difficulty building those modules
261 with optimization level -xO4. Try using only "-fast" optimization
262 for just those modules. (Or use gcc).
263
264 * I don't have `xmkmf' and `imake' on my HP.
265
266 You can get these standard X tools by anonymous FTP to hpcvaaz.cv.hp.com.
267 Essentially all X programs need these.
268
269 * When emacs starts up, I get lots of warnings about unknown keysyms.
270
271 If you are running the prebuilt binaries, the Motif library expects to find
272 certain thing in the XKeysymDB file. This file is normally in /usr/lib/X11/
273 or in /usr/openwin/lib/. If you keep yours in a different place, set the
274 environment variable $XKEYSYMDB to point to it before starting emacs. If
275 you still have the problem after doing that, perhaps your version of X is
276 too old. There is a copy of the MIT X11R5 XKeysymDB file in the emacs `etc'
277 directory. Try using that one.
278
279 * My X resources used to work, and now some of them are being ignored.
280
281 Check the resources in .../etc/Emacs.ad (which is the same as the file
282 sample.Xdefaults). Perhaps some of the default resources built in to
283 emacs are now overriding your existing resources. Copy and edit the
284 resources in Emacs.ad as necessary.
285
286 * Solaris 2.3 /bin/sh coredumps during configuration.
287
288 This only occurs if you have LANG != C. This is a known bug with
289 /bin/sh fixed by installing Patch-ID# 101613-01.
290
291 * "Cannot find callback list" messages from dialog boxes on HPUX, in
292 Emacs built with Motif.
293
294 This problem resulted from a bug in GCC 2.4.5. Newer GCC versions
295 such as 2.7.0 fix the problem.
296
297 * On Irix 6.0, make tries (and fails) to build a program named unexelfsgi
298
299 A compiler bug inserts spaces into the string "unexelfsgi . o"
300 in src/Makefile. Edit src/Makefile, after configure is run,
301 find that string, and take out the spaces.
302
303 Compiler fixes in Irix 6.0.1 should eliminate this problem.
304
305 * With certain fonts, when the cursor appears on a character, the
306 character doesn't appear--you get a solid box instead.
307
308 One user on a Linux system reported that this problem went away with
309 installation of a new X server. The failing server was XFree86 3.1.1.
310 XFree86 3.1.2 works.
311
312 * On SunOS 4.1.3, Emacs unpredictably crashes in _yp_dobind_soft.
313
314 This happens if you configure Emacs specifying just `sparc-sun-sunos4'
315 on a system that is version 4.1.3. You must specify the precise
316 version number (or let configure figure out the configuration, which
317 it can do perfectly well for SunOS).
318
319 * On SunOS 4, Emacs processes keep going after you kill the X server
320 (or log out, if you logged in using X).
321
322 Someone reported that recompiling with GCC 2.7.0 fixed this problem.
323
324 * On AIX 4, some programs fail when run in a Shell buffer
325 with an error message like No terminfo entry for "unknown".
326
327 On AIX, many terminal type definitions are not installed by default.
328 `unknown' is one of them. Install the "Special Generic Terminal
329 Definitions" to make them defined.
330
331 * On SunOS, you get linker errors
332 ld: Undefined symbol
333 _get_wmShellWidgetClass
334 _get_applicationShellWidgetClass
335
336 The fix to this is to install patch 100573 for OpenWindows 3.0
337 or link libXmu statically.
338
339 * On AIX 4.1.2, linker error messages such as
340 ld: 0711-212 SEVERE ERROR: Symbol .__quous, found in the global symbol table
341 of archive /usr/lib/libIM.a, was not defined in archive member shr.o.
342
343 This is a problem in libIM.a. You can work around it by executing
344 these shell commands in the src subdirectory of the directory where
345 you build Emacs:
346
347 cp /usr/lib/libIM.a .
348 chmod 664 libIM.a
349 ranlib libIM.a
350
351 Then change -lIM to ./libIM.a in the command to link temacs (in
352 Makefile).
353
354 * Emacs exits with "X protocol error" when run with an X server for
355 Windows.
356
357 A certain X server for Windows had a bug which caused this.
358 Supposedly the newer 32-bit version of this server doesn't have the
359 problem.
360
361 * A position you specified in .Xdefaults is ignored, using twm.
362
363 twm normally ignores "program-specified" positions.
364 You can tell it to obey them with this command in your `.twmrc' file:
365
366 UsePPosition "on" #allow clents to request a position
367
368 * Compiling lib-src says there is no rule to make test-distrib.c.
369
370 This results from a bug in a VERY old version of GNU Sed. To solve
371 the problem, install the current version of GNU Sed, then rerun
372 Emacs's configure script.
373
374 * On Sunos 4.1.1, there are errors compiling sysdep.c.
375
376 If you get errors such as
377
378 "sysdep.c", line 2017: undefined structure or union
379 "sysdep.c", line 2017: undefined structure or union
380 "sysdep.c", line 2019: nodename undefined
381
382 This can result from defining LD_LIBRARY_PATH. It is very tricky
383 to use that environment variable with Emacs. The Emacs configure
384 script links many test programs with the system libraries; you must
385 make sure that the libraries available to configure are the same
386 ones available when you build Emacs.
387
388 * The right Alt key works wrong on German HP keyboards (and perhaps
389 other non-English HP keyboards too).
390
391 This is because HPUX defines the modifiers wrong in X. Here is a
392 shell script to fix the problem; be sure that it is run after VUE
393 configures the X server.
394
395 xmodmap 2> /dev/null - << EOF
396 keysym Alt_L = Meta_L
397 keysym Alt_R = Meta_R
398 EOF
399
400 xmodmap - << EOF
401 clear mod1
402 keysym Mode_switch = NoSymbol
403 add mod1 = Meta_L
404 keysym Meta_R = Mode_switch
405 add mod2 = Mode_switch
406 EOF
407
408 * The Emacs window disappears when you type M-q.
409
410 Some versions of the Open Look window manager interpret M-q as a quit
411 command for whatever window you are typing at. If you want to use
412 Emacs with that window manager, you should try to configure the window
413 manager to use some other command. You can disable the
414 shortcut keys entirely by adding this line to ~/.OWdefaults:
415
416 OpenWindows.WindowMenuAccelerators: False
417
418 * Emacs does not notice when you release the mouse.
419
420 There are reports that this happened with (some) Microsoft mice and
421 that replacing the mouse made it stop.
422
423 * Trouble using ptys on IRIX, or running out of ptys.
424
425 The program mkpts (which may be in `/usr/adm' or `/usr/sbin') needs to
426 be set-UID to root, or non-root programs like Emacs will not be able
427 to allocate ptys reliably.
428
429 * On Irix 5.2, unexelfsgi.c can't find cmplrs/stsupport.h.
430
431 The file cmplrs/stsupport.h was included in the wrong file set in the
432 Irix 5.2 distribution. You can find it in the optional fileset
433 compiler_dev, or copy it from some other Irix 5.2 system. A kludgy
434 workaround is to change unexelfsgi.c to include sym.h instead of
435 syms.h.
436
437 * Slow startup on Linux.
438
439 People using systems based on the Linux kernel sometimes report that
440 startup takes 10 to 15 seconds longer than `usual'.
441
442 This is because Emacs looks up the host name when it starts.
443 Normally, this takes negligible time; the extra delay is due to
444 improper system configuration. This problem can occur for both
445 networked and non-networked machines.
446
447 Here is how to fix the configuration. It requires being root.
448
449 ** Networked Case
450
451 First, make sure the files `/etc/hosts' and `/etc/host.conf' both
452 exist. The first line in the `/etc/hosts' file should look like this
453 (replace HOSTNAME with your host name):
454
455 127.0.0.1 localhost HOSTNAME
456
457 Also make sure that the `/etc/host.conf' files contains the following
458 lines:
459
460 order hosts, bind
461 multi on
462
463 Any changes, permanent and temporary, to the host name should be
464 indicated in the `/etc/hosts' file, since it acts a limited local
465 database of addresses and names (e.g., some SLIP connections
466 dynamically allocate ip addresses).
467
468 ** Non-Networked Case
469
470 The solution described in the networked case applies here as well.
471 However, if you never intend to network your machine, you can use a
472 simpler solution: create an empty `/etc/host.conf' file. The command
473 `touch /etc/host.conf' suffices to create the file. The `/etc/hosts'
474 file is not necessary with this approach.
475
476 * On Solaris 2.4, Dired hangs and C-g does not work. Or Emacs hangs
477 forever waiting for termination of a subprocess that is a zombie.
478
479 casper@fwi.uva.nl says the problem is in X11R6. Rebuild libX11.so
480 after changing the file xc/config/cf/sunLib.tmpl. Change the lines
481
482 #if ThreadedX
483 #define SharedX11Reqs -lthread
484 #endif
485
486 to:
487
488 #if OSMinorVersion < 4
489 #if ThreadedX
490 #define SharedX11Reqs -lthread
491 #endif
492 #endif
493
494 Be sure also to edit x/config/cf/sun.cf so that OSMinorVersion is 4
495 (as it should be for Solaris 2.4). The file has three definitions for
496 OSMinorVersion: the first is for x86, the second for SPARC under
497 Solaris, and the third for SunOS 4. Make sure to update the
498 definition for your type of machine and system.
499
500 Then do `make Everything' in the top directory of X11R6, to rebuild
501 the makefiles and rebuild X. The X built this way work only on
502 Solaris 2.4, not on 2.3.
503
504 For multithreaded X to work it necessary to install patch
505 101925-02 to fix problems in header files [2.4]. You need
506 to reinstall gcc or re-run just-fixinc after installing that
507 patch.
508
509 However, Frank Rust <frust@iti.cs.tu-bs.de> used a simpler solution:
510 he changed
511 #define ThreadedX YES
512 to
513 #define ThreadedX NO
514 in sun.cf and did `make World' to rebuild X11R6. Removing all
515 `-DXTHREAD*' flags and `-lthread' entries from lib/X11/Makefile and
516 typing 'make install' in that directory also seemed to work.
517
518 * With M-x enable-flow-control, you need to type C-\ twice to do
519 incremental search--a single C-\ gets no response.
520
521 This has been traced to communicating with your machine via kermit,
522 with C-\ as the kermit escape character. One solution is to use
523 another escape character in kermit. One user did
524
525 set escape-character 17
526
527 in his .kermrc file, to make C-q the kermit escape character.
528
529 * The Motif version of Emacs paints the screen a solid color.
530
531 This has been observed to result from the following X resource:
532
533 Emacs*default.attributeFont: -*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*
534
535 That the resource has this effect indicates a bug in something, but we
536 do not yet know what. If it is an Emacs bug, we hope someone can
537 explain what the bug is so we can fix it. In the mean time, removing
538 the resource prevents the problem.
539
540 * Emacs gets hung shortly after startup, on Sunos 4.1.3.
541
542 We think this is due to a bug in Sunos. The word is that
543 one of these Sunos patches fixes the bug:
544
545 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 101080-01
546 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 101134-01
547 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 101070-01 101145-01
548 100173-10 100305-15 100383-06 100513-04 100570-05 100689-01 101071-03 101200-02
549 100178-09 100338-05 100421-03 100536-02 100584-05 100784-01 101072-01 101207-01
550
551 We don't know which of these patches really matter. If you find out
552 which ones, please inform bug-gnu-emacs@prep.ai.mit.edu.
553
554 * Emacs aborts while starting up, only when run without X.
555
556 This problem often results from compiling Emacs with GCC when GCC was
557 installed incorrectly. The usual error in installing GCC is to
558 specify --includedir=/usr/include. Installation of GCC makes
559 corrected copies of the system header files. GCC is supposed to use
560 the corrected copies in preference to the original system headers.
561 Specifying --includedir=/usr/include causes the original system header
562 files to be used. On some systems, the definition of ioctl in the
563 original system header files is invalid for ANSI C and causes Emacs
564 not to work.
565
566 The fix is to reinstall GCC, and this time do not specify --includedir
567 when you configure it. Then recompile Emacs. Specifying --includedir
568 is appropriate only in very special cases and it should *never* be the
569 same directory where system header files are kept.
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 * Regular expressions matching bugs on SCO systems.
578
579 On SCO, there are problems in regexp matching when Emacs is compiled
580 with the system compiler. The compiler version is "Microsoft C
581 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; Quick
582 C Compiler Version 1.00.46 (Beta). The solution is to compile with
583 GCC.
584
585 * On Sunos 4, you get the error ld: Undefined symbol __lib_version.
586
587 This is the result of using cc or gcc with the shared library meant
588 for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete
589 /usr/lang/SC2.0.1 or some similar directory.
590
591 * You can't select from submenus.
592
593 On certain systems, mouse-tracking and selection in top-level menus
594 works properly with the X toolkit, but neither of them works when you
595 bring up a submenu (such as Bookmarks or Compare or Apply Patch, in
596 the Files menu).
597
598 This works on most systems. There is speculation that the failure is
599 due to bugs in old versions of X toolkit libraries, but no one really
600 knows. If someone debugs this and finds the precise cause, perhaps a
601 workaround can be found.
602
603 * Unusable default font on SCO 3.2v4.
604
605 The Open Desktop environment comes with default X resource settings
606 that tell Emacs to use a variable-width font. Emacs cannot use such
607 fonts, so it does not work.
608
609 This is caused by the file /usr/lib/X11/app-defaults/ScoTerm, which is
610 the application-specific resource file for the `scoterm' terminal
611 emulator program. It contains several extremely general X resources
612 that affect other programs besides `scoterm'. In particular, these
613 resources affect Emacs also:
614
615 *Font: -*-helvetica-medium-r-*--12-*-p-*
616 *Background: scoBackground
617 *Foreground: scoForeground
618
619 The best solution is to create an application-specific resource file for
620 Emacs, /usr/lib/X11/app-defaults/Emacs, with the following contents:
621
622 Emacs*Font: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1
623 Emacs*Background: white
624 Emacs*Foreground: black
625
626 (or whatever other defaults you prefer).
627
628 These resource files are not normally shared across a network of SCO
629 machines; you must create the file on each machine individually.
630
631 * rcs2log gives you the awk error message "too many fields".
632
633 This is due to an arbitrary limit in certain versions of awk.
634 The solution is to use gawk (GNU awk).
635
636 * Emacs is slow using X11R5 on HP/UX.
637
638 This happens if you use the MIT versions of the X libraries--it
639 doesn't run as fast as HP's version. People sometimes use the version
640 because they see the HP version doesn't have the libraries libXaw.a,
641 libXmu.a, libXext.a and others. HP/UX normally doesn't come with
642 those libraries installed. To get good performance, you need to
643 install them and rebuild Emacs.
644
645 * Loading fonts is very slow.
646
647 You might be getting scalable fonts instead of precomputed bitmaps.
648 Known scalable font directories are "Type1" and "Speedo". A font
649 directory contains scalable fonts if it contains the file
650 "fonts.scale".
651
652 If this is so, re-order your X windows font path to put the scalable
653 font directories last. See the documentatoin of `xset' for details.
654
655 With some X servers, it may be necessary to take the scalable font
656 directories out of your path entirely, at least for Emacs 19.26.
657 Changes in the future may make this unnecessary.
658
659 * On AIX 3.2.4, releasing Ctrl/Act key has no effect, if Shift is down.
660
661 Due to a feature of AIX, pressing or releasing the Ctrl/Act key is
662 ignored when the Shift, Alt or AltGr keys are held down. This can
663 lead to the keyboard being "control-locked"--ordinary letters are
664 treated as control characters.
665
666 You can get out of this "control-locked" state by pressing and
667 releasing Ctrl/Act while not pressing or holding any other keys.
668
669 * display-time causes kernel problems on ISC systems.
670
671 Under Interactive Unix versions 3.0.1 and 4.0 (and probably other
672 versions), display-time causes the loss of large numbers of STREVENT
673 cells. Eventually the kernel's supply of these cells is exhausted.
674 This makes emacs and the whole system run slow, and can make other
675 processes die, in particular pcnfsd.
676
677 Other emacs functions that communicate with remote processes may have
678 the same problem. Display-time seems to be far the worst.
679
680 The only known fix: Don't run display-time.
681
682 * On Solaris, C-x doesn't get through to Emacs when you use the console.
683
684 This is a Solaris feature (at least on Intel x86 cpus). Type C-r
685 C-r C-t, to toggle whether C-x gets through to Emacs.
686
687 * Error message `Symbol's value as variable is void: x', followed by
688 segmentation fault and core dump.
689
690 This has been tracked to a bug in tar! People report that tar erroneously
691 added a line like this at the beginning of files of Lisp code:
692
693 x FILENAME, N bytes, B tape blocks
694
695 If your tar has this problem, install GNU tar--if you can manage to
696 untar it :-).
697
698 * Link failure when using acc on a Sun.
699
700 To use acc, you need additional options just before the libraries, such as
701
702 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
703
704 and you need to add -lansi just before -lc.
705
706 The precise file names depend on the compiler version, so we
707 cannot easily arrange to supply them.
708
709 * Link failure on IBM AIX 1.3 ptf 0013.
710
711 There is a real duplicate definition of the function `_slibc_free' in
712 the library /lib/libc_s.a (just do nm on it to verify). The
713 workaround/fix is:
714
715 cd /lib
716 ar xv libc_s.a NLtmtime.o
717 ar dv libc_s.a NLtmtime.o
718
719 * Undefined symbols _dlopen, _dlsym and/or _dlclose on a Sun.
720
721 If you see undefined symbols _dlopen, _dlsym, or _dlclose when linking
722 with -lX11, compile and link against the file mit/util/misc/dlsym.c in
723 the MIT X11R5 distribution. Alternatively, link temacs using shared
724 libraries with s/sunos4shr.h. (This doesn't work if you use the X
725 toolkit.)
726
727 If you get the additional error that the linker could not find
728 lib_version.o, try extracting it from X11/usr/lib/X11/libvim.a in
729 X11R4, then use it in the link.
730
731 * In Shell mode, you get a ^M at the end of every line.
732
733 This happens to people who use tcsh, because it is trying to be too
734 smart. It sees that the Shell uses terminal type `unknown' and turns
735 on the flag to output ^M at the end of each line. You can fix the
736 problem by adding this to your .cshrc file:
737
738 if ($?EMACS) then
739 if ($EMACS == "t") then
740 unset edit
741 stty -icrnl -onlcr -echo susp ^Z
742 endif
743 endif
744
745 * An error message such as `X protocol error: BadMatch (invalid
746 parameter attributes) on protocol request 93'.
747
748 This comes from having an invalid X resource, such as
749 emacs*Cursor: black
750 (which is invalid because it specifies a color name for something
751 that isn't a color.)
752
753 The fix is to correct your X resources.
754
755 * Undefined symbols when linking on Sunos 4.1.
756
757 If you get the undefined symbols _atowc _wcslen, _iswprint, _iswspace,
758 _iswcntrl, _wcscpy, and _wcsncpy, then you need to add -lXwchar after
759 -lXaw in the command that links temacs.
760
761 This problem seems to arise only when the international language
762 extensions to X11R5 are installed.
763
764 * src/Makefile and lib-src/Makefile are truncated--most of the file missing.
765
766 This can happen if configure uses GNU sed version 2.03. That version
767 had a bug. GNU sed version 2.05 works properly.
768
769 * Slow startup on X11R6 with X windows.
770
771 If Emacs takes two minutes to start up on X11R6, see if your X
772 resources specify any Adobe fonts. That causes the type-1 font
773 renderer to start up, even if the font you asked for is not a type-1
774 font.
775
776 One way to avoid this problem is to eliminate the type-1 fonts from
777 your font path, like this:
778
779 xset -fp /usr/X11R6/lib/X11/fonts/Type1/
780
781 * Pull-down menus appear in the wrong place, in the toolkit version of Emacs.
782
783 An X resource of this form can cause the problem:
784
785 Emacs*geometry: 80x55+0+0
786
787 This resource is supposed to apply, and does apply, to the menus
788 individually as well as to Emacs frames. If that is not what you
789 want, rewrite the resource.
790
791 To check thoroughly for such resource specifications, use `xrdb
792 -query' to see what resources the X server records, and also look at
793 the user's ~/.Xdefaults and ~/.Xdefaults-* files.
794
795 * `make install' fails on install-doc with `Error 141'.
796
797 This happens on Ultrix 4.2 due to failure of a pipeline of tar
798 commands. We don't know why they fail, but the bug seems not to be in
799 Emacs. The workaround is to run the shell command in install-doc by
800 hand.
801
802 * Subprocesses remain, hanging but not zombies, on Sunos 5.3.
803
804 A bug in Sunos 5.3 causes Emacs subprocesses to remain after Emacs
805 exits. Sun patch # 101415-02 is part of the fix for this, but it only
806 applies to ptys, and doesn't fix the problem with subprocesses
807 communicating through pipes.
808
809 * Mail is lost when sent to local aliases.
810
811 Many emacs mail user agents (VM and rmail, for instance) use the
812 sendmail.el library. This library can arrange for mail to be
813 delivered by passing messages to the /usr/lib/sendmail (usually)
814 program . In doing so, it passes the '-t' flag to sendmail, which
815 means that the name of the recipient of the message is not on the
816 command line and, therefore, that sendmail must parse the message to
817 obtain the destination address.
818
819 There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail.
820 In short, when given the -t flag, the SunOS sendmail won't recognize
821 non-local (i.e. NIS) aliases. It has been reported that the Solaris
822 2.x versions of sendmail do not have this bug. For those using SunOS
823 4.1, the best fix is to install sendmail V8 or IDA sendmail (which
824 have other advantages over the regular sendmail as well). At the time
825 of this writing, these official versions are available:
826
827 Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail:
828 sendmail.8.6.9.base.tar.Z (the base system source & documentation)
829 sendmail.8.6.9.cf.tar.Z (configuration files)
830 sendmail.8.6.9.misc.tar.Z (miscellaneous support programs)
831 sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript)
832
833 IDA sendmail on vixen.cso.uiuc.edu in /pub:
834 sendmail-5.67b+IDA-1.5.tar.gz
835
836 * On AIX, you get this message when running Emacs:
837
838 Could not load program emacs
839 Symbol smtcheckinit in csh is undefined
840 Error was: Exec format error
841
842 or this one:
843
844 Could not load program .emacs
845 Symbol _system_con in csh is undefined
846 Symbol _fp_trapsta in csh is undefined
847 Error was: Exec format error
848
849 These can happen when you try to run on AIX 3.2.5 a program that was
850 compiled with 3.2.4. The fix is to recompile.
851
852 * On AIX, you get this compiler error message:
853
854 Processing include file ./XMenuInt.h
855 1501-106: (S) Include file X11/Xlib.h not found.
856
857 This means your system was installed with only the X11 runtime i.d
858 libraries. You have to find your sipo (bootable tape) and install
859 X11Dev... with smit.
860
861 * You "lose characters" after typing Compose Character key.
862
863 This is because the Compose Character key is defined as the keysym
864 Multi_key, and Emacs (seeing that) does the proper X11
865 character-composition processing. If you don't want your Compose key
866 to do that, you can redefine it with xmodmap.
867
868 For example, here's one way to turn it into a Meta key:
869
870 xmodmap -e "keysym Multi_key = Meta_L"
871
872 If all users at your site of a particular keyboard prefer Meta to
873 Compose, you can make the remapping happen automatically by adding the
874 xmodmap command to the xdm setup script for that display.
875
876 * C-z just refreshes the screen instead of suspending Emacs.
877
878 You are probably using a shell that doesn't support job control, even
879 though the system itself is capable of it. Either use a different shell,
880 or set the variable `cannot-suspend' to a non-nil value.
881
882 * After running emacs once, subsequent invocations crash.
883
884 Some versions of SVR4 have a serious bug in the implementation of the
885 mmap () system call in the kernel; this causes emacs to run correctly
886 the first time, and then crash when run a second time.
887
888 Contact your vendor and ask for the mmap bug fix; in the mean time,
889 you may be able to work around the problem by adding a line to your
890 operating system description file (whose name is reported by the
891 configure script) that reads:
892 #define SYSTEM_MALLOC
893 This makes Emacs use memory less efficiently, but seems to work around
894 the kernel bug.
895
896 * Inability to send an Alt-modified key, when Emacs is communicating
897 directly with an X server.
898
899 If you have tried to bind an Alt-modified key as a command, and it
900 does not work to type the command, the first thing you should check is
901 whether the key is getting through to Emacs. To do this, type C-h c
902 followed by the Alt-modified key. C-h c should say what kind of event
903 it read. If it says it read an Alt-modified key, then make sure you
904 have made the key binding correctly.
905
906 If C-h c reports an event that doesn't have the Alt modifier, it may
907 be because your X server has no key for the Alt modifier. The X
908 server that comes from MIT does not set up the Alt modifier by
909 default.
910
911 If your keyboard has keys named Alt, you can enable them as follows:
912
913 xmodmap -e 'add mod2 = Alt_L'
914 xmodmap -e 'add mod2 = Alt_R'
915
916 If the keyboard has just one key named Alt, then only one of those
917 commands is needed. The modifier `mod2' is a reasonable choice if you
918 are using an unmodified MIT version of X. Otherwise, choose any
919 modifier bit not otherwise used.
920
921 If your keyboard does not have keys named Alt, you can use some other
922 keys. Use the keysym command in xmodmap to turn a function key (or
923 some other 'spare' key) into Alt_L or into Alt_R, and then use the
924 commands show above to make them modifier keys.
925
926 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
927 into Meta. This is because of the great importance of Meta in Emacs.
928
929 * `Pid xxx killed due to text modification or page I/O error'
930
931 On HP/UX, you can get that error when the Emacs executable is on an NFS
932 file system. HP/UX responds this way if it tries to swap in a page and
933 does not get a response from the server within a timeout whose default
934 value is just ten seconds.
935
936 If this happens to you, extend the timeout period.
937
938 * `expand-file-name' fails to work on any but the machine you dumped Emacs on.
939
940 On Ultrix, if you use any of the functions which look up information
941 in the passwd database before dumping Emacs (say, by using
942 expand-file-name in site-init.el), then those functions will not work
943 in the dumped Emacs on any host but the one Emacs was dumped on.
944
945 The solution? Don't use expand-file-name in site-init.el, or in
946 anything it loads. Yuck - some solution.
947
948 I'm not sure why this happens; if you can find out exactly what is
949 going on, and perhaps find a fix or a workaround, please let us know.
950 Perhaps the YP functions cache some information, the cache is included
951 in the dumped Emacs, and is then inaccurate on any other host.
952
953 * On some variants of SVR4, Emacs does not work at all with X.
954
955 Try defining BROKEN_FIONREAD in your config.h file. If this solves
956 the problem, please send a bug report to tell us this is needed; be
957 sure to say exactly what type of machine and system you are using.
958
959 * Emacs fails to understand most Internet host names, even though
960 the names work properly with other programs on the same system.
961 * Emacs won't work with X-windows if the value of DISPLAY is HOSTNAME:0.
962 * Gnus can't make contact with the specified host for nntp.
963
964 This typically happens on Suns and other systems that use shared
965 libraries. The cause is that the site has installed a version of the
966 shared library which uses a name server--but has not installed a
967 similar version of the unshared library which Emacs uses.
968
969 The result is that most programs, using the shared library, work with
970 the nameserver, but Emacs does not.
971
972 The fix is to install an unshared library that corresponds to what you
973 installed in the shared library, and then relink Emacs.
974
975 On SunOS 4.1, simply define HAVE_RES_INIT.
976
977 If you have already installed the name resolver in the file libresolv.a,
978 then you need to compile Emacs to use that library. The easiest way to
979 do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE
980 or LIB_STANDARD which uses -lresolv. Watch out! If you redefine a macro
981 that is already in use in your configuration to supply some other libraries,
982 be careful not to lose the others.
983
984 Thus, you could start by adding this to config.h:
985
986 #define LIBS_SYSTEM -lresolv
987
988 Then if this gives you an error for redefining a macro, and you see that
989 the s- file defines LIBS_SYSTEM as -lfoo -lbar, you could change config.h
990 again to say this:
991
992 #define LIBS_SYSTEM -lresolv -lfoo -lbar
993
994 * On a Sun running SunOS 4.1.1, you get this error message from GNU ld:
995
996 /lib/libc.a(_Q_sub.o): Undefined symbol __Q_get_rp_rd referenced from text segment
997
998 The problem is in the Sun shared C library, not in GNU ld.
999
1000 The solution is to install Patch-ID# 100267-03 from Sun.
1001
1002 * SunOS 4.1.2: undefined symbol _get_wmShellWidgetClass
1003
1004 Apparently the version of libXmu.so.a that Sun ships is hosed: it's missing
1005 some stuff that is in libXmu.a (the static version). Sun has a patch for
1006 this, but a workaround is to use the static version of libXmu, by changing
1007 the link command from "-lXmu" to "-Bstatic -lXmu -Bdynamic". If you have
1008 OpenWindows 3.0, ask Sun for these patches:
1009 100512-02 4.1.x OpenWindows 3.0 libXt Jumbo patch
1010 100573-03 4.1.x OpenWindows 3.0 undefined symbols with shared libXmu
1011
1012 * Random other SunOS 4.1.[12] link errors.
1013
1014 The X headers and libraries that Sun ships in /usr/{include,lib}/X11 are
1015 broken. Use the ones in /usr/openwin/{include,lib} instead.
1016
1017 * Bus errors on startup when compiled with Sun's "acc" (in the routine
1018 make_string_internal() called from initialize_environment_alist())
1019
1020 The Sun ANSI compiler doesn't place uninitialized static variables in BSS
1021 space like other compilers do. This breaks emacs. If you want to use acc,
1022 you need to make the file "lastfile.o" be the *first* file in the link
1023 command. Better yet, use Lucid C or GCC.
1024
1025 * The compiler generates lots and lots of syntax errors.
1026 21
1027 Are you using an ANSI C compiler, like lcc or gcc? The SunOS 4.1 bundled cc 22 Are you using an ANSI C compiler, like lcc or gcc? The SunOS 4.1 bundled cc
1028 is not ANSI. 23 is not ANSI.
1029 24
1030 If X has not been configured to compile itself using lcc, gcc, or another ANSI 25 If X has not been configured to compile itself using lcc, gcc, or another ANSI
1031 compiler, then you will have to hack the automatically-generated makefile in 26 compiler, then you will have to hack the automatically-generated makefile in
1032 the `lwlib' directory by hand to make it use an ANSI compiler. 27 the `lwlib' directory by hand to make it use an ANSI compiler.
1033 28
1034 * When using gcc, you get the error message "undefined symbol __fixunsdfsi". 29 ** test-distrib says that the distribution has been clobbered
1035 * When using gcc, you get the error message "undefined symbol __main". 30 ** or, temacs prints "Command key out of range 0-127"
1036 31 ** or, temacs runs and dumps xemacs, but xemacs totally fails to work.
1037 This means that you need to link with the gcc library. It may be called 32 ** or, temacs gets errors dumping xemacs
1038 "gcc-gnulib" or "libgcc.a"; figure out where it is, and define LIB_GCC in
1039 config.h to point to it.
1040
1041 It may also work to use the GCC version of `ld' instead of the standard one.
1042
1043 * When compiling with X11, you get "undefined symbol _XtStrings".
1044
1045 This means that you are trying to link emacs against the X11r4 version of
1046 libXt.a, but you have compiled either Emacs or the code in the lwlib
1047 subdirectory with the X11r5 header files. That doesn't work.
1048
1049 Remember, you can't compile lwlib for r4 and emacs for r5, or vice versa.
1050 They must be in sync.
1051
1052 * Self documentation messages are garbled.
1053
1054 This means that the file `etc/DOC-...' doesn't properly correspond
1055 with the Emacs executable. Redumping Emacs and then installing the
1056 corresponding pair of files should fix the problem.
1057
1058 * Trouble using ptys on AIX.
1059
1060 People often install the pty devices on AIX incorrectly.
1061 Use `smit pty' to reinstall them properly.
1062
1063 * Shell mode on HP/UX gives the message, "`tty`: Ambiguous".
1064
1065 christos@theory.tn.cornell.edu says:
1066
1067 The problem is that in your .cshrc you have something that tries to
1068 execute `tty`. If you are not running the shell on a real tty then
1069 tty will print "not a tty". Csh expects one word in some places,
1070 but tty is giving it back 3.
1071
1072 The solution is to add a pair of quotes around `tty` to make it a single
1073 word:
1074
1075 if (`tty` == "/dev/console")
1076
1077 should be changed to:
1078
1079 if ("`tty`" == "/dev/console")
1080
1081 Even better, move things that set up terminal sections out of .cshrc
1082 and into .login.
1083
1084 * With process-connection-type set to t, each line of subprocess output is
1085 terminated with a ^M, making ange-ftp and GNUS not work.
1086
1087 On SunOS systems, this problem has been seen to be a result of an incomplete
1088 installation of gcc 2.2 which allowed some non-ANSI compatible include files
1089 into the compilation. In particular this affected virtually all ioctl() calls.
1090
1091 * Once you pull down a menu from the menubar, it won't go away.
1092
1093 It has been claimed that this is caused by a bug in certain very old (1990?)
1094 versions of the twm window manager. It doesn't happen with recent vintages,
1095 or with other window managers.
1096
1097 * Emacs ignores the "help" key when running OLWM.
1098
1099 OLWM grabs the help key, and retransmits it to the appropriate client using
1100 XSendEvent. Allowing emacs to react to synthetic events is a security hole,
1101 so this is turned off by default. You can enable it by setting the variable
1102 x-allow-sendevents to t. You can also cause fix this by telling OLWM to not
1103 grab the help key, with the null binding "OpenWindows.KeyboardCommand.Help:".
1104
1105 * Using X11, control-shift-leftbutton makes Emacs hang.
1106
1107 Use the shell command `xset bc' to make the old X Menu package work.
1108
1109 * Emacs running under X11 does not handle mouse clicks.
1110 * `emacs -geometry 80x20' finds a file named `80x20'.
1111
1112 One cause of such problems is having (setq term-file-prefix nil) in
1113 your .emacs file. Another cause is a bad value of EMACSLOADPATH in
1114 the environment.
1115
1116 * Emacs gets error message from linker on Sun.
1117
1118 If the error message says that a symbol such as `f68881_used' or
1119 `ffpa_used' or `start_float' is undefined, this probably indicates
1120 that you have compiled some libraries, such as the X libraries,
1121 with a floating point option other than the default.
1122
1123 It's not terribly hard to make this work with small changes in
1124 crt0.c together with linking with Fcrt1.o, Wcrt1.o or Mcrt1.o.
1125 However, the easiest approach is to build Xlib with the default
1126 floating point option: -fsoft to decide at run time what hardware
1127 is available.
1128
1129 * Keyboard input gets confused after a beep when using a DECserver
1130 as a concentrator.
1131
1132 This problem seems to be a matter of configuring the DECserver to use
1133 7 bit characters rather than 8 bit characters.
1134
1135 * M-x shell persistently reports "Process shell exited abnormally with code 1".
1136
1137 This happened on Suns as a result of what is said to be a bug in Sunos
1138 version 4.0.x. The only fix was to reboot the machine.
1139
1140 * Programs running under terminal emulator do not recognize `emacs'
1141 terminal type.
1142
1143 The cause of this is a shell startup file that sets the TERMCAP
1144 environment variable. The terminal emulator uses that variable to
1145 provide the information on the special terminal type that Emacs
1146 emulates.
1147
1148 Rewrite your shell startup file so that it does not change TERMCAP
1149 in such a case. You could use the following conditional which sets
1150 it only if it is undefined.
1151
1152 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
1153
1154 Or you could set TERMCAP only when you set TERM--which should not
1155 happen in a non-login shell.
1156
1157 * Problem with remote X server on Suns.
1158
1159 On a Sun, running Emacs on one machine with the X server on another
1160 may not work if you have used the unshared system libraries. This
1161 is because the unshared libraries fail to use YP for host name lookup.
1162 As a result, the host name you specify may not be recognized.
1163
1164 * Shell mode ignores interrupts on Apollo Domain
1165
1166 You may find that M-x shell prints the following message:
1167
1168 Warning: no access to tty; thus no job control in this shell...
1169
1170 This can happen if there are not enough ptys on your system.
1171 Here is how to make more of them.
1172
1173 % cd /dev
1174 % ls pty*
1175 # shows how many pty's you have. I had 8, named pty0 to pty7)
1176 % /etc/crpty 8
1177 # creates eight new pty's
1178
1179 * Fatal signal in the command temacs -l loadup inc dump
1180
1181 This command is the final stage of building Emacs. It is run by the
1182 Makefile in the src subdirectory, or by build.com on VMS.
1183
1184 It has been known to get fatal errors due to insufficient swapping
1185 space available on the machine.
1186
1187 On 68000's, it has also happened because of bugs in the
1188 subroutine `alloca'. Verify that `alloca' works right, even
1189 for large blocks (many pages).
1190
1191 * test-distrib says that the distribution has been clobbered
1192 * or, temacs prints "Command key out of range 0-127"
1193 * or, temacs runs and dumps xemacs, but xemacs totally fails to work.
1194 * or, temacs gets errors dumping xemacs
1195 33
1196 This can be because the .elc files have been garbled. Do not be 34 This can be because the .elc files have been garbled. Do not be
1197 fooled by the fact that most of a .elc file is text: these are 35 fooled by the fact that most of a .elc file is text: these are
1198 binary files and can contain all 256 byte values. 36 binary files and can contain all 256 byte values.
1199 37
1222 on certain .el files. 400 was sufficient as of last report. 60 on certain .el files. 400 was sufficient as of last report.
1223 6) Reinstall the old alloc.o (undoing changes to alloc.c if any) 61 6) Reinstall the old alloc.o (undoing changes to alloc.c if any)
1224 and remake temacs. 62 and remake temacs.
1225 7) Remake xemacs. It should work now, with valid .elc files. 63 7) Remake xemacs. It should work now, with valid .elc files.
1226 64
1227 * temacs prints "Pure Lisp storage exhausted" 65 ** temacs prints "Pure Lisp storage exhausted"
1228 66
1229 This means that the Lisp code loaded from the .elc and .el 67 This means that the Lisp code loaded from the .elc and .el
1230 files during temacs -l loadup inc dump took up more 68 files during temacs -l loadup inc dump took up more
1231 space than was allocated. 69 space than was allocated.
1232 70
1251 89
1252 But in some of the cases listed above, this problem is a consequence 90 But in some of the cases listed above, this problem is a consequence
1253 of something else that is wrong. Be sure to check and fix the real 91 of something else that is wrong. Be sure to check and fix the real
1254 problem. 92 problem.
1255 93
1256 * Changes made to .el files do not take effect. 94 ** Don't use -O2 with gcc 2.7.2 under Linux without also using
95 `-fno-strength-reduce'.
96
97 gcc will generate incorrect code otherwise. This bug is present in at
98 least 2.6.x and 2.7.[0-2]. This bug has been fixed in GCC 2.7.2.1 and
99 later.
100
101 ** `Error: No ExtNode to pop!' on Linux systems with Lesstif.
102
103 This error message has been observed with lesstif-0.75a. It does not
104 appear to cause any harm.
105
106 ** Sparc Linux -vs- libXmu.
107
108 There have been reports of configure not detecting libXmu on
109 SparcLinux. The fix is to add -lXmu to the link flags.
110
111 ** Debian Linux and Berkeley db include files.
112
113 Debian Linux puts the Berkeley db include files in /usr/include/db
114 instead of /usr/include. The fix is to use
115 --site-includes=/usr/include/db with configure.
116
117 ** alloc.c will not compile without -P on HP-UX 9.05
118
119 Pekka Marjola <pema@iki.fi> writes:
120 Gcc (2.7.2, with cpplib IIRC) required something (-P worked :) to
121 get it to compile. Otherwise it failed on those DEFUN macros with
122 comments inside parameter lists (like buffer.c, line 296).
123
124 ** Excessive optimization with pgcc can break XEmacs
125
126 It has been reported on some systems that compiling with -O6 can lead
127 to XEmacs failures. The workaround is to use a lower optimization
128 level. -O2 and -O4 have been tested extensively.
129
130 ** -O2 optimization on Irix 5.3 can cause compiler complaint.
131
132 Nick J. Crabtree <nickc@scopic.com> writes:
133 Comes up OK on a tty (all I have available over this slow link). Ill
134 give it a hammering tomorrow. The -O2 optimisation complained about
135 sizes exceeding thresholds; I haven't bothered to use the -Olimit
136 option it recommends.
137
138 ** Excessive optimization on AIX 4.2 can lead to compiler failure.
139
140 Valdis.Kletnieks@vt.edu writes:
141 At least at the b34 level, and the latest-and-greatest IBM xlc
142 (3.1.4.4), there are problems with -O3. I haven't investigated
143 further.
144
145 ** Sed problems on Solaris 2.5
146
147 There have been reports of Sun sed truncating very lines in the
148 Makefile during configuration. The workaround is to use GNU sed or,
149 even better, think of a better way to generate Makefile, and send us a
150 patch. :-)
151
152 ** CDE is not autodetected on HP.
153
154 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
155 I have to force /usr/dt/{lib,include} into the site include/lib
156 command line options. I could add these in hpux10.h, but then I
157 would think these should be pretty standard (to my knowledge, that's
158 also where Sun puts its CDE stuff), so that wouldn't fix the problem
159 on other architectures. AAMOF, when these path are given, CDE is
160 detected, and DragAndDrop works (more or less, see next issue).
161
162 ** Linking with -rpath on IRIX.
163
164 Darrell Kindred <dkindred@cmu.edu> writes:
165 There are a couple of problems [with use of -rpath with Irix ld], though:
166
167 1. The ld in IRIX 5.3 ignores all but the last -rpath
168 spec, so the patched configure spits out a warning
169 if --x-libraries or --site-runtime-libraries are
170 specified under irix 5.x, and it only adds -rpath
171 entries for the --site-runtime-libraries. This bug was
172 fixed sometime between 5.3 and 6.2.
173
174 2. IRIX gcc 2.7.2 doesn't accept -rpath directly, so
175 it would have to be prefixed by -Xlinker or "-Wl,".
176 This would be fine, except that configure compiles with
177 ${CC-cc} $CFLAGS $LDFLAGS ...
178 rather than quoting $LDFLAGS with prefix-args, like
179 src/Makefile does. So if you specify --x-libraries
180 or --site-runtime-libraries, you must use --use-gcc=no,
181 or configure will fail.
182
183 ** On Irix 5.x and 6.x, the dumped XEmacs (xemacs) core dumps when executed
184 on another machine, or after newer SGI IRIX patches have been installed.
185
186 The xemacs binary must be executed with the same "libc.so" file which
187 was used when the xemacs binary was dumped. Some SGI IRIX patches
188 update this file. Make sure that all machines using the xemacs binary
189 are using the same set of IRIX patches. If xemacs core dumps after a
190 patch upgrade then you will have to redump it from temacs.
191
192 ** xemacs: can't resolve symbol '__malloc_hook'
193
194 This is a Linux problem where you've compiled the XEmacs binary on a libc
195 5.4 with version higher than 5.4.19 and attempted to run the binary against
196 an earlier version. The solution is to upgrade your old library.
197
198 ** Compilation errors on VMS.
199
200 Sorry, XEmacs does not work under VMS. You might consider working on
201 the port if you really want to have XEmacs work under VMS.
202
203 ** On HP/UX configure selects gcc even though it isn't actually present.
204
205 Some versions of SoftBench have an executable called 'gcc' that is not
206 actually the GNU C compiler. Use the --with-gcc=no flag when running
207 configure.
208
209 ** On Solaris 2.* I get undefined symbols from libcurses.a.
210
211 You probably have /usr/ucblib/ on your LD_LIBRARY_PATH. Do the link with
212 LD_LIBRARY_PATH unset.
213
214 ** On Solaris 2.* I cannot make alloc.o, glyphs.o or process.o.
215
216 The SparcWorks C compiler may have difficulty building those modules
217 with optimization level -xO4. Try using only "-fast" optimization
218 for just those modules. (Or use gcc).
219
220 ** On Digital UNIX, the DEC C compiler might have a problem compiling
221 some files.
222
223 In particular, src/extents.c and src/faces.c might cause the DEC C
224 compiler to abort. When this happens: cd src, compile the files by
225 hand, cd .., and redo the "make" command. When recompiling the files by
226 hand, use the old C compiler for the following versions of Digital UNIX:
227 - V3.n: Remove "-migrate" from the compile command.
228 - V4.n: Add "-oldc" to the compile command.
229
230 ** On HPUX, the HP C compiler might have a problem compiling some files
231 with optimization.
232
233 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
234
235 Had to drop once again to level 2 optimization, at least to
236 compile lstream.c. Otherwise, I get a "variable is void: \if"
237 problem while dumping (this is a problem I already reported
238 with vanilla hpux 10.01 and 9.07, which went away after
239 applying patches for the C compiler). Trouble is I still
240 haven't found the same patch for hpux 10.10, and I don't
241 remember the patch numbers. I think potential XEmacs builders
242 on HP should be warned about this.
243
244 ** I don't have `xmkmf' and `imake' on my HP.
245
246 You can get these standard X tools by anonymous FTP to hpcvaaz.cv.hp.com.
247 Essentially all X programs need these.
248
249 ** Solaris 2.3 /bin/sh coredumps during configuration.
250
251 This only occurs if you have LANG != C. This is a known bug with
252 /bin/sh fixed by installing Patch-ID# 101613-01.
253
254 ** On Irix 6.0, make tries (and fails) to build a program named unexelfsgi
255
256 A compiler bug inserts spaces into the string "unexelfsgi . o"
257 in src/Makefile. Edit src/Makefile, after configure is run,
258 find that string, and take out the spaces.
259
260 Compiler fixes in Irix 6.0.1 should eliminate this problem.
261
262 ** Native cc on SCO OpenServer 5 is now OK. Icc may still throw you
263 a curve. Here is what Robert Lipe <robertl@arnet.com> says:
264
265 Unlike XEmacs 19.13, building with the native cc on SCO OpenServer 5
266 now produces a functional binary. I will typically build this
267 configuration for COFF with:
268
269 /path_to_XEmacs_source/configure --with-gcc=no \
270 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
271 --with-xpm --with-xface --with-sound=nas
272
273 This version now supports ELF builds. I highly recommend this to
274 reduce the in-core footprint of XEmacs. This is now how I compile
275 all my test releases. Build it like this:
276
277 /path_to_XEmacs_source/configure --with-gcc=no \
278 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
279 --with-xpm --with-xface --with-sound=nas --dynamic
280
281 The compiler known as icc [ supplied with the OpenServer 5 Development
282 System ] generates a working binary, but it takes forever to generate
283 XEmacs. ICC also whines more about the code than /bin/cc does. I do
284 believe all its whining is legitimate, however. Note that you do
285 have to 'cd src ; make LD=icc' to avoid linker errors.
286
287 The way I handle the build procedure is:
288
289 /path_to_XEmacs_source/configure --with-gcc=no \
290 --site-includes=/usr/local/include --site-libraries=/usr/local/lib \
291 --with-xpm --with-xface --with-sound=nas --dynamic --compiler="icc"
292
293 NOTE I have the xpm, xface, and audio libraries and includes in
294 /usr/local/lib, /usr/local/include. If you don't have these,
295 don't include the "--with-*" arguments in any of my examples.
296
297 In previous versions of XEmacs, you had to override the defaults while
298 compiling font-lock.o and extents.o when building with icc. This seems
299 to no longer be true, but I'm including this old information in case it
300 resurfaces. The process I used was:
301
302 make -k
303 [ procure pizza, beer, repeat ]
304 cd src
305 make CC="icc -W0,-mP1COPT_max_tree_size=3000" font-lock.o extents.o
306 make LD=icc
307
308 If you want sound support, get the tls566 supplement from
309 ftp.sco.com:/TLS or any of its mirrors. It works just groovy
310 with XEmacs.
311
312 The M-x manual-entry is known not to work. If you know Lisp and would
313 like help in making it work, e-mail me at <robertl@dgii.com>.
314 (UNCHECKED for 19.15 -- it might work).
315
316 In earlier releases, gnuserv/gnuclient/gnudoit would open a frame
317 just fine, but the client would lock up and the server would
318 terminate when you used C-x # to close the frame. This is now
319 fixed in XEmacs.
320
321 In etc/ there are two files of note. emacskeys.sco and emacsstrs.sco.
322 The comments at the top of emacskeys.sco describe its function, and
323 the emacstrs.sco is a suitable candidate for /usr/lib/keyboard/strings
324 to take advantage of the keyboard map in emacskeys.sco.
325
326 ** Under some versions of OSF XEmacs runs fine if built without
327 optimization but will crash randomly if built with optimization.
328
329 Using 'cc -g' is not sufficient to eliminate all optimization. Try
330 'cc -g -O0' instead.
331
332 ** On SunOS, you get linker errors
333 ld: Undefined symbol
334 _get_wmShellWidgetClass
335 _get_applicationShellWidgetClass
336
337 The fix to this is to install patch 100573 for OpenWindows 3.0
338 or link libXmu statically.
339
340 ** On Sunos 4, you get the error ld: Undefined symbol __lib_version.
341
342 This is the result of using cc or gcc with the shared library meant
343 for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete
344 /usr/lang/SC2.0.1 or some similar directory.
345
346 ** On AIX 4.1.2, linker error messages such as
347 ld: 0711-212 SEVERE ERROR: Symbol .__quous, found in the global symbol table
348 of archive /usr/lib/libIM.a, was not defined in archive member shr.o.
349
350 This is a problem in libIM.a. You can work around it by executing
351 these shell commands in the src subdirectory of the directory where
352 you build Emacs:
353
354 cp /usr/lib/libIM.a .
355 chmod 664 libIM.a
356 ranlib libIM.a
357
358 Then change -lIM to ./libIM.a in the command to link temacs (in
359 Makefile).
360
361 ** On Irix 5.2, unexelfsgi.c can't find cmplrs/stsupport.h.
362
363 The file cmplrs/stsupport.h was included in the wrong file set in the
364 Irix 5.2 distribution. You can find it in the optional fileset
365 compiler_dev, or copy it from some other Irix 5.2 system. A kludgy
366 workaround is to change unexelfsgi.c to include sym.h instead of
367 syms.h.
368
369 ** Link failure when using acc on a Sun.
370
371 To use acc, you need additional options just before the libraries, such as
372
373 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
374
375 and you need to add -lansi just before -lc.
376
377 The precise file names depend on the compiler version, so we
378 cannot easily arrange to supply them.
379
380 ** Link failure on IBM AIX 1.3 ptf 0013.
381
382 There is a real duplicate definition of the function `_slibc_free' in
383 the library /lib/libc_s.a (just do nm on it to verify). The
384 workaround/fix is:
385
386 cd /lib
387 ar xv libc_s.a NLtmtime.o
388 ar dv libc_s.a NLtmtime.o
389
390 ** Undefined symbols _dlopen, _dlsym and/or _dlclose on a Sun.
391
392 If you see undefined symbols _dlopen, _dlsym, or _dlclose when linking
393 with -lX11, compile and link against the file mit/util/misc/dlsym.c in
394 the MIT X11R5 distribution. Alternatively, link temacs using shared
395 libraries with s/sunos4shr.h. (This doesn't work if you use the X
396 toolkit.)
397
398 If you get the additional error that the linker could not find
399 lib_version.o, try extracting it from X11/usr/lib/X11/libvim.a in
400 X11R4, then use it in the link.
401
402 ** Undefined symbols when linking on Sunos 4.1.
403
404 If you get the undefined symbols _atowc _wcslen, _iswprint, _iswspace,
405 _iswcntrl, _wcscpy, and _wcsncpy, then you need to add -lXwchar after
406 -lXaw in the command that links temacs.
407
408 This problem seems to arise only when the international language
409 extensions to X11R5 are installed.
410
411 ** src/Makefile and lib-src/Makefile are truncated--most of the file missing.
412
413 This can happen if configure uses GNU sed version 2.03. That version
414 had a bug. GNU sed version 2.05 works properly.
415
416 ** On AIX, you get this compiler error message:
417
418 Processing include file ./XMenuInt.h
419 1501-106: (S) Include file X11/Xlib.h not found.
420
421 This means your system was installed with only the X11 runtime i.d
422 libraries. You have to find your sipo (bootable tape) and install
423 X11Dev... with smit.
424
425 ** C-z just refreshes the screen instead of suspending Emacs.
426
427 You are probably using a shell that doesn't support job control, even
428 though the system itself is capable of it. Either use a different shell,
429 or set the variable `cannot-suspend' to a non-nil value.
430
431 ** On a Sun running SunOS 4.1.1, you get this error message from GNU ld:
432
433 /lib/libc.a(_Q_sub.o): Undefined symbol __Q_get_rp_rd referenced from text segment
434
435 The problem is in the Sun shared C library, not in GNU ld.
436
437 The solution is to install Patch-ID# 100267-03 from Sun.
438
439 ** SunOS 4.1.2: undefined symbol _get_wmShellWidgetClass
440
441 Apparently the version of libXmu.so.a that Sun ships is hosed: it's missing
442 some stuff that is in libXmu.a (the static version). Sun has a patch for
443 this, but a workaround is to use the static version of libXmu, by changing
444 the link command from "-lXmu" to "-Bstatic -lXmu -Bdynamic". If you have
445 OpenWindows 3.0, ask Sun for these patches:
446 100512-02 4.1.x OpenWindows 3.0 libXt Jumbo patch
447 100573-03 4.1.x OpenWindows 3.0 undefined symbols with shared libXmu
448
449 ** Random other SunOS 4.1.[12] link errors.
450
451 The X headers and libraries that Sun ships in /usr/{include,lib}/X11 are
452 broken. Use the ones in /usr/openwin/{include,lib} instead.
453
454 ** When using gcc, you get the error message "undefined symbol __fixunsdfsi".
455 ** When using gcc, you get the error message "undefined symbol __main".
456
457 This means that you need to link with the gcc library. It may be called
458 "gcc-gnulib" or "libgcc.a"; figure out where it is, and define LIB_GCC in
459 config.h to point to it.
460
461 It may also work to use the GCC version of `ld' instead of the standard one.
462
463 ** When compiling with X11, you get "undefined symbol _XtStrings".
464
465 This means that you are trying to link emacs against the X11r4 version of
466 libXt.a, but you have compiled either Emacs or the code in the lwlib
467 subdirectory with the X11r5 header files. That doesn't work.
468
469 Remember, you can't compile lwlib for r4 and emacs for r5, or vice versa.
470 They must be in sync.
471
472 * Problems with running XEmacs
473
474 ** You type Control-H (Backspace) expecting to delete characters.
475
476 Emacs has traditionally used Control-H for help; unfortunately this
477 interferes with its use as Backspace on TTY's. One way to solve this
478 problem is to put this in your .emacs:
479
480 (keyboard-translate ?\C-h ?\C-?)
481 (global-set-key "\M-?" 'help-command)
482
483 This makes Control-H (Backspace) work sensibly, and moves help to
484 Meta-? (ESC ?).
485
486 Note that you can probably also access help using F1.
487
488 ** On Solaris, C-x doesn't get through to Emacs when you use the console.
489
490 This is a Solaris feature (at least on Intel x86 cpus). Type C-r
491 C-r C-t, to toggle whether C-x gets through to Emacs.
492
493 ** VM appears to hang in large folders
494
495 This is normal (trust us) when upgrading to VM-6.22 from earlier
496 versions. Let VM finish what it is doing and all will be well.
497
498 ** Changes made to .el files do not take effect.
1257 499
1258 You may have forgotten to recompile them into .elc files. 500 You may have forgotten to recompile them into .elc files.
1259 Then the old .elc files will be loaded, and your changes 501 Then the old .elc files will be loaded, and your changes
1260 will not be seen. To fix this, do M-x byte-recompile-directory 502 will not be seen. To fix this, do M-x byte-recompile-directory
1261 and specify the directory that contains the Lisp files. 503 and specify the directory that contains the Lisp files.
1262 504
1263 Note that you may get a warning when loading a .elc file that 505 Note that you may get a warning when loading a .elc file that
1264 is older than the corresponding .el file. 506 is older than the corresponding .el file.
1265 507
1266 * Things which should be bold or italic (such as the initial copyright notice) 508 ** Things which should be bold or italic (such as the initial copyright notice)
1267 are not. 509 are not.
1268 510
1269 The fonts of the "bold" and "italic" faces are generated from the font of 511 The fonts of the "bold" and "italic" faces are generated from the font of
1270 the "default" face; in this way, your bold and italic fonts will have the 512 the "default" face; in this way, your bold and italic fonts will have the
1271 appropriate size and family. However, emacs can only be clever in this 513 appropriate size and family. However, emacs can only be clever in this
1272 way if you have specified the default font using the XLFD (X Logical Font 514 way if you have specified the default font using the XLFD (X Logical Font
1283 then emacs won't be able to guess the names of the "bold" and "italic" 525 then emacs won't be able to guess the names of the "bold" and "italic"
1284 versions. All X fonts can be referred to via XLFD-style names, so you 526 versions. All X fonts can be referred to via XLFD-style names, so you
1285 should use those forms. See the man pages for X(1), xlsfonts(1), and 527 should use those forms. See the man pages for X(1), xlsfonts(1), and
1286 xfontsel(1). 528 xfontsel(1).
1287 529
1288 * The dumped Emacs (XEmacs) crashes when run, trying to write pure data. 530 ** The dumped Emacs (XEmacs) crashes when run, trying to write pure data.
1289 531
1290 Two causes have been seen for such problems. 532 Two causes have been seen for such problems.
1291 533
1292 1) On a system where getpagesize is not a system call, it is defined 534 1) On a system where getpagesize is not a system call, it is defined
1293 as a macro. If the definition (in both unexec.c and malloc.c) is wrong, 535 as a macro. If the definition (in both unexec.c and malloc.c) is wrong,
1298 initialized variables. Emacs makes all initialized variables in most 540 initialized variables. Emacs makes all initialized variables in most
1299 of its files pure after dumping, but the variables declared static and 541 of its files pure after dumping, but the variables declared static and
1300 not initialized are not supposed to be pure. On these systems you 542 not initialized are not supposed to be pure. On these systems you
1301 may need to add "#define static" to the m- or the s- file. 543 may need to add "#define static" to the m- or the s- file.
1302 544
1303 * Reading and writing files is very very slow. 545 ** Reading and writing files is very very slow.
1304 546
1305 Try evaluating the form (setq lock-directory nil) and see if that helps. 547 Try evaluating the form (setq lock-directory nil) and see if that helps.
1306 There is a problem with file-locking on some systems (possibly related 548 There is a problem with file-locking on some systems (possibly related
1307 to NFS) that I don't understand. Please send mail to the address 549 to NFS) that I don't understand. Please send mail to the address
1308 xemacs@xemacs.org if you figure this one out. 550 xemacs@xemacs.org if you figure this one out.
1309 551
1310 * Compilation errors on VMS. 552 ** The Emacs window disappears when you type M-q.
1311 553
1312 Sorry, XEmacs does not work under VMS. You might consider working on 554 Some versions of the Open Look window manager interpret M-q as a quit
1313 the port if you really want to have XEmacs work under VMS. 555 command for whatever window you are typing at. If you want to use
1314 556 Emacs with that window manager, you should try to configure the window
1315 * Mail agents (VM, Gnus, rmail) cannot get new mail 557 manager to use some other command. You can disable the
558 shortcut keys entirely by adding this line to ~/.OWdefaults:
559
560 OpenWindows.WindowMenuAccelerators: False
561
562 ** The `Alt' key doesn't behave as `Meta' when running DECwindows.
563
564 The default DEC keyboard mapping has the Alt keys set up to generate the
565 keysym `Multi_key', which has a meaning to xemacs which is distinct from that
566 of the `Meta_L' and `Meta-R' keysyms. A second problem is that certain keys
567 have the Mod2 modifier attached to them for no adequately explored reason.
568 The correct fix is to pass this file to xmodmap upon starting X:
569
570 clear mod2
571 keysym Multi_key = Alt_L
572 add mod1 = Alt_L
573 add mod1 = Alt_R
574
575 ** The Compose key on a DEC keyboard does not work as Meta key.
576
577 This shell command should fix it:
578
579 xmodmap -e 'keycode 0xb1 = Meta_L'
580
581
582 ** When emacs starts up, I get lots of warnings about unknown keysyms.
583
584 If you are running the prebuilt binaries, the Motif library expects to find
585 certain thing in the XKeysymDB file. This file is normally in /usr/lib/X11/
586 or in /usr/openwin/lib/. If you keep yours in a different place, set the
587 environment variable $XKEYSYMDB to point to it before starting emacs. If
588 you still have the problem after doing that, perhaps your version of X is
589 too old. There is a copy of the MIT X11R5 XKeysymDB file in the emacs `etc'
590 directory. Try using that one.
591
592 ** My X resources used to work, and now some of them are being ignored.
593
594 Check the resources in .../etc/Emacs.ad (which is the same as the file
595 sample.Xdefaults). Perhaps some of the default resources built in to
596 emacs are now overriding your existing resources. Copy and edit the
597 resources in Emacs.ad as necessary.
598
599 ** I get complaints about the mapping of my HP keyboard at startup, but I
600 haven't changed anything.
601
602 The default HP keymap is set up to have Mod1 assigned to two different keys:
603 Meta_L and Mode_switch (even though there is not actually a Mode_switch key on
604 the keyboard -- it uses an "imaginary" keycode.) There actually is a reason
605 for this, but it's not a good one. The correct fix is to execute this command
606 upon starting X:
607
608 xmodmap -e 'remove mod1 = Mode_switch'
609
610 ** I have focus problems when I use `M-o' to switch to another screen without
611 using the mouse.
612
613 The focus issues with a program like XEmacs, which has multiple homogeneous
614 top-level windows, are very complicated, and as a result, most window managers
615 don't implement them correctly.
616
617 The R4/R5 version of twm (and all of its descendants) had buggy focus
618 handling; there is a patch in .../xemacs/etc/twm-patch which fixes this.
619 Sufficiently recent versions of tvtwm do not need this patch, but most other
620 versions of twm do. If you need to apply this patch, please try to get it
621 integrated by the maintainer of whichever version of twm you're using.
622
623 In addition, if you're using twm, make sure you have not specified
624 "NoTitleFocus" in your .tvtwmrc file. The very nature of this option makes
625 twm do some illegal focus tricks, even with the patch.
626
627 It is known that olwm and olvwm are buggy, and in different ways. If you're
628 using click-to-type mode, try using point-to-type, or vice versa.
629
630 In older versions of NCDwm, one could not even type at XEmacs windows. This
631 has been fixed in newer versions (2.4.3, and possibly earlier).
632
633 (Many people suggest that XEmacs should warp the mouse when focusing on
634 another screen in point-to-type mode. This is not ICCCM-compliant behavior.
635 Implementing such policy is the responsibility of the window manager itself,
636 it is not legal for a client to do this.)
637
638 ** Mail agents (VM, Gnus, rmail) cannot get new mail
1316 639
1317 rmail and VM get new mail from /usr/spool/mail/$USER using a program 640 rmail and VM get new mail from /usr/spool/mail/$USER using a program
1318 called `movemail'. This program interlocks with /bin/mail using the 641 called `movemail'. This program interlocks with /bin/mail using the
1319 protocol defined by /bin/mail. 642 protocol defined by /bin/mail.
1320 643
1348 installed copy of movemail is usually in the directory 671 installed copy of movemail is usually in the directory
1349 /usr/local/lib/emacs/VERSION/TARGET. You must change the group and 672 /usr/local/lib/emacs/VERSION/TARGET. You must change the group and
1350 mode of the installed copy; changing the group and mode of the build 673 mode of the installed copy; changing the group and mode of the build
1351 directory copy is ineffective. 674 directory copy is ineffective.
1352 675
1353 * Emacs spontaneously displays "I-search: " at the bottom of the screen. 676 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
1354 677
1355 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being 678 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being
1356 used. C-s/C-q flow control is bad for Emacs editors because it takes 679 used. C-s/C-q flow control is bad for Emacs editors because it takes
1357 away C-s and C-q as user commands. Since editors do not output long 680 away C-s and C-q as user commands. Since editors do not output long
1358 streams of text without user commands, there is no need for a 681 streams of text without user commands, there is no need for a
1432 widespread, XON/XOFF seems to be on the way out. If you can get some 755 widespread, XON/XOFF seems to be on the way out. If you can get some
1433 use out of GNU Emacs on inferior terminals, more power to you, but I 756 use out of GNU Emacs on inferior terminals, more power to you, but I
1434 will not make Emacs worse for properly designed systems for the sake 757 will not make Emacs worse for properly designed systems for the sake
1435 of inferior systems. 758 of inferior systems.
1436 759
1437 * Control-S and Control-Q commands are ignored completely. 760 ** Control-S and Control-Q commands are ignored completely.
1438 761
1439 For some reason, your system is using brain-damaged C-s/C-q flow 762 For some reason, your system is using brain-damaged C-s/C-q flow
1440 control despite Emacs's attempts to turn it off. Perhaps your 763 control despite Emacs's attempts to turn it off. Perhaps your
1441 terminal is connected to the computer through a concentrator 764 terminal is connected to the computer through a concentrator
1442 that wants to use flow control. 765 that wants to use flow control.
1447 770
1448 If that line of approach is not successful, map some other characters 771 If that line of approach is not successful, map some other characters
1449 into C-s and C-q using keyboard-translate-table. The example above 772 into C-s and C-q using keyboard-translate-table. The example above
1450 shows how to do this with C-^ and C-\. 773 shows how to do this with C-^ and C-\.
1451 774
1452 * Control-S and Control-Q commands are ignored completely on a net 775 ** Control-S and Control-Q commands are ignored completely on a net
1453 connection. 776 connection.
1454 777
1455 Some versions of rlogin (and possibly telnet) do not pass flow 778 Some versions of rlogin (and possibly telnet) do not pass flow
1456 control characters to the remote system to which they connect. 779 control characters to the remote system to which they connect.
1457 On such systems, emacs on the remote system cannot disable flow 780 On such systems, emacs on the remote system cannot disable flow
1458 control on the local system. 781 control on the local system.
1474 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131") 797 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
1475 798
1476 See the entry about spontaneous display of I-search (above) for more 799 See the entry about spontaneous display of I-search (above) for more
1477 info. 800 info.
1478 801
1479 * Screen is updated wrong, but only on one kind of terminal. 802 ** Screen is updated wrong, but only on one kind of terminal.
1480 803
1481 This could mean that the termcap entry you are using for that terminal 804 This could mean that the termcap entry you are using for that terminal
1482 is wrong, or it could mean that Emacs has a bug handing the 805 is wrong, or it could mean that Emacs has a bug handing the
1483 combination of features specified for that terminal. 806 combination of features specified for that terminal.
1484 807
1512 any terminal with the termcap entry you were using. 835 any terminal with the termcap entry you were using.
1513 836
1514 This is unambiguously an Emacs bug, and can probably be fixed in 837 This is unambiguously an Emacs bug, and can probably be fixed in
1515 termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c. 838 termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c.
1516 839
1517 * Output from Control-V is slow. 840 ** Output from Control-V is slow.
1518 841
1519 On many bit-map terminals, scrolling operations are fairly slow. 842 On many bit-map terminals, scrolling operations are fairly slow.
1520 Often the termcap entry for the type of terminal in use fails 843 Often the termcap entry for the type of terminal in use fails
1521 to inform Emacs of this. The two lines at the bottom of the screen 844 to inform Emacs of this. The two lines at the bottom of the screen
1522 before a Control-V command are supposed to appear at the top after 845 before a Control-V command are supposed to appear at the top after
1555 take the number of positions to insert or delete as an argument. 878 take the number of positions to insert or delete as an argument.
1556 879
1557 A `cs' string to set the scrolling region will reduce the amount 880 A `cs' string to set the scrolling region will reduce the amount
1558 of motion you see on the screen when part of the screen is scrolled. 881 of motion you see on the screen when part of the screen is scrolled.
1559 882
1560 * Your Delete key sends a Backspace to the terminal, using an AIXterm. 883 ** Your Delete key sends a Backspace to the terminal, using an AIXterm.
1561 884
1562 The solution is to include in your .Xdefaults the lines: 885 The solution is to include in your .Xdefaults the lines:
1563 886
1564 *aixterm.Translations: #override <Key>BackSpace: string(0x7f) 887 *aixterm.Translations: #override <Key>BackSpace: string(0x7f)
1565 aixterm*ttyModes: erase ^? 888 aixterm*ttyModes: erase ^?
1566 889
1567 This makes your Backspace key send DEL (ASCII 127). 890 This makes your Backspace key send DEL (ASCII 127).
1568 891
1569 * You type Control-H (Backspace) expecting to delete characters. 892 ** With certain fonts, when the cursor appears on a character, the
1570 893 character doesn't appear--you get a solid box instead.
1571 Emacs has traditionally used Control-H for help; unfortunately this 894
1572 interferes with its use as Backspace on TTY's. One way to solve this 895 One user on a Linux system reported that this problem went away with
1573 problem is to put this in your .emacs: 896 installation of a new X server. The failing server was XFree86 3.1.1.
1574 897 XFree86 3.1.2 works.
1575 (keyboard-translate ?\C-h ?\C-?) 898
1576 (global-set-key "\M-?" 'help-command) 899 ** On SunOS 4.1.3, Emacs unpredictably crashes in _yp_dobind_soft.
1577 900
1578 This makes Control-H (Backspace) work sensibly, and moves help to 901 This happens if you configure Emacs specifying just `sparc-sun-sunos4'
1579 Meta-? (ESC ?). 902 on a system that is version 4.1.3. You must specify the precise
1580 903 version number (or let configure figure out the configuration, which
1581 Note that you can probably also access help using F1. 904 it can do perfectly well for SunOS).
1582 905
1583 * Editing files through RFS gives spurious "file has changed" warnings. 906 ** On Irix, I don't see the toolbar icons and I'm getting lots of
1584 It is possible that a change in Emacs 18.37 gets around this problem, 907 entries in the warnings buffer.
1585 but in case not, here is a description of how to fix the RFS bug that 908
1586 causes it. 909 SGI ships a really old Xpm library in /usr/lib which does not work at
1587 910 all well with XEmacs. The solution is to install your own copy of the
1588 There was a serious pair of bugs in the handling of the fsync() system 911 latest version of Xpm somewhere and then use the --site-includes and
1589 call in the RFS server. 912 --site-libraries flags to tell configure where to find it.
1590 913
1591 The first is that the fsync() call is handled as another name for the 914 ** On HPUX, you get "poll: Interrupted system call" message in the window
1592 close() system call (!!). It appears that fsync() is not used by very 915 where XEmacs was launched.
1593 many programs; Emacs version 18 does an fsync() before closing files 916
1594 to make sure that the bits are on the disk. 917 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
1595 918
1596 This is fixed by the enclosed patch to the RFS server. 919 I get a very strange problem when linking libc.a
1597 920 dynamically: every event (mouse, keyboard, expose...) results
1598 The second, more serious problem, is that fsync() is treated as a 921 in a "poll: Interrupted system call" message in the window
1599 non-blocking system call (i.e., it's implemented as a message that 922 where XEmacs was launched. Forcing a static link of libc.a
1600 gets sent to the remote system without waiting for a reply). Fsync is 923 alone by adding /usr/lib/libc.a at the end of the link line
1601 a useful tool for building atomic file transactions. Implementing it 924 solves this. Note that my 9.07 build of 19.14b17 and my (old)
1602 as a non-blocking RPC call (when the local call blocks until the sync 925 build of 19.13 both exhibit the same behaviour. I've tried
1603 is done) is a bad idea; unfortunately, changing it will break the RFS 926 various hpux patches to no avail. If this problem cannot be
1604 protocol. No fix was supplied for this problem. 927 solved before the release date, binary kits for HP *must* be
1605 928 linked statically against libc, otherwise this problem will
1606 (as always, your line numbers may vary) 929 show up. (This is directed at whoever will volunteer for this
1607 930 kit, as I won't be available to do it, unless 19.14 gets
1608 % rcsdiff -c -r1.2 serversyscall.c 931 delayed until mid-june ;-). I think this problem will be an FAQ
1609 RCS file: RCS/serversyscall.c,v 932 soon after the release otherwise.
1610 retrieving revision 1.2 933
1611 diff -c -r1.2 serversyscall.c 934 ** When Emacs tries to ring the bell, you get an error like
1612 *** /tmp/,RCSt1003677 Wed Jan 28 15:15:02 1987 935
1613 --- serversyscall.c Wed Jan 28 15:14:48 1987 936 audio: sst_open: SETQSIZE" Invalid argument
1614 *************** 937 audio: sst_close: SETREG MMR2, Invalid argument
1615 *** 163,169 **** 938
1616 /* 939 you have probably compiled using an ANSI C compiler, but with non-ANSI include
1617 * No return sent for close or fsync! 940 files. In particular, on Suns, the file /usr/include/sun/audioio.h uses the
1618 */ 941 _IOW macro to define the constant AUDIOSETQSIZE. _IOW in turn uses a K&R
1619 ! if (syscall == RSYS_close || syscall == RSYS_fsync) 942 preprocessor feature that is now explicitly forbidden in ANSI preprocessors,
1620 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]); 943 namely substitution inside character constants. All ANSI C compilers must
1621 else 944 provide a workaround for this problem. Lucid's C compiler is shipped with a
1622 { 945 new set of system include files. If you are using GCC, there is a script
1623 --- 166,172 ---- 946 called fixincludes that creates new versions of some system include files that
1624 /* 947 use this obsolete feature.
1625 * No return sent for close or fsync! 948
1626 */ 949 ** My buffers are full of \000 characters or otherwise corrupt.
1627 ! if (syscall == RSYS_close) 950
1628 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]); 951 Some compilers have trouble with gmalloc.c and ralloc.c; try recompiling
1629 else 952 without optimization. If that doesn't work, try recompiling with
1630 { 953 SYSTEM_MALLOC defined, and/or with REL_ALLOC undefined.
1631 954
1632 * Vax C compiler bugs affecting Emacs. 955 ** On AIX 4, some programs fail when run in a Shell buffer
1633 956 with an error message like No terminfo entry for "unknown".
1634 You may get one of these problems compiling Emacs: 957
1635 958 On AIX, many terminal type definitions are not installed by default.
1636 foo.c line nnn: compiler error: no table entry for op STASG 959 `unknown' is one of them. Install the "Special Generic Terminal
1637 foo.c: fatal error in /lib/ccom 960 Definitions" to make them defined.
1638 961
1639 These are due to bugs in the C compiler; the code is valid C. 962 ** Emacs exits with "X protocol error" when run with an X server for
1640 Unfortunately, the bugs are unpredictable: the same construct 963 Windows.
1641 may compile properly or trigger one of these bugs, depending 964
1642 on what else is in the source file being compiled. Even changes 965 A certain X server for Windows had a bug which caused this.
1643 in header files that should not affect the file being compiled 966 Supposedly the newer 32-bit version of this server doesn't have the
1644 can affect whether the bug happens. In addition, sometimes files 967 problem.
1645 that compile correctly on one machine get this bug on another machine. 968
1646 969 ** A position you specified in .Xdefaults is ignored, using twm.
1647 As a result, it is hard for me to make sure this bug will not affect 970
1648 you. I have attempted to find and alter these constructs, but more 971 twm normally ignores "program-specified" positions.
1649 can always appear. However, I can tell you how to deal with it if it 972 You can tell it to obey them with this command in your `.twmrc' file:
1650 should happen. The bug comes from having an indexed reference to an 973
1651 array of Lisp_Objects, as an argument in a function call: 974 UsePPosition "on" #allow clents to request a position
1652 Lisp_Object *args; 975
1653 ... 976 ** The right Alt key works wrong on German HP keyboards (and perhaps
1654 ... foo (5, args[i], ...)... 977 other non-English HP keyboards too).
1655 putting the argument into a temporary variable first, as in 978
1656 Lisp_Object *args; 979 This is because HPUX defines the modifiers wrong in X. Here is a
1657 Lisp_Object tem; 980 shell script to fix the problem; be sure that it is run after VUE
1658 ... 981 configures the X server.
1659 tem = args[i]; 982
1660 ... foo (r, tem, ...)... 983 xmodmap 2> /dev/null - << EOF
1661 causes the problem to go away. 984 keysym Alt_L = Meta_L
1662 The `contents' field of a Lisp vector is an array of Lisp_Objects, 985 keysym Alt_R = Meta_R
1663 so you may see the problem happening with indexed references to that. 986 EOF
1664 987
1665 * 68000 C compiler problems 988 xmodmap - << EOF
1666 989 clear mod1
1667 Various 68000 compilers have different problems. 990 keysym Mode_switch = NoSymbol
1668 These are some that have been observed. 991 add mod1 = Meta_L
1669 992 keysym Meta_R = Mode_switch
1670 ** Using value of assignment expression on union type loses. 993 add mod2 = Mode_switch
1671 This means that x = y = z; or foo (x = z); does not work 994 EOF
1672 if x is of type Lisp_Object. 995
1673 996 ** Emacs does not notice when you release the mouse.
1674 ** "cannot reclaim" error. 997
1675 998 There are reports that this happened with (some) Microsoft mice and
1676 This means that an expression is too complicated. You get the correct 999 that replacing the mouse made it stop.
1677 line number in the error message. The code must be rewritten with 1000
1678 simpler expressions. 1001 ** Trouble using ptys on IRIX, or running out of ptys.
1679 1002
1680 ** XCONS, XSTRING, etc macros produce incorrect code. 1003 The program mkpts (which may be in `/usr/adm' or `/usr/sbin') needs to
1681 1004 be set-UID to root, or non-root programs like Emacs will not be able
1682 If temacs fails to run at all, this may be the cause. 1005 to allocate ptys reliably.
1683 Compile this test program and look at the assembler code: 1006
1684 1007 ** Slow startup on Linux.
1685 struct foo { char x; unsigned int y : 24; }; 1008
1686 1009 People using systems based on the Linux kernel sometimes report that
1687 lose (arg) 1010 startup takes 10 to 15 seconds longer than `usual'.
1688 struct foo arg; 1011
1689 { 1012 This is because Emacs looks up the host name when it starts.
1690 test ((int *) arg.y); 1013 Normally, this takes negligible time; the extra delay is due to
1691 } 1014 improper system configuration. This problem can occur for both
1692 1015 networked and non-networked machines.
1693 If the code is incorrect, your compiler has this problem. 1016
1694 In the XCONS, etc., macros in lisp.h you must replace (a).u.val with 1017 Here is how to fix the configuration. It requires being root.
1695 ((a).u.val + coercedummy) where coercedummy is declared as int. 1018
1696 1019 *** Networked Case
1697 This problem will not happen if the m-...h file for your type 1020
1698 of machine defines NO_UNION_TYPE. That is the recommended setting now. 1021 First, make sure the files `/etc/hosts' and `/etc/host.conf' both
1699 1022 exist. The first line in the `/etc/hosts' file should look like this
1700 * C compilers lose on returning unions 1023 (replace HOSTNAME with your host name):
1701 1024
1702 I hear that some C compilers cannot handle returning a union type. 1025 127.0.0.1 localhost HOSTNAME
1703 Most of the functions in GNU Emacs return type Lisp_Object, which is 1026
1704 defined as a union on some rare architectures. 1027 Also make sure that the `/etc/host.conf' files contains the following
1705 1028 lines:
1706 This problem will not happen if the m-...h file for your type of 1029
1707 machine defines NO_UNION_TYPE. That is the recommended setting now. 1030 order hosts, bind
1708 1031 multi on
1709 * `Error: No ExtNode to pop!' on Linux systems with Lesstif. 1032
1710 1033 Any changes, permanent and temporary, to the host name should be
1711 This error message has been observed with lesstif-0.75a. It does not 1034 indicated in the `/etc/hosts' file, since it acts a limited local
1712 appear to cause any harm. 1035 database of addresses and names (e.g., some SLIP connections
1713 1036 dynamically allocate ip addresses).
1714 * Sparc Linux -vs- libXmu. 1037
1715 1038 *** Non-Networked Case
1716 There have been reports of configure not detecting libXmu on 1039
1717 SparcLinux. The fix is to add -lXmu to the link flags. 1040 The solution described in the networked case applies here as well.
1718 1041 However, if you never intend to network your machine, you can use a
1719 * Debian Linux and Berkeley db include files. 1042 simpler solution: create an empty `/etc/host.conf' file. The command
1720 1043 `touch /etc/host.conf' suffices to create the file. The `/etc/hosts'
1721 Debian Linux puts the Berkeley db include files in /usr/include/db 1044 file is not necessary with this approach.
1722 instead of /usr/include. The fix is to use 1045
1723 --site-includes=/usr/include/db with configure. 1046 ** On Solaris 2.4, Dired hangs and C-g does not work. Or Emacs hangs
1724 1047 forever waiting for termination of a subprocess that is a zombie.
1725 * Signaling: (error "Byte code stack underflow (byte compiler bug), pc 38") 1048
1049 casper@fwi.uva.nl says the problem is in X11R6. Rebuild libX11.so
1050 after changing the file xc/config/cf/sunLib.tmpl. Change the lines
1051
1052 #if ThreadedX
1053 #define SharedX11Reqs -lthread
1054 #endif
1055
1056 to:
1057
1058 #if OSMinorVersion < 4
1059 #if ThreadedX
1060 #define SharedX11Reqs -lthread
1061 #endif
1062 #endif
1063
1064 Be sure also to edit x/config/cf/sun.cf so that OSMinorVersion is 4
1065 (as it should be for Solaris 2.4). The file has three definitions for
1066 OSMinorVersion: the first is for x86, the second for SPARC under
1067 Solaris, and the third for SunOS 4. Make sure to update the
1068 definition for your type of machine and system.
1069
1070 Then do `make Everything' in the top directory of X11R6, to rebuild
1071 the makefiles and rebuild X. The X built this way work only on
1072 Solaris 2.4, not on 2.3.
1073
1074 For multithreaded X to work it necessary to install patch
1075 101925-02 to fix problems in header files [2.4]. You need
1076 to reinstall gcc or re-run just-fixinc after installing that
1077 patch.
1078
1079 However, Frank Rust <frust@iti.cs.tu-bs.de> used a simpler solution:
1080 he changed
1081 #define ThreadedX YES
1082 to
1083 #define ThreadedX NO
1084 in sun.cf and did `make World' to rebuild X11R6. Removing all
1085 `-DXTHREAD*' flags and `-lthread' entries from lib/X11/Makefile and
1086 typing 'make install' in that directory also seemed to work.
1087
1088 ** With M-x enable-flow-control, you need to type C-\ twice to do
1089 incremental search--a single C-\ gets no response.
1090
1091 This has been traced to communicating with your machine via kermit,
1092 with C-\ as the kermit escape character. One solution is to use
1093 another escape character in kermit. One user did
1094
1095 set escape-character 17
1096
1097 in his .kermrc file, to make C-q the kermit escape character.
1098
1099 ** The Motif version of Emacs paints the screen a solid color.
1100
1101 This has been observed to result from the following X resource:
1102
1103 Emacs*default.attributeFont: -*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*
1104
1105 That the resource has this effect indicates a bug in something, but we
1106 do not yet know what. If it is an Emacs bug, we hope someone can
1107 explain what the bug is so we can fix it. In the mean time, removing
1108 the resource prevents the problem.
1109
1110 ** Regular expressions matching bugs on SCO systems.
1111
1112 On SCO, there are problems in regexp matching when Emacs is compiled
1113 with the system compiler. The compiler version is "Microsoft C
1114 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; Quick
1115 C Compiler Version 1.00.46 (Beta). The solution is to compile with
1116 GCC.
1117
1118 ** In Shell mode, you get a ^M at the end of every line.
1119
1120 This happens to people who use tcsh, because it is trying to be too
1121 smart. It sees that the Shell uses terminal type `unknown' and turns
1122 on the flag to output ^M at the end of each line. You can fix the
1123 problem by adding this to your .cshrc file:
1124
1125 if ($?EMACS) then
1126 if ($EMACS == "t") then
1127 unset edit
1128 stty -icrnl -onlcr -echo susp ^Z
1129 endif
1130 endif
1131
1132 ** An error message such as `X protocol error: BadMatch (invalid
1133 parameter attributes) on protocol request 93'.
1134
1135 This comes from having an invalid X resource, such as
1136 emacs*Cursor: black
1137 (which is invalid because it specifies a color name for something
1138 that isn't a color.)
1139
1140 The fix is to correct your X resources.
1141
1142 ** Mail is lost when sent to local aliases.
1143
1144 Many emacs mail user agents (VM and rmail, for instance) use the
1145 sendmail.el library. This library can arrange for mail to be
1146 delivered by passing messages to the /usr/lib/sendmail (usually)
1147 program . In doing so, it passes the '-t' flag to sendmail, which
1148 means that the name of the recipient of the message is not on the
1149 command line and, therefore, that sendmail must parse the message to
1150 obtain the destination address.
1151
1152 There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail.
1153 In short, when given the -t flag, the SunOS sendmail won't recognize
1154 non-local (i.e. NIS) aliases. It has been reported that the Solaris
1155 2.x versions of sendmail do not have this bug. For those using SunOS
1156 4.1, the best fix is to install sendmail V8 or IDA sendmail (which
1157 have other advantages over the regular sendmail as well). At the time
1158 of this writing, these official versions are available:
1159
1160 Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail:
1161 sendmail.8.6.9.base.tar.Z (the base system source & documentation)
1162 sendmail.8.6.9.cf.tar.Z (configuration files)
1163 sendmail.8.6.9.misc.tar.Z (miscellaneous support programs)
1164 sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript)
1165
1166 IDA sendmail on vixen.cso.uiuc.edu in /pub:
1167 sendmail-5.67b+IDA-1.5.tar.gz
1168
1169 ** On AIX, you get this message when running Emacs:
1170
1171 Could not load program emacs
1172 Symbol smtcheckinit in csh is undefined
1173 Error was: Exec format error
1174
1175 or this one:
1176
1177 Could not load program .emacs
1178 Symbol _system_con in csh is undefined
1179 Symbol _fp_trapsta in csh is undefined
1180 Error was: Exec format error
1181
1182 These can happen when you try to run on AIX 3.2.5 a program that was
1183 compiled with 3.2.4. The fix is to recompile.
1184
1185 ** After running emacs once, subsequent invocations crash.
1186
1187 Some versions of SVR4 have a serious bug in the implementation of the
1188 mmap () system call in the kernel; this causes emacs to run correctly
1189 the first time, and then crash when run a second time.
1190
1191 Contact your vendor and ask for the mmap bug fix; in the mean time,
1192 you may be able to work around the problem by adding a line to your
1193 operating system description file (whose name is reported by the
1194 configure script) that reads:
1195 #define SYSTEM_MALLOC
1196 This makes Emacs use memory less efficiently, but seems to work around
1197 the kernel bug.
1198
1199 ** Inability to send an Alt-modified key, when Emacs is communicating
1200 directly with an X server.
1201
1202 If you have tried to bind an Alt-modified key as a command, and it
1203 does not work to type the command, the first thing you should check is
1204 whether the key is getting through to Emacs. To do this, type C-h c
1205 followed by the Alt-modified key. C-h c should say what kind of event
1206 it read. If it says it read an Alt-modified key, then make sure you
1207 have made the key binding correctly.
1208
1209 If C-h c reports an event that doesn't have the Alt modifier, it may
1210 be because your X server has no key for the Alt modifier. The X
1211 server that comes from MIT does not set up the Alt modifier by
1212 default.
1213
1214 If your keyboard has keys named Alt, you can enable them as follows:
1215
1216 xmodmap -e 'add mod2 = Alt_L'
1217 xmodmap -e 'add mod2 = Alt_R'
1218
1219 If the keyboard has just one key named Alt, then only one of those
1220 commands is needed. The modifier `mod2' is a reasonable choice if you
1221 are using an unmodified MIT version of X. Otherwise, choose any
1222 modifier bit not otherwise used.
1223
1224 If your keyboard does not have keys named Alt, you can use some other
1225 keys. Use the keysym command in xmodmap to turn a function key (or
1226 some other 'spare' key) into Alt_L or into Alt_R, and then use the
1227 commands show above to make them modifier keys.
1228
1229 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
1230 into Meta. This is because of the great importance of Meta in Emacs.
1231
1232 ** `Pid xxx killed due to text modification or page I/O error'
1233
1234 On HP/UX, you can get that error when the Emacs executable is on an NFS
1235 file system. HP/UX responds this way if it tries to swap in a page and
1236 does not get a response from the server within a timeout whose default
1237 value is just ten seconds.
1238
1239 If this happens to you, extend the timeout period.
1240
1241 ** `expand-file-name' fails to work on any but the machine you dumped Emacs on.
1242
1243 On Ultrix, if you use any of the functions which look up information
1244 in the passwd database before dumping Emacs (say, by using
1245 expand-file-name in site-init.el), then those functions will not work
1246 in the dumped Emacs on any host but the one Emacs was dumped on.
1247
1248 The solution? Don't use expand-file-name in site-init.el, or in
1249 anything it loads. Yuck - some solution.
1250
1251 I'm not sure why this happens; if you can find out exactly what is
1252 going on, and perhaps find a fix or a workaround, please let us know.
1253 Perhaps the YP functions cache some information, the cache is included
1254 in the dumped Emacs, and is then inaccurate on any other host.
1255
1256 ** Emacs fails to understand most Internet host names, even though
1257 the names work properly with other programs on the same system.
1258 ** Emacs won't work with X-windows if the value of DISPLAY is HOSTNAME:0.
1259 ** Gnus can't make contact with the specified host for nntp.
1260
1261 This typically happens on Suns and other systems that use shared
1262 libraries. The cause is that the site has installed a version of the
1263 shared library which uses a name server--but has not installed a
1264 similar version of the unshared library which Emacs uses.
1265
1266 The result is that most programs, using the shared library, work with
1267 the nameserver, but Emacs does not.
1268
1269 The fix is to install an unshared library that corresponds to what you
1270 installed in the shared library, and then relink Emacs.
1271
1272 On SunOS 4.1, simply define HAVE_RES_INIT.
1273
1274 If you have already installed the name resolver in the file libresolv.a,
1275 then you need to compile Emacs to use that library. The easiest way to
1276 do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE
1277 or LIB_STANDARD which uses -lresolv. Watch out! If you redefine a macro
1278 that is already in use in your configuration to supply some other libraries,
1279 be careful not to lose the others.
1280
1281 Thus, you could start by adding this to config.h:
1282
1283 #define LIBS_SYSTEM -lresolv
1284
1285 Then if this gives you an error for redefining a macro, and you see that
1286 the s- file defines LIBS_SYSTEM as -lfoo -lbar, you could change config.h
1287 again to say this:
1288
1289 #define LIBS_SYSTEM -lresolv -lfoo -lbar
1290
1291 ** Bus errors on startup when compiled with Sun's "acc" (in the routine
1292 make_string_internal() called from initialize_environment_alist())
1293
1294 The Sun ANSI compiler doesn't place uninitialized static variables in BSS
1295 space like other compilers do. This breaks emacs. If you want to use acc,
1296 you need to make the file "lastfile.o" be the *first* file in the link
1297 command. Better yet, use Lucid C or GCC.
1298
1299 ** Trouble using ptys on AIX.
1300
1301 People often install the pty devices on AIX incorrectly.
1302 Use `smit pty' to reinstall them properly.
1303
1304 ** Shell mode on HP/UX gives the message, "`tty`: Ambiguous".
1305
1306 christos@theory.tn.cornell.edu says:
1307
1308 The problem is that in your .cshrc you have something that tries to
1309 execute `tty`. If you are not running the shell on a real tty then
1310 tty will print "not a tty". Csh expects one word in some places,
1311 but tty is giving it back 3.
1312
1313 The solution is to add a pair of quotes around `tty` to make it a single
1314 word:
1315
1316 if (`tty` == "/dev/console")
1317
1318 should be changed to:
1319
1320 if ("`tty`" == "/dev/console")
1321
1322 Even better, move things that set up terminal sections out of .cshrc
1323 and into .login.
1324
1325 ** With process-connection-type set to t, each line of subprocess output is
1326 terminated with a ^M, making ange-ftp and GNUS not work.
1327
1328 On SunOS systems, this problem has been seen to be a result of an incomplete
1329 installation of gcc 2.2 which allowed some non-ANSI compatible include files
1330 into the compilation. In particular this affected virtually all ioctl() calls.
1331
1332 ** Once you pull down a menu from the menubar, it won't go away.
1333
1334 It has been claimed that this is caused by a bug in certain very old (1990?)
1335 versions of the twm window manager. It doesn't happen with recent vintages,
1336 or with other window managers.
1337
1338 ** Emacs ignores the "help" key when running OLWM.
1339
1340 OLWM grabs the help key, and retransmits it to the appropriate client using
1341 XSendEvent. Allowing emacs to react to synthetic events is a security hole,
1342 so this is turned off by default. You can enable it by setting the variable
1343 x-allow-sendevents to t. You can also cause fix this by telling OLWM to not
1344 grab the help key, with the null binding "OpenWindows.KeyboardCommand.Help:".
1345
1346 ** Programs running under terminal emulator do not recognize `emacs'
1347 terminal type.
1348
1349 The cause of this is a shell startup file that sets the TERMCAP
1350 environment variable. The terminal emulator uses that variable to
1351 provide the information on the special terminal type that Emacs
1352 emulates.
1353
1354 Rewrite your shell startup file so that it does not change TERMCAP
1355 in such a case. You could use the following conditional which sets
1356 it only if it is undefined.
1357
1358 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
1359
1360 Or you could set TERMCAP only when you set TERM--which should not
1361 happen in a non-login shell.
1362
1363 * Compatibility problems (with Emacs 18, GNU Emacs, or previous XEmacs/lemacs)
1364
1365 ** "Symbol's value as variable is void: unread-command-char".
1366 ** "Wrong type argument: arrayp, #<keymap 143 entries>"
1367 ** "Wrong type argument: stringp, [#<keypress-event return>]"
1368
1369 There are a few incompatible changes in XEmacs, and these are the
1370 symptoms. Some of the emacs-lisp code you are running needs to be
1371 updated to be compatible with XEmacs.
1372
1373 The code should not treat keymaps as arrays (use `define-key', etc.),
1374 should not use obsolete variables like `unread-command-char' (use
1375 `unread-command-event'). Many (most) of the new ways of doing things
1376 are compatible in GNU Emacs and XEmacs.
1377
1378 Modern Emacs packages (Gnus, VM, etc) are written to support GNU Emacs
1379 and XEmacs. We have provided modified versions of several popular
1380 emacs packages (dired, etc) which are compatible with this version of
1381 emacs. Check to make sure you have not set your load-path so that
1382 your private copies of these packages are being found before the
1383 versions in the lisp directory.
1384
1385 Make sure that your load-path and your $EMACSLOADPATH environment
1386 variable are not pointing at an Emacs18 lisp directory. This will
1387 cripple emacs.
1388
1389 ** Some packages that worked before now cause the error
1390 Wrong type argument: arrayp, #<face ... >
1391
1392 Code which uses the `face' accessor functions must be recompiled with xemacs
1393 19.9 or later. The functions whose callers must be recompiled are: face-font,
1394 face-foreground, face-background, face-background-pixmap, and face-underline-p.
1395 The .elc files generated by version 19.9 will work in 19.6 and 19.8, but older
1396 .elc files which contain calls to these functions will not work in 19.9.
1397
1398 ** Signaling: (error "Byte code stack underflow (byte compiler bug), pc 38")
1726 1399
1727 This error is given when XEmacs 20 is compiled without MULE support 1400 This error is given when XEmacs 20 is compiled without MULE support
1728 but is attempting to load a .elc which requires MULE support. The fix 1401 but is attempting to load a .elc which requires MULE support. The fix
1729 is to rebytecompile the offending file. 1402 is to rebytecompile the offending file.
1730 1403
1731 * alloc.c will not compile without -P on HP-UX 9.05 1404 ** Signaling: (wrong-type-argument ...) when loading mail-abbrevs
1732
1733 Pekka Marjola <pema@iki.fi> writes:
1734 Gcc (2.7.2, with cpplib IIRC) required something (-P worked :) to
1735 get it to compile. Otherwise it failed on those DEFUN macros with
1736 comments inside parameter lists (like buffer.c, line 296).
1737
1738 * Excessive optimization with pgcc can break XEmacs
1739
1740 It has been reported on some systems that compiling with -O6 can lead
1741 to XEmacs failures. The workaround is to use a lower optimization
1742 level. -O2 and -O4 have been tested extensively.
1743
1744 * -O2 optimization on Irix 5.3 can cause compiler complaint.
1745
1746 Nick J. Crabtree <nickc@scopic.com> writes:
1747 Comes up OK on a tty (all I have available over this slow link). Ill
1748 give it a hammering tomorrow. The -O2 optimisation complained about
1749 sizes exceeding thresholds; I haven't bothered to use the -Olimit
1750 option it recommends.
1751
1752 * Excessive optimization on AIX 4.2 can lead to compiler failure.
1753
1754 Valdis.Kletnieks@vt.edu writes:
1755 At least at the b34 level, and the latest-and-greatest IBM xlc
1756 (3.1.4.4), there are problems with -O3. I haven't investigated
1757 further.
1758
1759 * Sed problems on Solaris 2.5
1760
1761 There have been reports of Sun sed truncating very lines in the
1762 Makefile during configuration. The workaround is to use GNU sed or,
1763 even better, think of a better way to generate Makefile, and send us a
1764 patch. :-)
1765
1766 * CDE is not autodetected on HP.
1767
1768 Richard Cognot <cognot@ensg.u-nancy.fr> writes:
1769 I have to force /usr/dt/{lib,include} into the site include/lib
1770 command line options. I could add these in hpux10.h, but then I
1771 would think these should be pretty standard (to my knowledge, that's
1772 also where Sun puts its CDE stuff), so that wouldn't fix the problem
1773 on other architectures. AAMOF, when these path are given, CDE is
1774 detected, and DragAndDrop works (more or less, see next issue).
1775
1776 * Signalling: (wrong-type-argument ...) when loading mail-abbrevs
1777 1405
1778 The is seen when installing the Big Brother Data Base (bbdb) which 1406 The is seen when installing the Big Brother Data Base (bbdb) which
1779 includes an outdated copy of mail-abbrevs.el. Remove the copy that 1407 includes an outdated copy of mail-abbrevs.el. Remove the copy that
1780 comes with bbdb and use the one that comes with XEmacs. 1408 comes with bbdb and use the one that comes with XEmacs.
1781
1782 * Linking with -rpath on IRIX.
1783
1784 Darrell Kindred <dkindred@cmu.edu> writes:
1785 There are a couple of problems [with use of -rpath with Irix ld], though:
1786
1787 1. The ld in IRIX 5.3 ignores all but the last -rpath
1788 spec, so the patched configure spits out a warning
1789 if --x-libraries or --site-runtime-libraries are
1790 specified under irix 5.x, and it only adds -rpath
1791 entries for the --site-runtime-libraries. This bug was
1792 fixed sometime between 5.3 and 6.2.
1793
1794 2. IRIX gcc 2.7.2 doesn't accept -rpath directly, so
1795 it would have to be prefixed by -Xlinker or "-Wl,".
1796 This would be fine, except that configure compiles with
1797 ${CC-cc} $CFLAGS $LDFLAGS ...
1798 rather than quoting $LDFLAGS with prefix-args, like
1799 src/Makefile does. So if you specify --x-libraries
1800 or --site-runtime-libraries, you must use --use-gcc=no,
1801 or configure will fail.
1802
1803 * On Irix 5.x and 6.x, the dumped XEmacs (xemacs) core dumps when executed
1804 on another machine, or after newer SGI IRIX patches have been installed.
1805
1806 The xemacs binary must be executed with the same "libc.so" file which
1807 was used when the xemacs binary was dumped. Some SGI IRIX patches
1808 update this file. Make sure that all machines using the xemacs binary
1809 are using the same set of IRIX patches. If xemacs core dumps after a
1810 patch upgrade then you will have to redump it from temacs.
1811
1812 * xemacs: can't resolve symbol '__malloc_hook'
1813
1814 This is a Linux problem where you've compiled the XEmacs binary on a libc
1815 5.4 with version higher than 5.4.19 and attempted to run the binary against
1816 an earlier version. The solution is to upgrade your old library.
1817
1818 * VM appears to hang in large folders
1819
1820 This is normal (trust us) when upgrading to VM-6.22 from earlier
1821 versions. Let VM finish what it is doing and all will be well.