annotate PROBLEMS @ 44:8d2a9b52c682 r19-15prefinal

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