annotate PROBLEMS @ 335:54f7aa390f4f r21-0-65

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