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