Commit | Line | Data |
---|---|---|
a933dad1 DL |
1 | This file describes various problems that have been encountered |
2 | in compiling, installing and running GNU Emacs. | |
3 | ||
2aa82bcf EZ |
4 | * Building Emacs with GCC 2.9x fails in the `src' directory. |
5 | ||
6 | This may happen if you use a development version of GNU `cpp' from one | |
7 | of the GCC snapshots between Oct 2000 and Feb 2001, or from a released | |
8 | version of GCC newer than 2.95.2 which was prepared around those | |
8632c7cb EZ |
9 | dates; similar problems were reported with some snapshots of GCC 3.1 |
10 | around Sep 30 2001. The preprocessor in those versions is | |
11 | incompatible with a traditional Unix cpp (e.g., it expands ".." into | |
12 | ". .", which breaks relative file names that reference the parent | |
13 | directory; or inserts TAB characters before lines that set Make | |
14 | variables). | |
2aa82bcf EZ |
15 | |
16 | The solution is to make sure the preprocessor is run with the | |
8632c7cb EZ |
17 | `-traditional' option. The `configure' script does that automatically |
18 | when it detects the known problems in your cpp, but you might hit some | |
19 | unknown ones. To force the `configure' script to use `-traditional', | |
20 | run the script like this: | |
21 | ||
173de997 | 22 | CPP='gcc -E -traditional' ./configure ... |
8632c7cb EZ |
23 | |
24 | (replace the ellipsis "..." with any additional arguments you pass to | |
25 | the script). | |
2aa82bcf EZ |
26 | |
27 | Note that this problem does not pertain to the MS-Windows port of | |
28 | Emacs, since it doesn't use the preprocessor to generate Makefiles. | |
29 | ||
9272ccfc AI |
30 | * Building the MS-Windows port with Cygwin GCC can fail. |
31 | ||
32 | Emacs may not build using recent Cygwin builds of GCC, such as Cygwin | |
33 | version 1.1.8, using the default configure settings. It appears to be | |
34 | necessary to specify the -mwin32 flag when compiling, and define | |
35 | __MSVCRT__, like so: | |
36 | ||
37 | configure --with-gcc --cflags -mwin32 --cflags -D__MSVCRT__ | |
38 | ||
39 | * Building the MS-Windows port with Leim fails in the `leim' directory. | |
7c22dc9d EZ |
40 | |
41 | The error message might be something like this: | |
42 | ||
43 | Converting d:/emacs-21.1/leim/CXTERM-DIC/4Corner.tit to quail-package... | |
44 | Invalid ENCODE: value in TIT dictionary | |
45 | NMAKE : fatal error U1077: '"../src/obj-spd/i386/emacs.exe"' : return code | |
46 | '0xffffffff' | |
47 | Stop. | |
48 | ||
49 | This can happen if the Leim distribution is unpacked with a program | |
50 | which converts the `*.tit' files to DOS-style CR-LF text format. The | |
51 | `*.tit' files in the leim/CXTERM-DIC directory require Unix-style line | |
52 | endings to compile properly, because Emacs reads them without any code | |
53 | or EOL conversions. | |
54 | ||
55 | The solution is to make sure the program used to unpack Leim does not | |
56 | change the files' line endings behind your back. The GNU FTP site has | |
57 | in the `/gnu/emacs/windows' directory a program called `djtarnt.exe' | |
58 | which can be used to unpack `.tar.gz' and `.zip' archives without | |
59 | mangling them. | |
60 | ||
677e7496 EZ |
61 | * Emacs crashes when dumping itself on Mac PPC running Yellow Dog GNU/Linux. |
62 | ||
63 | The crashes happen inside the function Fmake_symbol; here's a typical | |
64 | C backtrace printed by GDB: | |
65 | ||
66 | 0x190c0c0 in Fmake_symbol () | |
67 | (gdb) where | |
68 | #0 0x190c0c0 in Fmake_symbol () | |
69 | #1 0x1942ca4 in init_obarray () | |
70 | #2 0x18b3500 in main () | |
71 | #3 0x114371c in __libc_start_main (argc=5, argv=0x7ffff5b4, envp=0x7ffff5cc, | |
72 | ||
73 | This could happen because GCC version 2.95 and later changed the base | |
74 | of the load address to 0x10000000. Emacs needs to be told about this, | |
75 | but we currently cannot do that automatically, because that breaks | |
76 | other versions of GNU/Linux on the MacPPC. Until we find a way to | |
77 | distinguish between the Yellow Dog and the other varieties of | |
78 | GNU/Linux systems on the PPC, you will have to manually uncomment the | |
79 | following section near the end of the file src/m/macppc.h in the Emacs | |
80 | distribution: | |
81 | ||
82 | #if 0 /* This breaks things on PPC GNU/Linux ecept for Yellowdog, | |
83 | even with identical GCC, as, ld. Let's take it out until we | |
84 | know what's really going on here. */ | |
85 | /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to | |
86 | 0x10000000. */ | |
87 | #if defined __linux__ | |
88 | #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95) | |
89 | #define DATA_SEG_BITS 0x10000000 | |
90 | #endif | |
91 | #endif | |
92 | #endif /* 0 */ | |
93 | ||
94 | Remove the "#if 0" and "#endif" directives which surround this, save | |
95 | the file, and then reconfigure and rebuild Emacs. The dumping process | |
96 | should now succeed. | |
97 | ||
9ed04369 DL |
98 | * JPEG images aren't displayed. |
99 | ||
100 | This has been reported when Emacs is built with jpeg-6a library. | |
101 | Upgrading to jpeg-6b solves the problem. | |
102 | ||
b87207a0 EZ |
103 | * Building `ctags' for MS-Windows with the MinGW port of GCC fails. |
104 | ||
105 | This might happen due to a bug in the MinGW header assert.h, which | |
106 | defines the `assert' macro with a trailing semi-colon. The following | |
107 | patch to assert.h should solve this: | |
108 | ||
109 | *** include/assert.h.orig Sun Nov 7 02:41:36 1999 | |
110 | --- include/assert.h Mon Jan 29 11:49:10 2001 | |
111 | *************** | |
112 | *** 41,47 **** | |
113 | /* | |
114 | * If not debugging, assert does nothing. | |
115 | */ | |
116 | ! #define assert(x) ((void)0); | |
117 | ||
118 | #else /* debugging enabled */ | |
119 | ||
120 | --- 41,47 ---- | |
121 | /* | |
122 | * If not debugging, assert does nothing. | |
123 | */ | |
124 | ! #define assert(x) ((void)0) | |
125 | ||
126 | #else /* debugging enabled */ | |
127 | ||
128 | ||
61638355 EZ |
129 | |
130 | * Improving performance with slow X connections | |
131 | ||
132 | If you don't need X Input Methods (XIM) for entering text in some | |
133 | language you use, you can improve performance on WAN links by | |
134 | configuring Emacs with option `--without-xim'. Configuring Emacs | |
135 | without XIM does not affect the use of Emacs' own input methods, which | |
136 | are part of the Leim package. | |
137 | ||
138 | If the connection is very slow, you might also want to consider | |
139 | switching off scroll bars, menu bar, and tool bar. | |
140 | ||
141 | * Getting a Meta key on the FreeBSD console | |
142 | ||
143 | By default, neither Alt nor any other key acts as a Meta key on | |
144 | FreeBSD, but this can be changed using kbdcontrol(1). Dump the | |
145 | current keymap to a file with the command | |
146 | ||
147 | $ kbdcontrol -d >emacs.kbd | |
148 | ||
149 | Edit emacs.kbd, and give the key you want to be the Meta key the | |
150 | definition `meta'. For instance, if your keyboard has a ``Windows'' | |
151 | key with scan code 105, change the line for scan code 105 in emacs.kbd | |
152 | to look like this | |
153 | ||
154 | 105 meta meta meta meta meta meta meta meta O | |
155 | ||
156 | to make the Windows key the Meta key. Load the new keymap with | |
157 | ||
158 | $ kbdcontrol -l emacs.kbd | |
159 | ||
160 | * Emacs' xterm-mouse-mode doesn't work on the Gnome terminal. | |
161 | ||
162 | A symptom of this bug is that double-clicks insert a control sequence | |
163 | into the buffer. The reason this happens is an apparent | |
164 | incompatibility of the Gnome terminal with Xterm, which also affects | |
165 | other programs using the Xterm mouse interface. A problem report has | |
166 | been filed. | |
167 | ||
168 | * Emacs pauses for several seconds when changing the default font | |
169 | ||
170 | This has been reported for fvwm 2.2.5 and the window manager of KDE | |
171 | 2.1. The reason for the pause is Xt waiting for a ConfigureNotify | |
172 | event from the window manager, which the window manager doesn't send. | |
173 | Xt stops waiting after a default timeout of usually 5 seconds. | |
174 | ||
175 | A workaround for this is to add something like | |
176 | ||
177 | emacs.waitForWM: false | |
178 | ||
179 | to your X resources. Alternatively, add `(wait-for-wm . nil)' to a | |
180 | frame's parameter list, like this: | |
181 | ||
182 | (modify-frame-parameters nil '((wait-for-wm . nil))) | |
183 | ||
184 | (this should go into your `.emacs' file). | |
185 | ||
186 | * Underlines appear at the wrong position. | |
187 | ||
188 | This is caused by fonts having a wrong UNDERLINE_POSITION property. | |
556a9fad EZ |
189 | Examples are the font 7x13 on XFree prior to version 4.1, or the jmk |
190 | neep font from the Debian xfonts-jmk package. To circumvent this | |
191 | problem, set x-use-underline-position-properties to nil in your | |
192 | `.emacs'. | |
193 | ||
194 | To see what is the value of UNDERLINE_POSITION defined by the font, | |
195 | type `xlsfonts -lll FONT' and look at the font's UNDERLINE_POSITION | |
196 | property. | |
61638355 | 197 | |
49172314 GM |
198 | * When using Xaw3d scroll bars without arrows, the very first mouse |
199 | click in a scroll bar might be ignored by the scroll bar widget. This | |
200 | is probably a bug in Xaw3d; when Xaw3d is compiled with arrows, the | |
201 | problem disappears. | |
202 | ||
ed0d1d91 RS |
203 | * There are known binary incompatibilities between Xaw, Xaw3d, neXtaw, |
204 | XawM and the few other derivatives of Xaw. So when you compile with | |
205 | one of these, it may not work to dynamically link with another one. | |
206 | If you try it and it does not work, try rebuilding Emacs with the | |
207 | toolkit version you actually want to use. | |
208 | ||
6e1a66dc EZ |
209 | * Clicking C-mouse-2 in the scroll bar doesn't split the window. |
210 | ||
211 | This currently doesn't work with scroll-bar widgets (and we don't know | |
212 | a good way of implementing it with widgets). If Emacs is configured | |
213 | --without-toolkit-scroll-bars, C-mouse-2 on the scroll bar does work. | |
214 | ||
ed85f61d EZ |
215 | * Colors are not available on a tty or in xterm. |
216 | ||
9ed04369 DL |
217 | Emacs 21 supports colors on character terminals and terminal |
218 | emulators, but this support relies on the terminfo or termcap database | |
219 | entry to specify that the display supports color. Emacs looks at the | |
220 | "Co" capability for the terminal to find out how many colors are | |
221 | supported; it should be non-zero to activate the color support within | |
b300fd77 EZ |
222 | Emacs. (Most color terminals support 8 or 16 colors.) If your system |
223 | uses terminfo, the name of the capability equivalent to "Co" is | |
224 | "colors". | |
225 | ||
226 | In addition to the "Co" capability, Emacs needs the "op" (for | |
227 | ``original pair'') capability, which tells how to switch the terminal | |
228 | back to the default foreground and background colors. Emacs will not | |
229 | use colors if this capability is not defined. If your terminal entry | |
230 | doesn't provide such a capability, try using the ANSI standard escape | |
231 | sequence \E[00m (that is, define a new termcap/terminfo entry and make | |
232 | it use your current terminal's entry plus \E[00m for the "op" | |
233 | capability). | |
234 | ||
235 | Finally, the "NC" capability (terminfo name: "ncv") tells Emacs which | |
236 | attributes cannot be used with colors. Setting this capability | |
237 | incorrectly might have the effect of disabling colors; try setting | |
238 | this capability to `0' (zero) and see if that helps. | |
ed85f61d | 239 | |
9ed04369 DL |
240 | Emacs uses the database entry for the terminal whose name is the value |
241 | of the environment variable TERM. With `xterm', a common terminal | |
ed85f61d | 242 | entry that supports color is `xterm-color', so setting TERM's value to |
9ed04369 DL |
243 | `xterm-color' might activate the color support on an xterm-compatible |
244 | emulator. | |
ed85f61d | 245 | |
9ed04369 DL |
246 | Some modes do not use colors unless you turn on the Font-lock mode. |
247 | Some people have long ago set their `~/.emacs' files to turn on | |
248 | Font-lock on X only, so they won't see colors on a tty. The | |
249 | recommended way of turning on Font-lock is by typing "M-x | |
e085efdb EZ |
250 | global-font-lock-mode RET" or by customizing the variable |
251 | `global-font-lock-mode'. | |
ed85f61d | 252 | |
d0cf6c7d EZ |
253 | * Emacs on a tty switches the cursor to large blinking block. |
254 | ||
255 | This was reported to happen on some GNU/Linux systems which use | |
256 | ncurses version 5.0, but could be relevant for other versions as well. | |
257 | These versions of ncurses come with a `linux' terminfo entry, where | |
258 | the "cvvis" capability (termcap "vs") is defined as "\E[?25h\E[?8c" | |
259 | (show cursor, change size). This escape sequence switches on a | |
260 | blinking hardware text-mode cursor whose size is a full character | |
261 | cell. This blinking cannot be stopped, since a hardware cursor | |
262 | always blinks. | |
263 | ||
264 | A work-around is to redefine the "cvvis" capability so that it | |
265 | enables a *software* cursor. The software cursor works by inverting | |
266 | the colors of the character at point, so what you see is a block | |
267 | cursor that doesn't blink. For this to work, you need to redefine | |
268 | the "cnorm" capability as well, so that it operates on the software | |
269 | cursor instead of the hardware cursor. | |
270 | ||
271 | To this end, run "infocmp linux > linux-term", edit the file | |
272 | `linux-term' to make both the "cnorm" and "cvvis" capabilities send | |
273 | the sequence "\E[?25h\E[?17;0;64c", and then run "tic linux-term" to | |
274 | produce a modified terminfo entry. | |
275 | ||
c289e7f0 EZ |
276 | Alternatively, if you want a blinking underscore as your Emacs cursor, |
277 | change the "cvvis" capability to send the "\E[?25h\E[?0c" command. | |
278 | ||
339b95d5 EZ |
279 | * Problems in Emacs built with LessTif. |
280 | ||
281 | The problems seem to depend on the version of LessTif and the Motif | |
282 | emulation for which it is set up. | |
283 | ||
9ed04369 DL |
284 | Only the Motif 1.2 emulation seems to be stable enough in LessTif. |
285 | Lesstif 0.92-17's Motif 1.2 emulation seems to work okay on FreeBSD. | |
286 | On GNU/Linux systems, lesstif-0.92.6 configured with "./configure | |
287 | --enable-build-12 --enable-default-12" is reported to be the most | |
288 | successful. The binary GNU/Linux package | |
289 | lesstif-devel-0.92.0-1.i386.rpm was reported to have problems with | |
290 | menu placement. | |
339b95d5 EZ |
291 | |
292 | On some systems, even with Motif 1.2 emulation, Emacs occasionally | |
9ed04369 DL |
293 | locks up, grabbing all mouse and keyboard events. We still don't know |
294 | what causes these problems; they are not reproducible by Emacs | |
295 | developers. | |
339b95d5 | 296 | |
b87207a0 EZ |
297 | * Known problems with the MS-Windows port of Emacs 21.1. |
298 | ||
299 | Emacs 21.1 built for MS-Windows doesn't support images, the tool bar, | |
300 | and tooltips. Support for these will be added in future versions. | |
301 | ||
f936978f EZ |
302 | Help text that is displayed in a tooltip on other window systems, on |
303 | Windows is printed in the echo area, since tooltips are not yet | |
e071f64e | 304 | available. Help text for pop-up menu items is not displayed at all. |
f936978f | 305 | |
e071f64e JR |
306 | There are problems with display if mouse-tracking is enabled and the |
307 | mouse is moved off a frame, over another frame then back over the first | |
308 | frame. A workaround is to click the left mouse button inside the frame | |
309 | after moving back into it. | |
b87207a0 | 310 | |
e071f64e JR |
311 | Some minor flickering still persists during mouse-tracking, although |
312 | not as severely as in 21.1. | |
b87207a0 EZ |
313 | |
314 | Emacs can sometimes abort when non-ASCII text, possibly with null | |
315 | characters, is copied and pasted into a buffer. | |
316 | ||
317 | An inactive cursor remains in an active window after the Windows | |
318 | Manager driven switch of the focus, until a key is pressed. | |
319 | ||
e085efdb EZ |
320 | Windows 2000 input methods are not recognized by Emacs (as of v21.1). |
321 | These input methods cause the keyboard to send characters encoded in | |
322 | the appropriate coding system (e.g., ISO 8859-1 for Latin-1 | |
323 | characters, ISO 8859-8 for Hebrew characters, etc.). To make this | |
324 | work, set the keyboard coding system to the appropriate value after | |
325 | you activate the Windows input method. For example, if you activate | |
326 | the Hebrew input method, type "C-x RET k iso-8859-8 RET". (Emacs | |
327 | ought to recognize the Windows language-change event and set up the | |
328 | appropriate keyboard encoding automatically, but it doesn't do that | |
329 | yet.) | |
330 | ||
331 | Multilingual text put into the Windows 2000 clipboard by Windows | |
332 | applications cannot be safely pasted into Emacs (as of v21.1). This | |
333 | is because Windows 2000 uses Unicode to represent multilingual text, | |
334 | but Emacs does not yet support Unicode well enough to decode it. This | |
335 | means that Emacs can only interchange non-ASCII text with other | |
336 | Windows 2000 programs if the characters are in the system codepage. | |
337 | Reportedly, a partial solution is to install the Mule-UCS package and | |
338 | set selection-coding-system to utf-16-le-dos. | |
339 | ||
c8d9b4ee EZ |
340 | * The `configure' script doesn't find the jpeg library. |
341 | ||
342 | This can happen because the linker by default only looks for shared | |
343 | libraries, but jpeg distribution by default doesn't build and doesn't | |
344 | install a shared version of the library, `libjpeg.so'. One system | |
49e37720 DL |
345 | where this is known to happen is Compaq OSF/1 (`Tru64'), but it |
346 | probably isn't limited to that system. | |
c8d9b4ee | 347 | |
9ed04369 DL |
348 | You can configure the jpeg library with the `--enable-shared' option |
349 | and then rebuild libjpeg. This produces a shared version of libjpeg, | |
350 | which you need to install. Finally, rerun the Emacs configure script, | |
351 | which should now find the jpeg library. Alternatively, modify the | |
352 | generated src/Makefile to link the .a file explicitly. | |
c8d9b4ee | 353 | |
9ed04369 DL |
354 | (If you need the static version of the jpeg library as well, configure |
355 | libjpeg with both `--enable-static' and `--enable-shared' options.) | |
c8d9b4ee | 356 | |
d9810886 EZ |
357 | * Building Emacs over NFS fails with ``Text file busy''. |
358 | ||
d67e4586 EZ |
359 | This was reported to happen when building Emacs on a GNU/Linux system |
360 | (RedHat Linux 6.2) using a build directory automounted from Solaris | |
361 | (SunOS 5.6) file server, but it might not be limited to that | |
362 | configuration alone. Presumably, the NFS server doesn't commit the | |
363 | files' data to disk quickly enough, and the Emacs executable file is | |
364 | left ``busy'' for several seconds after Emacs has finished dumping | |
365 | itself. This causes the subsequent commands which invoke the dumped | |
366 | Emacs excutable to fail with the above message. | |
d9810886 | 367 | |
d04b2e49 EZ |
368 | In some of these cases, a time skew between the NFS server and the |
369 | machine where Emacs is built is detected and reported by GNU Make | |
370 | (it says that some of the files have modification time in the future). | |
371 | This might be a symptom of NFS-related problems. | |
372 | ||
d9810886 EZ |
373 | If the NFS server runs on Solaris, apply the Solaris patch 105379-05 |
374 | (Sunos 5.6: /kernel/misc/nfssrv patch). If that doesn't work, or if | |
375 | you have a different version of the OS or the NFS server, you can | |
376 | force the NFS server to use 1KB blocks, which was reported to fix the | |
377 | problem albeit at a price of slowing down file I/O. You can force 1KB | |
378 | blocks by specifying the "-o rsize=1024,wsize=1024" options to the | |
379 | `mount' command, or by adding ",rsize=1024,wsize=1024" to the mount | |
380 | options in the appropriate system configuration file, such as | |
381 | `/etc/auto.home'. | |
382 | ||
b4da93e1 EZ |
383 | Alternatively, when Make fails due to this problem, you could wait for |
384 | a few seconds and then invoke Make again. In one particular case, | |
385 | waiting for 10 or more seconds between the two Make invocations seemed | |
386 | to work around the problem. | |
d9810886 | 387 | |
aa99760e EZ |
388 | Similar problems can happen if your machine NFS-mounts a directory |
389 | onto itself. Suppose the Emacs sources live in `/usr/local/src' and | |
390 | you are working on the host called `marvin'. Then an entry in the | |
391 | `/etc/fstab' file like the following is asking for trouble: | |
392 | ||
393 | marvin:/usr/local/src /usr/local/src ...options.omitted... | |
394 | ||
395 | The solution is to remove this line from `etc/fstab'. | |
396 | ||
086b25d3 EZ |
397 | * Emacs binary is not in executable format, and cannot be run. |
398 | ||
399 | This was reported to happen when Emacs is built in a directory mounted | |
400 | via NFS. Usually, the file `emacs' produced in these cases is full of | |
401 | binary null characters, and the `file' utility says: | |
402 | ||
403 | emacs: ASCII text, with no line terminators | |
404 | ||
405 | We don't know what exactly causes this failure. A work-around is to | |
406 | build Emacs in a directory on a local disk. | |
407 | ||
9ed04369 | 408 | * Accented ISO-8859-1 characters are displayed as | or _. |
d6b7de9b EZ |
409 | |
410 | Try other font set sizes (S-mouse-1). If the problem persists with | |
411 | other sizes as well, your text is corrupted, probably through software | |
412 | that is not 8-bit clean. If the problem goes away with another font | |
413 | size, it's probably because some fonts pretend to be ISO-8859-1 fonts | |
414 | when they are really ASCII fonts. In particular the schumacher-clean | |
415 | fonts have this bug in some versions of X. | |
416 | ||
417 | To see what glyphs are included in a font, use `xfd', like this: | |
418 | ||
419 | xfd -fn -schumacher-clean-medium-r-normal--12-120-75-75-c-60-iso8859-1 | |
420 | ||
421 | If this shows only ASCII glyphs, the font is indeed the source of the | |
422 | problem. | |
423 | ||
424 | The solution is to remove the corresponding lines from the appropriate | |
425 | `fonts.alias' file, then run `mkfontdir' in that directory, and then run | |
426 | `xset fp rehash'. | |
427 | ||
ec6bd013 DL |
428 | * Large file support is disabled on HP-UX. See the comments in |
429 | src/s/hpux10.h. | |
430 | ||
431 | * Crashes when displaying uncompressed GIFs with version | |
432 | libungif-4.1.0 are resolved by using version libungif-4.1.0b1. | |
433 | ||
a408ce18 EZ |
434 | * Font Lock displays portions of the bufefr in incorrect faces. |
435 | ||
436 | By far the most frequent cause of this is a parenthesis `(' or a brace | |
437 | `{' in column zero. Font Lock assumes that such a paren is outside of | |
438 | any comment or string. This is of course not true in general, but the | |
439 | vast majority of well-formatted program source files don't have such | |
440 | parens, and therefore this assumption is used to allow optimizations | |
441 | in Font Lock's syntactical analysis. These optimizations avoid some | |
442 | patological cases where jit-lock, the Just-in-Time fontification | |
443 | introduced with Emacs 21.1, could significantly slow down scrolling | |
444 | through the buffer, especially scrolling backwards, and also jumping | |
445 | to the end of a very large buffer. | |
446 | ||
447 | If you don't use large buffers, or have a very fast machine which | |
448 | makes the delays insignificant, you can avoid the incorrect | |
449 | fontification by setting the variable | |
450 | `font-lock-beginning-of-syntax-function' to a nil value. (This must | |
451 | be done _after_ turning on Font Lock.) | |
452 | ||
453 | Another alternative is to avoid a paren in column zero. For example, | |
454 | in a Lisp string you could precede the paren with a backslash. | |
455 | ||
b87207a0 EZ |
456 | * Interrupting Cygwin port of Bash from Emacs doesn't work. |
457 | ||
458 | Cygwin 1.x builds of the ported Bash cannot be interrupted from the | |
459 | MS-Windows version of Emacs. This is due to some change in the Bash | |
460 | port or in the Cygwin library which apparently make Bash ignore the | |
461 | keyboard interrupt event sent by Emacs to Bash. (Older Cygwin ports | |
462 | of Bash, up to b20.1, did receive SIGINT from Emacs.) | |
463 | ||
61638355 EZ |
464 | * Accessing remote files with ange-ftp hangs the MS-Windows version of Emacs. |
465 | ||
466 | If the FTP client is the Cygwin port of GNU `ftp', this appears to be | |
467 | due to some bug in the Cygwin DLL or some incompatibility between it | |
468 | and the implementation of asynchronous subprocesses in the Windows | |
469 | port of Emacs. Specifically, some parts of the FTP server responses | |
470 | are not flushed out, apparently due to buffering issues, which | |
471 | confuses ange-ftp. | |
472 | ||
473 | The solution is to downgrade to an older version of the Cygwin DLL | |
474 | (version 1.3.2 was reported to solve the problem), or use the stock | |
475 | Windows FTP client, usually found in the `C:\WINDOWS' directory. To | |
476 | force ange-ftp use the stock Windows client, set the variable | |
477 | `ange-ftp-ftp-program-name' to the absolute file name of the client's | |
478 | executable. For example: | |
479 | ||
480 | (setq ange-ftp-ftp-program-name "c:/windows/ftp.exe") | |
481 | ||
482 | If you want to stick with the Cygwin FTP client, you can work around | |
483 | this problem by putting this in your `.emacs' file: | |
484 | ||
485 | (setq ange-ftp-ftp-program-args '("-i" "-n" "-g" "-v" "--prompt" "") | |
486 | ||
487 | ||
e0704d3b EZ |
488 | * The latest released version of the W3 package doesn't run properly |
489 | with Emacs 21 and needs work. However, these problems are already | |
9187d0a6 EZ |
490 | fixed in W3's CVS. The patch below is reported to make w3-4.0pre.46 |
491 | work. | |
492 | ||
493 | Some users report they are unable to byte-compile W3 with Emacs 21. | |
494 | If the patches below don't help to resolve your problems, install the | |
495 | CVS version of W3, which should be compatible with Emacs 21. | |
a953a8d3 DL |
496 | |
497 | diff -aur --new-file w3-4.0pre.46-orig/lisp/w3-display.el w3-4.0pre.46-new/lisp/w3-display.el | |
498 | --- w3-4.0pre.46-orig/lisp/w3-display.el Sun Nov 14 22:00:12 1999 | |
499 | +++ w3-4.0pre.46-new/lisp/w3-display.el Thu Dec 14 14:59:15 2000 | |
500 | @@ -181,7 +181,8 @@ | |
501 | (dispatch-event (next-command-event))) | |
502 | (error nil)))) | |
503 | (t | |
504 | - (if (and (not (sit-for 0)) (input-pending-p)) | |
505 | + ;; modified for GNU Emacs 21 by bob@rattlesnake.com on 2000 Dec 14 | |
506 | + (if (and (not (sit-for 0)) nil) | |
507 | (condition-case () | |
508 | (progn | |
509 | (setq w3-pause-keystroke | |
510 | diff -aur --new-file w3-4.0pre.46-orig/lisp/w3-e21.el w3-4.0pre.46-new/lisp/w3-e21.el | |
511 | --- w3-4.0pre.46-orig/lisp/w3-e21.el Thu Jan 1 00:00:00 1970 | |
512 | +++ w3-4.0pre.46-new/lisp/w3-e21.el Thu Dec 14 14:54:58 2000 | |
513 | @@ -0,0 +1,5 @@ | |
514 | +;;; w3-e21.el --- ** required for GNU Emacs 21 ** | |
515 | +;; Added by bob@rattlesnake.com on 2000 Dec 14 | |
516 | + | |
517 | +(require 'w3-e19) | |
518 | +(provide 'w3-e21) | |
519 | ||
2ebf6139 GM |
520 | * On AIX, if linking fails because libXbsd isn't found, check if you |
521 | are compiling with the system's `cc' and CFLAGS containing `-O5'. If | |
522 | so, you have hit a compiler bug. Please make sure to re-configure | |
523 | Emacs so that it isn't compiled with `-O5'. | |
524 | ||
e1f9a6b3 DL |
525 | * The PSGML package uses the obsolete variables |
526 | `before-change-function' and `after-change-function', which are no | |
49e37720 | 527 | longer used by Emacs. These changes to PSGML 1.2.2 fix that. |
e1f9a6b3 | 528 | |
49e37720 DL |
529 | --- psgml-edit.el 2001/03/03 00:23:31 1.1 |
530 | +++ psgml-edit.el 2001/03/03 00:24:22 | |
531 | @@ -264,4 +264,4 @@ | |
e1f9a6b3 DL |
532 | ; inhibit-read-only |
533 | - (before-change-function nil) | |
534 | - (after-change-function nil)) | |
535 | + (before-change-functions nil) | |
536 | + (after-change-functions nil)) | |
537 | (setq selective-display t) | |
49e37720 | 538 | @@ -1544,3 +1544,3 @@ |
e1f9a6b3 DL |
539 | (buffer-read-only nil) |
540 | - (before-change-function nil) | |
541 | + (before-change-functions nil) | |
542 | (markup-index ; match-data index in tag regexp | |
49e37720 | 543 | @@ -1596,3 +1596,3 @@ |
e1f9a6b3 DL |
544 | (defun sgml-expand-shortref-to-text (name) |
545 | - (let (before-change-function | |
546 | + (let (before-change-functions | |
547 | (entity (sgml-lookup-entity name (sgml-dtd-entities sgml-dtd-info)))) | |
49e37720 | 548 | @@ -1613,3 +1613,3 @@ |
e1f9a6b3 DL |
549 | (re-found nil) |
550 | - before-change-function) | |
551 | + before-change-functions) | |
552 | (goto-char sgml-markup-start) | |
49e37720 | 553 | @@ -1646,3 +1646,3 @@ |
e1f9a6b3 DL |
554 | (goto-char (sgml-element-end element)) |
555 | - (let ((before-change-function nil)) | |
556 | + (let ((before-change-functions nil)) | |
557 | (sgml-normalize-content element only-one))) | |
2f9c7108 | 558 | Index: psgml-other.el |
49e37720 DL |
559 | --- psgml-other.el 2001/03/03 00:23:42 1.1 |
560 | +++ psgml-other.el 2001/03/03 00:30:05 | |
e1f9a6b3 DL |
561 | @@ -32,2 +32,3 @@ |
562 | (require 'easymenu) | |
563 | +(eval-when-compile (require 'cl)) | |
564 | ||
565 | @@ -61,4 +62,9 @@ | |
566 | (let ((submenu | |
567 | - (subseq entries 0 (min (length entries) | |
568 | - sgml-max-menu-size)))) | |
569 | +;;; (subseq entries 0 (min (length entries) | |
570 | +;;; sgml-max-menu-size)) | |
571 | + (let ((new (copy-sequence entries))) | |
572 | + (setcdr (nthcdr (1- (min (length entries) | |
573 | + sgml-max-menu-size)) | |
574 | + new) nil) | |
575 | + new))) | |
576 | (setq entries (nthcdr sgml-max-menu-size entries)) | |
49e37720 | 577 | @@ -113,9 +119,10 @@ |
e1f9a6b3 DL |
578 | (let ((inhibit-read-only t) |
579 | - (after-change-function nil) ; obsolete variable | |
580 | - (before-change-function nil) ; obsolete variable | |
581 | (after-change-functions nil) | |
582 | - (before-change-functions nil)) | |
e1f9a6b3 DL |
583 | + (before-change-functions nil) |
584 | + (modified (buffer-modified-p)) | |
585 | + (buffer-undo-list t) | |
586 | + deactivate-mark) | |
49e37720 DL |
587 | (put-text-property start end 'face face) |
588 | - (when (< start end) | |
589 | - (put-text-property (1- end) end 'rear-nonsticky '(face))))) | |
e1f9a6b3 | 590 | + (when (and (not modified) (buffer-modified-p)) |
49e37720 | 591 | + (set-buffer-modified-p nil)))) |
e1f9a6b3 | 592 | (t |
2f9c7108 | 593 | Index: psgml-parse.el |
49e37720 DL |
594 | --- psgml-parse.el 2001/03/03 00:23:57 1.1 |
595 | +++ psgml-parse.el 2001/03/03 00:29:56 | |
e1f9a6b3 DL |
596 | @@ -40,2 +40,4 @@ |
597 | ||
598 | +(eval-when-compile (require 'cl)) | |
599 | + | |
600 | \f | |
49e37720 | 601 | @@ -2493,8 +2495,8 @@ |
e1f9a6b3 DL |
602 | (setq sgml-scratch-buffer nil)) |
603 | - (when after-change-function ;*** | |
604 | - (message "OOPS: after-change-function not NIL in scratch buffer %s: %s" | |
605 | + (when after-change-functions ;*** | |
606 | + (message "OOPS: after-change-functions not NIL in scratch buffer %s: %S" | |
607 | (current-buffer) | |
608 | - after-change-function) | |
609 | - (setq before-change-function nil | |
610 | - after-change-function nil)) | |
611 | + after-change-functions) | |
612 | + (setq before-change-functions nil | |
613 | + after-change-functions nil)) | |
614 | (setq sgml-last-entity-buffer (current-buffer)) | |
49e37720 | 615 | @@ -2878,6 +2880,5 @@ |
e1f9a6b3 DL |
616 | "Set initial state of parsing" |
617 | - (make-local-variable 'before-change-function) | |
618 | - (setq before-change-function 'sgml-note-change-at) | |
619 | - (make-local-variable 'after-change-function) | |
620 | - (setq after-change-function 'sgml-set-face-after-change) | |
621 | + (set (make-local-variable 'before-change-functions) '(sgml-note-change-at)) | |
622 | + (set (make-local-variable 'after-change-functions) | |
623 | + '(sgml-set-face-after-change)) | |
624 | (sgml-set-active-dtd-indicator (sgml-dtd-doctype dtd)) | |
49e37720 DL |
625 | @@ -3925,7 +3926,7 @@ |
626 | (sgml-need-dtd) | |
e1f9a6b3 DL |
627 | - (unless before-change-function |
628 | - (message "WARN: before-change-function has been lost, restoring (%s)" | |
629 | + (unless before-change-functions | |
630 | + (message "WARN: before-change-functions has been lost, restoring (%s)" | |
631 | (current-buffer)) | |
632 | - (setq before-change-function 'sgml-note-change-at) | |
49e37720 | 633 | - (setq after-change-function 'sgml-set-face-after-change)) |
e1f9a6b3 | 634 | + (setq before-change-functions '(sgml-note-change-at)) |
49e37720 DL |
635 | + (setq after-change-functions '(sgml-set-face-after-change))) |
636 | (sgml-with-parser-syntax-ro | |
e1f9a6b3 | 637 | |
1d297d9b CW |
638 | * TeX'ing the Calc manual fails. |
639 | ||
640 | The following patches allow to build the Calc manual using texinfo.tex | |
641 | from Emacs 19.34 distribution: | |
642 | ||
643 | *** calc-maint.e~0 Mon Dec 16 07:11:26 1996 | |
644 | --- calc-maint.el Sun Dec 10 14:32:38 2000 | |
645 | *************** | |
646 | *** 308,314 **** | |
647 | (insert "@tex\n" | |
648 | "\\global\\advance\\appendixno2\n" | |
649 | "\\gdef\\xref#1.{See ``#1.''}\n") | |
650 | ! (setq midpos (point)) | |
651 | (insert "@end tex\n") | |
652 | (insert-buffer-substring srcbuf sumpos endpos) | |
653 | (insert "@bye\n") | |
654 | --- 308,314 ---- | |
655 | (insert "@tex\n" | |
656 | "\\global\\advance\\appendixno2\n" | |
657 | "\\gdef\\xref#1.{See ``#1.''}\n") | |
658 | ! (setq midpos (point-marker)) | |
659 | (insert "@end tex\n") | |
660 | (insert-buffer-substring srcbuf sumpos endpos) | |
661 | (insert "@bye\n") | |
662 | *** Makefile.~0 Mon Dec 16 07:11:24 1996 | |
663 | --- Makefile Sun Dec 10 14:44:00 2000 | |
664 | *************** | |
665 | *** 98,106 **** | |
666 | # Format the Calc manual as one printable volume using TeX. | |
667 | tex: | |
668 | $(REMOVE) calc.aux | |
669 | ! $(TEX) calc.texinfo | |
670 | $(TEXINDEX) calc.[cfkptv]? | |
671 | ! $(TEX) calc.texinfo | |
672 | $(PURGE) calc.cp calc.fn calc.pg calc.tp calc.vr | |
673 | $(PURGE) calc.cps calc.fns calc.kys calc.pgs calc.tps calc.vrs | |
674 | $(PURGE) calc.toc | |
675 | --- 98,106 ---- | |
676 | # Format the Calc manual as one printable volume using TeX. | |
677 | tex: | |
678 | $(REMOVE) calc.aux | |
679 | ! -$(TEX) calc.texinfo | |
680 | $(TEXINDEX) calc.[cfkptv]? | |
681 | ! -$(TEX) calc.texinfo | |
682 | $(PURGE) calc.cp calc.fn calc.pg calc.tp calc.vr | |
683 | $(PURGE) calc.cps calc.fns calc.kys calc.pgs calc.tps calc.vrs | |
684 | $(PURGE) calc.toc | |
685 | *** calc.texinfo.~1~ Thu Oct 10 18:18:56 1996 | |
686 | --- calc.texinfo Mon Dec 11 08:25:00 2000 | |
687 | *************** | |
688 | *** 12,17 **** | |
689 | --- 12,19 ---- | |
690 | % Because makeinfo.c exists, we can't just define new commands. | |
691 | % So instead, we take over little-used existing commands. | |
692 | % | |
693 | + % Suggested by Karl Berry <karl@@freefriends.org> | |
694 | + \gdef\!{\mskip-\thinmuskip} | |
695 | % Redefine @cite{text} to act like $text$ in regular TeX. | |
696 | % Info will typeset this same as @samp{text}. | |
697 | \gdef\goodtex{\tex \let\rm\goodrm \let\t\ttfont \turnoffactive} | |
698 | *************** | |
699 | *** 23686,23692 **** | |
700 | a vector of the actual parameter values, written as equations: | |
701 | @cite{[a = 3, b = 2]}, in case you'd rather read them in a list | |
702 | than pick them out of the formula. (You can type @kbd{t y} | |
703 | ! to move this vector to the stack; @pxref{Trail Commands}.) | |
704 | ||
705 | Specifying a different independent variable name will affect the | |
706 | resulting formula: @kbd{a F 1 k RET} produces @kbd{3 + 2 k}. | |
707 | --- 23689,23695 ---- | |
708 | a vector of the actual parameter values, written as equations: | |
709 | @cite{[a = 3, b = 2]}, in case you'd rather read them in a list | |
710 | than pick them out of the formula. (You can type @kbd{t y} | |
711 | ! to move this vector to the stack; see @ref{Trail Commands}.) | |
712 | ||
713 | Specifying a different independent variable name will affect the | |
714 | resulting formula: @kbd{a F 1 k RET} produces @kbd{3 + 2 k}. | |
715 | ||
3d7a4ec8 EZ |
716 | * Unicode characters are not unified with other Mule charsets. |
717 | ||
718 | As of v21.1, Emacs charsets are still not unified. This means that | |
719 | characters which belong to charsets such as Latin-2, Greek, Hebrew, | |
720 | etc. and the same characters in the `mule-unicode-*' charsets are | |
721 | different characters, as far as Emacs is concerned. For example, text | |
722 | which includes Unicode characters from the Latin-2 locale cannot be | |
723 | encoded by Emacs with ISO 8859-2 coding system; and if you yank Greek | |
724 | text from a buffer whose buffer-file-coding-system is greek-iso-8bit | |
725 | into a mule-unicode-0100-24ff buffer, Emacs won't be able to save that | |
726 | buffer neither as ISO 8859-7 nor as UTF-8. | |
727 | ||
728 | To work around this, install some add-on package such as Mule-UCS. | |
729 | ||
de7396bb EZ |
730 | * Problems when using Emacs with UTF-8 locales |
731 | ||
732 | Some systems, including recent versions of GNU/Linux, have terminals | |
733 | or X11 subsystems that can be configured to provide Unicode/UTF-8 | |
734 | input and display. Normally, such a system sets environment variables | |
735 | such as LANG, LC_CTYPE, or LC_ALL to a string which ends with a | |
736 | `.UTF-8'. For example, a system like this in a French locale might | |
737 | use `fr_FR.UTF-8' as the value of LANG. | |
738 | ||
739 | Since Unicode support in Emacs, as of v21.1, is not yet complete (see | |
740 | the previous entry in this file), UTF-8 support is not enabled by | |
741 | default, even in UTF-8 locales. Thus, some Emacs features, such as | |
742 | non-ASCII keyboard input, might appear to be broken in these locales. | |
743 | To solve these problems, you need to turn on some options in your | |
744 | `.emacs' file. Specifically, the following customizations should make | |
745 | Emacs work correctly with UTF-8 input and text: | |
746 | ||
747 | (setq locale-coding-system 'utf-8) | |
748 | (set-terminal-coding-system 'utf-8) | |
749 | (set-keyboard-coding-system 'utf-8) | |
750 | (set-selection-coding-system 'utf-8) | |
751 | (prefer-coding-system 'utf-8) | |
752 | ||
b098c23c EZ |
753 | * The `oc-unicode' package doesn't work with Emacs 21. |
754 | ||
9ed04369 DL |
755 | This package tries to define more private charsets than there are free |
756 | slots now. If the built-in Unicode/UTF-8 support is insufficient, | |
757 | e.g. if you need more CJK coverage, use the current Mule-UCS package. | |
758 | Any files encoded as emacs-mule using oc-unicode won't be read | |
759 | correctly by Emacs 21. | |
224a0b4d | 760 | |
6343352f EZ |
761 | * Using epop3.el package causes Emacs to signal an error. |
762 | ||
763 | The error message might be something like this: | |
764 | ||
765 | "Lisp nesting exceeds max-lisp-eval-depth" | |
766 | ||
767 | This happens because epop3 redefines the function gethash, which is a | |
768 | built-in primitive beginning with Emacs 21.1. We don't have a patch | |
769 | for epop3 that fixes this, but perhaps a newer version of epop3 | |
770 | corrects that. | |
771 | ||
f4f4ee4d GM |
772 | * On systems with shared libraries you might encounter run-time errors |
773 | from the dynamic linker telling you that it is unable to find some | |
774 | shared libraries, for instance those for Xaw3d or image support. | |
775 | These errors mean Emacs has been linked with a library whose shared | |
776 | library is not in the default search path of the dynamic linker. | |
777 | ||
0cb26e21 EZ |
778 | Similar problems could prevent Emacs from building, since the build |
779 | process invokes Emacs several times. | |
780 | ||
f4f4ee4d GM |
781 | On many systems, it is possible to set LD_LIBRARY_PATH in your |
782 | environment to specify additional directories where shared libraries | |
783 | can be found. | |
784 | ||
785 | Other systems allow to set LD_RUN_PATH in a similar way, but before | |
786 | Emacs is linked. With LD_RUN_PATH set, the linker will include a | |
787 | specified run-time search path in the executable. | |
788 | ||
789 | Please refer to the documentation of your dynamic linker for details. | |
790 | ||
0c6456ad | 791 | * On Solaris 2.7, building Emacs with WorkShop Compilers 5.0 98/12/15 |
9b2999d0 DL |
792 | C 5.0 failed, apparently with non-default CFLAGS, most probably due to |
793 | compiler bugs. Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C | |
794 | release was reported to work without problems. It worked OK on | |
795 | another system with Solaris 8 using apparently the same 5.0 compiler | |
796 | and the default CFLAGS. | |
0c6456ad | 797 | |
b1739b51 EZ |
798 | * Compiling syntax.c with the OPENSTEP 4.2 compiler gcc 2.7.2.1 fails. |
799 | ||
800 | The compiler was reported to crash while compiling syntax.c with the | |
801 | following message: | |
802 | ||
803 | cc: Internal compiler error: program cc1obj got fatal signal 11 | |
804 | ||
805 | To work around this, replace the macros UPDATE_SYNTAX_TABLE_FORWARD, | |
806 | INC_BOTH, and INC_FROM with functions. To this end, first define 3 | |
807 | functions, one each for every macro. Here's an example: | |
808 | ||
809 | static int update_syntax_table_forward(int from) | |
810 | { | |
811 | return(UPDATE_SYNTAX_TABLE_FORWARD(from)); | |
812 | }/*update_syntax_table_forward*/ | |
813 | ||
814 | Then replace all references to UPDATE_SYNTAX_TABLE_FORWARD in syntax.c | |
815 | with a call to the function update_syntax_table_forward. | |
816 | ||
e9a52cfe EZ |
817 | * Emacs fails to start, complaining about missing fonts. |
818 | ||
819 | A typical error message might be something like | |
820 | ||
821 | No fonts match `-*-fixed-medium-r-*--6-*-*-*-*-*-iso8859-1' | |
822 | ||
823 | This happens because some X resource specifies a bad font family for | |
824 | Emacs to use. The possible places where this specification might be | |
825 | are: | |
826 | ||
827 | - in your ~/.Xdefaults file | |
828 | ||
829 | - client-side X resource file, such as ~/Emacs or | |
830 | /usr/X11R6/lib/app-defaults/Emacs or | |
831 | /usr/X11R6/lib/X11/app-defaults/Emacs | |
832 | ||
833 | One of these files might have bad or malformed specification of a | |
834 | fontset that Emacs should use. To fix the problem, you need to find | |
835 | the problematic line(s) and correct them. | |
836 | ||
f25eb4f7 EZ |
837 | * Emacs 20 and later fails to load Lisp files at startup. |
838 | ||
839 | The typical error message might be like this: | |
840 | ||
841 | "Cannot open load file: fontset" | |
842 | ||
843 | This could happen if you compress the file lisp/subdirs.el. That file | |
844 | tells Emacs what are the directories where it should look for Lisp | |
845 | files. Emacs cannot work with subdirs.el compressed, since the | |
846 | Auto-compress mode it needs for this will not be loaded until later, | |
847 | when your .emacs file is processed. (The package `fontset.el' is | |
848 | required to set up fonts used to display text on window systems, and | |
849 | its loaded very early in the startup procedure.) | |
850 | ||
851 | Similarly, any other .el file for which there's no corresponding .elc | |
852 | file could fail to load if it is compressed. | |
853 | ||
854 | The solution is to uncompress all .el files which don't have a .elc | |
855 | file. | |
856 | ||
f3d6f4ee EZ |
857 | * Attempting to visit remote files via ange-ftp fails. |
858 | ||
859 | If the error message is "ange-ftp-file-modtime: Specified time is not | |
860 | representable", then this could happen when `lukemftp' is used as the | |
861 | ftp client. This was reported to happen on Debian GNU/Linux 2.4.3 | |
862 | with `lukemftp' 1.5-5, but might happen on other systems as well. To | |
863 | avoid this problem, switch to using the standard ftp client. On a | |
864 | Debian system, type | |
865 | ||
866 | update-alternatives --config ftpd | |
867 | ||
868 | and then choose /usr/bin/netkit-ftp. | |
869 | ||
9f83d8b3 EZ |
870 | * Antivirus software interacts badly with the MS-Windows version of Emacs. |
871 | ||
872 | The usual manifestation of these problems is that subprocesses don't | |
873 | work or even wedge the entire system. In particular, "M-x shell RET" | |
874 | was reported to fail to work. But other commands also sometimes don't | |
875 | work when an antivirus package is installed. | |
876 | ||
877 | The solution is to switch the antivirus software to a less aggressive | |
878 | mode (e.g., disable the ``auto-protect'' feature), or even uninstall | |
879 | or disable it entirely. | |
880 | ||
f29d1e75 JR |
881 | * On Windows 95/98/ME, subprocesses do not terminate properly. |
882 | ||
883 | This is a limitation of the Operating System, and can cause problems | |
884 | when shutting down Windows. Ensure that all subprocesses are exited | |
885 | cleanly before exiting Emacs. For more details, see the FAQ at | |
886 | ftp://ftp.gnu.org/gnu/windows/emacs/doc/index.html | |
887 | ||
787994b7 DL |
888 | * Mail sent through Microsoft Exchange in some encodings appears to be |
889 | mangled and is not seen correctly in Rmail or Gnus. We don't know | |
890 | exactly what happens, but it isn't an Emacs problem in cases we've | |
891 | seen. | |
892 | ||
0a2eeca1 EZ |
893 | * After upgrading to a newer version of Emacs, the Meta key stops working. |
894 | ||
895 | This was reported to happen on a GNU/Linux system distributed by | |
896 | Mandrake. The reason is that the previous version of Emacs was | |
897 | modified by Mandrake to make the Alt key act as the Meta key, on a | |
898 | keyboard where the Windows key is the one which produces the Meta | |
899 | modifier. A user who started using a newer version of Emacs, which | |
900 | was not hacked by Mandrake, expected the Alt key to continue to act as | |
901 | Meta, and was astonished when that didn't happen. | |
902 | ||
903 | The solution is to find out what key on your keyboard produces the Meta | |
904 | modifier, and use that key instead. Try all of the keys to the left | |
905 | and to the right of the space bar, together with the `x' key, and see | |
906 | which combination produces "M-x" in the echo area. You can also use | |
907 | the `xmodmap' utility to show all the keys which produce a Meta | |
908 | modifier: | |
909 | ||
910 | xmodmap -pk | egrep -i "meta|alt" | |
911 | ||
912 | A more convenient way of finding out which keys produce a Meta modifier | |
913 | is to use the `xkbprint' utility, if it's available on your system: | |
914 | ||
915 | xkbprint 0:0 /tmp/k.ps | |
916 | ||
917 | This produces a PostScript file `/tmp/k.ps' with a picture of your | |
918 | keyboard; printing that file on a PostScript printer will show what | |
919 | keys can serve as Meta. | |
920 | ||
921 | The `xkeycaps' also shows a visual representation of the current | |
922 | keyboard settings. It also allows to modify them. | |
923 | ||
119d3665 DL |
924 | * On OSF/Dec Unix/Tru64/<whatever it is this year> under X locally or |
925 | remotely, M-SPC acts as a `compose' key with strange results. See | |
926 | keyboard(5). | |
927 | ||
928 | Changing Alt_L to Meta_L fixes it: | |
929 | % xmodmap -e 'keysym Alt_L = Meta_L Alt_L' | |
930 | % xmodmap -e 'keysym Alt_R = Meta_R Alt_R' | |
931 | ||
a933dad1 DL |
932 | * Error "conflicting types for `initstate'" compiling with GCC on Irix 6. |
933 | ||
934 | Install GCC 2.95 or a newer version, and this problem should go away. | |
935 | It is possible that this problem results from upgrading the operating | |
936 | system without reinstalling GCC; so you could also try reinstalling | |
937 | the same version of GCC, and telling us whether that fixes the problem. | |
938 | ||
0de9f9a8 EZ |
939 | * Emacs dumps core on Solaris in function IMCheckWindow. |
940 | ||
941 | This was reported to happen when Emacs runs with more than one frame, | |
942 | and one of them is closed, either with "C-x 5 0" or from the window | |
943 | manager. | |
944 | ||
945 | This bug was reported to Sun as | |
946 | ||
947 | Gtk apps dump core in ximlocal.so.2:IMCheckIMWindow() | |
948 | Bug Reports: 4463537 | |
949 | ||
2aa82bcf | 950 | Installing Solaris 8 patch 108773-12 for Sparc and 108774-12 for x86 |
0de9f9a8 EZ |
951 | reportedly fixes the bug, which appears to be inside the shared |
952 | library xiiimp.so. | |
953 | ||
954 | Alternatively, you can configure Emacs with `--with-xim=no' to prevent | |
955 | the core dump, but will loose X input method support, of course. (You | |
956 | can use Emacs's own input methods instead, if you install Leim.) | |
957 | ||
a933dad1 DL |
958 | * On Solaris 7, Emacs gets a segmentation fault when starting up using X. |
959 | ||
960 | This results from Sun patch 107058-01 (SunOS 5.7: Patch for | |
3156909f PE |
961 | assembler) if you use GCC version 2.7 or later. |
962 | To work around it, either install patch 106950-03 or later, | |
963 | or uninstall patch 107058-01, or install the GNU Binutils. | |
a933dad1 DL |
964 | Then recompile Emacs, and it should work. |
965 | ||
966 | * With X11R6.4, public-patch-3, Emacs crashes at startup. | |
967 | ||
968 | Reportedly this patch in X fixes the problem. | |
969 | ||
970 | --- xc/lib/X11/imInt.c~ Wed Jun 30 13:31:56 1999 | |
971 | +++ xc/lib/X11/imInt.c Thu Jul 1 15:10:27 1999 | |
972 | @@ -1,4 +1,4 @@ | |
973 | -/* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */ | |
974 | +/* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */ | |
975 | /****************************************************************** | |
976 | ||
977 | Copyright 1992, 1993, 1994 by FUJITSU LIMITED | |
978 | @@ -166,8 +166,8 @@ | |
979 | _XimMakeImName(lcd) | |
980 | XLCd lcd; | |
981 | { | |
982 | - char* begin; | |
983 | - char* end; | |
984 | + char* begin = NULL; | |
985 | + char* end = NULL; | |
986 | char* ret; | |
987 | int i = 0; | |
988 | char* ximmodifier = XIMMODIFIER; | |
989 | @@ -182,7 +182,11 @@ | |
990 | } | |
991 | ret = Xmalloc(end - begin + 2); | |
992 | if (ret != NULL) { | |
993 | - (void)strncpy(ret, begin, end - begin + 1); | |
994 | + if (begin != NULL) { | |
995 | + (void)strncpy(ret, begin, end - begin + 1); | |
996 | + } else { | |
997 | + ret[0] = '\0'; | |
998 | + } | |
999 | ret[end - begin + 1] = '\0'; | |
1000 | } | |
1001 | return ret; | |
1002 | ||
1003 | ||
a933dad1 DL |
1004 | * Emacs crashes on Irix 6.5 on the SGI R10K, when compiled with GCC. |
1005 | ||
1006 | This seems to be fixed in GCC 2.95. | |
1007 | ||
1008 | * Emacs crashes in utmpname on Irix 5.3. | |
1009 | ||
1010 | This problem is fixed in Patch 3175 for Irix 5.3. | |
1011 | It is also fixed in Irix versions 6.2 and up. | |
1012 | ||
de121241 EZ |
1013 | * The S-C-t key combination doesn't get passed to Emacs on X. |
1014 | ||
1015 | This happens because some X configurations assign the Ctrl-Shift-t | |
1016 | combination the same meaning as the Multi_key. The offending | |
1017 | definition is in the file `...lib/X11/locale/iso8859-1/Compose'; there | |
1018 | might be other similar combinations which are grabbed by X for similar | |
1019 | purposes. | |
1020 | ||
1021 | We think that this can be countermanded with the `xmodmap' utility, if | |
1022 | you want to be able to bind one of these key sequences within Emacs. | |
1023 | ||
a933dad1 DL |
1024 | * On Solaris, CTRL-t is ignored by Emacs when you use |
1025 | the fr.ISO-8859-15 locale (and maybe other related locales). | |
1026 | ||
1027 | You can fix this by editing the file: | |
1028 | ||
1029 | /usr/openwin/lib/locale/iso8859-15/Compose | |
1030 | ||
1031 | Near the bottom there is a line that reads: | |
1032 | ||
1033 | Ctrl<t> <quotedbl> <Y> : "\276" threequarters | |
1034 | ||
1035 | that should read: | |
1036 | ||
1037 | Ctrl<T> <quotedbl> <Y> : "\276" threequarters | |
1038 | ||
1039 | Note the lower case <t>. Changing this line should make C-t work. | |
1040 | ||
1041 | * Emacs on Digital Unix 4.0 fails to build, giving error message | |
1042 | Invalid dimension for the charset-ID 160 | |
1043 | ||
1044 | This is due to a bug or an installation problem in GCC 2.8.0. | |
1045 | Installing a more recent version of GCC fixes the problem. | |
1046 | ||
1047 | * Buffers from `with-output-to-temp-buffer' get set up in Help mode. | |
1048 | ||
1049 | Changes in Emacs 20.4 to the hooks used by that function cause | |
1050 | problems for some packages, specifically BBDB. See the function's | |
1051 | documentation for the hooks involved. BBDB 2.00.06 fixes the problem. | |
1052 | ||
1053 | * Under X, C-v and/or other keys don't work. | |
1054 | ||
1055 | These may have been intercepted by your window manager. In | |
1056 | particular, AfterStep 1.6 is reported to steal C-v in its default | |
1057 | configuration. Various Meta keys are also likely to be taken by the | |
1058 | configuration of the `feel'. See the WM's documentation for how to | |
1059 | change this. | |
1060 | ||
1061 | * When using Exceed, fonts sometimes appear too tall. | |
1062 | ||
1063 | When the display is set to an Exceed X-server and fonts are specified | |
1064 | (either explicitly with the -fn option or implicitly with X resources) | |
1065 | then the fonts may appear "too tall". The actual character sizes are | |
1066 | correct but there is too much vertical spacing between rows, which | |
1067 | gives the appearance of "double spacing". | |
1068 | ||
1069 | To prevent this, turn off the Exceed's "automatic font substitution" | |
1070 | feature (in the font part of the configuration window). | |
1071 | ||
a933dad1 DL |
1072 | * Failure in unexec while dumping emacs on Digital Unix 4.0 |
1073 | ||
1074 | This problem manifests itself as an error message | |
1075 | ||
1076 | unexec: Bad address, writing data section to ... | |
1077 | ||
1078 | The user suspects that this happened because his X libraries | |
1079 | were built for an older system version, | |
1080 | ||
1081 | ./configure --x-includes=/usr/include --x-libraries=/usr/shlib | |
1082 | ||
1083 | made the problem go away. | |
1084 | ||
1085 | * No visible display on mips-sgi-irix6.2 when compiling with GCC 2.8.1. | |
1086 | ||
1087 | This problem went away after installing the latest IRIX patches | |
1088 | as of 8 Dec 1998. | |
1089 | ||
1090 | The same problem has been reported on Irix 6.3. | |
1091 | ||
1092 | * As of version 20.4, Emacs doesn't work properly if configured for | |
1093 | the Motif toolkit and linked against the free LessTif library. The | |
1094 | next Emacs release is expected to work with LessTif. | |
1095 | ||
1096 | * Emacs gives the error, Couldn't find per display information. | |
1097 | ||
1098 | This can result if the X server runs out of memory because Emacs uses | |
1099 | a large number of fonts. On systems where this happens, C-h h is | |
1100 | likely to cause it. | |
1101 | ||
1102 | We do not know of a way to prevent the problem. | |
1103 | ||
1104 | * Emacs makes HPUX 11.0 crash. | |
1105 | ||
1106 | This is a bug in HPUX; HPUX patch PHKL_16260 is said to fix it. | |
1107 | ||
1108 | * Emacs crashes during dumping on the HPPA machine (HPUX 10.20). | |
1109 | ||
1110 | This seems to be due to a GCC bug; it is fixed in GCC 2.8.1. | |
1111 | ||
1112 | * The Hyperbole package causes *Help* buffers not to be displayed in | |
1113 | Help mode due to setting `temp-buffer-show-hook' rather than using | |
1114 | `add-hook'. Using `(add-hook 'temp-buffer-show-hook | |
1115 | 'help-mode-maybe)' after loading Hyperbole should fix this. | |
1116 | ||
1117 | * Versions of the PSGML package earlier than 1.0.3 (stable) or 1.1.2 | |
1118 | (alpha) fail to parse DTD files correctly in Emacs 20.3 and later. | |
1119 | Here is a patch for psgml-parse.el from PSGML 1.0.1 and, probably, | |
1120 | earlier versions. | |
1121 | ||
1122 | --- psgml-parse.el 1998/08/21 19:18:18 1.1 | |
1123 | +++ psgml-parse.el 1998/08/21 19:20:00 | |
1124 | @@ -2383,7 +2383,7 @@ (defun sgml-push-to-entity (entity &opti | |
1125 | (setq sgml-buffer-parse-state nil)) | |
1126 | (cond | |
1127 | ((stringp entity) ; a file name | |
1128 | - (save-excursion (insert-file-contents entity)) | |
1129 | + (insert-file-contents entity) | |
1130 | (setq default-directory (file-name-directory entity))) | |
1131 | ((consp (sgml-entity-text entity)) ; external id? | |
1132 | (let* ((extid (sgml-entity-text entity)) | |
1133 | ||
d238f982 EZ |
1134 | * Emacs 21 freezes when visiting a TeX file with AUC TeX installed. |
1135 | ||
1136 | Emacs 21 needs version 10 or later of AUC TeX; upgrading should solve | |
1137 | these problems. | |
1138 | ||
1139 | * Running TeX from AUC TeX package with Emacs 20.3 gives a Lisp error | |
a933dad1 DL |
1140 | about a read-only tex output buffer. |
1141 | ||
1142 | This problem appeared for AUC TeX version 9.9j and some earlier | |
1143 | versions. Here is a patch for the file tex-buf.el in the AUC TeX | |
1144 | package. | |
1145 | ||
1146 | diff -c auctex/tex-buf.el~ auctex/tex-buf.el | |
1147 | *** auctex/tex-buf.el~ Wed Jul 29 18:35:32 1998 | |
1148 | --- auctex/tex-buf.el Sat Sep 5 15:20:38 1998 | |
1149 | *************** | |
1150 | *** 545,551 **** | |
1151 | (dir (TeX-master-directory))) | |
1152 | (TeX-process-check file) ; Check that no process is running | |
1153 | (setq TeX-command-buffer (current-buffer)) | |
1154 | ! (with-output-to-temp-buffer buffer) | |
1155 | (set-buffer buffer) | |
1156 | (if dir (cd dir)) | |
1157 | (insert "Running `" name "' on `" file "' with ``" command "''\n") | |
1158 | - --- 545,552 ---- | |
1159 | (dir (TeX-master-directory))) | |
1160 | (TeX-process-check file) ; Check that no process is running | |
1161 | (setq TeX-command-buffer (current-buffer)) | |
1162 | ! (let (temp-buffer-show-function temp-buffer-show-hook) | |
1163 | ! (with-output-to-temp-buffer buffer)) | |
1164 | (set-buffer buffer) | |
1165 | (if dir (cd dir)) | |
1166 | (insert "Running `" name "' on `" file "' with ``" command "''\n") | |
1167 | ||
1168 | * On Irix 6.3, substituting environment variables in file names | |
1169 | in the minibuffer gives peculiar error messages such as | |
1170 | ||
1171 | Substituting nonexistent environment variable "" | |
1172 | ||
1173 | This is not an Emacs bug; it is caused by something in SGI patch | |
1174 | 003082 August 11, 1998. | |
1175 | ||
1176 | * After a while, Emacs slips into unibyte mode. | |
1177 | ||
1178 | The VM mail package, which is not part of Emacs, sometimes does | |
1179 | (standard-display-european t) | |
1180 | That should be changed to | |
1181 | (standard-display-european 1 t) | |
1182 | ||
1183 | * Installing Emacs gets an error running `install-info'. | |
1184 | ||
1185 | You need to install a recent version of Texinfo; that package | |
1186 | supplies the `install-info' command. | |
1187 | ||
1188 | * Emacs does not recognize the AltGr key, on HPUX. | |
1189 | ||
1190 | To fix this, set up a file ~/.dt/sessions/sessionetc with executable | |
1191 | rights, containing this text: | |
1192 | ||
1193 | -------------------------------- | |
1194 | xmodmap 2> /dev/null - << EOF | |
1195 | keysym Alt_L = Meta_L | |
1196 | keysym Alt_R = Meta_R | |
1197 | EOF | |
1198 | ||
1199 | xmodmap - << EOF | |
1200 | clear mod1 | |
1201 | keysym Mode_switch = NoSymbol | |
1202 | add mod1 = Meta_L | |
1203 | keysym Meta_R = Mode_switch | |
1204 | add mod2 = Mode_switch | |
1205 | EOF | |
1206 | -------------------------------- | |
1207 | ||
17a37d87 EZ |
1208 | * Emacs hangs on KDE when a large portion of text is killed. |
1209 | ||
62c485d2 GM |
1210 | This is caused by a bug in the KDE applet `klipper' which periodically |
1211 | requests the X clipboard contents from applications. Early versions | |
1212 | of klipper don't implement the ICCM protocol for large selections, | |
1213 | which leads to Emacs being flooded with selection requests. After a | |
1214 | while, Emacs will print a message: | |
17a37d87 EZ |
1215 | |
1216 | Timed out waiting for property-notify event | |
1217 | ||
62c485d2 | 1218 | A workaround is to not use `klipper'. |
17a37d87 | 1219 | |
a933dad1 DL |
1220 | * Emacs compiled with DJGPP for MS-DOS/MS-Windows cannot access files |
1221 | in the directory with the special name `dev' under the root of any | |
1222 | drive, e.g. `c:/dev'. | |
1223 | ||
1224 | This is an unfortunate side-effect of the support for Unix-style | |
1225 | device names such as /dev/null in the DJGPP runtime library. A | |
1226 | work-around is to rename the problem directory to another name. | |
1227 | ||
1228 | * M-SPC seems to be ignored as input. | |
1229 | ||
1230 | See if your X server is set up to use this as a command | |
1231 | for character composition. | |
1232 | ||
1233 | * Emacs startup on GNU/Linux systems (and possibly other systems) is slow. | |
1234 | ||
1235 | This can happen if the system is misconfigured and Emacs can't get the | |
1236 | full qualified domain name, FQDN. You should have your FQDN in the | |
1237 | /etc/hosts file, something like this: | |
1238 | ||
1239 | 127.0.0.1 localhost | |
1240 | 129.187.137.82 nuc04.t30.physik.tu-muenchen.de nuc04 | |
1241 | ||
1242 | The way to set this up may vary on non-GNU systems. | |
1243 | ||
1244 | * Garbled display on non-X terminals when Emacs runs on Digital Unix 4.0. | |
1245 | ||
1246 | So far it appears that running `tset' triggers this problem (when TERM | |
1247 | is vt100, at least). If you do not run `tset', then Emacs displays | |
1248 | properly. If someone can tell us precisely which effect of running | |
1249 | `tset' actually causes the problem, we may be able to implement a fix | |
1250 | in Emacs. | |
1251 | ||
1252 | * When you run Ispell from Emacs, it reports a "misalignment" error. | |
1253 | ||
3d00585e EZ |
1254 | This can happen if you compiled the Ispell program to use ASCII |
1255 | characters only and then try to use it from Emacs with non-ASCII | |
1256 | characters, like Latin-1. The solution is to recompile Ispell with | |
1257 | support for 8-bit characters. | |
a933dad1 | 1258 | |
3d00585e EZ |
1259 | To see whether your Ispell program supports 8-bit characters, type |
1260 | this at your shell's prompt: | |
1261 | ||
1262 | ispell -vv | |
1263 | ||
1264 | and look in the output for the string "NO8BIT". If Ispell says | |
1265 | "!NO8BIT (8BIT)", your speller supports 8-bit characters; otherwise it | |
1266 | does not. | |
1267 | ||
1268 | To rebuild Ispell with 8-bit character support, edit the local.h file | |
1269 | in the Ispell distribution and make sure it does _not_ define NO8BIT. | |
1270 | Then rebuild the speller. | |
1271 | ||
1272 | Another possible cause for "misalignment" error messages is that the | |
1273 | version of Ispell installed on your machine is old. Upgrade. | |
1274 | ||
1275 | Yet another possibility is that you are trying to spell-check a word | |
1276 | in a language that doesn't fit the dictionary you choose for use by | |
1277 | Ispell. (Ispell can only spell-check one language at a time, because | |
1278 | it uses a single dictionary.) Make sure that the text you are | |
1279 | spelling and the dictionary used by Ispell conform to each other. | |
a933dad1 DL |
1280 | |
1281 | * On Linux-based GNU systems using libc versions 5.4.19 through | |
1282 | 5.4.22, Emacs crashes at startup with a segmentation fault. | |
1283 | ||
1284 | This problem happens if libc defines the symbol __malloc_initialized. | |
1285 | One known solution is to upgrade to a newer libc version. 5.4.33 is | |
1286 | known to work. | |
1287 | ||
1288 | * On Windows, you cannot use the right-hand ALT key and the left-hand | |
1289 | CTRL key together to type a Control-Meta character. | |
1290 | ||
1291 | This is a consequence of a misfeature beyond Emacs's control. | |
1292 | ||
1293 | Under Windows, the AltGr key on international keyboards generates key | |
1294 | events with the modifiers Right-Alt and Left-Ctrl. Since Emacs cannot | |
1295 | distinguish AltGr from an explicit Right-Alt and Left-Ctrl | |
1296 | combination, whenever it sees Right-Alt and Left-Ctrl it assumes that | |
1297 | AltGr has been pressed. | |
1298 | ||
1299 | * Under some Windows X-servers, Emacs' display is incorrect | |
1300 | ||
1301 | The symptoms are that Emacs does not completely erase blank areas of the | |
1302 | screen during scrolling or some other screen operations (e.g., selective | |
1303 | display or when killing a region). M-x recenter will cause the screen | |
1304 | to be completely redisplayed and the "extra" characters will disappear. | |
1305 | ||
1306 | This is known to occur under Exceed 6, and possibly earlier versions as | |
1307 | well. The problem lies in the X-server settings. | |
1308 | ||
1309 | There are reports that you can solve the problem with Exceed by | |
1310 | running `Xconfig' from within NT, choosing "X selection", then | |
1311 | un-checking the boxes "auto-copy X selection" and "auto-paste to X | |
1312 | selection". | |
1313 | ||
1314 | Of this does not work, please inform bug-gnu-emacs@gnu.org. Then | |
1315 | please call support for your X-server and see if you can get a fix. | |
1316 | If you do, please send it to bug-gnu-emacs@gnu.org so we can list it | |
1317 | here. | |
1318 | ||
1319 | * On Solaris 2, Emacs dumps core when built with Motif. | |
1320 | ||
1321 | The Solaris Motif libraries are buggy, at least up through Solaris 2.5.1. | |
1322 | Install the current Motif runtime library patch appropriate for your host. | |
1323 | (Make sure the patch is current; some older patch versions still have the bug.) | |
1324 | You should install the other patches recommended by Sun for your host, too. | |
1325 | You can obtain Sun patches from ftp://sunsolve.sun.com/pub/patches/; | |
1326 | look for files with names ending in `.PatchReport' to see which patches | |
1327 | are currently recommended for your host. | |
1328 | ||
1329 | On Solaris 2.6, Emacs is said to work with Motif when Solaris patch | |
1330 | 105284-12 is installed, but fail when 105284-15 is installed. | |
1331 | 105284-18 might fix it again. | |
1332 | ||
3156909f PE |
1333 | * On Solaris 2.6 and 7, the Compose key does not work. |
1334 | ||
1335 | This is a bug in Motif in Solaris. Supposedly it has been fixed for | |
1336 | the next major release of Solaris. However, if someone with Sun | |
1337 | support complains to Sun about the bug, they may release a patch. | |
1338 | If you do this, mention Sun bug #4188711. | |
a933dad1 DL |
1339 | |
1340 | One workaround is to use a locale that allows non-ASCII characters. | |
1341 | For example, before invoking emacs, set the LC_ALL environment | |
1342 | variable to "en_US" (American English). The directory /usr/lib/locale | |
1343 | lists the supported locales; any locale other than "C" or "POSIX" | |
1344 | should do. | |
1345 | ||
3156909f PE |
1346 | pen@lysator.liu.se says (Feb 1998) that the Compose key does work |
1347 | if you link with the MIT X11 libraries instead of the Solaris X11 | |
1348 | libraries. | |
a933dad1 DL |
1349 | |
1350 | * Emacs does not know your host's fully-qualified domain name. | |
1351 | ||
1352 | You need to configure your machine with a fully qualified domain name, | |
1353 | either in /etc/hosts, /etc/hostname, the NIS, or wherever your system | |
1354 | calls for specifying this. | |
1355 | ||
1356 | If you cannot fix the configuration, you can set the Lisp variable | |
1357 | mail-host-address to the value you want. | |
1358 | ||
1359 | * Error 12 (virtual memory exceeded) when dumping Emacs, on UnixWare 2.1 | |
1360 | ||
1361 | Paul Abrahams (abrahams@acm.org) reports that with the installed | |
1362 | virtual memory settings for UnixWare 2.1.2, an Error 12 occurs during | |
1363 | the "make" that builds Emacs, when running temacs to dump emacs. That | |
1364 | error indicates that the per-process virtual memory limit has been | |
1365 | exceeded. The default limit is probably 32MB. Raising the virtual | |
1366 | memory limit to 40MB should make it possible to finish building Emacs. | |
1367 | ||
1368 | You can do this with the command `ulimit' (sh) or `limit' (csh). | |
1369 | But you have to be root to do it. | |
1370 | ||
1371 | According to Martin Sohnius, you can also retune this in the kernel: | |
1372 | ||
1373 | # /etc/conf/bin/idtune SDATLIM 33554432 ## soft data size limit | |
1374 | # /etc/conf/bin/idtune HDATLIM 33554432 ## hard " | |
1375 | # /etc/conf/bin/idtune SVMMSIZE unlimited ## soft process size limit | |
1376 | # /etc/conf/bin/idtune HVMMSIZE unlimited ## hard " | |
1377 | # /etc/conf/bin/idbuild -B | |
1378 | ||
1379 | (He recommends you not change the stack limit, though.) | |
1380 | These changes take effect when you reboot. | |
1381 | ||
1382 | * Redisplay using X11 is much slower than previous Emacs versions. | |
1383 | ||
1384 | We've noticed that certain X servers draw the text much slower when | |
1385 | scroll bars are on the left. We don't know why this happens. If this | |
1386 | happens to you, you can work around it by putting the scroll bars | |
1387 | on the right (as they were in Emacs 19). | |
1388 | ||
1389 | Here's how to do this: | |
1390 | ||
1391 | (set-scroll-bar-mode 'right) | |
1392 | ||
1393 | If you're not sure whether (or how much) this problem affects you, | |
1394 | try that and see how much difference it makes. To set things back | |
1395 | to normal, do | |
1396 | ||
1397 | (set-scroll-bar-mode 'left) | |
1398 | ||
1399 | * Under X11, some characters appear as hollow boxes. | |
1400 | ||
1401 | Each X11 font covers just a fraction of the characters that Emacs | |
1402 | supports. To display the whole range of Emacs characters requires | |
1403 | many different fonts, collected into a fontset. | |
1404 | ||
1405 | If some of the fonts called for in your fontset do not exist on your X | |
1406 | server, then the characters that have no font appear as hollow boxes. | |
1407 | You can remedy the problem by installing additional fonts. | |
1408 | ||
1409 | The intlfonts distribution includes a full spectrum of fonts that can | |
1410 | display all the characters Emacs supports. | |
1411 | ||
4c635a29 DL |
1412 | Another cause of this for specific characters is fonts which have a |
1413 | missing glyph and no default character. This is known ot occur for | |
1414 | character number 160 (no-break space) in some fonts, such as Lucida | |
1415 | but Emacs sets the display table for the unibyte and Latin-1 version | |
1416 | of this character to display a space. | |
1417 | ||
a933dad1 DL |
1418 | * Under X11, some characters appear improperly aligned in their lines. |
1419 | ||
1420 | You may have bad X11 fonts; try installing the intlfonts distribution. | |
1421 | ||
1422 | * Certain fonts make each line take one pixel more than it "should". | |
1423 | ||
1424 | This is because these fonts contain characters a little taller | |
1425 | than the font's nominal height. Emacs needs to make sure that | |
1426 | lines do not overlap. | |
1427 | ||
1428 | * You request inverse video, and the first Emacs frame is in inverse | |
1429 | video, but later frames are not in inverse video. | |
1430 | ||
1431 | This can happen if you have an old version of the custom library in | |
1432 | your search path for Lisp packages. Use M-x list-load-path-shadows to | |
1433 | check whether this is true. If it is, delete the old custom library. | |
1434 | ||
1435 | * In FreeBSD 2.1.5, useless symbolic links remain in /tmp or other | |
1436 | directories that have the +t bit. | |
1437 | ||
1438 | This is because of a kernel bug in FreeBSD 2.1.5 (fixed in 2.2). | |
1439 | Emacs uses symbolic links to implement file locks. In a directory | |
1440 | with +t bit, the directory owner becomes the owner of the symbolic | |
1441 | link, so that it cannot be removed by anyone else. | |
1442 | ||
1443 | If you don't like those useless links, you can let Emacs not to using | |
1444 | file lock by adding #undef CLASH_DETECTION to config.h. | |
1445 | ||
1446 | * When using M-x dbx with the SparcWorks debugger, the `up' and `down' | |
1447 | commands do not move the arrow in Emacs. | |
1448 | ||
1449 | You can fix this by adding the following line to `~/.dbxinit': | |
1450 | ||
1451 | dbxenv output_short_file_name off | |
1452 | ||
1453 | * Emacs says it has saved a file, but the file does not actually | |
1454 | appear on disk. | |
1455 | ||
1456 | This can happen on certain systems when you are using NFS, if the | |
1457 | remote disk is full. It is due to a bug in NFS (or certain NFS | |
1458 | implementations), and there is apparently nothing Emacs can do to | |
1459 | detect the problem. Emacs checks the failure codes of all the system | |
1460 | calls involved in writing a file, including `close'; but in the case | |
1461 | where the problem occurs, none of those system calls fails. | |
1462 | ||
1463 | * "Compose Character" key does strange things when used as a Meta key. | |
1464 | ||
1465 | If you define one key to serve as both Meta and Compose Character, you | |
1466 | will get strange results. In previous Emacs versions, this "worked" | |
1467 | in that the key acted as Meta--that's because the older Emacs versions | |
1468 | did not try to support Compose Character. Now Emacs tries to do | |
1469 | character composition in the standard X way. This means that you | |
1470 | must pick one meaning or the other for any given key. | |
1471 | ||
1472 | You can use both functions (Meta, and Compose Character) if you assign | |
1473 | them to two different keys. | |
1474 | ||
1475 | * Emacs gets a segmentation fault at startup, on AIX4.2. | |
1476 | ||
1477 | If you are using IBM's xlc compiler, compile emacs.c | |
1478 | without optimization; that should avoid the problem. | |
1479 | ||
1480 | * movemail compiled with POP support can't connect to the POP server. | |
1481 | ||
1482 | Make sure that the `pop' entry in /etc/services, or in the services | |
1483 | NIS map if your machine uses NIS, has the same port number as the | |
1484 | entry on the POP server. A common error is for the POP server to be | |
1485 | listening on port 110, the assigned port for the POP3 protocol, while | |
1486 | the client is trying to connect on port 109, the assigned port for the | |
1487 | old POP protocol. | |
1488 | ||
1489 | * Emacs crashes in x-popup-dialog. | |
1490 | ||
1491 | This can happen if the dialog widget cannot find the font it wants to | |
1492 | use. You can work around the problem by specifying another font with | |
1493 | an X resource--for example, `Emacs.dialog*.font: 9x15' (or any font that | |
1494 | happens to exist on your X server). | |
1495 | ||
1496 | * Emacs crashes when you use Bibtex mode. | |
1497 | ||
1498 | This happens if your system puts a small limit on stack size. You can | |
1499 | prevent the problem by using a suitable shell command (often `ulimit') | |
1500 | to raise the stack size limit before you run Emacs. | |
1501 | ||
1502 | Patches to raise the stack size limit automatically in `main' | |
1503 | (src/emacs.c) on various systems would be greatly appreciated. | |
1504 | ||
1505 | * Emacs crashes with SIGBUS or SIGSEGV on HPUX 9 after you delete a frame. | |
1506 | ||
1507 | We think this is due to a bug in the X libraries provided by HP. With | |
1508 | the alternative X libraries in /usr/contrib/mitX11R5/lib, the problem | |
1509 | does not happen. | |
1510 | ||
1511 | * Emacs crashes with SIGBUS or SIGSEGV on Solaris after you delete a frame. | |
1512 | ||
1513 | We suspect that this is a similar bug in the X libraries provided by | |
1514 | Sun. There is a report that one of these patches fixes the bug and | |
1515 | makes the problem stop: | |
1516 | ||
1517 | 105216-01 105393-01 105518-01 105621-01 105665-01 105615-02 105216-02 | |
1518 | 105667-01 105401-08 105615-03 105621-02 105686-02 105736-01 105755-03 | |
1519 | 106033-01 105379-01 105786-01 105181-04 105379-03 105786-04 105845-01 | |
1520 | 105284-05 105669-02 105837-01 105837-02 105558-01 106125-02 105407-01 | |
1521 | ||
1522 | Another person using a newer system (kernel patch level Generic_105181-06) | |
1523 | suspects that the bug was fixed by one of these more recent patches: | |
1524 | ||
1525 | 106040-07 SunOS 5.6: X Input & Output Method patch | |
1526 | 106222-01 OpenWindows 3.6: filemgr (ff.core) fixes | |
1527 | 105284-12 Motif 1.2.7: sparc Runtime library patch | |
1528 | ||
1529 | * Problems running Perl under Emacs on Windows NT/95. | |
1530 | ||
1531 | `perl -de 0' just hangs when executed in an Emacs subshell. | |
1532 | The fault lies with Perl (indirectly with Windows NT/95). | |
1533 | ||
1534 | The problem is that the Perl debugger explicitly opens a connection to | |
1535 | "CON", which is the DOS/NT equivalent of "/dev/tty", for interacting | |
1536 | with the user. | |
1537 | ||
1538 | On Unix, this is okay, because Emacs (or the shell?) creates a | |
1539 | pseudo-tty so that /dev/tty is really the pipe Emacs is using to | |
1540 | communicate with the subprocess. | |
1541 | ||
1542 | On NT, this fails because CON always refers to the handle for the | |
1543 | relevant console (approximately equivalent to a tty), and cannot be | |
1544 | redirected to refer to the pipe Emacs assigned to the subprocess as | |
1545 | stdin. | |
1546 | ||
1547 | A workaround is to modify perldb.pl to use STDIN/STDOUT instead of CON. | |
1548 | ||
1549 | For Perl 4: | |
1550 | ||
1551 | *** PERL/LIB/PERLDB.PL.orig Wed May 26 08:24:18 1993 | |
1552 | --- PERL/LIB/PERLDB.PL Mon Jul 01 15:28:16 1996 | |
1553 | *************** | |
1554 | *** 68,74 **** | |
1555 | $rcfile=".perldb"; | |
1556 | } | |
1557 | else { | |
1558 | ! $console = "con"; | |
1559 | $rcfile="perldb.ini"; | |
1560 | } | |
1561 | ||
1562 | --- 68,74 ---- | |
1563 | $rcfile=".perldb"; | |
1564 | } | |
1565 | else { | |
1566 | ! $console = ""; | |
1567 | $rcfile="perldb.ini"; | |
1568 | } | |
1569 | ||
1570 | ||
1571 | For Perl 5: | |
1572 | *** perl/5.001/lib/perl5db.pl.orig Sun Jun 04 21:13:40 1995 | |
1573 | --- perl/5.001/lib/perl5db.pl Mon Jul 01 17:00:08 1996 | |
1574 | *************** | |
1575 | *** 22,28 **** | |
1576 | $rcfile=".perldb"; | |
1577 | } | |
1578 | elsif (-e "con") { | |
1579 | ! $console = "con"; | |
1580 | $rcfile="perldb.ini"; | |
1581 | } | |
1582 | else { | |
1583 | --- 22,28 ---- | |
1584 | $rcfile=".perldb"; | |
1585 | } | |
1586 | elsif (-e "con") { | |
1587 | ! $console = ""; | |
1588 | $rcfile="perldb.ini"; | |
1589 | } | |
1590 | else { | |
1591 | ||
1592 | * Problems running DOS programs on Windows NT versions earlier than 3.51. | |
1593 | ||
1594 | Some DOS programs, such as pkzip/pkunzip will not work at all, while | |
1595 | others will only work if their stdin is redirected from a file or NUL. | |
1596 | ||
1597 | When a DOS program does not work, a new process is actually created, but | |
1598 | hangs. It cannot be interrupted from Emacs, and might need to be killed | |
1599 | by an external program if Emacs is hung waiting for the process to | |
1600 | finish. If Emacs is not waiting for it, you should be able to kill the | |
1601 | instance of ntvdm that is running the hung process from Emacs, if you | |
1602 | can find out the process id. | |
1603 | ||
1604 | It is safe to run most DOS programs using call-process (eg. M-! and | |
1605 | M-|) since stdin is then redirected from a file, but not with | |
1606 | start-process since that redirects stdin to a pipe. Also, running DOS | |
1607 | programs in a shell buffer prompt without redirecting stdin does not | |
1608 | work. | |
1609 | ||
1610 | * Problems on MS-DOG if DJGPP v2.0 is used to compile Emacs: | |
1611 | ||
1612 | There are two DJGPP library bugs which cause problems: | |
1613 | ||
1614 | * Running `shell-command' (or `compile', or `grep') you get | |
1615 | `Searching for program: permission denied (EACCES), c:/command.com'; | |
1616 | * After you shell to DOS, Ctrl-Break kills Emacs. | |
1617 | ||
1618 | To work around these bugs, you can use two files in the msdos | |
1619 | subdirectory: `is_exec.c' and `sigaction.c'. Compile them and link | |
1620 | them into the Emacs executable `temacs'; then they will replace the | |
1621 | incorrect library functions. | |
1622 | ||
f1e54ce1 EZ |
1623 | * When compiling with DJGPP on Windows NT, "config msdos" fails. |
1624 | ||
1625 | If the error message is "VDM has been already loaded", this is because | |
1626 | Windows has a program called `redir.exe' that is incompatible with a | |
1627 | program by the same name supplied with DJGPP, which is used by | |
1628 | config.bat. To resolve this, move the DJGPP's `bin' subdirectory to | |
1629 | the front of your PATH environment variable. | |
1630 | ||
a933dad1 DL |
1631 | * When compiling with DJGPP on Windows 95, Make fails for some targets |
1632 | like make-docfile. | |
1633 | ||
1634 | This can happen if long file name support (the setting of environment | |
1635 | variable LFN) when Emacs distribution was unpacked and during | |
1636 | compilation are not the same. See the MSDOG section of INSTALL for | |
1637 | the explanation of how to avoid this problem. | |
1638 | ||
1639 | * Emacs compiled for MSDOS cannot find some Lisp files, or other | |
1640 | run-time support files, when long filename support is enabled. | |
a01325b8 EZ |
1641 | |
1642 | Usually, this problem will manifest itself when Emacs exits | |
a933dad1 DL |
1643 | immediately after flashing the startup screen, because it cannot find |
1644 | the Lisp files it needs to load at startup. Redirect Emacs stdout | |
a01325b8 EZ |
1645 | and stderr to a file to see the error message printed by Emacs. |
1646 | ||
1647 | Another manifestation of this problem is that Emacs is unable to load | |
1648 | the support for editing program sources in languages such as C and | |
1649 | Lisp. | |
a933dad1 DL |
1650 | |
1651 | This can happen if the Emacs distribution was unzipped without LFN | |
1652 | support, thus causing long filenames to be truncated to the first 6 | |
1653 | characters and a numeric tail that Windows 95 normally attaches to it. | |
1654 | You should unzip the files again with a utility that supports long | |
1655 | filenames (such as djtar from DJGPP or InfoZip's UnZip program | |
1656 | compiled with DJGPP v2). The MSDOG section of the file INSTALL | |
1657 | explains this issue in more detail. | |
1658 | ||
a01325b8 EZ |
1659 | Another possible reason for such failures is that Emacs compiled for |
1660 | MSDOS is used on Windows NT, where long file names are not supported | |
1661 | by this version of Emacs, but the distribution was unpacked by an | |
1662 | unzip program that preserved the long file names instead of truncating | |
1663 | them to DOS 8+3 limits. To be useful on NT, the MSDOS port of Emacs | |
1664 | must be unzipped by a DOS utility, so that long file names are | |
1665 | properly truncated. | |
1666 | ||
a933dad1 DL |
1667 | * Emacs compiled with DJGPP complains at startup: |
1668 | ||
1669 | "Wrong type of argument: internal-facep, msdos-menu-active-face" | |
1670 | ||
1671 | This can happen if you define an environment variable `TERM'. Emacs | |
1672 | on MSDOS uses an internal terminal emulator which is disabled if the | |
1673 | value of `TERM' is anything but the string "internal". Emacs then | |
1674 | works as if its terminal were a dumb glass teletype that doesn't | |
1675 | support faces. To work around this, arrange for `TERM' to be | |
1676 | undefined when Emacs runs. The best way to do that is to add an | |
1677 | [emacs] section to the DJGPP.ENV file which defines an empty value for | |
1678 | `TERM'; this way, only Emacs gets the empty value, while the rest of | |
1679 | your system works as before. | |
1680 | ||
1681 | * On Windows 95, Alt-f6 does not get through to Emacs. | |
1682 | ||
1683 | This character seems to be trapped by the kernel in Windows 95. | |
1684 | You can enter M-f6 by typing ESC f6. | |
1685 | ||
1686 | * Typing Alt-Shift has strange effects on Windows 95. | |
1687 | ||
1688 | This combination of keys is a command to change keyboard layout. If | |
1689 | you proceed to type another non-modifier key before you let go of Alt | |
1690 | and Shift, the Alt and Shift act as modifiers in the usual way. | |
1691 | ||
1692 | * `tparam' reported as a multiply-defined symbol when linking with ncurses. | |
1693 | ||
1694 | This problem results from an incompatible change in ncurses, in | |
1695 | version 1.9.9e approximately. This version is unable to provide a | |
1696 | definition of tparm without also defining tparam. This is also | |
1697 | incompatible with Terminfo; as a result, the Emacs Terminfo support | |
1698 | does not work with this version of ncurses. | |
1699 | ||
1700 | The fix is to install a newer version of ncurses, such as version 4.2. | |
1701 | ||
1702 | * Strange results from format %d in a few cases, on a Sun. | |
1703 | ||
1704 | Sun compiler version SC3.0 has been found to miscompile part of | |
1705 | editfns.c. The workaround is to compile with some other compiler such | |
1706 | as GCC. | |
1707 | ||
1708 | * Output from subprocess (such as man or diff) is randomly truncated | |
1709 | on GNU/Linux systems. | |
1710 | ||
1711 | This is due to a kernel bug which seems to be fixed in Linux version | |
1712 | 1.3.75. | |
1713 | ||
1714 | * Error messages `internal facep []' happen on GNU/Linux systems. | |
1715 | ||
1716 | There is a report that replacing libc.so.5.0.9 with libc.so.5.2.16 | |
1717 | caused this to start happening. People are not sure why, but the | |
1718 | problem seems unlikely to be in Emacs itself. Some suspect that it | |
1719 | is actually Xlib which won't work with libc.so.5.2.16. | |
1720 | ||
1721 | Using the old library version is a workaround. | |
1722 | ||
1723 | * On Solaris, Emacs crashes if you use (display-time). | |
1724 | ||
1725 | This can happen if you configure Emacs without specifying the precise | |
1726 | version of Solaris that you are using. | |
1727 | ||
1728 | * Emacs dumps core on startup, on Solaris. | |
1729 | ||
1730 | Bill Sebok says that the cause of this is Solaris 2.4 vendor patch | |
1731 | 102303-05, which extends the Solaris linker to deal with the Solaris | |
1732 | Common Desktop Environment's linking needs. You can fix the problem | |
1733 | by removing this patch and installing patch 102049-02 instead. | |
1734 | However, that linker version won't work with CDE. | |
1735 | ||
1736 | Solaris 2.5 comes with a linker that has this bug. It is reported that if | |
1737 | you install all the latest patches (as of June 1996), the bug is fixed. | |
1738 | We suspect the crucial patch is one of these, but we don't know | |
1739 | for certain. | |
1740 | ||
1741 | 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes) | |
1742 | 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes) | |
1743 | 103242-04: [README] SunOS 5.5: linker patch (595363 bytes) | |
1744 | ||
1745 | (One user reports that the bug was fixed by those patches together | |
1746 | with patches 102980-04, 103279-01, 103300-02, and 103468-01.) | |
1747 | ||
1748 | If you can determine which patch does fix the bug, please tell | |
1749 | bug-gnu-emacs@gnu.org. | |
1750 | ||
1751 | Meanwhile, the GNU linker links Emacs properly on both Solaris 2.4 and | |
1752 | Solaris 2.5. | |
1753 | ||
1754 | * Emacs dumps core if lisp-complete-symbol is called, on Solaris. | |
1755 | ||
1756 | If you compile Emacs with the -fast or -xO4 option with version 3.0.2 | |
1757 | of the Sun C compiler, Emacs dumps core when lisp-complete-symbol is | |
1758 | called. The problem does not happen if you compile with GCC. | |
1759 | ||
1760 | * "Cannot find callback list" messages from dialog boxes on HPUX, in | |
1761 | Emacs built with Motif. | |
1762 | ||
1763 | This problem resulted from a bug in GCC 2.4.5. Newer GCC versions | |
1764 | such as 2.7.0 fix the problem. | |
1765 | ||
1766 | * On Irix 6.0, make tries (and fails) to build a program named unexelfsgi | |
1767 | ||
1768 | A compiler bug inserts spaces into the string "unexelfsgi . o" | |
1769 | in src/Makefile. Edit src/Makefile, after configure is run, | |
1770 | find that string, and take out the spaces. | |
1771 | ||
1772 | Compiler fixes in Irix 6.0.1 should eliminate this problem. | |
1773 | ||
1774 | * "out of virtual swap space" on Irix 5.3 | |
1775 | ||
1776 | This message occurs when the system runs out of swap space due to too | |
1777 | many large programs running. The solution is either to provide more | |
1778 | swap space or to reduce the number of large programs being run. You | |
1779 | can check the current status of the swap space by executing the | |
1780 | command `swap -l'. | |
1781 | ||
1782 | You can increase swap space by changing the file /etc/fstab. Adding a | |
1783 | line like this: | |
1784 | ||
1785 | /usr/swap/swap.more swap swap pri=3 0 0 | |
1786 | ||
1787 | where /usr/swap/swap.more is a file previously created (for instance | |
1788 | by using /etc/mkfile), will increase the swap space by the size of | |
1789 | that file. Execute `swap -m' or reboot the machine to activate the | |
1790 | new swap area. See the manpages for `swap' and `fstab' for further | |
1791 | information. | |
1792 | ||
1793 | The objectserver daemon can use up lots of memory because it can be | |
1794 | swamped with NIS information. It collects information about all users | |
1795 | on the network that can log on to the host. | |
1796 | ||
1797 | If you want to disable the objectserver completely, you can execute | |
1798 | the command `chkconfig objectserver off' and reboot. That may disable | |
1799 | some of the window system functionality, such as responding CDROM | |
1800 | icons. | |
1801 | ||
1802 | You can also remove NIS support from the objectserver. The SGI `admin' | |
1803 | FAQ has a detailed description on how to do that; see question 35 | |
1804 | ("Why isn't the objectserver working?"). The admin FAQ can be found at | |
1805 | ftp://viz.tamu.edu/pub/sgi/faq/. | |
1806 | ||
1807 | * With certain fonts, when the cursor appears on a character, the | |
1808 | character doesn't appear--you get a solid box instead. | |
1809 | ||
1810 | One user on a Linux-based GNU system reported that this problem went | |
1811 | away with installation of a new X server. The failing server was | |
1812 | XFree86 3.1.1. XFree86 3.1.2 works. | |
1813 | ||
1814 | * On SunOS 4.1.3, Emacs unpredictably crashes in _yp_dobind_soft. | |
1815 | ||
1816 | This happens if you configure Emacs specifying just `sparc-sun-sunos4' | |
1817 | on a system that is version 4.1.3. You must specify the precise | |
1818 | version number (or let configure figure out the configuration, which | |
1819 | it can do perfectly well for SunOS). | |
1820 | ||
1821 | * On SunOS 4, Emacs processes keep going after you kill the X server | |
1822 | (or log out, if you logged in using X). | |
1823 | ||
1824 | Someone reported that recompiling with GCC 2.7.0 fixed this problem. | |
1825 | ||
1826 | * On AIX 4, some programs fail when run in a Shell buffer | |
1827 | with an error message like No terminfo entry for "unknown". | |
1828 | ||
1829 | On AIX, many terminal type definitions are not installed by default. | |
1830 | `unknown' is one of them. Install the "Special Generic Terminal | |
1831 | Definitions" to make them defined. | |
1832 | ||
1833 | * On SunOS, you get linker errors | |
1834 | ld: Undefined symbol | |
1835 | _get_wmShellWidgetClass | |
1836 | _get_applicationShellWidgetClass | |
1837 | ||
1838 | The fix to this is to install patch 100573 for OpenWindows 3.0 | |
1839 | or link libXmu statically. | |
1840 | ||
1841 | * On AIX 4.1.2, linker error messages such as | |
1842 | ld: 0711-212 SEVERE ERROR: Symbol .__quous, found in the global symbol table | |
1843 | of archive /usr/lib/libIM.a, was not defined in archive member shr.o. | |
1844 | ||
1845 | This is a problem in libIM.a. You can work around it by executing | |
1846 | these shell commands in the src subdirectory of the directory where | |
1847 | you build Emacs: | |
1848 | ||
1849 | cp /usr/lib/libIM.a . | |
1850 | chmod 664 libIM.a | |
1851 | ranlib libIM.a | |
1852 | ||
1853 | Then change -lIM to ./libIM.a in the command to link temacs (in | |
1854 | Makefile). | |
1855 | ||
1856 | * Unpredictable segmentation faults on Solaris 2.3 and 2.4. | |
1857 | ||
1858 | A user reported that this happened in 19.29 when it was compiled with | |
1859 | the Sun compiler, but not when he recompiled with GCC 2.7.0. | |
1860 | ||
1861 | We do not know whether something in Emacs is partly to blame for this. | |
1862 | ||
1863 | * Emacs exits with "X protocol error" when run with an X server for | |
1864 | Windows. | |
1865 | ||
1866 | A certain X server for Windows had a bug which caused this. | |
1867 | Supposedly the newer 32-bit version of this server doesn't have the | |
1868 | problem. | |
1869 | ||
1870 | * Emacs crashes at startup on MSDOS. | |
1871 | ||
1872 | Some users report that Emacs 19.29 requires dpmi memory management, | |
1873 | and crashes on startup if the system does not have it. We don't yet | |
1874 | know why this happens--perhaps these machines don't have enough real | |
1875 | memory, or perhaps something is wrong in Emacs or the compiler. | |
1876 | However, arranging to use dpmi support is a workaround. | |
1877 | ||
1878 | You can find out if you have a dpmi host by running go32 without | |
1879 | arguments; it will tell you if it uses dpmi memory. For more | |
1880 | information about dpmi memory, consult the djgpp FAQ. (djgpp | |
1881 | is the GNU C compiler as packaged for MSDOS.) | |
1882 | ||
1883 | Compiling Emacs under MSDOS is extremely sensitive for proper memory | |
1884 | configuration. If you experience problems during compilation, consider | |
1885 | removing some or all memory resident programs (notably disk caches) | |
1886 | and make sure that your memory managers are properly configured. See | |
1887 | the djgpp faq for configuration hints. | |
1888 | ||
1889 | * A position you specified in .Xdefaults is ignored, using twm. | |
1890 | ||
1891 | twm normally ignores "program-specified" positions. | |
1892 | You can tell it to obey them with this command in your `.twmrc' file: | |
1893 | ||
1894 | UsePPosition "on" #allow clients to request a position | |
1895 | ||
1896 | * Compiling lib-src says there is no rule to make test-distrib.c. | |
1897 | ||
1898 | This results from a bug in a VERY old version of GNU Sed. To solve | |
1899 | the problem, install the current version of GNU Sed, then rerun | |
1900 | Emacs's configure script. | |
1901 | ||
1902 | * Compiling wakeup, in lib-src, says it can't make wakeup.c. | |
1903 | ||
1904 | This results from a bug in GNU Sed version 2.03. To solve the | |
1905 | problem, install the current version of GNU Sed, then rerun Emacs's | |
1906 | configure script. | |
1907 | ||
1908 | * On Sunos 4.1.1, there are errors compiling sysdep.c. | |
1909 | ||
1910 | If you get errors such as | |
1911 | ||
1912 | "sysdep.c", line 2017: undefined structure or union | |
1913 | "sysdep.c", line 2017: undefined structure or union | |
1914 | "sysdep.c", line 2019: nodename undefined | |
1915 | ||
1916 | This can result from defining LD_LIBRARY_PATH. It is very tricky | |
1917 | to use that environment variable with Emacs. The Emacs configure | |
1918 | script links many test programs with the system libraries; you must | |
1919 | make sure that the libraries available to configure are the same | |
1920 | ones available when you build Emacs. | |
1921 | ||
1922 | * The right Alt key works wrong on German HP keyboards (and perhaps | |
1923 | other non-English HP keyboards too). | |
1924 | ||
1925 | This is because HPUX defines the modifiers wrong in X. Here is a | |
1926 | shell script to fix the problem; be sure that it is run after VUE | |
1927 | configures the X server. | |
1928 | ||
1929 | xmodmap 2> /dev/null - << EOF | |
1930 | keysym Alt_L = Meta_L | |
1931 | keysym Alt_R = Meta_R | |
1932 | EOF | |
1933 | ||
1934 | xmodmap - << EOF | |
1935 | clear mod1 | |
1936 | keysym Mode_switch = NoSymbol | |
1937 | add mod1 = Meta_L | |
1938 | keysym Meta_R = Mode_switch | |
1939 | add mod2 = Mode_switch | |
1940 | EOF | |
1941 | ||
1942 | * The Emacs window disappears when you type M-q. | |
1943 | ||
1944 | Some versions of the Open Look window manager interpret M-q as a quit | |
1945 | command for whatever window you are typing at. If you want to use | |
1946 | Emacs with that window manager, you should try to configure the window | |
1947 | manager to use some other command. You can disable the | |
1948 | shortcut keys entirely by adding this line to ~/.OWdefaults: | |
1949 | ||
1950 | OpenWindows.WindowMenuAccelerators: False | |
1951 | ||
1952 | * Emacs does not notice when you release the mouse. | |
1953 | ||
1954 | There are reports that this happened with (some) Microsoft mice and | |
1955 | that replacing the mouse made it stop. | |
1956 | ||
1957 | * Trouble using ptys on IRIX, or running out of ptys. | |
1958 | ||
1959 | The program mkpts (which may be in `/usr/adm' or `/usr/sbin') needs to | |
1960 | be set-UID to root, or non-root programs like Emacs will not be able | |
1961 | to allocate ptys reliably. | |
1962 | ||
1963 | * On Irix 5.2, unexelfsgi.c can't find cmplrs/stsupport.h. | |
1964 | ||
1965 | The file cmplrs/stsupport.h was included in the wrong file set in the | |
1966 | Irix 5.2 distribution. You can find it in the optional fileset | |
1967 | compiler_dev, or copy it from some other Irix 5.2 system. A kludgy | |
1968 | workaround is to change unexelfsgi.c to include sym.h instead of | |
1969 | syms.h. | |
1970 | ||
1971 | * Slow startup on Linux-based GNU systems. | |
1972 | ||
1973 | People using systems based on the Linux kernel sometimes report that | |
1974 | startup takes 10 to 15 seconds longer than `usual'. | |
1975 | ||
1976 | This is because Emacs looks up the host name when it starts. | |
1977 | Normally, this takes negligible time; the extra delay is due to | |
1978 | improper system configuration. This problem can occur for both | |
1979 | networked and non-networked machines. | |
1980 | ||
1981 | Here is how to fix the configuration. It requires being root. | |
1982 | ||
1983 | ** Networked Case | |
1984 | ||
1985 | First, make sure the files `/etc/hosts' and `/etc/host.conf' both | |
1986 | exist. The first line in the `/etc/hosts' file should look like this | |
1987 | (replace HOSTNAME with your host name): | |
1988 | ||
1989 | 127.0.0.1 HOSTNAME | |
1990 | ||
1991 | Also make sure that the `/etc/host.conf' files contains the following | |
1992 | lines: | |
1993 | ||
1994 | order hosts, bind | |
1995 | multi on | |
1996 | ||
1997 | Any changes, permanent and temporary, to the host name should be | |
1998 | indicated in the `/etc/hosts' file, since it acts a limited local | |
1999 | database of addresses and names (e.g., some SLIP connections | |
2000 | dynamically allocate ip addresses). | |
2001 | ||
2002 | ** Non-Networked Case | |
2003 | ||
2004 | The solution described in the networked case applies here as well. | |
2005 | However, if you never intend to network your machine, you can use a | |
2006 | simpler solution: create an empty `/etc/host.conf' file. The command | |
2007 | `touch /etc/host.conf' suffices to create the file. The `/etc/hosts' | |
2008 | file is not necessary with this approach. | |
2009 | ||
2010 | * On Solaris 2.4, Dired hangs and C-g does not work. Or Emacs hangs | |
2011 | forever waiting for termination of a subprocess that is a zombie. | |
2012 | ||
2013 | casper@fwi.uva.nl says the problem is in X11R6. Rebuild libX11.so | |
2014 | after changing the file xc/config/cf/sunLib.tmpl. Change the lines | |
2015 | ||
2016 | #if ThreadedX | |
2017 | #define SharedX11Reqs -lthread | |
2018 | #endif | |
2019 | ||
2020 | to: | |
2021 | ||
2022 | #if OSMinorVersion < 4 | |
2023 | #if ThreadedX | |
2024 | #define SharedX11Reqs -lthread | |
2025 | #endif | |
2026 | #endif | |
2027 | ||
2028 | Be sure also to edit x/config/cf/sun.cf so that OSMinorVersion is 4 | |
2029 | (as it should be for Solaris 2.4). The file has three definitions for | |
2030 | OSMinorVersion: the first is for x86, the second for SPARC under | |
2031 | Solaris, and the third for SunOS 4. Make sure to update the | |
2032 | definition for your type of machine and system. | |
2033 | ||
2034 | Then do `make Everything' in the top directory of X11R6, to rebuild | |
2035 | the makefiles and rebuild X. The X built this way work only on | |
2036 | Solaris 2.4, not on 2.3. | |
2037 | ||
2038 | For multithreaded X to work it is necessary to install patch | |
2039 | 101925-02 to fix problems in header files [2.4]. You need | |
2040 | to reinstall gcc or re-run just-fixinc after installing that | |
2041 | patch. | |
2042 | ||
2043 | However, Frank Rust <frust@iti.cs.tu-bs.de> used a simpler solution: | |
2044 | he changed | |
2045 | #define ThreadedX YES | |
2046 | to | |
2047 | #define ThreadedX NO | |
2048 | in sun.cf and did `make World' to rebuild X11R6. Removing all | |
2049 | `-DXTHREAD*' flags and `-lthread' entries from lib/X11/Makefile and | |
2050 | typing 'make install' in that directory also seemed to work. | |
2051 | ||
2052 | * With M-x enable-flow-control, you need to type C-\ twice | |
2053 | to do incremental search--a single C-\ gets no response. | |
2054 | ||
2055 | This has been traced to communicating with your machine via kermit, | |
2056 | with C-\ as the kermit escape character. One solution is to use | |
2057 | another escape character in kermit. One user did | |
2058 | ||
2059 | set escape-character 17 | |
2060 | ||
2061 | in his .kermrc file, to make C-q the kermit escape character. | |
2062 | ||
2063 | * The Motif version of Emacs paints the screen a solid color. | |
2064 | ||
2065 | This has been observed to result from the following X resource: | |
2066 | ||
2067 | Emacs*default.attributeFont: -*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-* | |
2068 | ||
2069 | That the resource has this effect indicates a bug in something, but we | |
2070 | do not yet know what. If it is an Emacs bug, we hope someone can | |
2071 | explain what the bug is so we can fix it. In the mean time, removing | |
2072 | the resource prevents the problem. | |
2073 | ||
2074 | * Emacs gets hung shortly after startup, on Sunos 4.1.3. | |
2075 | ||
2076 | We think this is due to a bug in Sunos. The word is that | |
2077 | one of these Sunos patches fixes the bug: | |
2078 | ||
2079 | 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 101080-01 | |
2080 | 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 101134-01 | |
2081 | 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 101070-01 101145-01 | |
2082 | 100173-10 100305-15 100383-06 100513-04 100570-05 100689-01 101071-03 101200-02 | |
2083 | 100178-09 100338-05 100421-03 100536-02 100584-05 100784-01 101072-01 101207-01 | |
2084 | ||
2085 | We don't know which of these patches really matter. If you find out | |
2086 | which ones, please inform bug-gnu-emacs@gnu.org. | |
2087 | ||
2088 | * Emacs aborts while starting up, only when run without X. | |
2089 | ||
2090 | This problem often results from compiling Emacs with GCC when GCC was | |
2091 | installed incorrectly. The usual error in installing GCC is to | |
2092 | specify --includedir=/usr/include. Installation of GCC makes | |
2093 | corrected copies of the system header files. GCC is supposed to use | |
2094 | the corrected copies in preference to the original system headers. | |
2095 | Specifying --includedir=/usr/include causes the original system header | |
2096 | files to be used. On some systems, the definition of ioctl in the | |
2097 | original system header files is invalid for ANSI C and causes Emacs | |
2098 | not to work. | |
2099 | ||
2100 | The fix is to reinstall GCC, and this time do not specify --includedir | |
2101 | when you configure it. Then recompile Emacs. Specifying --includedir | |
2102 | is appropriate only in very special cases and it should *never* be the | |
2103 | same directory where system header files are kept. | |
2104 | ||
2105 | * On Solaris 2.x, GCC complains "64 bit integer types not supported" | |
2106 | ||
2107 | This suggests that GCC is not installed correctly. Most likely you | |
2108 | are using GCC 2.7.2.3 (or earlier) on Solaris 2.6 (or later); this | |
2109 | does not work without patching. To run GCC 2.7.2.3 on Solaris 2.6 or | |
2110 | later, you must patch fixinc.svr4 and reinstall GCC from scratch as | |
2111 | described in the Solaris FAQ | |
2112 | <http://www.wins.uva.nl/pub/solaris/solaris2.html>. A better fix is | |
2113 | to upgrade to GCC 2.8.1 or later. | |
2114 | ||
2115 | * The Compose key on a DEC keyboard does not work as Meta key. | |
2116 | ||
2117 | This shell command should fix it: | |
2118 | ||
2119 | xmodmap -e 'keycode 0xb1 = Meta_L' | |
2120 | ||
2121 | * Regular expressions matching bugs on SCO systems. | |
2122 | ||
2123 | On SCO, there are problems in regexp matching when Emacs is compiled | |
2124 | with the system compiler. The compiler version is "Microsoft C | |
2125 | version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; Quick | |
2126 | C Compiler Version 1.00.46 (Beta). The solution is to compile with | |
2127 | GCC. | |
2128 | ||
2129 | * On Sunos 4, you get the error ld: Undefined symbol __lib_version. | |
2130 | ||
2131 | This is the result of using cc or gcc with the shared library meant | |
2132 | for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete | |
2133 | /usr/lang/SC2.0.1 or some similar directory. | |
2134 | ||
2135 | * You can't select from submenus (in the X toolkit version). | |
2136 | ||
2137 | On certain systems, mouse-tracking and selection in top-level menus | |
2138 | works properly with the X toolkit, but neither of them works when you | |
2139 | bring up a submenu (such as Bookmarks or Compare or Apply Patch, in | |
2140 | the Files menu). | |
2141 | ||
2142 | This works on most systems. There is speculation that the failure is | |
2143 | due to bugs in old versions of X toolkit libraries, but no one really | |
2144 | knows. If someone debugs this and finds the precise cause, perhaps a | |
2145 | workaround can be found. | |
2146 | ||
2147 | * Unusable default font on SCO 3.2v4. | |
2148 | ||
2149 | The Open Desktop environment comes with default X resource settings | |
2150 | that tell Emacs to use a variable-width font. Emacs cannot use such | |
2151 | fonts, so it does not work. | |
2152 | ||
2153 | This is caused by the file /usr/lib/X11/app-defaults/ScoTerm, which is | |
2154 | the application-specific resource file for the `scoterm' terminal | |
2155 | emulator program. It contains several extremely general X resources | |
2156 | that affect other programs besides `scoterm'. In particular, these | |
2157 | resources affect Emacs also: | |
2158 | ||
2159 | *Font: -*-helvetica-medium-r-*--12-*-p-* | |
2160 | *Background: scoBackground | |
2161 | *Foreground: scoForeground | |
2162 | ||
2163 | The best solution is to create an application-specific resource file for | |
2164 | Emacs, /usr/lib/X11/sco/startup/Emacs, with the following contents: | |
2165 | ||
2166 | Emacs*Font: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1 | |
2167 | Emacs*Background: white | |
2168 | Emacs*Foreground: black | |
2169 | ||
2170 | (These settings mimic the Emacs defaults, but you can change them to | |
2171 | suit your needs.) This resource file is only read when the X server | |
2172 | starts up, so you should restart it by logging out of the Open Desktop | |
2173 | environment or by running `scologin stop; scologin start` from the shell | |
2174 | as root. Alternatively, you can put these settings in the | |
2175 | /usr/lib/X11/app-defaults/Emacs resource file and simply restart Emacs, | |
2176 | but then they will not affect remote invocations of Emacs that use the | |
2177 | Open Desktop display. | |
2178 | ||
2179 | These resource files are not normally shared across a network of SCO | |
2180 | machines; you must create the file on each machine individually. | |
2181 | ||
2182 | * rcs2log gives you the awk error message "too many fields". | |
2183 | ||
2184 | This is due to an arbitrary limit in certain versions of awk. | |
2185 | The solution is to use gawk (GNU awk). | |
2186 | ||
2187 | * Emacs is slow using X11R5 on HP/UX. | |
2188 | ||
2189 | This happens if you use the MIT versions of the X libraries--it | |
2190 | doesn't run as fast as HP's version. People sometimes use the version | |
2191 | because they see the HP version doesn't have the libraries libXaw.a, | |
2192 | libXmu.a, libXext.a and others. HP/UX normally doesn't come with | |
2193 | those libraries installed. To get good performance, you need to | |
2194 | install them and rebuild Emacs. | |
2195 | ||
2196 | * Loading fonts is very slow. | |
2197 | ||
2198 | You might be getting scalable fonts instead of precomputed bitmaps. | |
2199 | Known scalable font directories are "Type1" and "Speedo". A font | |
2200 | directory contains scalable fonts if it contains the file | |
2201 | "fonts.scale". | |
2202 | ||
2203 | If this is so, re-order your X windows font path to put the scalable | |
2204 | font directories last. See the documentation of `xset' for details. | |
2205 | ||
2206 | With some X servers, it may be necessary to take the scalable font | |
2207 | directories out of your path entirely, at least for Emacs 19.26. | |
2208 | Changes in the future may make this unnecessary. | |
2209 | ||
2210 | * On AIX 3.2.4, releasing Ctrl/Act key has no effect, if Shift is down. | |
2211 | ||
2212 | Due to a feature of AIX, pressing or releasing the Ctrl/Act key is | |
2213 | ignored when the Shift, Alt or AltGr keys are held down. This can | |
2214 | lead to the keyboard being "control-locked"--ordinary letters are | |
2215 | treated as control characters. | |
2216 | ||
2217 | You can get out of this "control-locked" state by pressing and | |
2218 | releasing Ctrl/Act while not pressing or holding any other keys. | |
2219 | ||
2220 | * display-time causes kernel problems on ISC systems. | |
2221 | ||
2222 | Under Interactive Unix versions 3.0.1 and 4.0 (and probably other | |
2223 | versions), display-time causes the loss of large numbers of STREVENT | |
2224 | cells. Eventually the kernel's supply of these cells is exhausted. | |
2225 | This makes emacs and the whole system run slow, and can make other | |
2226 | processes die, in particular pcnfsd. | |
2227 | ||
2228 | Other emacs functions that communicate with remote processes may have | |
2229 | the same problem. Display-time seems to be far the worst. | |
2230 | ||
2231 | The only known fix: Don't run display-time. | |
2232 | ||
2233 | * On Solaris, C-x doesn't get through to Emacs when you use the console. | |
2234 | ||
2235 | This is a Solaris feature (at least on Intel x86 cpus). Type C-r | |
2236 | C-r C-t, to toggle whether C-x gets through to Emacs. | |
2237 | ||
2238 | * Error message `Symbol's value as variable is void: x', followed by | |
2239 | segmentation fault and core dump. | |
2240 | ||
2241 | This has been tracked to a bug in tar! People report that tar erroneously | |
2242 | added a line like this at the beginning of files of Lisp code: | |
2243 | ||
2244 | x FILENAME, N bytes, B tape blocks | |
2245 | ||
2246 | If your tar has this problem, install GNU tar--if you can manage to | |
2247 | untar it :-). | |
2248 | ||
2249 | * Link failure when using acc on a Sun. | |
2250 | ||
2251 | To use acc, you need additional options just before the libraries, such as | |
2252 | ||
2253 | /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1 | |
2254 | ||
2255 | and you need to add -lansi just before -lc. | |
2256 | ||
2257 | The precise file names depend on the compiler version, so we | |
2258 | cannot easily arrange to supply them. | |
2259 | ||
2260 | * Link failure on IBM AIX 1.3 ptf 0013. | |
2261 | ||
2262 | There is a real duplicate definition of the function `_slibc_free' in | |
2263 | the library /lib/libc_s.a (just do nm on it to verify). The | |
2264 | workaround/fix is: | |
2265 | ||
2266 | cd /lib | |
2267 | ar xv libc_s.a NLtmtime.o | |
2268 | ar dv libc_s.a NLtmtime.o | |
2269 | ||
2270 | * Undefined symbols _dlopen, _dlsym and/or _dlclose on a Sun. | |
2271 | ||
2272 | If you see undefined symbols _dlopen, _dlsym, or _dlclose when linking | |
2273 | with -lX11, compile and link against the file mit/util/misc/dlsym.c in | |
2274 | the MIT X11R5 distribution. Alternatively, link temacs using shared | |
2275 | libraries with s/sunos4shr.h. (This doesn't work if you use the X | |
2276 | toolkit.) | |
2277 | ||
2278 | If you get the additional error that the linker could not find | |
2279 | lib_version.o, try extracting it from X11/usr/lib/X11/libvim.a in | |
2280 | X11R4, then use it in the link. | |
2281 | ||
2282 | * Error messages `Wrong number of arguments: #<subr where-is-internal>, 5' | |
2283 | ||
2284 | This typically results from having the powerkey library loaded. | |
2285 | Powerkey was designed for Emacs 19.22. It is obsolete now because | |
2286 | Emacs 19 now has this feature built in; and powerkey also calls | |
2287 | where-is-internal in an obsolete way. | |
2288 | ||
2289 | So the fix is to arrange not to load powerkey. | |
2290 | ||
2291 | * In Shell mode, you get a ^M at the end of every line. | |
2292 | ||
2293 | This happens to people who use tcsh, because it is trying to be too | |
2294 | smart. It sees that the Shell uses terminal type `unknown' and turns | |
2295 | on the flag to output ^M at the end of each line. You can fix the | |
2296 | problem by adding this to your .cshrc file: | |
2297 | ||
2298 | if ($?EMACS) then | |
2299 | if ($EMACS == "t") then | |
2300 | unset edit | |
2301 | stty -icrnl -onlcr -echo susp ^Z | |
2302 | endif | |
2303 | endif | |
2304 | ||
2305 | * An error message such as `X protocol error: BadMatch (invalid | |
2306 | parameter attributes) on protocol request 93'. | |
2307 | ||
2308 | This comes from having an invalid X resource, such as | |
2309 | emacs*Cursor: black | |
2310 | (which is invalid because it specifies a color name for something | |
2311 | that isn't a color.) | |
2312 | ||
2313 | The fix is to correct your X resources. | |
2314 | ||
2315 | * Undefined symbols when linking on Sunos 4.1 using --with-x-toolkit. | |
2316 | ||
2317 | If you get the undefined symbols _atowc _wcslen, _iswprint, _iswspace, | |
2318 | _iswcntrl, _wcscpy, and _wcsncpy, then you need to add -lXwchar after | |
2319 | -lXaw in the command that links temacs. | |
2320 | ||
2321 | This problem seems to arise only when the international language | |
2322 | extensions to X11R5 are installed. | |
2323 | ||
2324 | * Typing C-c C-c in Shell mode kills your X server. | |
2325 | ||
2326 | This happens with Linux kernel 1.0 thru 1.04, approximately. The workaround is | |
2327 | to define SIGNALS_VIA_CHARACTERS in config.h and recompile Emacs. | |
2328 | Newer Linux kernel versions don't have this problem. | |
2329 | ||
2330 | * src/Makefile and lib-src/Makefile are truncated--most of the file missing. | |
2331 | ||
2332 | This can happen if configure uses GNU sed version 2.03. That version | |
2333 | had a bug. GNU sed version 2.05 works properly. | |
2334 | ||
2335 | * Slow startup on X11R6 with X windows. | |
2336 | ||
2337 | If Emacs takes two minutes to start up on X11R6, see if your X | |
2338 | resources specify any Adobe fonts. That causes the type-1 font | |
2339 | renderer to start up, even if the font you asked for is not a type-1 | |
2340 | font. | |
2341 | ||
2342 | One way to avoid this problem is to eliminate the type-1 fonts from | |
2343 | your font path, like this: | |
2344 | ||
2345 | xset -fp /usr/X11R6/lib/X11/fonts/Type1/ | |
2346 | ||
2347 | * Pull-down menus appear in the wrong place, in the toolkit version of Emacs. | |
2348 | ||
2349 | An X resource of this form can cause the problem: | |
2350 | ||
2351 | Emacs*geometry: 80x55+0+0 | |
2352 | ||
2353 | This resource is supposed to apply, and does apply, to the menus | |
2354 | individually as well as to Emacs frames. If that is not what you | |
2355 | want, rewrite the resource. | |
2356 | ||
2357 | To check thoroughly for such resource specifications, use `xrdb | |
2358 | -query' to see what resources the X server records, and also look at | |
2359 | the user's ~/.Xdefaults and ~/.Xdefaults-* files. | |
2360 | ||
2361 | * --with-x-toolkit version crashes when used with shared libraries. | |
2362 | ||
2363 | On some systems, including Sunos 4 and DGUX 5.4.2 and perhaps others, | |
2364 | unexec doesn't work properly with the shared library for the X | |
2365 | toolkit. You might be able to work around this by using a nonshared | |
2366 | libXt.a library. The real fix is to upgrade the various versions of | |
2367 | unexec and/or ralloc. We think this has been fixed on Sunos 4 | |
2368 | and Solaris in version 19.29. | |
2369 | ||
2370 | * `make install' fails on install-doc with `Error 141'. | |
2371 | ||
2372 | This happens on Ultrix 4.2 due to failure of a pipeline of tar | |
2373 | commands. We don't know why they fail, but the bug seems not to be in | |
2374 | Emacs. The workaround is to run the shell command in install-doc by | |
2375 | hand. | |
2376 | ||
2377 | * --with-x-toolkit option configures wrong on BSD/386. | |
2378 | ||
2379 | This problem is due to bugs in the shell in version 1.0 of BSD/386. | |
2380 | The workaround is to edit the configure file to use some other shell, | |
2381 | such as bash. | |
2382 | ||
2383 | * Subprocesses remain, hanging but not zombies, on Sunos 5.3. | |
2384 | ||
2385 | A bug in Sunos 5.3 causes Emacs subprocesses to remain after Emacs | |
2386 | exits. Sun patch # 101415-02 is part of the fix for this, but it only | |
2387 | applies to ptys, and doesn't fix the problem with subprocesses | |
2388 | communicating through pipes. | |
2389 | ||
2390 | * Mail is lost when sent to local aliases. | |
2391 | ||
2392 | Many emacs mail user agents (VM and rmail, for instance) use the | |
2393 | sendmail.el library. This library can arrange for mail to be | |
2394 | delivered by passing messages to the /usr/lib/sendmail (usually) | |
2395 | program . In doing so, it passes the '-t' flag to sendmail, which | |
2396 | means that the name of the recipient of the message is not on the | |
2397 | command line and, therefore, that sendmail must parse the message to | |
2398 | obtain the destination address. | |
2399 | ||
2400 | There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail. | |
2401 | In short, when given the -t flag, the SunOS sendmail won't recognize | |
2402 | non-local (i.e. NIS) aliases. It has been reported that the Solaris | |
2403 | 2.x versions of sendmail do not have this bug. For those using SunOS | |
2404 | 4.1, the best fix is to install sendmail V8 or IDA sendmail (which | |
2405 | have other advantages over the regular sendmail as well). At the time | |
2406 | of this writing, these official versions are available: | |
2407 | ||
2408 | Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail: | |
2409 | sendmail.8.6.9.base.tar.Z (the base system source & documentation) | |
2410 | sendmail.8.6.9.cf.tar.Z (configuration files) | |
2411 | sendmail.8.6.9.misc.tar.Z (miscellaneous support programs) | |
2412 | sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript) | |
2413 | ||
2414 | IDA sendmail on vixen.cso.uiuc.edu in /pub: | |
2415 | sendmail-5.67b+IDA-1.5.tar.gz | |
2416 | ||
2417 | * On AIX, you get this message when running Emacs: | |
2418 | ||
2419 | Could not load program emacs | |
2420 | Symbol smtcheckinit in csh is undefined | |
2421 | Error was: Exec format error | |
2422 | ||
2423 | or this one: | |
2424 | ||
2425 | Could not load program .emacs | |
2426 | Symbol _system_con in csh is undefined | |
2427 | Symbol _fp_trapsta in csh is undefined | |
2428 | Error was: Exec format error | |
2429 | ||
2430 | These can happen when you try to run on AIX 3.2.5 a program that was | |
2431 | compiled with 3.2.4. The fix is to recompile. | |
2432 | ||
2433 | * On AIX, you get this compiler error message: | |
2434 | ||
2435 | Processing include file ./XMenuInt.h | |
2436 | 1501-106: (S) Include file X11/Xlib.h not found. | |
2437 | ||
2438 | This means your system was installed with only the X11 runtime i.d | |
2439 | libraries. You have to find your sipo (bootable tape) and install | |
2440 | X11Dev... with smit. | |
2441 | ||
2442 | * You "lose characters" after typing Compose Character key. | |
2443 | ||
2444 | This is because the Compose Character key is defined as the keysym | |
2445 | Multi_key, and Emacs (seeing that) does the proper X11 | |
2446 | character-composition processing. If you don't want your Compose key | |
2447 | to do that, you can redefine it with xmodmap. | |
2448 | ||
2449 | For example, here's one way to turn it into a Meta key: | |
2450 | ||
2451 | xmodmap -e "keysym Multi_key = Meta_L" | |
2452 | ||
2453 | If all users at your site of a particular keyboard prefer Meta to | |
2454 | Compose, you can make the remapping happen automatically by adding the | |
2455 | xmodmap command to the xdm setup script for that display. | |
2456 | ||
2457 | * C-z just refreshes the screen instead of suspending Emacs. | |
2458 | ||
2459 | You are probably using a shell that doesn't support job control, even | |
2460 | though the system itself is capable of it. Either use a different shell, | |
2461 | or set the variable `cannot-suspend' to a non-nil value. | |
2462 | ||
2463 | * Watch out for .emacs files and EMACSLOADPATH environment vars | |
2464 | ||
2465 | These control the actions of Emacs. | |
2466 | ~/.emacs is your Emacs init file. | |
2467 | EMACSLOADPATH overrides which directories the function | |
2468 | "load" will search. | |
2469 | ||
2470 | If you observe strange problems, check for these and get rid | |
2471 | of them, then try again. | |
2472 | ||
2473 | * After running emacs once, subsequent invocations crash. | |
2474 | ||
2475 | Some versions of SVR4 have a serious bug in the implementation of the | |
2476 | mmap () system call in the kernel; this causes emacs to run correctly | |
2477 | the first time, and then crash when run a second time. | |
2478 | ||
2479 | Contact your vendor and ask for the mmap bug fix; in the mean time, | |
2480 | you may be able to work around the problem by adding a line to your | |
2481 | operating system description file (whose name is reported by the | |
2482 | configure script) that reads: | |
2483 | #define SYSTEM_MALLOC | |
2484 | This makes Emacs use memory less efficiently, but seems to work around | |
2485 | the kernel bug. | |
2486 | ||
2487 | * Inability to send an Alt-modified key, when Emacs is communicating | |
2488 | directly with an X server. | |
2489 | ||
2490 | If you have tried to bind an Alt-modified key as a command, and it | |
2491 | does not work to type the command, the first thing you should check is | |
2492 | whether the key is getting through to Emacs. To do this, type C-h c | |
2493 | followed by the Alt-modified key. C-h c should say what kind of event | |
2494 | it read. If it says it read an Alt-modified key, then make sure you | |
2495 | have made the key binding correctly. | |
2496 | ||
2497 | If C-h c reports an event that doesn't have the Alt modifier, it may | |
2498 | be because your X server has no key for the Alt modifier. The X | |
2499 | server that comes from MIT does not set up the Alt modifier by | |
2500 | default. | |
2501 | ||
2502 | If your keyboard has keys named Alt, you can enable them as follows: | |
2503 | ||
2504 | xmodmap -e 'add mod2 = Alt_L' | |
2505 | xmodmap -e 'add mod2 = Alt_R' | |
2506 | ||
2507 | If the keyboard has just one key named Alt, then only one of those | |
2508 | commands is needed. The modifier `mod2' is a reasonable choice if you | |
2509 | are using an unmodified MIT version of X. Otherwise, choose any | |
2510 | modifier bit not otherwise used. | |
2511 | ||
2512 | If your keyboard does not have keys named Alt, you can use some other | |
2513 | keys. Use the keysym command in xmodmap to turn a function key (or | |
2514 | some other 'spare' key) into Alt_L or into Alt_R, and then use the | |
2515 | commands show above to make them modifier keys. | |
2516 | ||
2517 | Note that if you have Alt keys but no Meta keys, Emacs translates Alt | |
2518 | into Meta. This is because of the great importance of Meta in Emacs. | |
2519 | ||
2520 | * `Pid xxx killed due to text modification or page I/O error' | |
2521 | ||
2522 | On HP/UX, you can get that error when the Emacs executable is on an NFS | |
2523 | file system. HP/UX responds this way if it tries to swap in a page and | |
2524 | does not get a response from the server within a timeout whose default | |
2525 | value is just ten seconds. | |
2526 | ||
2527 | If this happens to you, extend the timeout period. | |
2528 | ||
2529 | * `expand-file-name' fails to work on any but the machine you dumped Emacs on. | |
2530 | ||
2531 | On Ultrix, if you use any of the functions which look up information | |
2532 | in the passwd database before dumping Emacs (say, by using | |
2533 | expand-file-name in site-init.el), then those functions will not work | |
2534 | in the dumped Emacs on any host but the one Emacs was dumped on. | |
2535 | ||
2536 | The solution? Don't use expand-file-name in site-init.el, or in | |
2537 | anything it loads. Yuck - some solution. | |
2538 | ||
2539 | I'm not sure why this happens; if you can find out exactly what is | |
2540 | going on, and perhaps find a fix or a workaround, please let us know. | |
2541 | Perhaps the YP functions cache some information, the cache is included | |
2542 | in the dumped Emacs, and is then inaccurate on any other host. | |
2543 | ||
2544 | * On some variants of SVR4, Emacs does not work at all with X. | |
2545 | ||
2546 | Try defining BROKEN_FIONREAD in your config.h file. If this solves | |
2547 | the problem, please send a bug report to tell us this is needed; be | |
2548 | sure to say exactly what type of machine and system you are using. | |
2549 | ||
2550 | * Linking says that the functions insque and remque are undefined. | |
2551 | ||
2552 | Change oldXMenu/Makefile by adding insque.o to the variable OBJS. | |
2553 | ||
2554 | * Emacs fails to understand most Internet host names, even though | |
2555 | the names work properly with other programs on the same system. | |
2556 | * Emacs won't work with X-windows if the value of DISPLAY is HOSTNAME:0. | |
2557 | * GNUs can't make contact with the specified host for nntp. | |
2558 | ||
2559 | This typically happens on Suns and other systems that use shared | |
2560 | libraries. The cause is that the site has installed a version of the | |
2561 | shared library which uses a name server--but has not installed a | |
2562 | similar version of the unshared library which Emacs uses. | |
2563 | ||
2564 | The result is that most programs, using the shared library, work with | |
2565 | the nameserver, but Emacs does not. | |
2566 | ||
2567 | The fix is to install an unshared library that corresponds to what you | |
2568 | installed in the shared library, and then relink Emacs. | |
2569 | ||
2570 | On SunOS 4.1, simply define HAVE_RES_INIT. | |
2571 | ||
2572 | If you have already installed the name resolver in the file libresolv.a, | |
2573 | then you need to compile Emacs to use that library. The easiest way to | |
2574 | do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE | |
2575 | or LIB_STANDARD which uses -lresolv. Watch out! If you redefine a macro | |
2576 | that is already in use in your configuration to supply some other libraries, | |
2577 | be careful not to lose the others. | |
2578 | ||
2579 | Thus, you could start by adding this to config.h: | |
2580 | ||
2581 | #define LIBS_SYSTEM -lresolv | |
2582 | ||
2583 | Then if this gives you an error for redefining a macro, and you see that | |
2584 | the s- file defines LIBS_SYSTEM as -lfoo -lbar, you could change config.h | |
2585 | again to say this: | |
2586 | ||
2587 | #define LIBS_SYSTEM -lresolv -lfoo -lbar | |
2588 | ||
2589 | * On a Sun running SunOS 4.1.1, you get this error message from GNU ld: | |
2590 | ||
2591 | /lib/libc.a(_Q_sub.o): Undefined symbol __Q_get_rp_rd referenced from text segment | |
2592 | ||
2593 | The problem is in the Sun shared C library, not in GNU ld. | |
2594 | ||
2595 | The solution is to install Patch-ID# 100267-03 from Sun. | |
2596 | ||
2597 | * Self documentation messages are garbled. | |
2598 | ||
2599 | This means that the file `etc/DOC-...' doesn't properly correspond | |
2600 | with the Emacs executable. Redumping Emacs and then installing the | |
2601 | corresponding pair of files should fix the problem. | |
2602 | ||
2603 | * Trouble using ptys on AIX. | |
2604 | ||
2605 | People often install the pty devices on AIX incorrectly. | |
2606 | Use `smit pty' to reinstall them properly. | |
2607 | ||
2608 | * Shell mode on HP/UX gives the message, "`tty`: Ambiguous". | |
2609 | ||
2610 | christos@theory.tn.cornell.edu says: | |
2611 | ||
2612 | The problem is that in your .cshrc you have something that tries to | |
2613 | execute `tty`. If you are not running the shell on a real tty then | |
2614 | tty will print "not a tty". Csh expects one word in some places, | |
2615 | but tty is giving it back 3. | |
2616 | ||
2617 | The solution is to add a pair of quotes around `tty` to make it a single | |
2618 | word: | |
2619 | ||
2620 | if (`tty` == "/dev/console") | |
2621 | ||
2622 | should be changed to: | |
2623 | ||
2624 | if ("`tty`" == "/dev/console") | |
2625 | ||
2626 | Even better, move things that set up terminal sections out of .cshrc | |
2627 | and into .login. | |
2628 | ||
2629 | * Using X Windows, control-shift-leftbutton makes Emacs hang. | |
2630 | ||
2631 | Use the shell command `xset bc' to make the old X Menu package work. | |
2632 | ||
2633 | * Emacs running under X Windows does not handle mouse clicks. | |
2634 | * `emacs -geometry 80x20' finds a file named `80x20'. | |
2635 | ||
2636 | One cause of such problems is having (setq term-file-prefix nil) in | |
2637 | your .emacs file. Another cause is a bad value of EMACSLOADPATH in | |
2638 | the environment. | |
2639 | ||
2640 | * Emacs gets error message from linker on Sun. | |
2641 | ||
2642 | If the error message says that a symbol such as `f68881_used' or | |
2643 | `ffpa_used' or `start_float' is undefined, this probably indicates | |
2644 | that you have compiled some libraries, such as the X libraries, | |
2645 | with a floating point option other than the default. | |
2646 | ||
2647 | It's not terribly hard to make this work with small changes in | |
2648 | crt0.c together with linking with Fcrt1.o, Wcrt1.o or Mcrt1.o. | |
2649 | However, the easiest approach is to build Xlib with the default | |
2650 | floating point option: -fsoft. | |
2651 | ||
2652 | * Emacs fails to get default settings from X Windows server. | |
2653 | ||
2654 | The X library in X11R4 has a bug; it interchanges the 2nd and 3rd | |
2655 | arguments to XGetDefaults. Define the macro XBACKWARDS in config.h to | |
2656 | tell Emacs to compensate for this. | |
2657 | ||
2658 | I don't believe there is any way Emacs can determine for itself | |
2659 | whether this problem is present on a given system. | |
2660 | ||
2661 | * Keyboard input gets confused after a beep when using a DECserver | |
2662 | as a concentrator. | |
2663 | ||
2664 | This problem seems to be a matter of configuring the DECserver to use | |
2665 | 7 bit characters rather than 8 bit characters. | |
2666 | ||
2667 | * M-x shell persistently reports "Process shell exited abnormally with code 1". | |
2668 | ||
2669 | This happened on Suns as a result of what is said to be a bug in Sunos | |
2670 | version 4.0.x. The only fix was to reboot the machine. | |
2671 | ||
2672 | * Programs running under terminal emulator do not recognize `emacs' | |
2673 | terminal type. | |
2674 | ||
2675 | The cause of this is a shell startup file that sets the TERMCAP | |
2676 | environment variable. The terminal emulator uses that variable to | |
2677 | provide the information on the special terminal type that Emacs | |
2678 | emulates. | |
2679 | ||
2680 | Rewrite your shell startup file so that it does not change TERMCAP | |
2681 | in such a case. You could use the following conditional which sets | |
2682 | it only if it is undefined. | |
2683 | ||
2684 | if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file | |
2685 | ||
2686 | Or you could set TERMCAP only when you set TERM--which should not | |
2687 | happen in a non-login shell. | |
2688 | ||
2689 | * X Windows doesn't work if DISPLAY uses a hostname. | |
2690 | ||
2691 | People have reported kernel bugs in certain systems that cause Emacs | |
2692 | not to work with X Windows if DISPLAY is set using a host name. But | |
2693 | the problem does not occur if DISPLAY is set to `unix:0.0'. I think | |
2694 | the bug has to do with SIGIO or FIONREAD. | |
2695 | ||
2696 | You may be able to compensate for the bug by doing (set-input-mode nil nil). | |
2697 | However, that has the disadvantage of turning off interrupts, so that | |
2698 | you are unable to quit out of a Lisp program by typing C-g. | |
2699 | ||
2700 | The easy way to do this is to put | |
2701 | ||
2702 | (setq x-sigio-bug t) | |
2703 | ||
2704 | in your site-init.el file. | |
2705 | ||
2706 | * Problem with remote X server on Suns. | |
2707 | ||
2708 | On a Sun, running Emacs on one machine with the X server on another | |
2709 | may not work if you have used the unshared system libraries. This | |
2710 | is because the unshared libraries fail to use YP for host name lookup. | |
2711 | As a result, the host name you specify may not be recognized. | |
2712 | ||
2713 | * Shell mode ignores interrupts on Apollo Domain | |
2714 | ||
2715 | You may find that M-x shell prints the following message: | |
2716 | ||
2717 | Warning: no access to tty; thus no job control in this shell... | |
2718 | ||
2719 | This can happen if there are not enough ptys on your system. | |
2720 | Here is how to make more of them. | |
2721 | ||
2722 | % cd /dev | |
2723 | % ls pty* | |
2724 | # shows how many pty's you have. I had 8, named pty0 to pty7) | |
2725 | % /etc/crpty 8 | |
2726 | # creates eight new pty's | |
2727 | ||
2728 | * Fatal signal in the command temacs -l loadup inc dump | |
2729 | ||
2730 | This command is the final stage of building Emacs. It is run by the | |
2731 | Makefile in the src subdirectory, or by build.com on VMS. | |
2732 | ||
2733 | It has been known to get fatal errors due to insufficient swapping | |
2734 | space available on the machine. | |
2735 | ||
2736 | On 68000's, it has also happened because of bugs in the | |
2737 | subroutine `alloca'. Verify that `alloca' works right, even | |
2738 | for large blocks (many pages). | |
2739 | ||
2740 | * test-distrib says that the distribution has been clobbered | |
2741 | * or, temacs prints "Command key out of range 0-127" | |
2742 | * or, temacs runs and dumps emacs, but emacs totally fails to work. | |
2743 | * or, temacs gets errors dumping emacs | |
2744 | ||
2745 | This can be because the .elc files have been garbled. Do not be | |
2746 | fooled by the fact that most of a .elc file is text: these are | |
2747 | binary files and can contain all 256 byte values. | |
2748 | ||
2749 | In particular `shar' cannot be used for transmitting GNU Emacs. | |
2750 | It typically truncates "lines". What appear to be "lines" in | |
2751 | a binary file can of course be of any length. Even once `shar' | |
2752 | itself is made to work correctly, `sh' discards null characters | |
2753 | when unpacking the shell archive. | |
2754 | ||
2755 | I have also seen character \177 changed into \377. I do not know | |
2756 | what transfer means caused this problem. Various network | |
2757 | file transfer programs are suspected of clobbering the high bit. | |
2758 | ||
2759 | If you have a copy of Emacs that has been damaged in its | |
2760 | nonprinting characters, you can fix them: | |
2761 | ||
2762 | 1) Record the names of all the .elc files. | |
2763 | 2) Delete all the .elc files. | |
2764 | 3) Recompile alloc.c with a value of PURESIZE twice as large. | |
2765 | (See puresize.h.) You might as well save the old alloc.o. | |
2766 | 4) Remake emacs. It should work now. | |
2767 | 5) Running emacs, do Meta-x byte-compile-file repeatedly | |
2768 | to recreate all the .elc files that used to exist. | |
2769 | You may need to increase the value of the variable | |
2770 | max-lisp-eval-depth to succeed in running the compiler interpreted | |
2771 | on certain .el files. 400 was sufficient as of last report. | |
2772 | 6) Reinstall the old alloc.o (undoing changes to alloc.c if any) | |
2773 | and remake temacs. | |
2774 | 7) Remake emacs. It should work now, with valid .elc files. | |
2775 | ||
2776 | * temacs prints "Pure Lisp storage exhausted" | |
2777 | ||
2778 | This means that the Lisp code loaded from the .elc and .el | |
2779 | files during temacs -l loadup inc dump took up more | |
2780 | space than was allocated. | |
2781 | ||
2782 | This could be caused by | |
2783 | 1) adding code to the preloaded Lisp files | |
2784 | 2) adding more preloaded files in loadup.el | |
2785 | 3) having a site-init.el or site-load.el which loads files. | |
2786 | Note that ANY site-init.el or site-load.el is nonstandard; | |
2787 | if you have received Emacs from some other site | |
2788 | and it contains a site-init.el or site-load.el file, consider | |
2789 | deleting that file. | |
2790 | 4) getting the wrong .el or .elc files | |
2791 | (not from the directory you expected). | |
2792 | 5) deleting some .elc files that are supposed to exist. | |
2793 | This would cause the source files (.el files) to be | |
2794 | loaded instead. They take up more room, so you lose. | |
2795 | 6) a bug in the Emacs distribution which underestimates | |
2796 | the space required. | |
2797 | ||
2798 | If the need for more space is legitimate, change the definition | |
2799 | of PURESIZE in puresize.h. | |
2800 | ||
2801 | But in some of the cases listed above, this problem is a consequence | |
2802 | of something else that is wrong. Be sure to check and fix the real | |
2803 | problem. | |
2804 | ||
2805 | * Changes made to .el files do not take effect. | |
2806 | ||
2807 | You may have forgotten to recompile them into .elc files. | |
2808 | Then the old .elc files will be loaded, and your changes | |
2809 | will not be seen. To fix this, do M-x byte-recompile-directory | |
2810 | and specify the directory that contains the Lisp files. | |
2811 | ||
2812 | Emacs should print a warning when loading a .elc file which is older | |
2813 | than the corresponding .el file. | |
2814 | ||
2815 | * The dumped Emacs crashes when run, trying to write pure data. | |
2816 | ||
2817 | Two causes have been seen for such problems. | |
2818 | ||
2819 | 1) On a system where getpagesize is not a system call, it is defined | |
2820 | as a macro. If the definition (in both unexec.c and malloc.c) is wrong, | |
2821 | it can cause problems like this. You might be able to find the correct | |
2822 | value in the man page for a.out (5). | |
2823 | ||
2824 | 2) Some systems allocate variables declared static among the | |
2825 | initialized variables. Emacs makes all initialized variables in most | |
2826 | of its files pure after dumping, but the variables declared static and | |
2827 | not initialized are not supposed to be pure. On these systems you | |
2828 | may need to add "#define static" to the m- or the s- file. | |
2829 | ||
2830 | * Compilation errors on VMS. | |
2831 | ||
2832 | You will get warnings when compiling on VMS because there are | |
2833 | variable names longer than 32 (or whatever it is) characters. | |
2834 | This is not an error. Ignore it. | |
2835 | ||
2836 | VAX C does not support #if defined(foo). Uses of this construct | |
2837 | were removed, but some may have crept back in. They must be rewritten. | |
2838 | ||
2839 | There is a bug in the C compiler which fails to sign extend characters | |
2840 | in conditional expressions. The bug is: | |
2841 | char c = -1, d = 1; | |
2842 | int i; | |
2843 | ||
2844 | i = d ? c : d; | |
2845 | The result is i == 255; the fix is to typecast the char in the | |
2846 | conditional expression as an (int). Known occurrences of such | |
2847 | constructs in Emacs have been fixed. | |
2848 | ||
2849 | * rmail gets error getting new mail | |
2850 | ||
2851 | rmail gets new mail from /usr/spool/mail/$USER using a program | |
2852 | called `movemail'. This program interlocks with /bin/mail using | |
2853 | the protocol defined by /bin/mail. | |
2854 | ||
2855 | There are two different protocols in general use. One of them uses | |
2856 | the `flock' system call. The other involves creating a lock file; | |
2857 | `movemail' must be able to write in /usr/spool/mail in order to do | |
2858 | this. You control which one is used by defining, or not defining, | |
2859 | the macro MAIL_USE_FLOCK in config.h or the m- or s- file it includes. | |
2860 | IF YOU DON'T USE THE FORM OF INTERLOCKING THAT IS NORMAL ON YOUR | |
2861 | SYSTEM, YOU CAN LOSE MAIL! | |
2862 | ||
2863 | If your system uses the lock file protocol, and fascist restrictions | |
2864 | prevent ordinary users from writing the lock files in /usr/spool/mail, | |
2865 | you may need to make `movemail' setgid to a suitable group such as | |
2866 | `mail'. You can use these commands (as root): | |
2867 | ||
2868 | chgrp mail movemail | |
2869 | chmod 2755 movemail | |
2870 | ||
2871 | If your system uses the lock file protocol, and fascist restrictions | |
2872 | prevent ordinary users from writing the lock files in /usr/spool/mail, | |
2873 | you may need to make `movemail' setgid to a suitable group such as | |
2874 | `mail'. To do this, use the following commands (as root) after doing the | |
2875 | make install. | |
2876 | ||
2877 | chgrp mail movemail | |
2878 | chmod 2755 movemail | |
2879 | ||
2880 | Installation normally copies movemail from the build directory to an | |
2881 | installation directory which is usually under /usr/local/lib. The | |
2882 | installed copy of movemail is usually in the directory | |
2883 | /usr/local/lib/emacs/VERSION/TARGET. You must change the group and | |
2884 | mode of the installed copy; changing the group and mode of the build | |
2885 | directory copy is ineffective. | |
2886 | ||
2887 | * Emacs spontaneously displays "I-search: " at the bottom of the screen. | |
2888 | ||
2889 | This means that Control-S/Control-Q (XON/XOFF) "flow control" is being | |
2890 | used. C-s/C-q flow control is bad for Emacs editors because it takes | |
2891 | away C-s and C-q as user commands. Since editors do not output long | |
2892 | streams of text without user commands, there is no need for a | |
2893 | user-issuable "stop output" command in an editor; therefore, a | |
2894 | properly designed flow control mechanism would transmit all possible | |
2895 | input characters without interference. Designing such a mechanism is | |
2896 | easy, for a person with at least half a brain. | |
2897 | ||
2898 | There are three possible reasons why flow control could be taking place: | |
2899 | ||
2900 | 1) Terminal has not been told to disable flow control | |
2901 | 2) Insufficient padding for the terminal in use | |
2902 | 3) Some sort of terminal concentrator or line switch is responsible | |
2903 | ||
2904 | First of all, many terminals have a set-up mode which controls whether | |
2905 | they generate XON/XOFF flow control characters. This must be set to | |
2906 | "no XON/XOFF" in order for Emacs to work. Sometimes there is an | |
2907 | escape sequence that the computer can send to turn flow control off | |
2908 | and on. If so, perhaps the termcap `ti' string should turn flow | |
2909 | control off, and the `te' string should turn it on. | |
2910 | ||
2911 | Once the terminal has been told "no flow control", you may find it | |
2912 | needs more padding. The amount of padding Emacs sends is controlled | |
2913 | by the termcap entry for the terminal in use, and by the output baud | |
2914 | rate as known by the kernel. The shell command `stty' will print | |
2915 | your output baud rate; `stty' with suitable arguments will set it if | |
2916 | it is wrong. Setting to a higher speed causes increased padding. If | |
2917 | the results are wrong for the correct speed, there is probably a | |
2918 | problem in the termcap entry. You must speak to a local Unix wizard | |
2919 | to fix this. Perhaps you are just using the wrong terminal type. | |
2920 | ||
2921 | For terminals that lack a "no flow control" mode, sometimes just | |
2922 | giving lots of padding will prevent actual generation of flow control | |
2923 | codes. You might as well try it. | |
2924 | ||
2925 | If you are really unlucky, your terminal is connected to the computer | |
2926 | through a concentrator which sends XON/XOFF flow control to the | |
2927 | computer, or it insists on sending flow control itself no matter how | |
2928 | much padding you give it. Unless you can figure out how to turn flow | |
2929 | control off on this concentrator (again, refer to your local wizard), | |
2930 | you are screwed! You should have the terminal or concentrator | |
2931 | replaced with a properly designed one. In the mean time, some drastic | |
2932 | measures can make Emacs semi-work. | |
2933 | ||
2934 | You can make Emacs ignore C-s and C-q and let the operating system | |
2935 | handle them. To do this on a per-session basis, just type M-x | |
2936 | enable-flow-control RET. You will see a message that C-\ and C-^ are | |
2937 | now translated to C-s and C-q. (Use the same command M-x | |
2938 | enable-flow-control to turn *off* this special mode. It toggles flow | |
2939 | control handling.) | |
2940 | ||
2941 | If C-\ and C-^ are inconvenient for you (for example, if one of them | |
2942 | is the escape character of your terminal concentrator), you can choose | |
2943 | other characters by setting the variables flow-control-c-s-replacement | |
2944 | and flow-control-c-q-replacement. But choose carefully, since all | |
2945 | other control characters are already used by emacs. | |
2946 | ||
2947 | IMPORTANT: if you type C-s by accident while flow control is enabled, | |
2948 | Emacs output will freeze, and you will have to remember to type C-q in | |
2949 | order to continue. | |
2950 | ||
2951 | If you work in an environment where a majority of terminals of a | |
2952 | certain type are flow control hobbled, you can use the function | |
2953 | `enable-flow-control-on' to turn on this flow control avoidance scheme | |
2954 | automatically. Here is an example: | |
2955 | ||
2956 | (enable-flow-control-on "vt200" "vt300" "vt101" "vt131") | |
2957 | ||
2958 | If this isn't quite correct (e.g. you have a mixture of flow-control hobbled | |
2959 | and good vt200 terminals), you can still run enable-flow-control | |
2960 | manually. | |
2961 | ||
2962 | I have no intention of ever redesigning the Emacs command set for the | |
2963 | assumption that terminals use C-s/C-q flow control. XON/XOFF flow | |
2964 | control technique is a bad design, and terminals that need it are bad | |
2965 | merchandise and should not be purchased. Now that X is becoming | |
2966 | widespread, XON/XOFF seems to be on the way out. If you can get some | |
2967 | use out of GNU Emacs on inferior terminals, more power to you, but I | |
2968 | will not make Emacs worse for properly designed systems for the sake | |
2969 | of inferior systems. | |
2970 | ||
2971 | * Control-S and Control-Q commands are ignored completely. | |
2972 | ||
2973 | For some reason, your system is using brain-damaged C-s/C-q flow | |
2974 | control despite Emacs's attempts to turn it off. Perhaps your | |
2975 | terminal is connected to the computer through a concentrator | |
2976 | that wants to use flow control. | |
2977 | ||
2978 | You should first try to tell the concentrator not to use flow control. | |
2979 | If you succeed in this, try making the terminal work without | |
2980 | flow control, as described in the preceding section. | |
2981 | ||
2982 | If that line of approach is not successful, map some other characters | |
2983 | into C-s and C-q using keyboard-translate-table. The example above | |
2984 | shows how to do this with C-^ and C-\. | |
2985 | ||
2986 | * Control-S and Control-Q commands are ignored completely on a net connection. | |
2987 | ||
2988 | Some versions of rlogin (and possibly telnet) do not pass flow | |
2989 | control characters to the remote system to which they connect. | |
2990 | On such systems, emacs on the remote system cannot disable flow | |
2991 | control on the local system. | |
2992 | ||
2993 | One way to cure this is to disable flow control on the local host | |
2994 | (the one running rlogin, not the one running rlogind) using the | |
2995 | stty command, before starting the rlogin process. On many systems, | |
2996 | "stty start u stop u" will do this. | |
2997 | ||
2998 | Some versions of tcsh will prevent even this from working. One way | |
2999 | around this is to start another shell before starting rlogin, and | |
3000 | issue the stty command to disable flow control from that shell. | |
3001 | ||
3002 | If none of these methods work, the best solution is to type | |
3003 | M-x enable-flow-control at the beginning of your emacs session, or | |
3004 | if you expect the problem to continue, add a line such as the | |
3005 | following to your .emacs (on the host running rlogind): | |
3006 | ||
3007 | (enable-flow-control-on "vt200" "vt300" "vt101" "vt131") | |
3008 | ||
3009 | See the entry about spontaneous display of I-search (above) for more | |
3010 | info. | |
3011 | ||
3012 | * Screen is updated wrong, but only on one kind of terminal. | |
3013 | ||
3014 | This could mean that the termcap entry you are using for that | |
3015 | terminal is wrong, or it could mean that Emacs has a bug handing | |
3016 | the combination of features specified for that terminal. | |
3017 | ||
3018 | The first step in tracking this down is to record what characters | |
3019 | Emacs is sending to the terminal. Execute the Lisp expression | |
3020 | (open-termscript "./emacs-script") to make Emacs write all | |
3021 | terminal output into the file ~/emacs-script as well; then do | |
3022 | what makes the screen update wrong, and look at the file | |
3023 | and decode the characters using the manual for the terminal. | |
3024 | There are several possibilities: | |
3025 | ||
3026 | 1) The characters sent are correct, according to the terminal manual. | |
3027 | ||
3028 | In this case, there is no obvious bug in Emacs, and most likely you | |
3029 | need more padding, or possibly the terminal manual is wrong. | |
3030 | ||
3031 | 2) The characters sent are incorrect, due to an obscure aspect | |
3032 | of the terminal behavior not described in an obvious way | |
3033 | by termcap. | |
3034 | ||
3035 | This case is hard. It will be necessary to think of a way for | |
3036 | Emacs to distinguish between terminals with this kind of behavior | |
3037 | and other terminals that behave subtly differently but are | |
3038 | classified the same by termcap; or else find an algorithm for | |
3039 | Emacs to use that avoids the difference. Such changes must be | |
3040 | tested on many kinds of terminals. | |
3041 | ||
3042 | 3) The termcap entry is wrong. | |
3043 | ||
3044 | See the file etc/TERMS for information on changes | |
3045 | that are known to be needed in commonly used termcap entries | |
3046 | for certain terminals. | |
3047 | ||
3048 | 4) The characters sent are incorrect, and clearly cannot be | |
3049 | right for any terminal with the termcap entry you were using. | |
3050 | ||
3051 | This is unambiguously an Emacs bug, and can probably be fixed | |
3052 | in termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c. | |
3053 | ||
3054 | * Output from Control-V is slow. | |
3055 | ||
3056 | On many bit-map terminals, scrolling operations are fairly slow. | |
3057 | Often the termcap entry for the type of terminal in use fails | |
3058 | to inform Emacs of this. The two lines at the bottom of the screen | |
3059 | before a Control-V command are supposed to appear at the top after | |
3060 | the Control-V command. If Emacs thinks scrolling the lines is fast, | |
3061 | it will scroll them to the top of the screen. | |
3062 | ||
3063 | If scrolling is slow but Emacs thinks it is fast, the usual reason is | |
3064 | that the termcap entry for the terminal you are using does not | |
3065 | specify any padding time for the `al' and `dl' strings. Emacs | |
3066 | concludes that these operations take only as much time as it takes to | |
3067 | send the commands at whatever line speed you are using. You must | |
3068 | fix the termcap entry to specify, for the `al' and `dl', as much | |
3069 | time as the operations really take. | |
3070 | ||
3071 | Currently Emacs thinks in terms of serial lines which send characters | |
3072 | at a fixed rate, so that any operation which takes time for the | |
3073 | terminal to execute must also be padded. With bit-map terminals | |
3074 | operated across networks, often the network provides some sort of | |
3075 | flow control so that padding is never needed no matter how slow | |
3076 | an operation is. You must still specify a padding time if you want | |
3077 | Emacs to realize that the operation takes a long time. This will | |
3078 | cause padding characters to be sent unnecessarily, but they do | |
3079 | not really cost much. They will be transmitted while the scrolling | |
3080 | is happening and then discarded quickly by the terminal. | |
3081 | ||
3082 | Most bit-map terminals provide commands for inserting or deleting | |
3083 | multiple lines at once. Define the `AL' and `DL' strings in the | |
3084 | termcap entry to say how to do these things, and you will have | |
3085 | fast output without wasted padding characters. These strings should | |
3086 | each contain a single %-spec saying how to send the number of lines | |
3087 | to be scrolled. These %-specs are like those in the termcap | |
3088 | `cm' string. | |
3089 | ||
3090 | You should also define the `IC' and `DC' strings if your terminal | |
3091 | has a command to insert or delete multiple characters. These | |
3092 | take the number of positions to insert or delete as an argument. | |
3093 | ||
3094 | A `cs' string to set the scrolling region will reduce the amount | |
3095 | of motion you see on the screen when part of the screen is scrolled. | |
3096 | ||
3097 | * Your Delete key sends a Backspace to the terminal, using an AIXterm. | |
3098 | ||
3099 | The solution is to include in your .Xdefaults the lines: | |
3100 | ||
3101 | *aixterm.Translations: #override <Key>BackSpace: string(0x7f) | |
3102 | aixterm*ttyModes: erase ^? | |
3103 | ||
3104 | This makes your Backspace key send DEL (ASCII 127). | |
3105 | ||
3106 | * You type Control-H (Backspace) expecting to delete characters. | |
3107 | ||
3108 | Put `stty dec' in your .login file and your problems will disappear | |
3109 | after a day or two. | |
3110 | ||
3111 | The choice of Backspace for erasure was based on confusion, caused by | |
3112 | the fact that backspacing causes erasure (later, when you type another | |
3113 | character) on most display terminals. But it is a mistake. Deletion | |
3114 | of text is not the same thing as backspacing followed by failure to | |
3115 | overprint. I do not wish to propagate this confusion by conforming | |
3116 | to it. | |
3117 | ||
3118 | For this reason, I believe `stty dec' is the right mode to use, | |
3119 | and I have designed Emacs to go with that. If there were a thousand | |
3120 | other control characters, I would define Control-h to delete as well; | |
3121 | but there are not very many other control characters, and I think | |
3122 | that providing the most mnemonic possible Help character is more | |
3123 | important than adapting to people who don't use `stty dec'. | |
3124 | ||
3125 | If you are obstinate about confusing buggy overprinting with deletion, | |
3126 | you can redefine Backspace in your .emacs file: | |
3127 | (global-set-key "\b" 'delete-backward-char) | |
3128 | You can probably access help-command via f1. | |
3129 | ||
3130 | * Editing files through RFS gives spurious "file has changed" warnings. | |
3131 | It is possible that a change in Emacs 18.37 gets around this problem, | |
3132 | but in case not, here is a description of how to fix the RFS bug that | |
3133 | causes it. | |
3134 | ||
3135 | There was a serious pair of bugs in the handling of the fsync() system | |
3136 | call in the RFS server. | |
3137 | ||
3138 | The first is that the fsync() call is handled as another name for the | |
3139 | close() system call (!!). It appears that fsync() is not used by very | |
3140 | many programs; Emacs version 18 does an fsync() before closing files | |
3141 | to make sure that the bits are on the disk. | |
3142 | ||
3143 | This is fixed by the enclosed patch to the RFS server. | |
3144 | ||
3145 | The second, more serious problem, is that fsync() is treated as a | |
3146 | non-blocking system call (i.e., it's implemented as a message that | |
3147 | gets sent to the remote system without waiting for a reply). Fsync is | |
3148 | a useful tool for building atomic file transactions. Implementing it | |
3149 | as a non-blocking RPC call (when the local call blocks until the sync | |
3150 | is done) is a bad idea; unfortunately, changing it will break the RFS | |
3151 | protocol. No fix was supplied for this problem. | |
3152 | ||
3153 | (as always, your line numbers may vary) | |
3154 | ||
3155 | % rcsdiff -c -r1.2 serversyscall.c | |
3156 | RCS file: RCS/serversyscall.c,v | |
3157 | retrieving revision 1.2 | |
3158 | diff -c -r1.2 serversyscall.c | |
3159 | *** /tmp/,RCSt1003677 Wed Jan 28 15:15:02 1987 | |
3160 | --- serversyscall.c Wed Jan 28 15:14:48 1987 | |
3161 | *************** | |
3162 | *** 163,169 **** | |
3163 | /* | |
3164 | * No return sent for close or fsync! | |
3165 | */ | |
3166 | ! if (syscall == RSYS_close || syscall == RSYS_fsync) | |
3167 | proc->p_returnval = deallocate_fd(proc, msg->m_args[0]); | |
3168 | else | |
3169 | { | |
3170 | --- 166,172 ---- | |
3171 | /* | |
3172 | * No return sent for close or fsync! | |
3173 | */ | |
3174 | ! if (syscall == RSYS_close) | |
3175 | proc->p_returnval = deallocate_fd(proc, msg->m_args[0]); | |
3176 | else | |
3177 | { | |
3178 | ||
3179 | * Vax C compiler bugs affecting Emacs. | |
3180 | ||
3181 | You may get one of these problems compiling Emacs: | |
3182 | ||
3183 | foo.c line nnn: compiler error: no table entry for op STASG | |
3184 | foo.c: fatal error in /lib/ccom | |
3185 | ||
3186 | These are due to bugs in the C compiler; the code is valid C. | |
3187 | Unfortunately, the bugs are unpredictable: the same construct | |
3188 | may compile properly or trigger one of these bugs, depending | |
3189 | on what else is in the source file being compiled. Even changes | |
3190 | in header files that should not affect the file being compiled | |
3191 | can affect whether the bug happens. In addition, sometimes files | |
3192 | that compile correctly on one machine get this bug on another machine. | |
3193 | ||
3194 | As a result, it is hard for me to make sure this bug will not affect | |
3195 | you. I have attempted to find and alter these constructs, but more | |
3196 | can always appear. However, I can tell you how to deal with it if it | |
3197 | should happen. The bug comes from having an indexed reference to an | |
3198 | array of Lisp_Objects, as an argument in a function call: | |
3199 | Lisp_Object *args; | |
3200 | ... | |
3201 | ... foo (5, args[i], ...)... | |
3202 | putting the argument into a temporary variable first, as in | |
3203 | Lisp_Object *args; | |
3204 | Lisp_Object tem; | |
3205 | ... | |
3206 | tem = args[i]; | |
3207 | ... foo (r, tem, ...)... | |
3208 | causes the problem to go away. | |
3209 | The `contents' field of a Lisp vector is an array of Lisp_Objects, | |
3210 | so you may see the problem happening with indexed references to that. | |
3211 | ||
3212 | * 68000 C compiler problems | |
3213 | ||
3214 | Various 68000 compilers have different problems. | |
3215 | These are some that have been observed. | |
3216 | ||
3217 | ** Using value of assignment expression on union type loses. | |
3218 | This means that x = y = z; or foo (x = z); does not work | |
3219 | if x is of type Lisp_Object. | |
3220 | ||
3221 | ** "cannot reclaim" error. | |
3222 | ||
3223 | This means that an expression is too complicated. You get the correct | |
3224 | line number in the error message. The code must be rewritten with | |
3225 | simpler expressions. | |
3226 | ||
3227 | ** XCONS, XSTRING, etc macros produce incorrect code. | |
3228 | ||
3229 | If temacs fails to run at all, this may be the cause. | |
3230 | Compile this test program and look at the assembler code: | |
3231 | ||
3232 | struct foo { char x; unsigned int y : 24; }; | |
3233 | ||
3234 | lose (arg) | |
3235 | struct foo arg; | |
3236 | { | |
3237 | test ((int *) arg.y); | |
3238 | } | |
3239 | ||
3240 | If the code is incorrect, your compiler has this problem. | |
3241 | In the XCONS, etc., macros in lisp.h you must replace (a).u.val with | |
3242 | ((a).u.val + coercedummy) where coercedummy is declared as int. | |
3243 | ||
3244 | This problem will not happen if the m-...h file for your type | |
3245 | of machine defines NO_UNION_TYPE. That is the recommended setting now. | |
3246 | ||
3247 | * C compilers lose on returning unions | |
3248 | ||
3249 | I hear that some C compilers cannot handle returning a union type. | |
3250 | Most of the functions in GNU Emacs return type Lisp_Object, which is | |
3251 | defined as a union on some rare architectures. | |
3252 | ||
3253 | This problem will not happen if the m-...h file for your type | |
3254 | of machine defines NO_UNION_TYPE. | |
3255 |