annotate etc/PROBLEMS @ 68082:dfbba4e99c09

*** empty log message ***
author Eli Zaretskii <eliz@gnu.org>
date Sat, 07 Jan 2006 15:12:32 +0000
parents 0fa61a6c1680
children e8a3fb527b77 7beb78bc1f8e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1 This file describes various problems that have been encountered
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2 in compiling, installing and running GNU Emacs. Try doing Ctl-C Ctl-t
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3 and browsing through the outline headers.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
5 * Emacs startup failures
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
6
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
7 ** Emacs fails to start, complaining about missing fonts.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
8
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
9 A typical error message might be something like
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
10
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
11 No fonts match `-*-fixed-medium-r-*--6-*-*-*-*-*-iso8859-1'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
12
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
13 This happens because some X resource specifies a bad font family for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
14 Emacs to use. The possible places where this specification might be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
15 are:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
16
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
17 - in your ~/.Xdefaults file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
18
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
19 - client-side X resource file, such as ~/Emacs or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
20 /usr/X11R6/lib/app-defaults/Emacs or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
21 /usr/X11R6/lib/X11/app-defaults/Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
22
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
23 One of these files might have bad or malformed specification of a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
24 fontset that Emacs should use. To fix the problem, you need to find
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
25 the problematic line(s) and correct them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
26
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
27 ** Emacs aborts while starting up, only when run without X.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
28
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
29 This problem often results from compiling Emacs with GCC when GCC was
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
30 installed incorrectly. The usual error in installing GCC is to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
31 specify --includedir=/usr/include. Installation of GCC makes
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
32 corrected copies of the system header files. GCC is supposed to use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
33 the corrected copies in preference to the original system headers.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
34 Specifying --includedir=/usr/include causes the original system header
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
35 files to be used. On some systems, the definition of ioctl in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
36 original system header files is invalid for ANSI C and causes Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
37 not to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
38
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
39 The fix is to reinstall GCC, and this time do not specify --includedir
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
40 when you configure it. Then recompile Emacs. Specifying --includedir
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
41 is appropriate only in very special cases and it should *never* be the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
42 same directory where system header files are kept.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
43
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
44 ** Emacs does not start, complaining that it cannot open termcap database file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
45
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
46 If your system uses Terminfo rather than termcap (most modern
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
47 systems do), this could happen if the proper version of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
48 ncurses is not visible to the Emacs configure script (i.e. it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
49 cannot be found along the usual path the linker looks for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
50 libraries). It can happen because your version of ncurses is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
51 obsolete, or is available only in form of binaries.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
52
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
53 The solution is to install an up-to-date version of ncurses in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
54 the developer's form (header files, static libraries and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
55 symbolic links); in some GNU/Linux distributions (e.g. Debian)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
56 it constitutes a separate package.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
57
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
58 ** Emacs 20 and later fails to load Lisp files at startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
59
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
60 The typical error message might be like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
61
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
62 "Cannot open load file: fontset"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
63
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
64 This could happen if you compress the file lisp/subdirs.el. That file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
65 tells Emacs what are the directories where it should look for Lisp
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
66 files. Emacs cannot work with subdirs.el compressed, since the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
67 Auto-compress mode it needs for this will not be loaded until later,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
68 when your .emacs file is processed. (The package `fontset.el' is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
69 required to set up fonts used to display text on window systems, and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
70 it's loaded very early in the startup procedure.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
71
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
72 Similarly, any other .el file for which there's no corresponding .elc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
73 file could fail to load if it is compressed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
74
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
75 The solution is to uncompress all .el files which don't have a .elc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
76 file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
77
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
78 Another possible reason for such failures is stale *.elc files
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
79 lurking somewhere on your load-path. The following command will
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
80 print any duplicate Lisp files that are present in load-path:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
81
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
82 emacs -q -batch -f list-load-path-shadows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
83
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
84 If this command prints any file names, some of these files are stale,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
85 and should be deleted or their directories removed from your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
86 load-path.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
87
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
88 ** Emacs prints an error at startup after upgrading from an earlier version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
89
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
90 An example of such an error is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
91
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
92 x-complement-fontset-spec: "Wrong type argument: stringp, nil"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
93
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
94 This can be another symptom of stale *.elc files in your load-path.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
95 The following command will print any duplicate Lisp files that are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
96 present in load-path:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
97
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
98 emacs -q -batch -f list-load-path-shadows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
99
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
100 If this command prints any file names, some of these files are stale,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
101 and should be deleted or their directories removed from your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
102 load-path.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
103
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
104 ** With X11R6.4, public-patch-3, Emacs crashes at startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
105
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
106 Reportedly this patch in X fixes the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
107
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
108 --- xc/lib/X11/imInt.c~ Wed Jun 30 13:31:56 1999
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
109 +++ xc/lib/X11/imInt.c Thu Jul 1 15:10:27 1999
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
110 @@ -1,4 +1,4 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
111 -/* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
112 +/* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
113 /******************************************************************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
114
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
115 Copyright 1992, 1993, 1994 by FUJITSU LIMITED
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
116 @@ -166,8 +166,8 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
117 _XimMakeImName(lcd)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
118 XLCd lcd;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
119 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
120 - char* begin;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
121 - char* end;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
122 + char* begin = NULL;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
123 + char* end = NULL;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
124 char* ret;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
125 int i = 0;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
126 char* ximmodifier = XIMMODIFIER;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
127 @@ -182,7 +182,11 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
128 }
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
129 ret = Xmalloc(end - begin + 2);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
130 if (ret != NULL) {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
131 - (void)strncpy(ret, begin, end - begin + 1);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
132 + if (begin != NULL) {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
133 + (void)strncpy(ret, begin, end - begin + 1);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
134 + } else {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
135 + ret[0] = '\0';
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
136 + }
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
137 ret[end - begin + 1] = '\0';
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
138 }
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
139 return ret;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
140
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
141 * Crash bugs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
142
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
143 ** Emacs crashes in x-popup-dialog.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
144
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
145 This can happen if the dialog widget cannot find the font it wants to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
146 use. You can work around the problem by specifying another font with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
147 an X resource--for example, `Emacs.dialog*.font: 9x15' (or any font that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
148 happens to exist on your X server).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
149
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
150 ** Emacs crashes when you use Bibtex mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
151
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
152 This happens if your system puts a small limit on stack size. You can
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
153 prevent the problem by using a suitable shell command (often `ulimit')
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
154 to raise the stack size limit before you run Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
155
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
156 Patches to raise the stack size limit automatically in `main'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
157 (src/emacs.c) on various systems would be greatly appreciated.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
158
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
159 ** Error message `Symbol's value as variable is void: x', followed by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
160 a segmentation fault and core dump.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
161
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
162 This has been tracked to a bug in tar! People report that tar erroneously
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
163 added a line like this at the beginning of files of Lisp code:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
164
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
165 x FILENAME, N bytes, B tape blocks
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
166
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
167 If your tar has this problem, install GNU tar--if you can manage to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
168 untar it :-).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
169
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
170 ** Crashes when displaying GIF images in Emacs built with version
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
171 libungif-4.1.0 are resolved by using version libungif-4.1.0b1.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
172 Configure checks for the correct version, but this problem could occur
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
173 if a binary built against a shared libungif is run on a system with an
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
174 older version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
175
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
176 ** Emacs aborts inside the function `tparam1'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
177
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
178 This can happen if Emacs was built without terminfo support, but the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
179 terminal's capabilities use format that is only supported by terminfo.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
180 If your system has ncurses installed, this might happen if your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
181 version of ncurses is broken; upgrading to a newer version of ncurses
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
182 and reconfiguring and rebuilding Emacs should solve this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
183
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
184 All modern systems support terminfo, so even if ncurses is not the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
185 problem, you should look for a way to configure Emacs so that it uses
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
186 terminfo when built.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
187
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
188 ** Emacs crashes when using the Exceed 6.0 X server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
189
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
190 If you are using Exceed 6.1, upgrade to a later version. This was
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
191 reported to prevent the crashes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
192
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
193 ** Emacs crashes with SIGSEGV in XtInitializeWidgetClass.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
194
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
195 It crashes on X, but runs fine when called with option "-nw".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
197 This has been observed when Emacs is linked with GNU ld but without passing
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
198 the -z nocombreloc flag. Emacs normally knows to pass the -z nocombreloc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
199 flag when needed, so if you come across a situation where the flag is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
200 necessary but missing, please report it via M-x report-emacs-bug.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
201
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
202 On platforms such as Solaris, you can also work around this problem by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
203 configuring your compiler to use the native linker instead of GNU ld.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
204
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
205 * General runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
206
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
207 ** Lisp problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
208
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
209 *** Changes made to .el files do not take effect.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
210
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
211 You may have forgotten to recompile them into .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
212 Then the old .elc files will be loaded, and your changes
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
213 will not be seen. To fix this, do M-x byte-recompile-directory
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
214 and specify the directory that contains the Lisp files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
215
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
216 Emacs should print a warning when loading a .elc file which is older
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
217 than the corresponding .el file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
218
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
219 *** Watch out for .emacs files and EMACSLOADPATH environment vars.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
220
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
221 These control the actions of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
222 ~/.emacs is your Emacs init file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
223 EMACSLOADPATH overrides which directories the function
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
224 "load" will search.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
225
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
226 If you observe strange problems, check for these and get rid
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
227 of them, then try again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
228
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
229 *** Using epop3.el package causes Emacs to signal an error.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
230
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
231 The error message might be something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
232
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
233 "Lisp nesting exceeds max-lisp-eval-depth"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
234
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
235 This happens because epop3 redefines the function gethash, which is a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
236 built-in primitive beginning with Emacs 21.1. We don't have a patch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
237 for epop3 that fixes this, but perhaps a newer version of epop3
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
238 corrects that.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
239
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
240 *** Buffers from `with-output-to-temp-buffer' get set up in Help mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
241
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
242 Changes in Emacs 20.4 to the hooks used by that function cause
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
243 problems for some packages, specifically BBDB. See the function's
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
244 documentation for the hooks involved. BBDB 2.00.06 fixes the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
245
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
246 *** The Hyperbole package causes *Help* buffers not to be displayed in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
247 Help mode due to setting `temp-buffer-show-hook' rather than using
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
248 `add-hook'. Using `(add-hook 'temp-buffer-show-hook
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
249 'help-mode-maybe)' after loading Hyperbole should fix this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
250
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
251 ** Keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
252
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
253 *** "Compose Character" key does strange things when used as a Meta key.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
254
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
255 If you define one key to serve as both Meta and Compose Character, you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
256 will get strange results. In previous Emacs versions, this "worked"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
257 in that the key acted as Meta--that's because the older Emacs versions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
258 did not try to support Compose Character. Now Emacs tries to do
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
259 character composition in the standard X way. This means that you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
260 must pick one meaning or the other for any given key.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
262 You can use both functions (Meta, and Compose Character) if you assign
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
263 them to two different keys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
264
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
265 *** C-z just refreshes the screen instead of suspending Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
266
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
267 You are probably using a shell that doesn't support job control, even
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
268 though the system itself is capable of it. Either use a different shell,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
269 or set the variable `cannot-suspend' to a non-nil value.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
270
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
271 *** With M-x enable-flow-control, you need to type C-\ twice
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
272 to do incremental search--a single C-\ gets no response.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
273
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
274 This has been traced to communicating with your machine via kermit,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
275 with C-\ as the kermit escape character. One solution is to use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
276 another escape character in kermit. One user did
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
277
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
278 set escape-character 17
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
279
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
280 in his .kermrc file, to make C-q the kermit escape character.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
282 ** Mailers and other helper programs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
283
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
284 *** movemail compiled with POP support can't connect to the POP server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
285
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
286 Make sure that the `pop' entry in /etc/services, or in the services
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
287 NIS map if your machine uses NIS, has the same port number as the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
288 entry on the POP server. A common error is for the POP server to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
289 listening on port 110, the assigned port for the POP3 protocol, while
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
290 the client is trying to connect on port 109, the assigned port for the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
291 old POP protocol.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
292
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
293 *** RMAIL gets error getting new mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
294
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
295 RMAIL gets new mail from /usr/spool/mail/$USER using a program
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
296 called `movemail'. This program interlocks with /bin/mail using
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
297 the protocol defined by /bin/mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
298
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
299 There are two different protocols in general use. One of them uses
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
300 the `flock' system call. The other involves creating a lock file;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
301 `movemail' must be able to write in /usr/spool/mail in order to do
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
302 this. You control which one is used by defining, or not defining,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
303 the macro MAIL_USE_FLOCK in config.h or the m- or s- file it includes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
304 IF YOU DON'T USE THE FORM OF INTERLOCKING THAT IS NORMAL ON YOUR
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
305 SYSTEM, YOU CAN LOSE MAIL!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
306
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
307 If your system uses the lock file protocol, and fascist restrictions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
308 prevent ordinary users from writing the lock files in /usr/spool/mail,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
309 you may need to make `movemail' setgid to a suitable group such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
310 `mail'. You can use these commands (as root):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
311
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
312 chgrp mail movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
313 chmod 2755 movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
314
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
315 If your system uses the lock file protocol, and fascist restrictions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
316 prevent ordinary users from writing the lock files in /usr/spool/mail,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
317 you may need to make `movemail' setgid to a suitable group such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
318 `mail'. To do this, use the following commands (as root) after doing the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
319 make install.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
320
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
321 chgrp mail movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
322 chmod 2755 movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
323
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
324 Installation normally copies movemail from the build directory to an
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
325 installation directory which is usually under /usr/local/lib. The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
326 installed copy of movemail is usually in the directory
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
327 /usr/local/lib/emacs/VERSION/TARGET. You must change the group and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
328 mode of the installed copy; changing the group and mode of the build
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
329 directory copy is ineffective.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
330
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
331 *** rcs2log gives you the awk error message "too many fields".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
332
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
333 This is due to an arbitrary limit in certain versions of awk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
334 The solution is to use gawk (GNU awk).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
335
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
336 ** Problems with hostname resolution
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
337
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
338 *** Emacs fails to understand most Internet host names, even though
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
339 the names work properly with other programs on the same system.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
340 *** Emacs won't work with X-windows if the value of DISPLAY is HOSTNAME:0.
65134
c0ac29c13790 Fix capitalization of "Gnus".
Romain Francoise <romain@orebokech.com>
parents: 65088
diff changeset
341 *** Gnus can't make contact with the specified host for nntp.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
342
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
343 This typically happens on Suns and other systems that use shared
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
344 libraries. The cause is that the site has installed a version of the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
345 shared library which uses a name server--but has not installed a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
346 similar version of the unshared library which Emacs uses.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
347
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
348 The result is that most programs, using the shared library, work with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
349 the nameserver, but Emacs does not.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
350
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
351 The fix is to install an unshared library that corresponds to what you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
352 installed in the shared library, and then relink Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
353
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
354 On SunOS 4.1, simply define HAVE_RES_INIT.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
355
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
356 If you have already installed the name resolver in the file libresolv.a,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
357 then you need to compile Emacs to use that library. The easiest way to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
358 do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
359 or LIB_STANDARD which uses -lresolv. Watch out! If you redefine a macro
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
360 that is already in use in your configuration to supply some other libraries,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
361 be careful not to lose the others.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
362
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
363 Thus, you could start by adding this to config.h:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
364
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
365 #define LIBS_SYSTEM -lresolv
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
366
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
367 Then if this gives you an error for redefining a macro, and you see that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
368 the s- file defines LIBS_SYSTEM as -lfoo -lbar, you could change config.h
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
369 again to say this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
370
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
371 #define LIBS_SYSTEM -lresolv -lfoo -lbar
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
372
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
373 *** Emacs does not know your host's fully-qualified domain name.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
374
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
375 You need to configure your machine with a fully qualified domain name,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
376 either in /etc/hosts, /etc/hostname, the NIS, or wherever your system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
377 calls for specifying this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
378
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
379 If you cannot fix the configuration, you can set the Lisp variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
380 mail-host-address to the value you want.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
381
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
382 ** NFS and RFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
383
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
384 *** Emacs says it has saved a file, but the file does not actually
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
385 appear on disk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
386
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
387 This can happen on certain systems when you are using NFS, if the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
388 remote disk is full. It is due to a bug in NFS (or certain NFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
389 implementations), and there is apparently nothing Emacs can do to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
390 detect the problem. Emacs checks the failure codes of all the system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
391 calls involved in writing a file, including `close'; but in the case
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
392 where the problem occurs, none of those system calls fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
393
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
394 *** Editing files through RFS gives spurious "file has changed" warnings.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
395 It is possible that a change in Emacs 18.37 gets around this problem,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
396 but in case not, here is a description of how to fix the RFS bug that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
397 causes it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
398
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
399 There was a serious pair of bugs in the handling of the fsync() system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
400 call in the RFS server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
401
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
402 The first is that the fsync() call is handled as another name for the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
403 close() system call (!!). It appears that fsync() is not used by very
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
404 many programs; Emacs version 18 does an fsync() before closing files
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
405 to make sure that the bits are on the disk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
406
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
407 This is fixed by the enclosed patch to the RFS server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
408
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
409 The second, more serious problem, is that fsync() is treated as a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
410 non-blocking system call (i.e., it's implemented as a message that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
411 gets sent to the remote system without waiting for a reply). Fsync is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
412 a useful tool for building atomic file transactions. Implementing it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
413 as a non-blocking RPC call (when the local call blocks until the sync
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
414 is done) is a bad idea; unfortunately, changing it will break the RFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
415 protocol. No fix was supplied for this problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
416
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
417 (as always, your line numbers may vary)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
418
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
419 % rcsdiff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
420 RCS file: RCS/serversyscall.c,v
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
421 retrieving revision 1.2
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
422 diff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
423 *** /tmp/,RCSt1003677 Wed Jan 28 15:15:02 1987
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
424 --- serversyscall.c Wed Jan 28 15:14:48 1987
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
425 ***************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
426 *** 163,169 ****
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
427 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
428 * No return sent for close or fsync!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
429 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
430 ! if (syscall == RSYS_close || syscall == RSYS_fsync)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
431 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
432 else
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
433 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
434 --- 166,172 ----
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
435 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
436 * No return sent for close or fsync!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
437 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
438 ! if (syscall == RSYS_close)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
439 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
440 else
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
441 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
442
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
443 ** PSGML
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
444
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
445 *** Old versions of the PSGML package use the obsolete variables
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
446 `before-change-function' and `after-change-function', which are no
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
447 longer used by Emacs. Please use PSGML 1.2.3 or later.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
448
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
449 *** PSGML conflicts with sgml-mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
450
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
451 PSGML package uses the same names of some variables (like keymap)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
452 as built-in sgml-mode.el because it was created as a replacement
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
453 of that package. The conflict will be shown if you load
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
454 sgml-mode.el before psgml.el. E.g. this could happen if you edit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
455 HTML page and then start to work with SGML or XML file. html-mode
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
456 (from sgml-mode.el) is used for HTML file and loading of psgml.el
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
457 (for sgml-mode or xml-mode) will cause an error.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
458
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
459 *** Versions of the PSGML package earlier than 1.0.3 (stable) or 1.1.2
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
460 (alpha) fail to parse DTD files correctly in Emacs 20.3 and later.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
461 Here is a patch for psgml-parse.el from PSGML 1.0.1 and, probably,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
462 earlier versions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
463
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
464 --- psgml-parse.el 1998/08/21 19:18:18 1.1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
465 +++ psgml-parse.el 1998/08/21 19:20:00
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
466 @@ -2383,7 +2383,7 @@ (defun sgml-push-to-entity (entity &opti
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
467 (setq sgml-buffer-parse-state nil))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
468 (cond
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
469 ((stringp entity) ; a file name
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
470 - (save-excursion (insert-file-contents entity))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
471 + (insert-file-contents entity)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
472 (setq default-directory (file-name-directory entity)))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
473 ((consp (sgml-entity-text entity)) ; external id?
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
474 (let* ((extid (sgml-entity-text entity))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
475
56754
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
476 ** AUCTeX
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
477
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
478 You should not be using a version older than 11.52 if you can avoid
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
479 it.
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
480
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
481 *** Emacs 21 freezes when visiting a TeX file with AUCTeX installed.
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
482
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
483 Emacs 21 needs version 10 or later of AUCTeX; upgrading should solve
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
484 these problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
485
56754
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
486 *** No colors in AUCTeX with Emacs 21.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
487
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
488 Upgrade to AUC TeX version 10 or later, and make sure it is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
489 byte-compiled with Emacs 21.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
490
60158
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
491 ** PCL-CVS
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
492
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
493 *** Lines are not updated or new lines are added in the buffer upon commit.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
494
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
495 When committing files located higher in the hierarchy than the examined
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
496 directory, some versions of the CVS program return an ambiguous message
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
497 from which PCL-CVS cannot extract the full location of the committed
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
498 files. As a result, the corresponding lines in the PCL-CVS buffer are
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
499 not updated with the new revision of these files, and new lines are
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
500 added to the top-level directory.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
501
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
502 This can happen with CVS versions 1.12.8 and 1.12.9. Upgrade to CVS
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
503 1.12.10 or newer to fix this problem.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
504
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
505 ** Miscellaneous problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
506
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
507 *** Self-documentation messages are garbled.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
508
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
509 This means that the file `etc/DOC-...' doesn't properly correspond
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
510 with the Emacs executable. Redumping Emacs and then installing the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
511 corresponding pair of files should fix the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
512
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
513 *** Programs running under terminal emulator do not recognize `emacs'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
514 terminal type.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
515
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
516 The cause of this is a shell startup file that sets the TERMCAP
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
517 environment variable. The terminal emulator uses that variable to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
518 provide the information on the special terminal type that Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
519 emulates.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
520
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
521 Rewrite your shell startup file so that it does not change TERMCAP
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
522 in such a case. You could use the following conditional which sets
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
523 it only if it is undefined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
524
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
525 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
526
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
527 Or you could set TERMCAP only when you set TERM--which should not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
528 happen in a non-login shell.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
529
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
530 *** In Shell mode, you get a ^M at the end of every line.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
531
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
532 This happens to people who use tcsh, because it is trying to be too
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
533 smart. It sees that the Shell uses terminal type `unknown' and turns
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
534 on the flag to output ^M at the end of each line. You can fix the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
535 problem by adding this to your .cshrc file:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
536
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
537 if ($?EMACS) then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
538 if ($EMACS == "t") then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
539 unset edit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
540 stty -icrnl -onlcr -echo susp ^Z
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
541 endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
542 endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
543
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
544 *** Emacs startup on GNU/Linux systems (and possibly other systems) is slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
545
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
546 This can happen if the system is misconfigured and Emacs can't get the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
547 full qualified domain name, FQDN. You should have your FQDN in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
548 /etc/hosts file, something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
549
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
550 127.0.0.1 localhost
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
551 129.187.137.82 nuc04.t30.physik.tu-muenchen.de nuc04
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
552
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
553 The way to set this up may vary on non-GNU systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
554
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
555 *** Attempting to visit remote files via ange-ftp fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
556
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
557 If the error message is "ange-ftp-file-modtime: Specified time is not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
558 representable", then this could happen when `lukemftp' is used as the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
559 ftp client. This was reported to happen on Debian GNU/Linux, kernel
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
560 version 2.4.3, with `lukemftp' 1.5-5, but might happen on other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
561 systems as well. To avoid this problem, switch to using the standard
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
562 ftp client. On a Debian system, type
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
563
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
564 update-alternatives --config ftp
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
565
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
566 and then choose /usr/bin/netkit-ftp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
567
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
568 *** JPEG images aren't displayed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
569
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
570 This has been reported when Emacs is built with jpeg-6a library.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
571 Upgrading to jpeg-6b solves the problem. Configure checks for the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
572 correct version, but this problem could occur if a binary built
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
573 against a shared libjpeg is run on a system with an older version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
574
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
575 *** Dired is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
576
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
577 This could happen if invocation of the `df' program takes a long
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
578 time. Possible reasons for this include:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
579
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
580 - ClearCase mounted filesystems (VOBs) that sometimes make `df'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
581 response time extremely slow (dozens of seconds);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
582
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
583 - slow automounters on some old versions of Unix;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
584
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
585 - slow operation of some versions of `df'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
586
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
587 To work around the problem, you could either (a) set the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
588 `directory-free-space-program' to nil, and thus prevent Emacs from
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
589 invoking `df'; (b) use `df' from the GNU Fileutils package; or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
590 (c) use CVS, which is Free Software, instead of ClearCase.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
591
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
592 *** Versions of the W3 package released before Emacs 21.1 don't run
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
593 under Emacs 21. This fixed in W3 version 4.0pre.47.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
594
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
595 *** The LDAP support rely on ldapsearch program from OpenLDAP version 2.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
596
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
597 It can fail to work with ldapsearch program from OpenLDAP version 1.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
598 Version 1 of OpenLDAP is now deprecated. If you are still using it,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
599 please upgrade to version 2. As a temporary workaround, remove
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
600 argument "-x" from the variable `ldap-ldapsearch-args'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
601
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
602 *** ps-print commands fail to find prologue files ps-prin*.ps.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
603
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
604 This can happen if you use an old version of X-Symbol package: it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
605 defines compatibility functions which trick ps-print into thinking it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
606 runs in XEmacs, and look for the prologue files in a wrong directory.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
607
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
608 The solution is to upgrade X-Symbol to a later version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
609
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
610 *** On systems with shared libraries you might encounter run-time errors
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
611 from the dynamic linker telling you that it is unable to find some
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
612 shared libraries, for instance those for Xaw3d or image support.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
613 These errors mean Emacs has been linked with a library whose shared
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
614 library is not in the default search path of the dynamic linker.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
615
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
616 Similar problems could prevent Emacs from building, since the build
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
617 process invokes Emacs several times.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
618
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
619 On many systems, it is possible to set LD_LIBRARY_PATH in your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
620 environment to specify additional directories where shared libraries
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
621 can be found.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
622
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
623 Other systems allow to set LD_RUN_PATH in a similar way, but before
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
624 Emacs is linked. With LD_RUN_PATH set, the linker will include a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
625 specified run-time search path in the executable.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
626
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
627 On some systems, Emacs can crash due to problems with dynamic
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
628 linking. Specifically, on SGI Irix 6.5, crashes were reported with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
629 backtraces like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
630
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
631 (dbx) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
632 0 strcmp(0xf49239d, 0x4031184, 0x40302b4, 0x12, 0xf0000000, 0xf4923aa, 0x0, 0x492ddb2) ["/xlv22/ficus-jan23/work/irix/lib/libc/libc_n32_M3_ns/strings/strcmp.s":35, 0xfb7e480]
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
633 1 general_find_symbol(0xf49239d, 0x0, 0x0, 0x0, 0xf0000000, 0xf4923aa, 0x0, 0x492ddb2)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
634 ["/comp2/mtibuild/v73/workarea/v7.3/rld/rld.c":2140, 0xfb65a98]
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
635 2 resolve_symbol(0xf49239d, 0x4031184, 0x0, 0xfbdd438, 0x0, 0xf4923aa, 0x0, 0x492ddb2)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
636 ["/comp2/mtibuild/v73/workarea/v7.3/rld/rld.c":1947, 0xfb657e4]
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
637 3 lazy_text_resolve(0xd18, 0x1a3, 0x40302b4, 0x12, 0xf0000000, 0xf4923aa, 0x0, 0x492ddb2)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
638 ["/comp2/mtibuild/v73/workarea/v7.3/rld/rld.c":997, 0xfb64d44]
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
639 4 _rld_text_resolve(0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
640 ["/comp2/mtibuild/v73/workarea/v7.3/rld/rld_bridge.s":175, 0xfb6032c]
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
641
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
642 (`rld' is the dynamic linker.) We don't know yet why this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
643 happens, but setting the environment variable LD_BIND_NOW to 1 (which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
644 forces the dynamic linker to bind all shared objects early on) seems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
645 to work around the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
646
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
647 Please refer to the documentation of your dynamic linker for details.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
648
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
649 *** You request inverse video, and the first Emacs frame is in inverse
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
650 video, but later frames are not in inverse video.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
651
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
652 This can happen if you have an old version of the custom library in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
653 your search path for Lisp packages. Use M-x list-load-path-shadows to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
654 check whether this is true. If it is, delete the old custom library.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
655
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
656 *** When you run Ispell from Emacs, it reports a "misalignment" error.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
657
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
658 This can happen if you compiled the Ispell program to use ASCII
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
659 characters only and then try to use it from Emacs with non-ASCII
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
660 characters, like Latin-1. The solution is to recompile Ispell with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
661 support for 8-bit characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
662
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
663 To see whether your Ispell program supports 8-bit characters, type
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
664 this at your shell's prompt:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
665
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
666 ispell -vv
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
667
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
668 and look in the output for the string "NO8BIT". If Ispell says
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
669 "!NO8BIT (8BIT)", your speller supports 8-bit characters; otherwise it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
670 does not.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
671
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
672 To rebuild Ispell with 8-bit character support, edit the local.h file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
673 in the Ispell distribution and make sure it does _not_ define NO8BIT.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
674 Then rebuild the speller.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
675
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
676 Another possible cause for "misalignment" error messages is that the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
677 version of Ispell installed on your machine is old. Upgrade.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
678
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
679 Yet another possibility is that you are trying to spell-check a word
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
680 in a language that doesn't fit the dictionary you choose for use by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
681 Ispell. (Ispell can only spell-check one language at a time, because
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
682 it uses a single dictionary.) Make sure that the text you are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
683 spelling and the dictionary used by Ispell conform to each other.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
684
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
685 If your spell-checking program is Aspell, it has been reported that if
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
686 you have a personal configuration file (normally ~/.aspell.conf), it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
687 can cause this error. Remove that file, execute `ispell-kill-ispell'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
688 in Emacs, and then try spell-checking again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
689
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
690 * Runtime problems related to font handling
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
691
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
692 ** Under X11, some characters appear as hollow boxes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
693
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
694 Each X11 font covers just a fraction of the characters that Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
695 supports. To display the whole range of Emacs characters requires
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
696 many different fonts, collected into a fontset.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
697
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
698 If some of the fonts called for in your fontset do not exist on your X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
699 server, then the characters that have no font appear as hollow boxes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
700 You can remedy the problem by installing additional fonts.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
701
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
702 The intlfonts distribution includes a full spectrum of fonts that can
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
703 display all the characters Emacs supports.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
704
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
705 Another cause of this for specific characters is fonts which have a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
706 missing glyph and no default character. This is known to occur for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
707 character number 160 (no-break space) in some fonts, such as Lucida
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
708 but Emacs sets the display table for the unibyte and Latin-1 version
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
709 of this character to display a space.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
710
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
711 ** Under X11, some characters appear improperly aligned in their lines.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
712
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
713 You may have bad X11 fonts; try installing the intlfonts distribution.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
714
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
715 ** Certain fonts make each line take one pixel more than it "should".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
716
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
717 This is because these fonts contain characters a little taller
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
718 than the font's nominal height. Emacs needs to make sure that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
719 lines do not overlap.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
720
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
721 ** Loading fonts is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
722
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
723 You might be getting scalable fonts instead of precomputed bitmaps.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
724 Known scalable font directories are "Type1" and "Speedo". A font
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
725 directory contains scalable fonts if it contains the file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
726 "fonts.scale".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
727
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
728 If this is so, re-order your X windows font path to put the scalable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
729 font directories last. See the documentation of `xset' for details.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
730
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
731 With some X servers, it may be necessary to take the scalable font
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
732 directories out of your path entirely, at least for Emacs 19.26.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
733 Changes in the future may make this unnecessary.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
735 ** Font Lock displays portions of the buffer in incorrect faces.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
736
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
737 By far the most frequent cause of this is a parenthesis `(' or a brace
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
738 `{' in column zero. Font Lock assumes that such a paren is outside of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
739 any comment or string. This is of course not true in general, but the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
740 vast majority of well-formatted program source files don't have such
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
741 parens, and therefore this assumption is used to allow optimizations
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
742 in Font Lock's syntactical analysis. These optimizations avoid some
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
743 pathological cases where jit-lock, the Just-in-Time fontification
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
744 introduced with Emacs 21.1, could significantly slow down scrolling
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
745 through the buffer, especially scrolling backwards, and also jumping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
746 to the end of a very large buffer.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
747
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
748 Beginning with version 22.1, a parenthesis or a brace in column zero
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
749 is highlighted in bold-red face if it is inside a string or a comment,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
750 to indicate that it could interfere with Font Lock (and also with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
751 indentation) and should be moved or escaped with a backslash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
752
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
753 If you don't use large buffers, or have a very fast machine which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
754 makes the delays insignificant, you can avoid the incorrect
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
755 fontification by setting the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
756 `font-lock-beginning-of-syntax-function' to a nil value. (This must
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
757 be done _after_ turning on Font Lock.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
758
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
759 Another alternative is to avoid a paren in column zero. For example,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
760 in a Lisp string you could precede the paren with a backslash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
761
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
762 ** With certain fonts, when the cursor appears on a character, the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
763 character doesn't appear--you get a solid box instead.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
764
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
765 One user on a Linux-based GNU system reported that this problem went
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
766 away with installation of a new X server. The failing server was
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
767 XFree86 3.1.1. XFree86 3.1.2 works.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
768
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
769 ** Characters are displayed as empty boxes or with wrong font under X.
52928
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
770
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
771 This can occur when two different versions of FontConfig are used.
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
772 For example, XFree86 4.3.0 has one version and Gnome usually comes
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
773 with a newer version. Emacs compiled with --with-gtk will then use
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
774 the newer version. In most cases the problem can be temporarily
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
775 fixed by stopping the application that has the error (it can be
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
776 Emacs or any other application), removing ~/.fonts.cache-1,
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
777 and then start the application again.
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
778 If removing ~/.fonts.cache-1 and restarting doesn't help, the
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
779 application with problem must be recompiled with the same version
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
780 of FontConfig as the rest of the system uses. For KDE, it is
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
781 sufficient to recompile Qt.
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
782
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
783 ** Emacs pauses for several seconds when changing the default font.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
784
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
785 This has been reported for fvwm 2.2.5 and the window manager of KDE
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
786 2.1. The reason for the pause is Xt waiting for a ConfigureNotify
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
787 event from the window manager, which the window manager doesn't send.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
788 Xt stops waiting after a default timeout of usually 5 seconds.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
789
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
790 A workaround for this is to add something like
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
791
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
792 emacs.waitForWM: false
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
793
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
794 to your X resources. Alternatively, add `(wait-for-wm . nil)' to a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
795 frame's parameter list, like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
796
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
797 (modify-frame-parameters nil '((wait-for-wm . nil)))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
798
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
799 (this should go into your `.emacs' file).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
800
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
801 ** Underlines appear at the wrong position.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
802
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
803 This is caused by fonts having a wrong UNDERLINE_POSITION property.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
804 Examples are the font 7x13 on XFree prior to version 4.1, or the jmk
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
805 neep font from the Debian xfonts-jmk package. To circumvent this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
806 problem, set x-use-underline-position-properties to nil in your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
807 `.emacs'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
808
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
809 To see what is the value of UNDERLINE_POSITION defined by the font,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
810 type `xlsfonts -lll FONT' and look at the font's UNDERLINE_POSITION
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
811 property.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
812
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
813 ** When using Exceed, fonts sometimes appear too tall.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
814
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
815 When the display is set to an Exceed X-server and fonts are specified
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
816 (either explicitly with the -fn option or implicitly with X resources)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
817 then the fonts may appear "too tall". The actual character sizes are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
818 correct but there is too much vertical spacing between rows, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
819 gives the appearance of "double spacing".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
820
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
821 To prevent this, turn off the Exceed's "automatic font substitution"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
822 feature (in the font part of the configuration window).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
823
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
824 * Internationalization problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
825
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
826 ** Characters from the mule-unicode charsets aren't displayed under X.
47994
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
827
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
828 XFree86 4 contains many fonts in iso10646-1 encoding which have
51316
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
829 minimal character repertoires (whereas the encoding part of the font
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
830 name is meant to be a reasonable indication of the repertoire
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
831 according to the XLFD spec). Emacs may choose one of these to display
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
832 characters from the mule-unicode charsets and then typically won't be
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
833 able to find the glyphs to display many characters. (Check with C-u
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
834 C-x = .) To avoid this, you may need to use a fontset which sets the
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
835 font for the mule-unicode sets explicitly. E.g. to use GNU unifont,
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
836 include in the fontset spec:
47994
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
837
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
838 mule-unicode-2500-33ff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
839 mule-unicode-e000-ffff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
840 mule-unicode-0100-24ff:-gnu-unifont-*-iso10646-1
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
841
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
842 ** The UTF-8/16/7 coding systems don't encode CJK (Far Eastern) characters.
51316
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
843
65518
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
844 Emacs directly supports the Unicode BMP whose code points are in the
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
845 ranges 0000-33ff and e000-ffff, and indirectly supports the parts of
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
846 CJK characters belonging to these legacy charsets:
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
847
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
848 GB2312, Big5, JISX0208, JISX0212, JISX0213-1, JISX0213-2, KSC5601
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
849
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
850 The latter support is done in Utf-Translate-Cjk mode (turned on by
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
851 default). Which Unicode CJK characters are decoded into which Emacs
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
852 charset is decided by the current language environment. For instance,
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
853 in Chinese-GB, most of them are decoded into chinese-gb2312.
51316
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
854
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
855 If you read UTF-8 data with code points outside these ranges, the
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
856 characters appear in the buffer as raw bytes of the original UTF-8
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
857 (composed into a single quasi-character) and they will be written back
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
858 correctly as UTF-8, assuming you don't break the composed sequences.
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
859 If you read such characters from UTF-16 or UTF-7 data, they are
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
860 substituted with the Unicode `replacement character', and you lose
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
861 information.
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
862
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
863 ** Mule-UCS loads very slowly.
46677
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
864
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
865 Changes to Emacs internals interact badly with Mule-UCS's `un-define'
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
866 library, which is the usual interface to Mule-UCS. Apply the
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
867 following patch to Mule-UCS 0.84 and rebuild it. That will help,
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
868 though loading will still be slower than in Emacs 20. (Some
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
869 distributions, such as Debian, may already have applied such a patch.)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
870
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
871 --- lisp/un-define.el 6 Mar 2001 22:41:38 -0000 1.30
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
872 +++ lisp/un-define.el 19 Apr 2002 18:34:26 -0000
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
873 @@ -610,13 +624,21 @@ by calling post-read-conversion and pre-
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
874
46677
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
875 (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
876 (lambda (x)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
877 - (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
878 - (lambda (y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
879 - (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
880 - (nth 0 y) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
881 - (nth 3 y) (nth 4 y) (nth 5 y) (nth 6 y))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
882 - (coding-system-put (car y) 'alias-coding-systems (list (car x))))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
883 - (cdr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
884 + (if (fboundp 'register-char-codings)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
885 + ;; Mule 5, where we don't need the eol-type specified and
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
886 + ;; register-char-codings may be very slow for these coding
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
887 + ;; system definitions.
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
888 + (let ((y (cadr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
889 + (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
890 + (car x) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
891 + (nth 3 y) (nth 4 y) (nth 5 y)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
892 + (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
893 + (lambda (y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
894 + (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
895 + (nth 0 y) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
896 + (nth 3 y) (nth 4 y) (nth 5 y) (nth 6 y))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
897 + (coding-system-put (car y) 'alias-coding-systems (list (car x)))))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
898 + (cdr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
899 `((utf-8
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
900 (utf-8-unix
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
901 ?u "UTF-8 coding system"
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
902
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
903 Note that Emacs has native support for Unicode, roughly equivalent to
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
904 Mule-UCS's, so you may not need it.
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
905
65362
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
906 ** Mule-UCS compilation problem.
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
907
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
908 Emacs of old versions and XEmacs byte-compile the form `(progn progn
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
909 ...)' the same way as `(progn ...)', but Emacs of version 21.3 and the
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
910 later process that form just as interpreter does, that is, as `progn'
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
911 variable reference. Apply the following patch to Mule-UCS 0.84 to
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
912 make it compiled by the latest Emacs.
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
913
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
914 --- mucs-ccl.el 2 Sep 2005 00:42:23 -0000 1.1.1.1
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
915 +++ mucs-ccl.el 2 Sep 2005 01:31:51 -0000 1.3
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
916 @@ -639,10 +639,14 @@
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
917 (mucs-notify-embedment 'mucs-ccl-required name)
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
918 (setq ccl-pgm-list (cdr ccl-pgm-list)))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
919 ; (message "MCCLREGFIN:%S" result)
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
920 - `(progn
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
921 - (setq mucs-ccl-facility-alist
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
922 - (quote ,mucs-ccl-facility-alist))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
923 - ,@result)))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
924 + ;; The only way the function is used in this package is included
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
925 + ;; in `mucs-package-definition-end-hook' value, where it must
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
926 + ;; return (possibly empty) *list* of forms. Do this. Do not rely
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
927 + ;; on byte compiler to remove extra `progn's in `(progn ...)'
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
928 + ;; form.
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
929 + `((setq mucs-ccl-facility-alist
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
930 + (quote ,mucs-ccl-facility-alist))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
931 + ,@result)))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
932
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
933 ;;; Add hook for embedding translation informations to a package.
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
934 (add-hook 'mucs-package-definition-end-hook
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
935
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
936 ** Accented ISO-8859-1 characters are displayed as | or _.
34721
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
937
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
938 Try other font set sizes (S-mouse-1). If the problem persists with
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
939 other sizes as well, your text is corrupted, probably through software
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
940 that is not 8-bit clean. If the problem goes away with another font
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
941 size, it's probably because some fonts pretend to be ISO-8859-1 fonts
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
942 when they are really ASCII fonts. In particular the schumacher-clean
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
943 fonts have this bug in some versions of X.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
944
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
945 To see what glyphs are included in a font, use `xfd', like this:
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
946
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
947 xfd -fn -schumacher-clean-medium-r-normal--12-120-75-75-c-60-iso8859-1
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
948
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
949 If this shows only ASCII glyphs, the font is indeed the source of the
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
950 problem.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
951
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
952 The solution is to remove the corresponding lines from the appropriate
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
953 `fonts.alias' file, then run `mkfontdir' in that directory, and then run
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
954 `xset fp rehash'.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
955
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
956 ** The `oc-unicode' package doesn't work with Emacs 21.
36112
1ddf9f48dc2f Document problems with oc-unicode.
Eli Zaretskii <eliz@gnu.org>
parents: 36004
diff changeset
957
36813
fcca57f520e5 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 36550
diff changeset
958 This package tries to define more private charsets than there are free
51132
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
959 slots now. The current built-in Unicode support is actually more
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
960 flexible. (Use option `utf-translate-cjk-mode' if you need CJK
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
961 support.) Files encoded as emacs-mule using oc-unicode aren't
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
962 generally read correctly by Emacs 21.
35645
141f70353995 Add two items with solutions for Calc problems.
Eli Zaretskii <eliz@gnu.org>
parents: 35575
diff changeset
963
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
964 ** After a while, Emacs slips into unibyte mode.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
965
Dave Love <fx@gnu.org>
parents:
diff changeset
966 The VM mail package, which is not part of Emacs, sometimes does
Dave Love <fx@gnu.org>
parents:
diff changeset
967 (standard-display-european t)
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
968 That should be changed to
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
969 (standard-display-european 1 t)
Dave Love <fx@gnu.org>
parents:
diff changeset
970
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
971 * X runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
972
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
973 ** X keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
974
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
975 *** You "lose characters" after typing Compose Character key.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
976
Dave Love <fx@gnu.org>
parents:
diff changeset
977 This is because the Compose Character key is defined as the keysym
Dave Love <fx@gnu.org>
parents:
diff changeset
978 Multi_key, and Emacs (seeing that) does the proper X11
Dave Love <fx@gnu.org>
parents:
diff changeset
979 character-composition processing. If you don't want your Compose key
Dave Love <fx@gnu.org>
parents:
diff changeset
980 to do that, you can redefine it with xmodmap.
Dave Love <fx@gnu.org>
parents:
diff changeset
981
Dave Love <fx@gnu.org>
parents:
diff changeset
982 For example, here's one way to turn it into a Meta key:
Dave Love <fx@gnu.org>
parents:
diff changeset
983
Dave Love <fx@gnu.org>
parents:
diff changeset
984 xmodmap -e "keysym Multi_key = Meta_L"
Dave Love <fx@gnu.org>
parents:
diff changeset
985
Dave Love <fx@gnu.org>
parents:
diff changeset
986 If all users at your site of a particular keyboard prefer Meta to
Dave Love <fx@gnu.org>
parents:
diff changeset
987 Compose, you can make the remapping happen automatically by adding the
Dave Love <fx@gnu.org>
parents:
diff changeset
988 xmodmap command to the xdm setup script for that display.
Dave Love <fx@gnu.org>
parents:
diff changeset
989
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
990 *** Using X Windows, control-shift-leftbutton makes Emacs hang.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
991
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
992 Use the shell command `xset bc' to make the old X Menu package work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
993
63756
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
994 *** C-SPC fails to work on Fedora GNU/Linux.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
995
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
996 Fedora Core 4 steals the C-SPC key by default for the `iiimx' program
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
997 which is the input method for some languages. It blocks Emacs users
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
998 from using the C-SPC key for `set-mark-command'.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
999
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1000 One solutions is to remove the `<Ctrl>space' from the `Iiimx' file
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1001 which can be found in the `/usr/lib/X11/app-defaults' directory.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1002 However, that requires root access.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1003
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1004 Another is to specify `Emacs*useXIM: false' in your X resources.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1005
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1006 Another is to build Emacs with the `--without-xim' configure option.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1007
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1008 *** M-SPC seems to be ignored as input.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1009
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1010 See if your X server is set up to use this as a command
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1011 for character composition.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1012
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1013 *** The S-C-t key combination doesn't get passed to Emacs on X.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1014
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1015 This happens because some X configurations assign the Ctrl-Shift-t
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1016 combination the same meaning as the Multi_key. The offending
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1017 definition is in the file `...lib/X11/locale/iso8859-1/Compose'; there
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1018 might be other similar combinations which are grabbed by X for similar
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1019 purposes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1020
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1021 We think that this can be countermanded with the `xmodmap' utility, if
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1022 you want to be able to bind one of these key sequences within Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1023
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1024 *** Under X, C-v and/or other keys don't work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1025
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1026 These may have been intercepted by your window manager. In
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1027 particular, AfterStep 1.6 is reported to steal C-v in its default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1028 configuration. Various Meta keys are also likely to be taken by the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1029 configuration of the `feel'. See the WM's documentation for how to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1030 change this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1031
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1032 *** Clicking C-mouse-2 in the scroll bar doesn't split the window.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1033
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1034 This currently doesn't work with scroll-bar widgets (and we don't know
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1035 a good way of implementing it with widgets). If Emacs is configured
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1036 --without-toolkit-scroll-bars, C-mouse-2 on the scroll bar does work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1037
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1038 *** Inability to send an Alt-modified key, when Emacs is communicating
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1039 directly with an X server.
Dave Love <fx@gnu.org>
parents:
diff changeset
1040
Dave Love <fx@gnu.org>
parents:
diff changeset
1041 If you have tried to bind an Alt-modified key as a command, and it
Dave Love <fx@gnu.org>
parents:
diff changeset
1042 does not work to type the command, the first thing you should check is
Dave Love <fx@gnu.org>
parents:
diff changeset
1043 whether the key is getting through to Emacs. To do this, type C-h c
Dave Love <fx@gnu.org>
parents:
diff changeset
1044 followed by the Alt-modified key. C-h c should say what kind of event
Dave Love <fx@gnu.org>
parents:
diff changeset
1045 it read. If it says it read an Alt-modified key, then make sure you
Dave Love <fx@gnu.org>
parents:
diff changeset
1046 have made the key binding correctly.
Dave Love <fx@gnu.org>
parents:
diff changeset
1047
Dave Love <fx@gnu.org>
parents:
diff changeset
1048 If C-h c reports an event that doesn't have the Alt modifier, it may
Dave Love <fx@gnu.org>
parents:
diff changeset
1049 be because your X server has no key for the Alt modifier. The X
Dave Love <fx@gnu.org>
parents:
diff changeset
1050 server that comes from MIT does not set up the Alt modifier by
Dave Love <fx@gnu.org>
parents:
diff changeset
1051 default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1052
Dave Love <fx@gnu.org>
parents:
diff changeset
1053 If your keyboard has keys named Alt, you can enable them as follows:
Dave Love <fx@gnu.org>
parents:
diff changeset
1054
Dave Love <fx@gnu.org>
parents:
diff changeset
1055 xmodmap -e 'add mod2 = Alt_L'
Dave Love <fx@gnu.org>
parents:
diff changeset
1056 xmodmap -e 'add mod2 = Alt_R'
Dave Love <fx@gnu.org>
parents:
diff changeset
1057
Dave Love <fx@gnu.org>
parents:
diff changeset
1058 If the keyboard has just one key named Alt, then only one of those
Dave Love <fx@gnu.org>
parents:
diff changeset
1059 commands is needed. The modifier `mod2' is a reasonable choice if you
Dave Love <fx@gnu.org>
parents:
diff changeset
1060 are using an unmodified MIT version of X. Otherwise, choose any
Dave Love <fx@gnu.org>
parents:
diff changeset
1061 modifier bit not otherwise used.
Dave Love <fx@gnu.org>
parents:
diff changeset
1062
Dave Love <fx@gnu.org>
parents:
diff changeset
1063 If your keyboard does not have keys named Alt, you can use some other
Dave Love <fx@gnu.org>
parents:
diff changeset
1064 keys. Use the keysym command in xmodmap to turn a function key (or
Dave Love <fx@gnu.org>
parents:
diff changeset
1065 some other 'spare' key) into Alt_L or into Alt_R, and then use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1066 commands show above to make them modifier keys.
Dave Love <fx@gnu.org>
parents:
diff changeset
1067
Dave Love <fx@gnu.org>
parents:
diff changeset
1068 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
Dave Love <fx@gnu.org>
parents:
diff changeset
1069 into Meta. This is because of the great importance of Meta in Emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
1070
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1071 ** Window-manager and toolkit-related problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1072
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1073 *** Gnome: Emacs' xterm-mouse-mode doesn't work on the Gnome terminal.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1074
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1075 A symptom of this bug is that double-clicks insert a control sequence
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1076 into the buffer. The reason this happens is an apparent
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1077 incompatibility of the Gnome terminal with Xterm, which also affects
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1078 other programs using the Xterm mouse interface. A problem report has
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1079 been filed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1080
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1081 *** KDE: When running on KDE, colors or fonts are not as specified for Emacs,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1082 or messed up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1083
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1084 For example, you could see background you set for Emacs only in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1085 empty portions of the Emacs display, while characters have some other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1086 background.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1087
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1088 This happens because KDE's defaults apply its color and font
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1089 definitions even to applications that weren't compiled for KDE. The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1090 solution is to uncheck the "Apply fonts and colors to non-KDE apps"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1091 option in Preferences->Look&Feel->Style (KDE 2). In KDE 3, this option
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1092 is in the "Colors" section, rather than "Style".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1093
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1094 Alternatively, if you do want the KDE defaults to apply to other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1095 applications, but not to Emacs, you could modify the file `Emacs.ad'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1096 (should be in the `/usr/share/apps/kdisplay/app-defaults/' directory)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1097 so that it doesn't set the default background and foreground only for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1098 Emacs. For example, make sure the following resources are either not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1099 present or commented out:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1100
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1101 Emacs.default.attributeForeground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1102 Emacs.default.attributeBackground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1103 Emacs*Foreground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1104 Emacs*Background
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1105
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1106 *** KDE: Emacs hangs on KDE when a large portion of text is killed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1107
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1108 This is caused by a bug in the KDE applet `klipper' which periodically
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1109 requests the X clipboard contents from applications. Early versions
67539
0fa61a6c1680 ICCM => ICCCM
Jan Djärv <jan.h.d@swipnet.se>
parents: 66452
diff changeset
1110 of klipper don't implement the ICCCM protocol for large selections,
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1111 which leads to Emacs being flooded with selection requests. After a
58825
a1e4505728bf * PROBLEMS: Update information about klipper on KDE.
Jan Djärv <jan.h.d@swipnet.se>
parents: 57229
diff changeset
1112 while, Emacs may print a message:
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1113
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1114 Timed out waiting for property-notify event
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1115
58825
a1e4505728bf * PROBLEMS: Update information about klipper on KDE.
Jan Djärv <jan.h.d@swipnet.se>
parents: 57229
diff changeset
1116 A workaround is to not use `klipper'. An upgrade to the `klipper' that
a1e4505728bf * PROBLEMS: Update information about klipper on KDE.
Jan Djärv <jan.h.d@swipnet.se>
parents: 57229
diff changeset
1117 comes with KDE 3.3 or later also solves the problem.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1118
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1119 *** CDE: Frames may cover dialogs they created when using CDE.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1120
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1121 This can happen if you have "Allow Primary Windows On Top" enabled which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1122 seems to be the default in the Common Desktop Environment.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1123 To change, go in to "Desktop Controls" -> "Window Style Manager"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1124 and uncheck "Allow Primary Windows On Top".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1125
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1126 *** Xaw3d : When using Xaw3d scroll bars without arrows, the very first mouse
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1127 click in a scroll bar might be ignored by the scroll bar widget. This
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1128 is probably a bug in Xaw3d; when Xaw3d is compiled with arrows, the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1129 problem disappears.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1130
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1131 *** Xaw: There are known binary incompatibilities between Xaw, Xaw3d, neXtaw,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1132 XawM and the few other derivatives of Xaw. So when you compile with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1133 one of these, it may not work to dynamically link with another one.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1134 For example, strange problems, such as Emacs exiting when you type
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1135 "C-x 1", were reported when Emacs compiled with Xaw3d and libXaw was
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1136 used with neXtaw at run time.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1137
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1138 The solution is to rebuild Emacs with the toolkit version you actually
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1139 want to use, or set LD_PRELOAD to preload the same toolkit version you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1140 built Emacs with.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1141
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1142 *** Open Motif: Problems with file dialogs in Emacs built with Open Motif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1143
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1144 When Emacs 21 is built with Open Motif 2.1, it can happen that the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1145 graphical file dialog boxes do not work properly. The "OK", "Filter"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1146 and "Cancel" buttons do not respond to mouse clicks. Dragging the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1147 file dialog window usually causes the buttons to work again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1148
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1149 The solution is to use LessTif instead. LessTif is a free replacement
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1150 for Motif. See the file INSTALL for information on how to do this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1151
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1152 Another workaround is not to use the mouse to trigger file prompts,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1153 but to use the keyboard. This way, you will be prompted for a file in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1154 the minibuffer instead of a graphical file dialog.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1155
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1156 *** LessTif: Problems in Emacs built with LessTif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1157
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1158 The problems seem to depend on the version of LessTif and the Motif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1159 emulation for which it is set up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1160
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1161 Only the Motif 1.2 emulation seems to be stable enough in LessTif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1162 Lesstif 0.92-17's Motif 1.2 emulation seems to work okay on FreeBSD.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1163 On GNU/Linux systems, lesstif-0.92.6 configured with "./configure
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1164 --enable-build-12 --enable-default-12" is reported to be the most
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1165 successful. The binary GNU/Linux package
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1166 lesstif-devel-0.92.0-1.i386.rpm was reported to have problems with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1167 menu placement.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1168
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1169 On some systems, even with Motif 1.2 emulation, Emacs occasionally
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1170 locks up, grabbing all mouse and keyboard events. We still don't know
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1171 what causes these problems; they are not reproducible by Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1172 developers.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1173
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1174 *** Motif: The Motif version of Emacs paints the screen a solid color.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1175
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1176 This has been observed to result from the following X resource:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1177
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1178 Emacs*default.attributeFont: -*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1179
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1180 That the resource has this effect indicates a bug in something, but we
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1181 do not yet know what. If it is an Emacs bug, we hope someone can
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1182 explain what the bug is so we can fix it. In the mean time, removing
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1183 the resource prevents the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1184
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1185 ** General X problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1186
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1187 *** Redisplay using X11 is much slower than previous Emacs versions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1188
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1189 We've noticed that certain X servers draw the text much slower when
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1190 scroll bars are on the left. We don't know why this happens. If this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1191 happens to you, you can work around it by putting the scroll bars
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1192 on the right (as they were in Emacs 19).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1193
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1194 Here's how to do this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1195
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1196 (set-scroll-bar-mode 'right)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1197
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1198 If you're not sure whether (or how much) this problem affects you,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1199 try that and see how much difference it makes. To set things back
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1200 to normal, do
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1201
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1202 (set-scroll-bar-mode 'left)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1203
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1204 *** Error messages about undefined colors on X.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1205
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1206 The messages might say something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1207
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1208 Unable to load color "grey95"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1209
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1210 (typically, in the `*Messages*' buffer), or something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1211
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1212 Error while displaying tooltip: (error Undefined color lightyellow)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1213
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1214 These problems could happen if some other X program has used up too
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1215 many colors of the X palette, leaving Emacs with insufficient system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1216 resources to load all the colors it needs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1217
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1218 A solution is to exit the offending X programs before starting Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1219
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1220 *** Improving performance with slow X connections.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1221
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1222 There are several ways to improve this performance, any subset of which can
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1223 be carried out at the same time:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1224
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1225 1) If you don't need X Input Methods (XIM) for entering text in some
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1226 language you use, you can improve performance on WAN links by using
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1227 the X resource useXIM to turn off use of XIM. This does not affect
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1228 the use of Emacs' own input methods, which are part of the Leim
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1229 package.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1230
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1231 2) If the connection is very slow, you might also want to consider
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1232 switching off scroll bars, menu bar, and tool bar.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1233
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1234 3) Use ssh to forward the X connection, and enable compression on this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1235 forwarded X connection (ssh -XC remotehostname emacs ...).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1236
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1237 4) Use lbxproxy on the remote end of the connection. This is an interface
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1238 to the low bandwidth X extension in most modern X servers, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1239 improves performance dramatically, at the slight expense of correctness
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1240 of the X protocol. lbxproxy acheives the performance gain by grouping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1241 several X requests in one TCP packet and sending them off together,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1242 instead of requiring a round-trip for each X request in a seperate
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1243 packet. The switches that seem to work best for emacs are:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1244 -noatomsfile -nowinattr -cheaterrors -cheatevents
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1245 Note that the -nograbcmap option is known to cause problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1246 For more about lbxproxy, see:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1247 http://www.xfree86.org/4.3.0/lbxproxy.1.html
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1248
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1249 *** Emacs gives the error, Couldn't find per display information.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1250
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1251 This can result if the X server runs out of memory because Emacs uses
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1252 a large number of fonts. On systems where this happens, C-h h is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1253 likely to cause it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1254
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1255 We do not know of a way to prevent the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1256
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1257 *** Emacs does not notice when you release the mouse.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1258
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1259 There are reports that this happened with (some) Microsoft mice and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1260 that replacing the mouse made it stop.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1262 *** You can't select from submenus (in the X toolkit version).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1264 On certain systems, mouse-tracking and selection in top-level menus
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1265 works properly with the X toolkit, but neither of them works when you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1266 bring up a submenu (such as Bookmarks or Compare or Apply Patch, in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1267 the Files menu).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1268
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1269 This works on most systems. There is speculation that the failure is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1270 due to bugs in old versions of X toolkit libraries, but no one really
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1271 knows. If someone debugs this and finds the precise cause, perhaps a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1272 workaround can be found.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1273
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1274 *** An error message such as `X protocol error: BadMatch (invalid
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1275 parameter attributes) on protocol request 93'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1276
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1277 This comes from having an invalid X resource, such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1278 emacs*Cursor: black
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1279 (which is invalid because it specifies a color name for something
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1280 that isn't a color.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1282 The fix is to correct your X resources.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1283
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1284 *** Slow startup on X11R6 with X windows.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1285
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1286 If Emacs takes two minutes to start up on X11R6, see if your X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1287 resources specify any Adobe fonts. That causes the type-1 font
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1288 renderer to start up, even if the font you asked for is not a type-1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1289 font.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1290
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1291 One way to avoid this problem is to eliminate the type-1 fonts from
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1292 your font path, like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1293
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1294 xset -fp /usr/X11R6/lib/X11/fonts/Type1/
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1295
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1296 *** Pull-down menus appear in the wrong place, in the toolkit version of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1297
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1298 An X resource of this form can cause the problem:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1299
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1300 Emacs*geometry: 80x55+0+0
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1301
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1302 This resource is supposed to apply, and does apply, to the menus
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1303 individually as well as to Emacs frames. If that is not what you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1304 want, rewrite the resource.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1305
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1306 To check thoroughly for such resource specifications, use `xrdb
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1307 -query' to see what resources the X server records, and also look at
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1308 the user's ~/.Xdefaults and ~/.Xdefaults-* files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1309
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1310 *** Emacs running under X Windows does not handle mouse clicks.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1311 *** `emacs -geometry 80x20' finds a file named `80x20'.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1312
Dave Love <fx@gnu.org>
parents:
diff changeset
1313 One cause of such problems is having (setq term-file-prefix nil) in
Dave Love <fx@gnu.org>
parents:
diff changeset
1314 your .emacs file. Another cause is a bad value of EMACSLOADPATH in
Dave Love <fx@gnu.org>
parents:
diff changeset
1315 the environment.
Dave Love <fx@gnu.org>
parents:
diff changeset
1316
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1317 *** Emacs fails to get default settings from X Windows server.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1318
Dave Love <fx@gnu.org>
parents:
diff changeset
1319 The X library in X11R4 has a bug; it interchanges the 2nd and 3rd
Dave Love <fx@gnu.org>
parents:
diff changeset
1320 arguments to XGetDefaults. Define the macro XBACKWARDS in config.h to
Dave Love <fx@gnu.org>
parents:
diff changeset
1321 tell Emacs to compensate for this.
Dave Love <fx@gnu.org>
parents:
diff changeset
1322
Dave Love <fx@gnu.org>
parents:
diff changeset
1323 I don't believe there is any way Emacs can determine for itself
Dave Love <fx@gnu.org>
parents:
diff changeset
1324 whether this problem is present on a given system.
Dave Love <fx@gnu.org>
parents:
diff changeset
1325
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1326 *** X Windows doesn't work if DISPLAY uses a hostname.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1327
Dave Love <fx@gnu.org>
parents:
diff changeset
1328 People have reported kernel bugs in certain systems that cause Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1329 not to work with X Windows if DISPLAY is set using a host name. But
Dave Love <fx@gnu.org>
parents:
diff changeset
1330 the problem does not occur if DISPLAY is set to `unix:0.0'. I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1331 the bug has to do with SIGIO or FIONREAD.
Dave Love <fx@gnu.org>
parents:
diff changeset
1332
Dave Love <fx@gnu.org>
parents:
diff changeset
1333 You may be able to compensate for the bug by doing (set-input-mode nil nil).
Dave Love <fx@gnu.org>
parents:
diff changeset
1334 However, that has the disadvantage of turning off interrupts, so that
Dave Love <fx@gnu.org>
parents:
diff changeset
1335 you are unable to quit out of a Lisp program by typing C-g.
Dave Love <fx@gnu.org>
parents:
diff changeset
1336
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
1337 The easy way to do this is to put
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1338
Dave Love <fx@gnu.org>
parents:
diff changeset
1339 (setq x-sigio-bug t)
Dave Love <fx@gnu.org>
parents:
diff changeset
1340
Dave Love <fx@gnu.org>
parents:
diff changeset
1341 in your site-init.el file.
Dave Love <fx@gnu.org>
parents:
diff changeset
1342
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1343 * Runtime problems on character termunals
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1344
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1345 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1346
Dave Love <fx@gnu.org>
parents:
diff changeset
1347 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being
Dave Love <fx@gnu.org>
parents:
diff changeset
1348 used. C-s/C-q flow control is bad for Emacs editors because it takes
Dave Love <fx@gnu.org>
parents:
diff changeset
1349 away C-s and C-q as user commands. Since editors do not output long
Dave Love <fx@gnu.org>
parents:
diff changeset
1350 streams of text without user commands, there is no need for a
Dave Love <fx@gnu.org>
parents:
diff changeset
1351 user-issuable "stop output" command in an editor; therefore, a
Dave Love <fx@gnu.org>
parents:
diff changeset
1352 properly designed flow control mechanism would transmit all possible
Dave Love <fx@gnu.org>
parents:
diff changeset
1353 input characters without interference. Designing such a mechanism is
Dave Love <fx@gnu.org>
parents:
diff changeset
1354 easy, for a person with at least half a brain.
Dave Love <fx@gnu.org>
parents:
diff changeset
1355
Dave Love <fx@gnu.org>
parents:
diff changeset
1356 There are three possible reasons why flow control could be taking place:
Dave Love <fx@gnu.org>
parents:
diff changeset
1357
Dave Love <fx@gnu.org>
parents:
diff changeset
1358 1) Terminal has not been told to disable flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1359 2) Insufficient padding for the terminal in use
Dave Love <fx@gnu.org>
parents:
diff changeset
1360 3) Some sort of terminal concentrator or line switch is responsible
Dave Love <fx@gnu.org>
parents:
diff changeset
1361
Dave Love <fx@gnu.org>
parents:
diff changeset
1362 First of all, many terminals have a set-up mode which controls whether
Dave Love <fx@gnu.org>
parents:
diff changeset
1363 they generate XON/XOFF flow control characters. This must be set to
Dave Love <fx@gnu.org>
parents:
diff changeset
1364 "no XON/XOFF" in order for Emacs to work. Sometimes there is an
Dave Love <fx@gnu.org>
parents:
diff changeset
1365 escape sequence that the computer can send to turn flow control off
Dave Love <fx@gnu.org>
parents:
diff changeset
1366 and on. If so, perhaps the termcap `ti' string should turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1367 control off, and the `te' string should turn it on.
Dave Love <fx@gnu.org>
parents:
diff changeset
1368
Dave Love <fx@gnu.org>
parents:
diff changeset
1369 Once the terminal has been told "no flow control", you may find it
Dave Love <fx@gnu.org>
parents:
diff changeset
1370 needs more padding. The amount of padding Emacs sends is controlled
Dave Love <fx@gnu.org>
parents:
diff changeset
1371 by the termcap entry for the terminal in use, and by the output baud
Dave Love <fx@gnu.org>
parents:
diff changeset
1372 rate as known by the kernel. The shell command `stty' will print
Dave Love <fx@gnu.org>
parents:
diff changeset
1373 your output baud rate; `stty' with suitable arguments will set it if
Dave Love <fx@gnu.org>
parents:
diff changeset
1374 it is wrong. Setting to a higher speed causes increased padding. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1375 the results are wrong for the correct speed, there is probably a
Dave Love <fx@gnu.org>
parents:
diff changeset
1376 problem in the termcap entry. You must speak to a local Unix wizard
Dave Love <fx@gnu.org>
parents:
diff changeset
1377 to fix this. Perhaps you are just using the wrong terminal type.
Dave Love <fx@gnu.org>
parents:
diff changeset
1378
Dave Love <fx@gnu.org>
parents:
diff changeset
1379 For terminals that lack a "no flow control" mode, sometimes just
Dave Love <fx@gnu.org>
parents:
diff changeset
1380 giving lots of padding will prevent actual generation of flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1381 codes. You might as well try it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1382
Dave Love <fx@gnu.org>
parents:
diff changeset
1383 If you are really unlucky, your terminal is connected to the computer
Dave Love <fx@gnu.org>
parents:
diff changeset
1384 through a concentrator which sends XON/XOFF flow control to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1385 computer, or it insists on sending flow control itself no matter how
Dave Love <fx@gnu.org>
parents:
diff changeset
1386 much padding you give it. Unless you can figure out how to turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1387 control off on this concentrator (again, refer to your local wizard),
Dave Love <fx@gnu.org>
parents:
diff changeset
1388 you are screwed! You should have the terminal or concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1389 replaced with a properly designed one. In the mean time, some drastic
Dave Love <fx@gnu.org>
parents:
diff changeset
1390 measures can make Emacs semi-work.
Dave Love <fx@gnu.org>
parents:
diff changeset
1391
Dave Love <fx@gnu.org>
parents:
diff changeset
1392 You can make Emacs ignore C-s and C-q and let the operating system
Dave Love <fx@gnu.org>
parents:
diff changeset
1393 handle them. To do this on a per-session basis, just type M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1394 enable-flow-control RET. You will see a message that C-\ and C-^ are
Dave Love <fx@gnu.org>
parents:
diff changeset
1395 now translated to C-s and C-q. (Use the same command M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1396 enable-flow-control to turn *off* this special mode. It toggles flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1397 control handling.)
Dave Love <fx@gnu.org>
parents:
diff changeset
1398
Dave Love <fx@gnu.org>
parents:
diff changeset
1399 If C-\ and C-^ are inconvenient for you (for example, if one of them
Dave Love <fx@gnu.org>
parents:
diff changeset
1400 is the escape character of your terminal concentrator), you can choose
Dave Love <fx@gnu.org>
parents:
diff changeset
1401 other characters by setting the variables flow-control-c-s-replacement
Dave Love <fx@gnu.org>
parents:
diff changeset
1402 and flow-control-c-q-replacement. But choose carefully, since all
Dave Love <fx@gnu.org>
parents:
diff changeset
1403 other control characters are already used by emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
1404
Dave Love <fx@gnu.org>
parents:
diff changeset
1405 IMPORTANT: if you type C-s by accident while flow control is enabled,
Dave Love <fx@gnu.org>
parents:
diff changeset
1406 Emacs output will freeze, and you will have to remember to type C-q in
Dave Love <fx@gnu.org>
parents:
diff changeset
1407 order to continue.
Dave Love <fx@gnu.org>
parents:
diff changeset
1408
Dave Love <fx@gnu.org>
parents:
diff changeset
1409 If you work in an environment where a majority of terminals of a
Dave Love <fx@gnu.org>
parents:
diff changeset
1410 certain type are flow control hobbled, you can use the function
Dave Love <fx@gnu.org>
parents:
diff changeset
1411 `enable-flow-control-on' to turn on this flow control avoidance scheme
Dave Love <fx@gnu.org>
parents:
diff changeset
1412 automatically. Here is an example:
Dave Love <fx@gnu.org>
parents:
diff changeset
1413
Dave Love <fx@gnu.org>
parents:
diff changeset
1414 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
Dave Love <fx@gnu.org>
parents:
diff changeset
1415
Dave Love <fx@gnu.org>
parents:
diff changeset
1416 If this isn't quite correct (e.g. you have a mixture of flow-control hobbled
Dave Love <fx@gnu.org>
parents:
diff changeset
1417 and good vt200 terminals), you can still run enable-flow-control
Dave Love <fx@gnu.org>
parents:
diff changeset
1418 manually.
Dave Love <fx@gnu.org>
parents:
diff changeset
1419
Dave Love <fx@gnu.org>
parents:
diff changeset
1420 I have no intention of ever redesigning the Emacs command set for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1421 assumption that terminals use C-s/C-q flow control. XON/XOFF flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1422 control technique is a bad design, and terminals that need it are bad
Dave Love <fx@gnu.org>
parents:
diff changeset
1423 merchandise and should not be purchased. Now that X is becoming
Dave Love <fx@gnu.org>
parents:
diff changeset
1424 widespread, XON/XOFF seems to be on the way out. If you can get some
Dave Love <fx@gnu.org>
parents:
diff changeset
1425 use out of GNU Emacs on inferior terminals, more power to you, but I
Dave Love <fx@gnu.org>
parents:
diff changeset
1426 will not make Emacs worse for properly designed systems for the sake
Dave Love <fx@gnu.org>
parents:
diff changeset
1427 of inferior systems.
Dave Love <fx@gnu.org>
parents:
diff changeset
1428
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1429 ** Control-S and Control-Q commands are ignored completely.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1430
Dave Love <fx@gnu.org>
parents:
diff changeset
1431 For some reason, your system is using brain-damaged C-s/C-q flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1432 control despite Emacs's attempts to turn it off. Perhaps your
Dave Love <fx@gnu.org>
parents:
diff changeset
1433 terminal is connected to the computer through a concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1434 that wants to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1435
Dave Love <fx@gnu.org>
parents:
diff changeset
1436 You should first try to tell the concentrator not to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1437 If you succeed in this, try making the terminal work without
Dave Love <fx@gnu.org>
parents:
diff changeset
1438 flow control, as described in the preceding section.
Dave Love <fx@gnu.org>
parents:
diff changeset
1439
Dave Love <fx@gnu.org>
parents:
diff changeset
1440 If that line of approach is not successful, map some other characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1441 into C-s and C-q using keyboard-translate-table. The example above
Dave Love <fx@gnu.org>
parents:
diff changeset
1442 shows how to do this with C-^ and C-\.
Dave Love <fx@gnu.org>
parents:
diff changeset
1443
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1444 ** Screen is updated wrong, but only on one kind of terminal.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1445
Dave Love <fx@gnu.org>
parents:
diff changeset
1446 This could mean that the termcap entry you are using for that
Dave Love <fx@gnu.org>
parents:
diff changeset
1447 terminal is wrong, or it could mean that Emacs has a bug handing
Dave Love <fx@gnu.org>
parents:
diff changeset
1448 the combination of features specified for that terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1449
Dave Love <fx@gnu.org>
parents:
diff changeset
1450 The first step in tracking this down is to record what characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1451 Emacs is sending to the terminal. Execute the Lisp expression
Dave Love <fx@gnu.org>
parents:
diff changeset
1452 (open-termscript "./emacs-script") to make Emacs write all
Dave Love <fx@gnu.org>
parents:
diff changeset
1453 terminal output into the file ~/emacs-script as well; then do
Dave Love <fx@gnu.org>
parents:
diff changeset
1454 what makes the screen update wrong, and look at the file
Dave Love <fx@gnu.org>
parents:
diff changeset
1455 and decode the characters using the manual for the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1456 There are several possibilities:
Dave Love <fx@gnu.org>
parents:
diff changeset
1457
Dave Love <fx@gnu.org>
parents:
diff changeset
1458 1) The characters sent are correct, according to the terminal manual.
Dave Love <fx@gnu.org>
parents:
diff changeset
1459
Dave Love <fx@gnu.org>
parents:
diff changeset
1460 In this case, there is no obvious bug in Emacs, and most likely you
Dave Love <fx@gnu.org>
parents:
diff changeset
1461 need more padding, or possibly the terminal manual is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1462
Dave Love <fx@gnu.org>
parents:
diff changeset
1463 2) The characters sent are incorrect, due to an obscure aspect
Dave Love <fx@gnu.org>
parents:
diff changeset
1464 of the terminal behavior not described in an obvious way
Dave Love <fx@gnu.org>
parents:
diff changeset
1465 by termcap.
Dave Love <fx@gnu.org>
parents:
diff changeset
1466
Dave Love <fx@gnu.org>
parents:
diff changeset
1467 This case is hard. It will be necessary to think of a way for
Dave Love <fx@gnu.org>
parents:
diff changeset
1468 Emacs to distinguish between terminals with this kind of behavior
Dave Love <fx@gnu.org>
parents:
diff changeset
1469 and other terminals that behave subtly differently but are
Dave Love <fx@gnu.org>
parents:
diff changeset
1470 classified the same by termcap; or else find an algorithm for
Dave Love <fx@gnu.org>
parents:
diff changeset
1471 Emacs to use that avoids the difference. Such changes must be
Dave Love <fx@gnu.org>
parents:
diff changeset
1472 tested on many kinds of terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1473
Dave Love <fx@gnu.org>
parents:
diff changeset
1474 3) The termcap entry is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1475
Dave Love <fx@gnu.org>
parents:
diff changeset
1476 See the file etc/TERMS for information on changes
Dave Love <fx@gnu.org>
parents:
diff changeset
1477 that are known to be needed in commonly used termcap entries
Dave Love <fx@gnu.org>
parents:
diff changeset
1478 for certain terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1479
Dave Love <fx@gnu.org>
parents:
diff changeset
1480 4) The characters sent are incorrect, and clearly cannot be
Dave Love <fx@gnu.org>
parents:
diff changeset
1481 right for any terminal with the termcap entry you were using.
Dave Love <fx@gnu.org>
parents:
diff changeset
1482
Dave Love <fx@gnu.org>
parents:
diff changeset
1483 This is unambiguously an Emacs bug, and can probably be fixed
Dave Love <fx@gnu.org>
parents:
diff changeset
1484 in termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c.
Dave Love <fx@gnu.org>
parents:
diff changeset
1485
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1486 ** Control-S and Control-Q commands are ignored completely on a net connection.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1487
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1488 Some versions of rlogin (and possibly telnet) do not pass flow
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1489 control characters to the remote system to which they connect.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1490 On such systems, emacs on the remote system cannot disable flow
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1491 control on the local system.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1492
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1493 One way to cure this is to disable flow control on the local host
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1494 (the one running rlogin, not the one running rlogind) using the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1495 stty command, before starting the rlogin process. On many systems,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1496 "stty start u stop u" will do this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1497
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1498 Some versions of tcsh will prevent even this from working. One way
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1499 around this is to start another shell before starting rlogin, and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1500 issue the stty command to disable flow control from that shell.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1501
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1502 If none of these methods work, the best solution is to type
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1503 M-x enable-flow-control at the beginning of your emacs session, or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1504 if you expect the problem to continue, add a line such as the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1505 following to your .emacs (on the host running rlogind):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1506
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1507 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1508
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1509 See the entry about spontaneous display of I-search (above) for more
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1510 info.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1511
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1512 ** Output from Control-V is slow.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1513
Dave Love <fx@gnu.org>
parents:
diff changeset
1514 On many bit-map terminals, scrolling operations are fairly slow.
Dave Love <fx@gnu.org>
parents:
diff changeset
1515 Often the termcap entry for the type of terminal in use fails
Dave Love <fx@gnu.org>
parents:
diff changeset
1516 to inform Emacs of this. The two lines at the bottom of the screen
Dave Love <fx@gnu.org>
parents:
diff changeset
1517 before a Control-V command are supposed to appear at the top after
Dave Love <fx@gnu.org>
parents:
diff changeset
1518 the Control-V command. If Emacs thinks scrolling the lines is fast,
Dave Love <fx@gnu.org>
parents:
diff changeset
1519 it will scroll them to the top of the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
1520
Dave Love <fx@gnu.org>
parents:
diff changeset
1521 If scrolling is slow but Emacs thinks it is fast, the usual reason is
Dave Love <fx@gnu.org>
parents:
diff changeset
1522 that the termcap entry for the terminal you are using does not
Dave Love <fx@gnu.org>
parents:
diff changeset
1523 specify any padding time for the `al' and `dl' strings. Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1524 concludes that these operations take only as much time as it takes to
Dave Love <fx@gnu.org>
parents:
diff changeset
1525 send the commands at whatever line speed you are using. You must
Dave Love <fx@gnu.org>
parents:
diff changeset
1526 fix the termcap entry to specify, for the `al' and `dl', as much
Dave Love <fx@gnu.org>
parents:
diff changeset
1527 time as the operations really take.
Dave Love <fx@gnu.org>
parents:
diff changeset
1528
Dave Love <fx@gnu.org>
parents:
diff changeset
1529 Currently Emacs thinks in terms of serial lines which send characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1530 at a fixed rate, so that any operation which takes time for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1531 terminal to execute must also be padded. With bit-map terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1532 operated across networks, often the network provides some sort of
Dave Love <fx@gnu.org>
parents:
diff changeset
1533 flow control so that padding is never needed no matter how slow
Dave Love <fx@gnu.org>
parents:
diff changeset
1534 an operation is. You must still specify a padding time if you want
Dave Love <fx@gnu.org>
parents:
diff changeset
1535 Emacs to realize that the operation takes a long time. This will
Dave Love <fx@gnu.org>
parents:
diff changeset
1536 cause padding characters to be sent unnecessarily, but they do
Dave Love <fx@gnu.org>
parents:
diff changeset
1537 not really cost much. They will be transmitted while the scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
1538 is happening and then discarded quickly by the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1539
Dave Love <fx@gnu.org>
parents:
diff changeset
1540 Most bit-map terminals provide commands for inserting or deleting
Dave Love <fx@gnu.org>
parents:
diff changeset
1541 multiple lines at once. Define the `AL' and `DL' strings in the
Dave Love <fx@gnu.org>
parents:
diff changeset
1542 termcap entry to say how to do these things, and you will have
Dave Love <fx@gnu.org>
parents:
diff changeset
1543 fast output without wasted padding characters. These strings should
Dave Love <fx@gnu.org>
parents:
diff changeset
1544 each contain a single %-spec saying how to send the number of lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1545 to be scrolled. These %-specs are like those in the termcap
Dave Love <fx@gnu.org>
parents:
diff changeset
1546 `cm' string.
Dave Love <fx@gnu.org>
parents:
diff changeset
1547
Dave Love <fx@gnu.org>
parents:
diff changeset
1548 You should also define the `IC' and `DC' strings if your terminal
Dave Love <fx@gnu.org>
parents:
diff changeset
1549 has a command to insert or delete multiple characters. These
Dave Love <fx@gnu.org>
parents:
diff changeset
1550 take the number of positions to insert or delete as an argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
1551
Dave Love <fx@gnu.org>
parents:
diff changeset
1552 A `cs' string to set the scrolling region will reduce the amount
Dave Love <fx@gnu.org>
parents:
diff changeset
1553 of motion you see on the screen when part of the screen is scrolled.
Dave Love <fx@gnu.org>
parents:
diff changeset
1554
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1555 ** You type Control-H (Backspace) expecting to delete characters.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1556
Dave Love <fx@gnu.org>
parents:
diff changeset
1557 Put `stty dec' in your .login file and your problems will disappear
Dave Love <fx@gnu.org>
parents:
diff changeset
1558 after a day or two.
Dave Love <fx@gnu.org>
parents:
diff changeset
1559
Dave Love <fx@gnu.org>
parents:
diff changeset
1560 The choice of Backspace for erasure was based on confusion, caused by
Dave Love <fx@gnu.org>
parents:
diff changeset
1561 the fact that backspacing causes erasure (later, when you type another
Dave Love <fx@gnu.org>
parents:
diff changeset
1562 character) on most display terminals. But it is a mistake. Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
1563 of text is not the same thing as backspacing followed by failure to
Dave Love <fx@gnu.org>
parents:
diff changeset
1564 overprint. I do not wish to propagate this confusion by conforming
Dave Love <fx@gnu.org>
parents:
diff changeset
1565 to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1566
Dave Love <fx@gnu.org>
parents:
diff changeset
1567 For this reason, I believe `stty dec' is the right mode to use,
Dave Love <fx@gnu.org>
parents:
diff changeset
1568 and I have designed Emacs to go with that. If there were a thousand
Dave Love <fx@gnu.org>
parents:
diff changeset
1569 other control characters, I would define Control-h to delete as well;
Dave Love <fx@gnu.org>
parents:
diff changeset
1570 but there are not very many other control characters, and I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1571 that providing the most mnemonic possible Help character is more
Dave Love <fx@gnu.org>
parents:
diff changeset
1572 important than adapting to people who don't use `stty dec'.
Dave Love <fx@gnu.org>
parents:
diff changeset
1573
Dave Love <fx@gnu.org>
parents:
diff changeset
1574 If you are obstinate about confusing buggy overprinting with deletion,
Dave Love <fx@gnu.org>
parents:
diff changeset
1575 you can redefine Backspace in your .emacs file:
Dave Love <fx@gnu.org>
parents:
diff changeset
1576 (global-set-key "\b" 'delete-backward-char)
Dave Love <fx@gnu.org>
parents:
diff changeset
1577 You can probably access help-command via f1.
Dave Love <fx@gnu.org>
parents:
diff changeset
1578
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1579 ** Colors are not available on a tty or in xterm.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1580
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1581 Emacs 21 supports colors on character terminals and terminal
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1582 emulators, but this support relies on the terminfo or termcap database
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1583 entry to specify that the display supports color. Emacs looks at the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1584 "Co" capability for the terminal to find out how many colors are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1585 supported; it should be non-zero to activate the color support within
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1586 Emacs. (Most color terminals support 8 or 16 colors.) If your system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1587 uses terminfo, the name of the capability equivalent to "Co" is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1588 "colors".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1589
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1590 In addition to the "Co" capability, Emacs needs the "op" (for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1591 ``original pair'') capability, which tells how to switch the terminal
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1592 back to the default foreground and background colors. Emacs will not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1593 use colors if this capability is not defined. If your terminal entry
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1594 doesn't provide such a capability, try using the ANSI standard escape
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1595 sequence \E[00m (that is, define a new termcap/terminfo entry and make
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1596 it use your current terminal's entry plus \E[00m for the "op"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1597 capability).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1598
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1599 Finally, the "NC" capability (terminfo name: "ncv") tells Emacs which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1600 attributes cannot be used with colors. Setting this capability
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1601 incorrectly might have the effect of disabling colors; try setting
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1602 this capability to `0' (zero) and see if that helps.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1603
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1604 Emacs uses the database entry for the terminal whose name is the value
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1605 of the environment variable TERM. With `xterm', a common terminal
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1606 entry that supports color is `xterm-color', so setting TERM's value to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1607 `xterm-color' might activate the color support on an xterm-compatible
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1608 emulator.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1609
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
1610 Beginning with version 22.1, Emacs supports the --color command-line
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1611 option which may be used to force Emacs to use one of a few popular
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1612 modes for getting colors on a tty. For example, --color=ansi8 sets up
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1613 for using the ANSI-standard escape sequences that support 8 colors.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1614
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1615 Some modes do not use colors unless you turn on the Font-lock mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1616 Some people have long ago set their `~/.emacs' files to turn on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1617 Font-lock on X only, so they won't see colors on a tty. The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1618 recommended way of turning on Font-lock is by typing "M-x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1619 global-font-lock-mode RET" or by customizing the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1620 `global-font-lock-mode'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1621
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1622 * Runtime problems specific to individual Unix variants
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1623
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1624 ** GNU/Linux
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1625
63126
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1626 *** GNU/Linux: Process output is corrupted.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1627
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1628 There is a bug in Linux kernel 2.6.10 PTYs that can cause emacs to
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1629 read corrupted process output.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1630
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1631 *** GNU/Linux: Remote access to CVS with SSH causes file corruption.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1632
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1633 If you access a remote CVS repository via SSH, files may be corrupted
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1634 due to bad interaction between CVS, SSH, and libc.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1635
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1636 To fix the problem, save the following script into a file, make it
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1637 executable, and set CVS_RSH environment variable to the file name of
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1638 the script:
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1639
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1640 #!/bin/bash
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1641 exec 2> >(exec cat >&2 2>/dev/null)
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1642 exec ssh "$@"
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1643
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1644 *** GNU/Linux: On Linux-based GNU systems using libc versions 5.4.19 through
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1645 5.4.22, Emacs crashes at startup with a segmentation fault.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1646
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1647 This problem happens if libc defines the symbol __malloc_initialized.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1648 One known solution is to upgrade to a newer libc version. 5.4.33 is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1649 known to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1650
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1651 *** GNU/Linux: After upgrading to a newer version of Emacs,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1652 the Meta key stops working.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1653
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1654 This was reported to happen on a GNU/Linux system distributed by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1655 Mandrake. The reason is that the previous version of Emacs was
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1656 modified by Mandrake to make the Alt key act as the Meta key, on a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1657 keyboard where the Windows key is the one which produces the Meta
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1658 modifier. A user who started using a newer version of Emacs, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1659 was not hacked by Mandrake, expected the Alt key to continue to act as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1660 Meta, and was astonished when that didn't happen.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1661
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1662 The solution is to find out what key on your keyboard produces the Meta
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1663 modifier, and use that key instead. Try all of the keys to the left
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1664 and to the right of the space bar, together with the `x' key, and see
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1665 which combination produces "M-x" in the echo area. You can also use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1666 the `xmodmap' utility to show all the keys which produce a Meta
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1667 modifier:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1668
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1669 xmodmap -pk | egrep -i "meta|alt"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1670
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1671 A more convenient way of finding out which keys produce a Meta modifier
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1672 is to use the `xkbprint' utility, if it's available on your system:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1673
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1674 xkbprint 0:0 /tmp/k.ps
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1675
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1676 This produces a PostScript file `/tmp/k.ps' with a picture of your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1677 keyboard; printing that file on a PostScript printer will show what
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1678 keys can serve as Meta.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1679
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1680 The `xkeycaps' also shows a visual representation of the current
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1681 keyboard settings. It also allows to modify them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1682
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1683 *** GNU/Linux: low startup on Linux-based GNU systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1684
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1685 People using systems based on the Linux kernel sometimes report that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1686 startup takes 10 to 15 seconds longer than `usual'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1687
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1688 This is because Emacs looks up the host name when it starts.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1689 Normally, this takes negligible time; the extra delay is due to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1690 improper system configuration. This problem can occur for both
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1691 networked and non-networked machines.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1692
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1693 Here is how to fix the configuration. It requires being root.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1694
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1695 **** Networked Case.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1696
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1697 First, make sure the files `/etc/hosts' and `/etc/host.conf' both
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1698 exist. The first line in the `/etc/hosts' file should look like this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1699 (replace HOSTNAME with your host name):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1700
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1701 127.0.0.1 HOSTNAME
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1702
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1703 Also make sure that the `/etc/host.conf' files contains the following
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1704 lines:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1705
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1706 order hosts, bind
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1707 multi on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1708
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1709 Any changes, permanent and temporary, to the host name should be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1710 indicated in the `/etc/hosts' file, since it acts a limited local
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1711 database of addresses and names (e.g., some SLIP connections
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1712 dynamically allocate ip addresses).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1713
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1714 **** Non-Networked Case.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1715
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1716 The solution described in the networked case applies here as well.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1717 However, if you never intend to network your machine, you can use a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1718 simpler solution: create an empty `/etc/host.conf' file. The command
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1719 `touch /etc/host.conf' suffices to create the file. The `/etc/hosts'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1720 file is not necessary with this approach.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1721
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1722 *** GNU/Linux: Emacs on a tty switches the cursor to large blinking block.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1723
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1724 This was reported to happen on some GNU/Linux systems which use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1725 ncurses version 5.0, but could be relevant for other versions as well.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1726 These versions of ncurses come with a `linux' terminfo entry, where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1727 the "cvvis" capability (termcap "vs") is defined as "\E[?25h\E[?8c"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1728 (show cursor, change size). This escape sequence switches on a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1729 blinking hardware text-mode cursor whose size is a full character
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1730 cell. This blinking cannot be stopped, since a hardware cursor
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1731 always blinks.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1732
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1733 A work-around is to redefine the "cvvis" capability so that it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1734 enables a *software* cursor. The software cursor works by inverting
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1735 the colors of the character at point, so what you see is a block
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1736 cursor that doesn't blink. For this to work, you need to redefine
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1737 the "cnorm" capability as well, so that it operates on the software
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1738 cursor instead of the hardware cursor.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1739
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1740 To this end, run "infocmp linux > linux-term", edit the file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1741 `linux-term' to make both the "cnorm" and "cvvis" capabilities send
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1742 the sequence "\E[?25h\E[?17;0;64c", and then run "tic linux-term" to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1743 produce a modified terminfo entry.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1744
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1745 Alternatively, if you want a blinking underscore as your Emacs cursor,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1746 change the "cvvis" capability to send the "\E[?25h\E[?0c" command.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1747
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1748 *** GNU/Linux: Error messages `internal facep []' happen on GNU/Linux systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1749
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1750 There is a report that replacing libc.so.5.0.9 with libc.so.5.2.16
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1751 caused this to start happening. People are not sure why, but the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1752 problem seems unlikely to be in Emacs itself. Some suspect that it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1753 is actually Xlib which won't work with libc.so.5.2.16.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1754
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1755 Using the old library version is a workaround.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1756
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1757 ** Mac OS X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1758
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1759 *** Mac OS X (Carbon): Environment Variables from dotfiles are ignored.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1760
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1761 When starting Emacs from the Dock or the Finder on Mac OS X, the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1762 environment variables that are set up in dotfiles, such as .cshrc or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1763 .profile, are ignored. This is because the Finder and Dock are not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1764 started from a shell, but instead from the Window Manager itself.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1765
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1766 The workaround for this is to create a .MacOSX/environment.plist file to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1767 setup these environment variables. These environment variables will
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1768 apply to all processes regardless of where they are started.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1769 For me information, see http://developer.apple.com/qa/qa2001/qa1067.html.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1770
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1771 *** Mac OS X (Carbon): Process output truncated when using ptys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1772
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1773 There appears to be a problem with the implementation of pty's on the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1774 Mac OS X that causes process output to be truncated. To avoid this,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1775 leave process-connection-type set to its default value of nil.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1776
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1777 ** FreeBSD
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1778
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1779 *** FreeBSD 2.1.5: useless symbolic links remain in /tmp or other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1780 directories that have the +t bit.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1781
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1782 This is because of a kernel bug in FreeBSD 2.1.5 (fixed in 2.2).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1783 Emacs uses symbolic links to implement file locks. In a directory
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1784 with +t bit, the directory owner becomes the owner of the symbolic
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1785 link, so that it cannot be removed by anyone else.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1786
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1787 If you don't like those useless links, you can let Emacs not to using
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1788 file lock by adding #undef CLASH_DETECTION to config.h.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1789
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1790 *** FreeBSD: Getting a Meta key on the console.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1791
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1792 By default, neither Alt nor any other key acts as a Meta key on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1793 FreeBSD, but this can be changed using kbdcontrol(1). Dump the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1794 current keymap to a file with the command
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1795
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1796 $ kbdcontrol -d >emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1797
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1798 Edit emacs.kbd, and give the key you want to be the Meta key the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1799 definition `meta'. For instance, if your keyboard has a ``Windows''
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1800 key with scan code 105, change the line for scan code 105 in emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1801 to look like this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1802
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1803 105 meta meta meta meta meta meta meta meta O
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1804
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1805 to make the Windows key the Meta key. Load the new keymap with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1806
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1807 $ kbdcontrol -l emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1808
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1809 ** HP-UX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1810
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1811 *** HP/UX : Shell mode gives the message, "`tty`: Ambiguous".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1812
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1813 christos@theory.tn.cornell.edu says:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1814
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1815 The problem is that in your .cshrc you have something that tries to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1816 execute `tty`. If you are not running the shell on a real tty then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1817 tty will print "not a tty". Csh expects one word in some places,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1818 but tty is giving it back 3.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1819
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1820 The solution is to add a pair of quotes around `tty` to make it a single
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1821 word:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1822
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1823 if (`tty` == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1824
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1825 should be changed to:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1826
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1827 if ("`tty`" == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1828
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1829 Even better, move things that set up terminal sections out of .cshrc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1830 and into .login.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1831
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1832 *** HP/UX: `Pid xxx killed due to text modification or page I/O error'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1833
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1834 On HP/UX, you can get that error when the Emacs executable is on an NFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1835 file system. HP/UX responds this way if it tries to swap in a page and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1836 does not get a response from the server within a timeout whose default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1837 value is just ten seconds.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1838
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1839 If this happens to you, extend the timeout period.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1840
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1841 *** HP/UX: The right Alt key works wrong on German HP keyboards (and perhaps
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1842 other non-English HP keyboards too).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1843
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1844 This is because HP-UX defines the modifiers wrong in X. Here is a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1845 shell script to fix the problem; be sure that it is run after VUE
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1846 configures the X server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1847
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1848 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1849 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1850 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1851 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1852
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1853 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1854 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1855 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1856 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1857 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1858 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1859 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1860
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1861 *** HP/UX: "Cannot find callback list" messages from dialog boxes in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1862 Emacs built with Motif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1863
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1864 This problem resulted from a bug in GCC 2.4.5. Newer GCC versions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1865 such as 2.7.0 fix the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1866
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1867 *** HP/UX: Emacs does not recognize the AltGr key.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1868
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1869 To fix this, set up a file ~/.dt/sessions/sessionetc with executable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1870 rights, containing this text:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1871
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1872 --------------------------------
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1873 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1874 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1875 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1876 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1877
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1878 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1879 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1880 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1881 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1882 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1883 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1884 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1885 --------------------------------
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1886
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1887 *** HP/UX 11.0: Emacs makes HP/UX 11.0 crash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1888
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1889 This is a bug in HPUX; HPUX patch PHKL_16260 is said to fix it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1890
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1891 ** AIX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1892
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1893 *** AIX: Trouble using ptys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1894
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1895 People often install the pty devices on AIX incorrectly.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1896 Use `smit pty' to reinstall them properly.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1897
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1898 *** AIXterm: Your Delete key sends a Backspace to the terminal.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1899
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1900 The solution is to include in your .Xdefaults the lines:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1901
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1902 *aixterm.Translations: #override <Key>BackSpace: string(0x7f)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1903 aixterm*ttyModes: erase ^?
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1904
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1905 This makes your Backspace key send DEL (ASCII 127).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1906
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1907 *** AIX: If linking fails because libXbsd isn't found, check if you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1908 are compiling with the system's `cc' and CFLAGS containing `-O5'. If
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1909 so, you have hit a compiler bug. Please make sure to re-configure
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1910 Emacs so that it isn't compiled with `-O5'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1911
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1912 *** AIX 4.3.x or 4.4: Compiling fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1913
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1914 This could happen if you use /bin/c89 as your compiler, instead of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1915 the default `cc'. /bin/c89 treats certain warnings, such as benign
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1916 redefinitions of macros, as errors, and fails the build. A solution
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1917 is to use the default compiler `cc'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1918
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1919 *** AIX 4: Some programs fail when run in a Shell buffer
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1920 with an error message like No terminfo entry for "unknown".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1921
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1922 On AIX, many terminal type definitions are not installed by default.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1923 `unknown' is one of them. Install the "Special Generic Terminal
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1924 Definitions" to make them defined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1925
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1926 ** Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1927
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1928 We list bugs in current versions here. Solaris 2.x and 4.x are covered in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1929 section on legacy systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1930
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1931 *** On Solaris, C-x doesn't get through to Emacs when you use the console.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1932
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1933 This is a Solaris feature (at least on Intel x86 cpus). Type C-r
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1934 C-r C-t, to toggle whether C-x gets through to Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1935
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1936 *** Problem with remote X server on Suns.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1937
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1938 On a Sun, running Emacs on one machine with the X server on another
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1939 may not work if you have used the unshared system libraries. This
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1940 is because the unshared libraries fail to use YP for host name lookup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1941 As a result, the host name you specify may not be recognized.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1942
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1943 *** Solaris 2,6: Emacs crashes with SIGBUS or SIGSEGV on Solaris after you delete a frame.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1944
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1945 We suspect that this is a bug in the X libraries provided by
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1946 Sun. There is a report that one of these patches fixes the bug and
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1947 makes the problem stop:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1948
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1949 105216-01 105393-01 105518-01 105621-01 105665-01 105615-02 105216-02
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1950 105667-01 105401-08 105615-03 105621-02 105686-02 105736-01 105755-03
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1951 106033-01 105379-01 105786-01 105181-04 105379-03 105786-04 105845-01
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1952 105284-05 105669-02 105837-01 105837-02 105558-01 106125-02 105407-01
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1953
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1954 Another person using a newer system (kernel patch level Generic_105181-06)
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1955 suspects that the bug was fixed by one of these more recent patches:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1956
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1957 106040-07 SunOS 5.6: X Input & Output Method patch
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1958 106222-01 OpenWindows 3.6: filemgr (ff.core) fixes
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1959 105284-12 Motif 1.2.7: sparc Runtime library patch
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1960
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1961 *** Solaris 7 or 8: Emacs reports a BadAtom error (from X)
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1962
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1963 This happens when Emacs was built on some other version of Solaris.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1964 Rebuild it on Solaris 8.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1965
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1966 *** When using M-x dbx with the SparcWorks debugger, the `up' and `down'
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1967 commands do not move the arrow in Emacs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1968
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1969 You can fix this by adding the following line to `~/.dbxinit':
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1970
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1971 dbxenv output_short_file_name off
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1972
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1973 *** On Solaris, CTRL-t is ignored by Emacs when you use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1974 the fr.ISO-8859-15 locale (and maybe other related locales).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1975
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1976 You can fix this by editing the file:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1977
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1978 /usr/openwin/lib/locale/iso8859-15/Compose
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1979
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1980 Near the bottom there is a line that reads:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1981
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1982 Ctrl<t> <quotedbl> <Y> : "\276" threequarters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1983
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1984 that should read:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1985
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1986 Ctrl<T> <quotedbl> <Y> : "\276" threequarters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1987
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1988 Note the lower case <t>. Changing this line should make C-t work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1989
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1990 ** Irix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1991
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1992 *** Irix 6.5: Emacs crashes on the SGI R10K, when compiled with GCC.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1993
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1994 This seems to be fixed in GCC 2.95.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1995
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1996 *** Irix: Trouble using ptys, or running out of ptys.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1997
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1998 The program mkpts (which may be in `/usr/adm' or `/usr/sbin') needs to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1999 be set-UID to root, or non-root programs like Emacs will not be able
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2000 to allocate ptys reliably.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2001
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2002 * Runtime problems specific to MS-Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2003
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2004 ** Emacs exits with "X protocol error" when run with an X server for MS-Windows.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2005
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2006 A certain X server for Windows had a bug which caused this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2007 Supposedly the newer 32-bit version of this server doesn't have the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2008 problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2009
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2010 ** Known problems with the MS-Windows port of Emacs 22.1
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2011
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2012 Using create-fontset-from-ascii-font or the --font startup parameter
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2013 with a Chinese, Japanese or Korean font leads to display problems.
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2014 Use a Latin-only font as your default font. If you want control over
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2015 which font is used to display Chinese, Japanese or Korean character,
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2016 use create-fontset-from-fontset-spec to define a fontset.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2017
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2018 Frames are not refreshed while the File or Font dialog or a pop-up menu
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2019 is displayed. This also means help text for pop-up menus is not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2020 displayed at all. This is because message handling under Windows is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2021 synchronous, so we cannot handle repaint (or any other) messages while
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2022 waiting for a system function to return the result of the dialog or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2023 pop-up menu interaction.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2024
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2025 Windows 95 and Windows NT up to version 4.0 do not support help text
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2026 for menus. Help text is only available in later versions of Windows.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2027
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2028 There are problems with display if mouse-tracking is enabled and the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2029 mouse is moved off a frame, over another frame then back over the first
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2030 frame. A workaround is to click the left mouse button inside the frame
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2031 after moving back into it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2032
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2033 Some minor flickering still persists during mouse-tracking, although
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2034 not as severely as in 21.1.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2035
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2036 An inactive cursor remains in an active window after the Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2037 Manager driven switch of the focus, until a key is pressed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2038
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2039 Windows input methods are not recognized by Emacs. Some
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2040 of these input methods cause the keyboard to send characters encoded
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2041 in the appropriate coding system (e.g., ISO 8859-1 for Latin-1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2042 characters, ISO 8859-8 for Hebrew characters, etc.). To make this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2043 work, set the keyboard coding system to the appropriate value after
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2044 you activate the Windows input method. For example, if you activate
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2045 the Hebrew input method, type "C-x RET k iso-8859-8 RET". (Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2046 ought to recognize the Windows language-change event and set up the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2047 appropriate keyboard encoding automatically, but it doesn't do that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2048 yet.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2049
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2050 The %b specifier for format-time-string does not produce abbreviated
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2051 month names with consistent widths for some locales on some versions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2052 of Windows. This is caused by a deficiency in the underlying system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2053 library function.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2054
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2055 ** Typing Alt-Shift has strange effects on MS-Windows.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2056
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2057 This combination of keys is a command to change keyboard layout. If
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2058 you proceed to type another non-modifier key before you let go of Alt
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2059 and Shift, the Alt and Shift act as modifiers in the usual way. A
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2060 more permanent work around is to change it to another key combination,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2061 or disable it in the keyboard control panel.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2062
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2063 ** Interrupting Cygwin port of Bash from Emacs doesn't work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2064
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2065 Cygwin 1.x builds of the ported Bash cannot be interrupted from the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2066 MS-Windows version of Emacs. This is due to some change in the Bash
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2067 port or in the Cygwin library which apparently make Bash ignore the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2068 keyboard interrupt event sent by Emacs to Bash. (Older Cygwin ports
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2069 of Bash, up to b20.1, did receive SIGINT from Emacs.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2070
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2071 ** Accessing remote files with ange-ftp hangs the MS-Windows version of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2072
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2073 If the FTP client is the Cygwin port of GNU `ftp', this appears to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2074 due to some bug in the Cygwin DLL or some incompatibility between it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2075 and the implementation of asynchronous subprocesses in the Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2076 port of Emacs. Specifically, some parts of the FTP server responses
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2077 are not flushed out, apparently due to buffering issues, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2078 confuses ange-ftp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2079
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2080 The solution is to downgrade to an older version of the Cygwin DLL
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2081 (version 1.3.2 was reported to solve the problem), or use the stock
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2082 Windows FTP client, usually found in the `C:\WINDOWS' or 'C:\WINNT'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2083 directory. To force ange-ftp use the stock Windows client, set the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2084 variable `ange-ftp-ftp-program-name' to the absolute file name of the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2085 client's executable. For example:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2086
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2087 (setq ange-ftp-ftp-program-name "c:/windows/ftp.exe")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2088
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2089 If you want to stick with the Cygwin FTP client, you can work around
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2090 this problem by putting this in your `.emacs' file:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2091
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2092 (setq ange-ftp-ftp-program-args '("-i" "-n" "-g" "-v" "--prompt" "")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2093
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2094 ** lpr commands don't work on MS-Windows with some cheap printers.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2095
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2096 This problem may also strike other platforms, but the solution is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2097 likely to be a global one, and not Emacs specific.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2098
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2099 Many cheap inkjet, and even some cheap laser printers, do not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2100 print plain text anymore, they will only print through graphical
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2101 printer drivers. A workaround on MS-Windows is to use Windows' basic
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2102 built in editor to print (this is possibly the only useful purpose it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2103 has):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2104
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2105 (setq printer-name "") ;; notepad takes the default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2106 (setq lpr-command "notepad") ;; notepad
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2107 (setq lpr-switches nil) ;; not needed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2108 (setq lpr-printer-switch "/P") ;; run notepad as batch printer
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2109
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2110 ** Antivirus software interacts badly with the MS-Windows version of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2111
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2112 The usual manifestation of these problems is that subprocesses don't
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2113 work or even wedge the entire system. In particular, "M-x shell RET"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2114 was reported to fail to work. But other commands also sometimes don't
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2115 work when an antivirus package is installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2116
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2117 The solution is to switch the antivirus software to a less aggressive
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2118 mode (e.g., disable the ``auto-protect'' feature), or even uninstall
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2119 or disable it entirely.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2120
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2121 ** Pressing the mouse button on MS-Windows does not give a mouse-2 event.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2122
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2123 This is usually a problem with the mouse driver. Because most Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2124 programs do not do anything useful with the middle mouse button, many
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2125 mouse drivers allow you to define the wheel press to do something
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2126 different. Some drivers do not even have the option to generate a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2127 middle button press. In such cases, setting the wheel press to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2128 "scroll" sometimes works if you press the button twice. Trying a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2129 generic mouse driver might help.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2130
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2131 ** Scrolling the mouse wheel on MS-Windows always scrolls the top window.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2132
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2133 This is another common problem with mouse drivers. Instead of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2134 generating scroll events, some mouse drivers try to fake scroll bar
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2135 movement. But they are not intelligent enough to handle multiple
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2136 scroll bars within a frame. Trying a generic mouse driver might help.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2137
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2138 ** Mail sent through Microsoft Exchange in some encodings appears to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2139 mangled and is not seen correctly in Rmail or Gnus. We don't know
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2140 exactly what happens, but it isn't an Emacs problem in cases we've
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2141 seen.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2142
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2143 ** On MS-Windows, you cannot use the right-hand ALT key and the left-hand
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2144 CTRL key together to type a Control-Meta character.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2145
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2146 This is a consequence of a misfeature beyond Emacs's control.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2147
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2148 Under Windows, the AltGr key on international keyboards generates key
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2149 events with the modifiers Right-Alt and Left-Ctrl. Since Emacs cannot
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2150 distinguish AltGr from an explicit Right-Alt and Left-Ctrl
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2151 combination, whenever it sees Right-Alt and Left-Ctrl it assumes that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2152 AltGr has been pressed. The variable `w32-recognize-altgr' can be set
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2153 to nil to tell Emacs that AltGr is really Ctrl and Alt.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2154
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2155 ** Under some X-servers running on MS-Windows, Emacs' display is incorrect.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2156
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2157 The symptoms are that Emacs does not completely erase blank areas of the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2158 screen during scrolling or some other screen operations (e.g., selective
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2159 display or when killing a region). M-x recenter will cause the screen
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2160 to be completely redisplayed and the "extra" characters will disappear.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2161
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2162 This is known to occur under Exceed 6, and possibly earlier versions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2163 as well; it is reportedly solved in version 6.2.0.16 and later. The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2164 problem lies in the X-server settings.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2165
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2166 There are reports that you can solve the problem with Exceed by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2167 running `Xconfig' from within NT, choosing "X selection", then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2168 un-checking the boxes "auto-copy X selection" and "auto-paste to X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2169 selection".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2170
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2171 Of this does not work, please inform bug-gnu-emacs@gnu.org. Then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2172 please call support for your X-server and see if you can get a fix.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2173 If you do, please send it to bug-gnu-emacs@gnu.org so we can list it
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2174 here.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2175
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2176 * Build-time problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2177
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2178 ** Configuration
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2179
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2180 *** The `configure' script doesn't find the jpeg library.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2181
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2182 There are reports that this happens on some systems because the linker
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2183 by default only looks for shared libraries, but jpeg distribution by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2184 default only installs a nonshared version of the library, `libjpeg.a'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2185
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2186 If this is the problem, you can configure the jpeg library with the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2187 `--enable-shared' option and then rebuild libjpeg. This produces a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2188 shared version of libjpeg, which you need to install. Finally, rerun
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2189 the Emacs configure script, which should now find the jpeg library.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2190 Alternatively, modify the generated src/Makefile to link the .a file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2191 explicitly, and edit src/config.h to define HAVE_JPEG.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2192
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2193 ** Compilation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2194
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2195 *** Building Emacs over NFS fails with ``Text file busy''.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2197 This was reported to happen when building Emacs on a GNU/Linux system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2198 (RedHat Linux 6.2) using a build directory automounted from Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2199 (SunOS 5.6) file server, but it might not be limited to that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2200 configuration alone. Presumably, the NFS server doesn't commit the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2201 files' data to disk quickly enough, and the Emacs executable file is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2202 left ``busy'' for several seconds after Emacs has finished dumping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2203 itself. This causes the subsequent commands which invoke the dumped
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2204 Emacs executable to fail with the above message.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2205
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2206 In some of these cases, a time skew between the NFS server and the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2207 machine where Emacs is built is detected and reported by GNU Make
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2208 (it says that some of the files have modification time in the future).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2209 This might be a symptom of NFS-related problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2210
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2211 If the NFS server runs on Solaris, apply the Solaris patch 105379-05
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2212 (Sunos 5.6: /kernel/misc/nfssrv patch). If that doesn't work, or if
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2213 you have a different version of the OS or the NFS server, you can
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2214 force the NFS server to use 1KB blocks, which was reported to fix the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2215 problem albeit at a price of slowing down file I/O. You can force 1KB
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2216 blocks by specifying the "-o rsize=1024,wsize=1024" options to the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2217 `mount' command, or by adding ",rsize=1024,wsize=1024" to the mount
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2218 options in the appropriate system configuration file, such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2219 `/etc/auto.home'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2220
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2221 Alternatively, when Make fails due to this problem, you could wait for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2222 a few seconds and then invoke Make again. In one particular case,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2223 waiting for 10 or more seconds between the two Make invocations seemed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2224 to work around the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2225
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2226 Similar problems can happen if your machine NFS-mounts a directory
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2227 onto itself. Suppose the Emacs sources live in `/usr/local/src' and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2228 you are working on the host called `marvin'. Then an entry in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2229 `/etc/fstab' file like the following is asking for trouble:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2230
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2231 marvin:/usr/local/src /usr/local/src ...options.omitted...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2232
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2233 The solution is to remove this line from `etc/fstab'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2234
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2235 *** Building Emacs with GCC 2.9x fails in the `src' directory.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2236
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2237 This may happen if you use a development version of GNU `cpp' from one
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2238 of the GCC snapshots between Oct 2000 and Feb 2001, or from a released
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2239 version of GCC newer than 2.95.2 which was prepared around those
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2240 dates; similar problems were reported with some snapshots of GCC 3.1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2241 around Sep 30 2001. The preprocessor in those versions is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2242 incompatible with a traditional Unix cpp (e.g., it expands ".." into
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2243 ". .", which breaks relative file names that reference the parent
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2244 directory; or inserts TAB characters before lines that set Make
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2245 variables).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2246
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2247 The solution is to make sure the preprocessor is run with the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2248 `-traditional' option. The `configure' script does that automatically
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2249 when it detects the known problems in your cpp, but you might hit some
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2250 unknown ones. To force the `configure' script to use `-traditional',
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2251 run the script like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2252
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2253 CPP='gcc -E -traditional' ./configure ...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2254
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2255 (replace the ellipsis "..." with any additional arguments you pass to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2256 the script).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2257
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2258 Note that this problem does not pertain to the MS-Windows port of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2259 Emacs, since it doesn't use the preprocessor to generate Makefiles.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2260
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2261 *** src/Makefile and lib-src/Makefile are truncated--most of the file missing.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2262 *** Compiling wakeup, in lib-src, says it can't make wakeup.c.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2264 This can happen if configure uses GNU sed version 2.03. That version
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2265 had a bug. GNU sed version 2.05 works properly.To solve the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2266 problem, install the current version of GNU Sed, then rerun Emacs's
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2267 configure script.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2268
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2269 *** Compiling lib-src says there is no rule to make test-distrib.c.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2270
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2271 This results from a bug in a VERY old version of GNU Sed. To solve
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2272 the problem, install the current version of GNU Sed, then rerun
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2273 Emacs's configure script.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2274
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2275 *** Building the MS-Windows port with Cygwin GCC can fail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2276
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2277 Emacs may not build using recent Cygwin builds of GCC, such as Cygwin
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2278 version 1.1.8, using the default configure settings. It appears to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2279 necessary to specify the -mwin32 flag when compiling, and define
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2280 __MSVCRT__, like so:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2282 configure --with-gcc --cflags -mwin32 --cflags -D__MSVCRT__
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2283
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2284 *** Building the MS-Windows port fails with a CreateProcess failure.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2285
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2286 Some versions of mingw32 make on some versions of Windows do not seem
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2287 to detect the shell correctly. Try "make SHELL=cmd.exe", or if that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2288 fails, try running make from Cygwin bash instead.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2289
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2290 *** Building the MS-Windows port with Leim fails in the `leim' directory.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2291
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2292 The error message might be something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2293
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2294 Converting d:/emacs-21.3/leim/CXTERM-DIC/4Corner.tit to quail-package...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2295 Invalid ENCODE: value in TIT dictionary
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2296 NMAKE : fatal error U1077: '"../src/obj-spd/i386/emacs.exe"' : return code
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2297 '0xffffffff'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2298 Stop.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2299
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2300 This can happen if the Leim distribution is unpacked with a program
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2301 which converts the `*.tit' files to DOS-style CR-LF text format. The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2302 `*.tit' files in the leim/CXTERM-DIC directory require Unix-style line
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2303 endings to compile properly, because Emacs reads them without any code
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2304 or EOL conversions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2305
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2306 The solution is to make sure the program used to unpack Leim does not
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2307 change the files' line endings behind your back. The GNU FTP site has
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2308 in the `/gnu/emacs/windows' directory a program called `djtarnt.exe'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2309 which can be used to unpack `.tar.gz' and `.zip' archives without
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2310 mangling them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2311
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2312 *** Building `ctags' for MS-Windows with the MinGW port of GCC fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2313
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2314 This might happen due to a bug in the MinGW header assert.h, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2315 defines the `assert' macro with a trailing semi-colon. The following
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2316 patch to assert.h should solve this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2317
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2318 *** include/assert.h.orig Sun Nov 7 02:41:36 1999
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2319 --- include/assert.h Mon Jan 29 11:49:10 2001
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2320 ***************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2321 *** 41,47 ****
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2322 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2323 * If not debugging, assert does nothing.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2324 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2325 ! #define assert(x) ((void)0);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2326
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2327 #else /* debugging enabled */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2328
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2329 --- 41,47 ----
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2330 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2331 * If not debugging, assert does nothing.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2332 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2333 ! #define assert(x) ((void)0)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2334
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2335 #else /* debugging enabled */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2336
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2337
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2338 ** Linking
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2339
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2340 *** Building Emacs with a system compiler fails to link because of an
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2341 undefined symbol such as __eprintf which does not appear in Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2342
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2343 This can happen if some of the libraries linked into Emacs were built
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2344 with GCC, but Emacs itself is being linked with a compiler other than
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2345 GCC. Object files compiled with GCC might need some helper functions
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2346 from libgcc.a, the library which comes with GCC, but the system
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2347 compiler does not instruct the linker to search libgcc.a during the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2348 link stage.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2349
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2350 A solution is to link with GCC, like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2351
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2352 make CC=gcc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2353
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2354 Since the .o object files already exist, this will not recompile Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2355 with GCC, but just restart by trying again to link temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2356
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2357 *** AIX 1.3 ptf 0013: Link failure.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2358
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2359 There is a real duplicate definition of the function `_slibc_free' in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2360 the library /lib/libc_s.a (just do nm on it to verify). The
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2361 workaround/fix is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2362
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2363 cd /lib
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2364 ar xv libc_s.a NLtmtime.o
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2365 ar dv libc_s.a NLtmtime.o
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2366
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2367 *** AIX 4.1.2: Linker error messages such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2368 ld: 0711-212 SEVERE ERROR: Symbol .__quous, found in the global symbol table
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2369 of archive /usr/lib/libIM.a, was not defined in archive member shr.o.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2370
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2371 This is a problem in libIM.a. You can work around it by executing
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2372 these shell commands in the src subdirectory of the directory where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2373 you build Emacs:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2374
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2375 cp /usr/lib/libIM.a .
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2376 chmod 664 libIM.a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2377 ranlib libIM.a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2378
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2379 Then change -lIM to ./libIM.a in the command to link temacs (in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2380 Makefile).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2381
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2382 *** Sun with acc: Link failure when using acc on a Sun.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2383
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2384 To use acc, you need additional options just before the libraries, such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2385
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2386 /usr/lang/SC2.0.1/values-Xt.o -L/usr/lang/SC2.0.1/cg87 -L/usr/lang/SC2.0.1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2387
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2388 and you need to add -lansi just before -lc.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2389
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2390 The precise file names depend on the compiler version, so we
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2391 cannot easily arrange to supply them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2392
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2393 *** Linking says that the functions insque and remque are undefined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2394
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2395 Change oldXMenu/Makefile by adding insque.o to the variable OBJS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2396
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2397 *** `tparam' reported as a multiply-defined symbol when linking with ncurses.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2398
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2399 This problem results from an incompatible change in ncurses, in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2400 version 1.9.9e approximately. This version is unable to provide a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2401 definition of tparm without also defining tparam. This is also
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2402 incompatible with Terminfo; as a result, the Emacs Terminfo support
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2403 does not work with this version of ncurses.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2404
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2405 The fix is to install a newer version of ncurses, such as version 4.2.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2406
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2407 ** Dumping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2408
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2409 *** Linux: Segfault during `make bootstrap' under certain recent versions of the Linux kernel.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2410
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2411 With certain recent Linux kernels (like the one of Redhat Fedora Core
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2412 1 and newer), the new "Exec-shield" functionality is enabled by default, which
63969
4b9c4819acb4 Added that emacs tries to handle exec-shield at build time.
Jan Djärv <jan.h.d@swipnet.se>
parents: 63968
diff changeset
2413 creates a different memory layout that breaks the emacs dumper. Emacs tries
4b9c4819acb4 Added that emacs tries to handle exec-shield at build time.
Jan Djärv <jan.h.d@swipnet.se>
parents: 63968
diff changeset
2414 to handle this at build time, but if the workaround used fails, these
4b9c4819acb4 Added that emacs tries to handle exec-shield at build time.
Jan Djärv <jan.h.d@swipnet.se>
parents: 63968
diff changeset
2415 instructions can be useful.
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2416 The work-around explained here is not enough on Fedora Core 4 (and possible
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2417 newer). Read the next item.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2418
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2419 Configure can overcome the problem of exec-shield if the architecture is
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2420 x86 and the program setarch is present. On other architectures no
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2421 workaround is known.
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2422
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2423 You can check the Exec-shield state like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2424
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2425 cat /proc/sys/kernel/exec-shield
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2426
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2427 It returns non-zero when Exec-shield is enabled, 0 otherwise. Please
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2428 read your system documentation for more details on Exec-shield and
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2429 associated commands. Exec-shield can be turned off with this command:
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2430
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2431 echo "0" > /proc/sys/kernel/exec-shield
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2432
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2433 When Exec-shield is enabled, building Emacs will segfault during the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2434 execution of this command:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2435
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2436 ./temacs --batch --load loadup [dump|bootstrap]
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2437
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2438 To work around this problem, it is necessary to temporarily disable
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2439 Exec-shield while building Emacs, or, on x86, by using the `setarch'
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2440 command when running temacs like this:
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2441
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2442 setarch i386 ./temacs --batch --load loadup [dump|bootstrap]
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2443
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2444
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2445 *** Fedora Core 4 GNU/Linux: Segfault during dumping.
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2446
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2447 In addition to exec-shield explained above "Linux: Segfault during
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2448 `make bootstrap' under certain recent versions of the Linux kernel"
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2449 item, Linux kernel shipped with Fedora Core 4 randomizes the virtual
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2450 address space of a process. As the result dumping may fail even if
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2451 you turn off exec-shield. In this case, use the -R option to the setarch
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2452 command:
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2453
64489
86ac75fb6283 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63969
diff changeset
2454 setarch i386 -R ./temacs --batch --load loadup [dump|bootstrap]
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2455
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2456 or
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2457
64489
86ac75fb6283 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63969
diff changeset
2458 setarch i386 -R make bootstrap
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2459
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2460 *** Fatal signal in the command temacs -l loadup inc dump.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2461
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2462 This command is the final stage of building Emacs. It is run by the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2463 Makefile in the src subdirectory, or by build.com on VMS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2464
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2465 It has been known to get fatal errors due to insufficient swapping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2466 space available on the machine.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2467
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2468 On 68000s, it has also happened because of bugs in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2469 subroutine `alloca'. Verify that `alloca' works right, even
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2470 for large blocks (many pages).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2471
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2472 *** test-distrib says that the distribution has been clobbered.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2473 *** or, temacs prints "Command key out of range 0-127".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2474 *** or, temacs runs and dumps emacs, but emacs totally fails to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2475 *** or, temacs gets errors dumping emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2476
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2477 This can be because the .elc files have been garbled. Do not be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2478 fooled by the fact that most of a .elc file is text: these are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2479 binary files and can contain all 256 byte values.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2480
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2481 In particular `shar' cannot be used for transmitting GNU Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2482 It typically truncates "lines". What appear to be "lines" in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2483 a binary file can of course be of any length. Even once `shar'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2484 itself is made to work correctly, `sh' discards null characters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2485 when unpacking the shell archive.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2486
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2487 I have also seen character \177 changed into \377. I do not know
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2488 what transfer means caused this problem. Various network
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2489 file transfer programs are suspected of clobbering the high bit.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2490
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2491 If you have a copy of Emacs that has been damaged in its
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2492 nonprinting characters, you can fix them:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2493
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2494 1) Record the names of all the .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2495 2) Delete all the .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2496 3) Recompile alloc.c with a value of PURESIZE twice as large.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2497 (See puresize.h.) You might as well save the old alloc.o.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2498 4) Remake emacs. It should work now.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2499 5) Running emacs, do Meta-x byte-compile-file repeatedly
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2500 to recreate all the .elc files that used to exist.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2501 You may need to increase the value of the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2502 max-lisp-eval-depth to succeed in running the compiler interpreted
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2503 on certain .el files. 400 was sufficient as of last report.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2504 6) Reinstall the old alloc.o (undoing changes to alloc.c if any)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2505 and remake temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2506 7) Remake emacs. It should work now, with valid .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2507
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2508 *** temacs prints "Pure Lisp storage exhausted".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2509
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2510 This means that the Lisp code loaded from the .elc and .el
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2511 files during temacs -l loadup inc dump took up more
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2512 space than was allocated.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2513
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2514 This could be caused by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2515 1) adding code to the preloaded Lisp files
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2516 2) adding more preloaded files in loadup.el
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2517 3) having a site-init.el or site-load.el which loads files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2518 Note that ANY site-init.el or site-load.el is nonstandard;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2519 if you have received Emacs from some other site
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2520 and it contains a site-init.el or site-load.el file, consider
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2521 deleting that file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2522 4) getting the wrong .el or .elc files
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2523 (not from the directory you expected).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2524 5) deleting some .elc files that are supposed to exist.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2525 This would cause the source files (.el files) to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2526 loaded instead. They take up more room, so you lose.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2527 6) a bug in the Emacs distribution which underestimates
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2528 the space required.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2529
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2530 If the need for more space is legitimate, change the definition
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2531 of PURESIZE in puresize.h.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2532
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2533 But in some of the cases listed above, this problem is a consequence
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2534 of something else that is wrong. Be sure to check and fix the real
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2535 problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2536
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2537 *** Linux: Emacs crashes when dumping itself on Mac PPC running Yellow Dog GNU/Linux.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2538
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2539 The crashes happen inside the function Fmake_symbol; here's a typical
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2540 C backtrace printed by GDB:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2541
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2542 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2543 (gdb) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2544 #0 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2545 #1 0x1942ca4 in init_obarray ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2546 #2 0x18b3500 in main ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2547 #3 0x114371c in __libc_start_main (argc=5, argv=0x7ffff5b4, envp=0x7ffff5cc,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2548
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2549 This could happen because GCC version 2.95 and later changed the base
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2550 of the load address to 0x10000000. Emacs needs to be told about this,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2551 but we currently cannot do that automatically, because that breaks
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2552 other versions of GNU/Linux on the MacPPC. Until we find a way to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2553 distinguish between the Yellow Dog and the other varieties of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2554 GNU/Linux systems on the PPC, you will have to manually uncomment the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2555 following section near the end of the file src/m/macppc.h in the Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2556 distribution:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2557
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2558 #if 0 /* This breaks things on PPC GNU/Linux except for Yellowdog,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2559 even with identical GCC, as, ld. Let's take it out until we
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2560 know what's really going on here. */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2561 /* GCC 2.95 and newer on GNU/Linux PPC changed the load address to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2562 0x10000000. */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2563 #if defined __linux__
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2564 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2565 #define DATA_SEG_BITS 0x10000000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2566 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2567 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2568 #endif /* 0 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2569
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2570 Remove the "#if 0" and "#endif" directives which surround this, save
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2571 the file, and then reconfigure and rebuild Emacs. The dumping process
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2572 should now succeed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2573
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2574 ** Installation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2575
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2576 *** Installing Emacs gets an error running `install-info'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2577
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2578 You need to install a recent version of Texinfo; that package
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2579 supplies the `install-info' command.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2580
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2581 ** First execution
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2582
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2583 *** Emacs binary is not in executable format, and cannot be run.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2584
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2585 This was reported to happen when Emacs is built in a directory mounted
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2586 via NFS, for some combinations of NFS client and NFS server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2587 Usually, the file `emacs' produced in these cases is full of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2588 binary null characters, and the `file' utility says:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2589
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2590 emacs: ASCII text, with no line terminators
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2591
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2592 We don't know what exactly causes this failure. A work-around is to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2593 build Emacs in a directory on a local disk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2594
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2595 *** The dumped Emacs crashes when run, trying to write pure data.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2596
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2597 Two causes have been seen for such problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2598
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2599 1) On a system where getpagesize is not a system call, it is defined
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2600 as a macro. If the definition (in both unexec.c and malloc.c) is wrong,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2601 it can cause problems like this. You might be able to find the correct
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2602 value in the man page for a.out (5).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2603
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2604 2) Some systems allocate variables declared static among the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2605 initialized variables. Emacs makes all initialized variables in most
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2606 of its files pure after dumping, but the variables declared static and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2607 not initialized are not supposed to be pure. On these systems you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2608 may need to add "#define static" to the m- or the s- file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2609
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2610 * Emacs 19 problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2611
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2612 ** Error messages `Wrong number of arguments: #<subr where-is-internal>, 5'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2613
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2614 This typically results from having the powerkey library loaded.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2615 Powerkey was designed for Emacs 19.22. It is obsolete now because
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2616 Emacs 19 now has this feature built in; and powerkey also calls
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2617 where-is-internal in an obsolete way.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2618
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2619 So the fix is to arrange not to load powerkey.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2620
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2621 * Runtime problems on legacy systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2622
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2623 This section covers bugs reported on very old hardware or software.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2624 If you are using hardware and an operating system shipped after 2000,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2625 it is unlikely you will see any of these.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2626
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2627 ** Ancient operating systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2628
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2629 AIX 4.2 was end-of-lifed on Dec 31st, 1999.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2630
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2631 *** AIX: You get this compiler error message:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2632
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2633 Processing include file ./XMenuInt.h
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2634 1501-106: (S) Include file X11/Xlib.h not found.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2635
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2636 This means your system was installed with only the X11 runtime i.d
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2637 libraries. You have to find your sipo (bootable tape) and install
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2638 X11Dev... with smit.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2639
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2640 (This report must be ancient. Bootable tapes are long dead.)
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2641
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2642 *** AIX 3.2.4: Releasing Ctrl/Act key has no effect, if Shift is down.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2643
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2644 Due to a feature of AIX, pressing or releasing the Ctrl/Act key is
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2645 ignored when the Shift, Alt or AltGr keys are held down. This can
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2646 lead to the keyboard being "control-locked"--ordinary letters are
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2647 treated as control characters.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2648
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2649 You can get out of this "control-locked" state by pressing and
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2650 releasing Ctrl/Act while not pressing or holding any other keys.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2651
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2652 *** AIX 3.2.5: You get this message when running Emacs:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2653
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2654 Could not load program emacs
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2655 Symbol smtcheckinit in csh is undefined
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2656 Error was: Exec format error
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2657
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2658 or this one:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2659
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2660 Could not load program .emacs
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2661 Symbol _system_con in csh is undefined
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2662 Symbol _fp_trapsta in csh is undefined
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2663 Error was: Exec format error
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2664
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2665 These can happen when you try to run on AIX 3.2.5 a program that was
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2666 compiled with 3.2.4. The fix is to recompile.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2667
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2668 *** AIX 4.2: Emacs gets a segmentation fault at startup.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2669
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2670 If you are using IBM's xlc compiler, compile emacs.c
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2671 without optimization; that should avoid the problem.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2672
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2673 *** ISC Unix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2674
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2675 **** ISC: display-time causes kernel problems on ISC systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2676
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2677 Under Interactive Unix versions 3.0.1 and 4.0 (and probably other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2678 versions), display-time causes the loss of large numbers of STREVENT
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2679 cells. Eventually the kernel's supply of these cells is exhausted.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2680 This makes emacs and the whole system run slow, and can make other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2681 processes die, in particular pcnfsd.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2682
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2683 Other emacs functions that communicate with remote processes may have
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2684 the same problem. Display-time seems to be far the worst.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2685
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2686 The only known fix: Don't run display-time.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2687
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2688 *** SunOS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2689
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2690 SunOS 4.1.4 stopped shipping on Sep 30 1998.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2691
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2692 **** SunOS: You get linker errors
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2693 ld: Undefined symbol
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2694 _get_wmShellWidgetClass
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2695 _get_applicationShellWidgetClass
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2696
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2697 **** Sun 4.0.x: M-x shell persistently reports "Process shell exited abnormally with code 1".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2698
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2699 This happened on Suns as a result of what is said to be a bug in Sunos
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2700 version 4.0.x. The only fix was to reboot the machine.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2701
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2702 **** SunOS4.1.1 and SunOS4.1.3: Mail is lost when sent to local aliases.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2703
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2704 Many emacs mail user agents (VM and rmail, for instance) use the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2705 sendmail.el library. This library can arrange for mail to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2706 delivered by passing messages to the /usr/lib/sendmail (usually)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2707 program . In doing so, it passes the '-t' flag to sendmail, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2708 means that the name of the recipient of the message is not on the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2709 command line and, therefore, that sendmail must parse the message to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2710 obtain the destination address.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2711
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2712 There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2713 In short, when given the -t flag, the SunOS sendmail won't recognize
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2714 non-local (i.e. NIS) aliases. It has been reported that the Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2715 2.x versions of sendmail do not have this bug. For those using SunOS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2716 4.1, the best fix is to install sendmail V8 or IDA sendmail (which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2717 have other advantages over the regular sendmail as well). At the time
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2718 of this writing, these official versions are available:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2720 Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2721 sendmail.8.6.9.base.tar.Z (the base system source & documentation)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2722 sendmail.8.6.9.cf.tar.Z (configuration files)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2723 sendmail.8.6.9.misc.tar.Z (miscellaneous support programs)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2724 sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2725
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2726 IDA sendmail on vixen.cso.uiuc.edu in /pub:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2727 sendmail-5.67b+IDA-1.5.tar.gz
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2728
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2729 **** Sunos 4: You get the error ld: Undefined symbol __lib_version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2730
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2731 This is the result of using cc or gcc with the shared library meant
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2732 for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2733 /usr/lang/SC2.0.1 or some similar directory.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2735 **** SunOS 4.1.3: Emacs unpredictably crashes in _yp_dobind_soft.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2736
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2737 This happens if you configure Emacs specifying just `sparc-sun-sunos4'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2738 on a system that is version 4.1.3. You must specify the precise
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2739 version number (or let configure figure out the configuration, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2740 it can do perfectly well for SunOS).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2741
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2742 **** Sunos 4.1.3: Emacs gets hung shortly after startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2743
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2744 We think this is due to a bug in Sunos. The word is that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2745 one of these Sunos patches fixes the bug:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2746
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2747 100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 101080-01
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2748 100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 101134-01
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2749 100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 101070-01 101145-01
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2750 100173-10 100305-15 100383-06 100513-04 100570-05 100689-01 101071-03 101200-02
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2751 100178-09 100338-05 100421-03 100536-02 100584-05 100784-01 101072-01 101207-01
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2752
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2753 We don't know which of these patches really matter. If you find out
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2754 which ones, please inform bug-gnu-emacs@gnu.org.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2755
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2756 **** SunOS 4: Emacs processes keep going after you kill the X server
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2757 (or log out, if you logged in using X).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2758
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2759 Someone reported that recompiling with GCC 2.7.0 fixed this problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2760
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2761 The fix to this is to install patch 100573 for OpenWindows 3.0
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2762 or link libXmu statically.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2763
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2764 **** Sunos 5.3: Subprocesses remain, hanging but not zombies.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2765
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2766 A bug in Sunos 5.3 causes Emacs subprocesses to remain after Emacs
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2767 exits. Sun patch # 101415-02 is part of the fix for this, but it only
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2768 applies to ptys, and doesn't fix the problem with subprocesses
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2769 communicating through pipes.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2770
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2771 *** Apollo Domain
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2772
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2773 **** Shell mode ignores interrupts on Apollo Domain.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2774
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2775 You may find that M-x shell prints the following message:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2776
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2777 Warning: no access to tty; thus no job control in this shell...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2778
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2779 This can happen if there are not enough ptys on your system.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2780 Here is how to make more of them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2781
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2782 % cd /dev
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2783 % ls pty*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2784 # shows how many pty's you have. I had 8, named pty0 to pty7)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2785 % /etc/crpty 8
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2786 # creates eight new pty's
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2787
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2788 *** Irix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2789
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2790 *** Irix 6.2: No visible display on mips-sgi-irix6.2 when compiling with GCC 2.8.1.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2791
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2792 This problem went away after installing the latest IRIX patches
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2793 as of 8 Dec 1998.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2794
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2795 The same problem has been reported on Irix 6.3.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2796
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2797 *** Irix 6.3: substituting environment variables in file names
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2798 in the minibuffer gives peculiar error messages such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2799
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2800 Substituting nonexistent environment variable ""
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2801
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2802 This is not an Emacs bug; it is caused by something in SGI patch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2803 003082 August 11, 1998.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2804
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2805 *** OPENSTEP
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2806
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2807 **** OPENSTEP 4.2: Compiling syntax.c with gcc 2.7.2.1 fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2808
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2809 The compiler was reported to crash while compiling syntax.c with the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2810 following message:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2811
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2812 cc: Internal compiler error: program cc1obj got fatal signal 11
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2813
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2814 To work around this, replace the macros UPDATE_SYNTAX_TABLE_FORWARD,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2815 INC_BOTH, and INC_FROM with functions. To this end, first define 3
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2816 functions, one each for every macro. Here's an example:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2817
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2818 static int update_syntax_table_forward(int from)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2819 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2820 return(UPDATE_SYNTAX_TABLE_FORWARD(from));
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2821 }/*update_syntax_table_forward*/
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2822
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2823 Then replace all references to UPDATE_SYNTAX_TABLE_FORWARD in syntax.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2824 with a call to the function update_syntax_table_forward.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2825
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2826 *** Solaris 2.x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2827
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2828 **** Strange results from format %d in a few cases, on a Sun.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2829
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2830 Sun compiler version SC3.0 has been found to miscompile part of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2831 editfns.c. The workaround is to compile with some other compiler such
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2832 as GCC.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2833
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2834 **** On Solaris, Emacs dumps core if lisp-complete-symbol is called.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2835
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2836 If you compile Emacs with the -fast or -xO4 option with version 3.0.2
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2837 of the Sun C compiler, Emacs dumps core when lisp-complete-symbol is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2838 called. The problem does not happen if you compile with GCC.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2839
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2840 **** On Solaris, Emacs crashes if you use (display-time).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2841
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2842 This can happen if you configure Emacs without specifying the precise
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2843 version of Solaris that you are using.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2844
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2845 **** Solaris 2.3 and 2.4: Unpredictable segmentation faults.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2846
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2847 A user reported that this happened in 19.29 when it was compiled with
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2848 the Sun compiler, but not when he recompiled with GCC 2.7.0.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2849
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2850 We do not know whether something in Emacs is partly to blame for this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2851
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2852 **** Solaris 2.4: Emacs dumps core on startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2853
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2854 Bill Sebok says that the cause of this is Solaris 2.4 vendor patch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2855 102303-05, which extends the Solaris linker to deal with the Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2856 Common Desktop Environment's linking needs. You can fix the problem
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2857 by removing this patch and installing patch 102049-02 instead.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2858 However, that linker version won't work with CDE.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2859
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2860 Solaris 2.5 comes with a linker that has this bug. It is reported that if
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2861 you install all the latest patches (as of June 1996), the bug is fixed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2862 We suspect the crucial patch is one of these, but we don't know
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2863 for certain.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2864
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2865 103093-03: [README] SunOS 5.5: kernel patch (2140557 bytes)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2866 102832-01: [README] OpenWindows 3.5: Xview Jumbo Patch (4181613 bytes)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2867 103242-04: [README] SunOS 5.5: linker patch (595363 bytes)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2868
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2869 (One user reports that the bug was fixed by those patches together
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2870 with patches 102980-04, 103279-01, 103300-02, and 103468-01.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2871
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2872 If you can determine which patch does fix the bug, please tell
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2873 bug-gnu-emacs@gnu.org.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2874
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2875 Meanwhile, the GNU linker links Emacs properly on both Solaris 2.4 and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2876 Solaris 2.5.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2877
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2878 **** Solaris 2.4: Dired hangs and C-g does not work. Or Emacs hangs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2879 forever waiting for termination of a subprocess that is a zombie.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2880
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2881 casper@fwi.uva.nl says the problem is in X11R6. Rebuild libX11.so
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2882 after changing the file xc/config/cf/sunLib.tmpl. Change the lines
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2883
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2884 #if ThreadedX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2885 #define SharedX11Reqs -lthread
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2886 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2887
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2888 to:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2889
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2890 #if OSMinorVersion < 4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2891 #if ThreadedX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2892 #define SharedX11Reqs -lthread
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2893 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2894 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2895
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2896 Be sure also to edit x/config/cf/sun.cf so that OSMinorVersion is 4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2897 (as it should be for Solaris 2.4). The file has three definitions for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2898 OSMinorVersion: the first is for x86, the second for SPARC under
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2899 Solaris, and the third for SunOS 4. Make sure to update the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2900 definition for your type of machine and system.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2901
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2902 Then do `make Everything' in the top directory of X11R6, to rebuild
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2903 the makefiles and rebuild X. The X built this way work only on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2904 Solaris 2.4, not on 2.3.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2905
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2906 For multithreaded X to work it is necessary to install patch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2907 101925-02 to fix problems in header files [2.4]. You need
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2908 to reinstall gcc or re-run just-fixinc after installing that
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2909 patch.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2910
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2911 However, Frank Rust <frust@iti.cs.tu-bs.de> used a simpler solution:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2912 he changed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2913 #define ThreadedX YES
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2914 to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2915 #define ThreadedX NO
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2916 in sun.cf and did `make World' to rebuild X11R6. Removing all
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2917 `-DXTHREAD*' flags and `-lthread' entries from lib/X11/Makefile and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2918 typing 'make install' in that directory also seemed to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2919
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2920 **** Solaris 2.x: GCC complains "64 bit integer types not supported".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2921
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2922 This suggests that GCC is not installed correctly. Most likely you
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2923 are using GCC 2.7.2.3 (or earlier) on Solaris 2.6 (or later); this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2924 does not work without patching. To run GCC 2.7.2.3 on Solaris 2.6 or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2925 later, you must patch fixinc.svr4 and reinstall GCC from scratch as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2926 described in the Solaris FAQ
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2927 <http://www.wins.uva.nl/pub/solaris/solaris2.html>. A better fix is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2928 to upgrade to GCC 2.8.1 or later.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2929
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2930 **** Solaris 2.7: Building Emacs with WorkShop Compilers 5.0 98/12/15
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2931 C 5.0 failed, apparently with non-default CFLAGS, most probably due to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2932 compiler bugs. Using Sun Solaris 2.7 Sun WorkShop 6 update 1 C
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2933 release was reported to work without problems. It worked OK on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2934 another system with Solaris 8 using apparently the same 5.0 compiler
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2935 and the default CFLAGS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2936
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2937 **** Solaris 2.x: Emacs dumps core when built with Motif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2938
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2939 The Solaris Motif libraries are buggy, at least up through Solaris 2.5.1.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2940 Install the current Motif runtime library patch appropriate for your host.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2941 (Make sure the patch is current; some older patch versions still have the bug.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2942 You should install the other patches recommended by Sun for your host, too.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2943 You can obtain Sun patches from ftp://sunsolve.sun.com/pub/patches/;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2944 look for files with names ending in `.PatchReport' to see which patches
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2945 are currently recommended for your host.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2946
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2947 On Solaris 2.6, Emacs is said to work with Motif when Solaris patch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2948 105284-12 is installed, but fail when 105284-15 is installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2949 105284-18 might fix it again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2950
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2951 **** Solaris 2.6 and 7: the Compose key does not work.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2952
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2953 This is a bug in Motif in Solaris. Supposedly it has been fixed for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2954 the next major release of Solaris. However, if someone with Sun
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2955 support complains to Sun about the bug, they may release a patch.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2956 If you do this, mention Sun bug #4188711.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2957
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2958 One workaround is to use a locale that allows non-ASCII characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2959 For example, before invoking emacs, set the LC_ALL environment
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2960 variable to "en_US" (American English). The directory /usr/lib/locale
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2961 lists the supported locales; any locale other than "C" or "POSIX"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2962 should do.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2963
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2964 pen@lysator.liu.se says (Feb 1998) that the Compose key does work
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2965 if you link with the MIT X11 libraries instead of the Solaris X11
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2966 libraries.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2967
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2968 *** HP/UX versions before 11.0
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2969
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
2970 HP/UX 9 was end-of-lifed in December 1998.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2971 HP/UX 10 was end-of-lifed in May 1999.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2972
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2973 **** HP/UX 9: Emacs crashes with SIGBUS or SIGSEGV after you delete a frame.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2974
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2975 We think this is due to a bug in the X libraries provided by HP. With
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2976 the alternative X libraries in /usr/contrib/mitX11R5/lib, the problem
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2977 does not happen.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2978
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2979 *** HP/UX 10: Large file support is disabled.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2980
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2981 See the comments in src/s/hpux10.h.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2982
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2983 *** HP/UX: Emacs is slow using X11R5.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2984
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2985 This happens if you use the MIT versions of the X libraries--it
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2986 doesn't run as fast as HP's version. People sometimes use the version
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2987 because they see the HP version doesn't have the libraries libXaw.a,
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2988 libXmu.a, libXext.a and others. HP/UX normally doesn't come with
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2989 those libraries installed. To get good performance, you need to
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2990 install them and rebuild Emacs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2991
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2992 *** Ultrix and Digital Unix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2993
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2994 **** Ultrix 4.2: `make install' fails on install-doc with `Error 141'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2995
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2996 This happens on Ultrix 4.2 due to failure of a pipeline of tar
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2997 commands. We don't know why they fail, but the bug seems not to be in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2998 Emacs. The workaround is to run the shell command in install-doc by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2999 hand.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3001 **** Digital Unix 4.0: Garbled display on non-X terminals when Emacs runs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3002
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3003 So far it appears that running `tset' triggers this problem (when TERM
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3004 is vt100, at least). If you do not run `tset', then Emacs displays
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3005 properly. If someone can tell us precisely which effect of running
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3006 `tset' actually causes the problem, we may be able to implement a fix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3007 in Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3008
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3009 **** Ultrix: `expand-file-name' fails to work on any but the machine you dumped Emacs on.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3010
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3011 On Ultrix, if you use any of the functions which look up information
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3012 in the passwd database before dumping Emacs (say, by using
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3013 expand-file-name in site-init.el), then those functions will not work
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3014 in the dumped Emacs on any host but the one Emacs was dumped on.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3015
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3016 The solution? Don't use expand-file-name in site-init.el, or in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3017 anything it loads. Yuck - some solution.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3018
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3019 I'm not sure why this happens; if you can find out exactly what is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3020 going on, and perhaps find a fix or a workaround, please let us know.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3021 Perhaps the YP functions cache some information, the cache is included
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3022 in the dumped Emacs, and is then inaccurate on any other host.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3023
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3024 *** SVr4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3025
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3026 **** SVr4: On some variants of SVR4, Emacs does not work at all with X.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3027
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3028 Try defining BROKEN_FIONREAD in your config.h file. If this solves
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3029 the problem, please send a bug report to tell us this is needed; be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3030 sure to say exactly what type of machine and system you are using.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3031
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3032 **** SVr4: After running emacs once, subsequent invocations crash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3033
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3034 Some versions of SVR4 have a serious bug in the implementation of the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3035 mmap () system call in the kernel; this causes emacs to run correctly
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3036 the first time, and then crash when run a second time.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3037
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3038 Contact your vendor and ask for the mmap bug fix; in the mean time,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3039 you may be able to work around the problem by adding a line to your
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3040 operating system description file (whose name is reported by the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3041 configure script) that reads:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3042 #define SYSTEM_MALLOC
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3043 This makes Emacs use memory less efficiently, but seems to work around
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3044 the kernel bug.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3045
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3046 *** Irix 5 and earlier
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3047
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
3048 Exactly when Irix-5 end-of-lifed is obscure. But since Irix 6.0
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3049 shipped in 1994, it has been some years.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3050
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3051 **** Irix 5.2: unexelfsgi.c can't find cmplrs/stsupport.h.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3052
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3053 The file cmplrs/stsupport.h was included in the wrong file set in the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3054 Irix 5.2 distribution. You can find it in the optional fileset
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3055 compiler_dev, or copy it from some other Irix 5.2 system. A kludgy
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3056 workaround is to change unexelfsgi.c to include sym.h instead of
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3057 syms.h.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3058
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3059 **** Irix 5.3: "out of virtual swap space".
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3060
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3061 This message occurs when the system runs out of swap space due to too
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3062 many large programs running. The solution is either to provide more
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3063 swap space or to reduce the number of large programs being run. You
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3064 can check the current status of the swap space by executing the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3065 command `swap -l'.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3066
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3067 You can increase swap space by changing the file /etc/fstab. Adding a
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3068 line like this:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3069
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3070 /usr/swap/swap.more swap swap pri=3 0 0
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3071
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3072 where /usr/swap/swap.more is a file previously created (for instance
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3073 by using /etc/mkfile), will increase the swap space by the size of
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3074 that file. Execute `swap -m' or reboot the machine to activate the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3075 new swap area. See the manpages for `swap' and `fstab' for further
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3076 information.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3077
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3078 The objectserver daemon can use up lots of memory because it can be
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3079 swamped with NIS information. It collects information about all users
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3080 on the network that can log on to the host.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3081
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3082 If you want to disable the objectserver completely, you can execute
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3083 the command `chkconfig objectserver off' and reboot. That may disable
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3084 some of the window system functionality, such as responding CDROM
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3085 icons.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3086
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3087 You can also remove NIS support from the objectserver. The SGI `admin'
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3088 FAQ has a detailed description on how to do that; see question 35
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3089 ("Why isn't the objectserver working?"). The admin FAQ can be found at
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3090 ftp://viz.tamu.edu/pub/sgi/faq/.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3091
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3092 **** Irix 5.3: Emacs crashes in utmpname.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3093
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3094 This problem is fixed in Patch 3175 for Irix 5.3.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3095 It is also fixed in Irix versions 6.2 and up.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3096
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3097 **** Irix 6.0: Make tries (and fails) to build a program named unexelfsgi.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3098
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3099 A compiler bug inserts spaces into the string "unexelfsgi . o"
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3100 in src/Makefile. Edit src/Makefile, after configure is run,
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3101 find that string, and take out the spaces.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3102
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3103 Compiler fixes in Irix 6.0.1 should eliminate this problem.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3104
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3105 *** SCO Unix and UnixWare
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3106
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3107 **** SCO 3.2v4: Unusable default font.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3108
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3109 The Open Desktop environment comes with default X resource settings
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3110 that tell Emacs to use a variable-width font. Emacs cannot use such
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3111 fonts, so it does not work.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3112
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3113 This is caused by the file /usr/lib/X11/app-defaults/ScoTerm, which is
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3114 the application-specific resource file for the `scoterm' terminal
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3115 emulator program. It contains several extremely general X resources
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3116 that affect other programs besides `scoterm'. In particular, these
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3117 resources affect Emacs also:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3118
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3119 *Font: -*-helvetica-medium-r-*--12-*-p-*
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3120 *Background: scoBackground
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3121 *Foreground: scoForeground
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3122
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3123 The best solution is to create an application-specific resource file for
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3124 Emacs, /usr/lib/X11/sco/startup/Emacs, with the following contents:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3125
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3126 Emacs*Font: -*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3127 Emacs*Background: white
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3128 Emacs*Foreground: black
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3129
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3130 (These settings mimic the Emacs defaults, but you can change them to
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3131 suit your needs.) This resource file is only read when the X server
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3132 starts up, so you should restart it by logging out of the Open Desktop
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3133 environment or by running `scologin stop; scologin start` from the shell
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3134 as root. Alternatively, you can put these settings in the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3135 /usr/lib/X11/app-defaults/Emacs resource file and simply restart Emacs,
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3136 but then they will not affect remote invocations of Emacs that use the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3137 Open Desktop display.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3138
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3139 These resource files are not normally shared across a network of SCO
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3140 machines; you must create the file on each machine individually.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3141
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3142 **** SCO 4.2.0: Regular expressions matching bugs on SCO systems.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3143
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3144 On SCO, there are problems in regexp matching when Emacs is compiled
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3145 with the system compiler. The compiler version is "Microsoft C
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3146 version 6", SCO 4.2.0h Dev Sys Maintenance Supplement 01/06/93; Quick
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3147 C Compiler Version 1.00.46 (Beta). The solution is to compile with
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3148 GCC.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3149
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3150 **** UnixWare 2.1: Error 12 (virtual memory exceeded) when dumping Emacs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3151
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3152 Paul Abrahams (abrahams@acm.org) reports that with the installed
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3153 virtual memory settings for UnixWare 2.1.2, an Error 12 occurs during
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3154 the "make" that builds Emacs, when running temacs to dump emacs. That
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3155 error indicates that the per-process virtual memory limit has been
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3156 exceeded. The default limit is probably 32MB. Raising the virtual
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3157 memory limit to 40MB should make it possible to finish building Emacs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3158
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3159 You can do this with the command `ulimit' (sh) or `limit' (csh).
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3160 But you have to be root to do it.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3161
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3162 According to Martin Sohnius, you can also retune this in the kernel:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3163
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3164 # /etc/conf/bin/idtune SDATLIM 33554432 ## soft data size limit
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3165 # /etc/conf/bin/idtune HDATLIM 33554432 ## hard "
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3166 # /etc/conf/bin/idtune SVMMSIZE unlimited ## soft process size limit
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3167 # /etc/conf/bin/idtune HVMMSIZE unlimited ## hard "
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3168 # /etc/conf/bin/idbuild -B
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3169
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3170 (He recommends you not change the stack limit, though.)
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3171 These changes take effect when you reboot.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3172
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3173 *** Linux 1.x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3174
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3175 **** Linux 1.0-1.04: Typing C-c C-c in Shell mode kills your X server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3176
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3177 This happens with Linux kernel 1.0 thru 1.04, approximately. The workaround is
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3178 to define SIGNALS_VIA_CHARACTERS in config.h and recompile Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3179 Newer Linux kernel versions don't have this problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3180
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3181 **** Linux 1.3: Output from subprocess (such as man or diff) is randomly
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3182 truncated on GNU/Linux systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3183
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3184 This is due to a kernel bug which seems to be fixed in Linux version
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3185 1.3.75.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3186
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3187 ** Windows 3.1, 95, 98, and ME
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3188
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3189 *** MS-Windows NT/95: Problems running Perl under Emacs
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3190
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3191 `perl -de 0' just hangs when executed in an Emacs subshell.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3192 The fault lies with Perl (indirectly with Windows NT/95).
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3193
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3194 The problem is that the Perl debugger explicitly opens a connection to
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3195 "CON", which is the DOS/NT equivalent of "/dev/tty", for interacting
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3196 with the user.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3197
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3198 On Unix, this is okay, because Emacs (or the shell?) creates a
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3199 pseudo-tty so that /dev/tty is really the pipe Emacs is using to
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3200 communicate with the subprocess.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3201
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3202 On NT, this fails because CON always refers to the handle for the
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3203 relevant console (approximately equivalent to a tty), and cannot be
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3204 redirected to refer to the pipe Emacs assigned to the subprocess as
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3205 stdin.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3206
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3207 A workaround is to modify perldb.pl to use STDIN/STDOUT instead of CON.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3208
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3209 For Perl 4:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3210
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3211 *** PERL/LIB/PERLDB.PL.orig Wed May 26 08:24:18 1993
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3212 --- PERL/LIB/PERLDB.PL Mon Jul 01 15:28:16 1996
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3213 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3214 *** 68,74 ****
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3215 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3216 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3217 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3218 ! $console = "con";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3219 $rcfile="perldb.ini";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3220 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3221
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3222 --- 68,74 ----
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3223 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3224 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3225 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3226 ! $console = "";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3227 $rcfile="perldb.ini";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3228 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3229
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3230
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3231 For Perl 5:
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3232 *** perl/5.001/lib/perl5db.pl.orig Sun Jun 04 21:13:40 1995
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3233 --- perl/5.001/lib/perl5db.pl Mon Jul 01 17:00:08 1996
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3234 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3235 *** 22,28 ****
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3236 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3237 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3238 elsif (-e "con") {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3239 ! $console = "con";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3240 $rcfile="perldb.ini";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3241 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3242 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3243 --- 22,28 ----
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3244 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3245 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3246 elsif (-e "con") {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3247 ! $console = "";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3248 $rcfile="perldb.ini";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3249 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3250 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3251
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3252 *** MS-Windows 95: Alt-f6 does not get through to Emacs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3253
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3254 This character seems to be trapped by the kernel in Windows 95.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3255 You can enter M-f6 by typing ESC f6.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3256
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3257 *** MS-Windows 95/98/ME: subprocesses do not terminate properly.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3258
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3259 This is a limitation of the Operating System, and can cause problems
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3260 when shutting down Windows. Ensure that all subprocesses are exited
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3261 cleanly before exiting Emacs. For more details, see the FAQ at
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3262 http://www.gnu.org/software/emacs/windows/.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3263
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3264 *** MS-Windows 95/98/ME: crashes when Emacs invokes non-existent programs.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3265
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3266 When a program you are trying to run is not found on the PATH,
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3267 Windows might respond by crashing or locking up your system. In
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3268 particular, this has been reported when trying to compile a Java
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3269 program in JDEE when javac.exe is installed, but not on the system
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3270 PATH.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3271
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3272 ** MS-DOS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3273
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3274 *** When compiling with DJGPP on MS-Windows NT, "config msdos" fails.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3275
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3276 If the error message is "VDM has been already loaded", this is because
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3277 Windows has a program called `redir.exe' that is incompatible with a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3278 program by the same name supplied with DJGPP, which is used by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3279 config.bat. To resolve this, move the DJGPP's `bin' subdirectory to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3280 the front of your PATH environment variable.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3282 *** When compiling with DJGPP on MS-Windows 95, Make fails for some targets
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3283 like make-docfile.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3284
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3285 This can happen if long file name support (the setting of environment
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3286 variable LFN) when Emacs distribution was unpacked and during
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3287 compilation are not the same. See the MSDOG section of INSTALL for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3288 the explanation of how to avoid this problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3289
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3290 *** Emacs compiled with DJGPP complains at startup:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3291
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3292 "Wrong type of argument: internal-facep, msdos-menu-active-face"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3293
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3294 This can happen if you define an environment variable `TERM'. Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3295 on MSDOS uses an internal terminal emulator which is disabled if the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3296 value of `TERM' is anything but the string "internal". Emacs then
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3297 works as if its terminal were a dumb glass teletype that doesn't
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3298 support faces. To work around this, arrange for `TERM' to be
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3299 undefined when Emacs runs. The best way to do that is to add an
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3300 [emacs] section to the DJGPP.ENV file which defines an empty value for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3301 `TERM'; this way, only Emacs gets the empty value, while the rest of
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3302 your system works as before.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3303
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3304 *** MS-DOS: Emacs crashes at startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3305
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3306 Some users report that Emacs 19.29 requires dpmi memory management,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3307 and crashes on startup if the system does not have it. We don't yet
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3308 know why this happens--perhaps these machines don't have enough real
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3309 memory, or perhaps something is wrong in Emacs or the compiler.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3310 However, arranging to use dpmi support is a workaround.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3311
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3312 You can find out if you have a dpmi host by running go32 without
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3313 arguments; it will tell you if it uses dpmi memory. For more
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3314 information about dpmi memory, consult the djgpp FAQ. (djgpp
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3315 is the GNU C compiler as packaged for MSDOS.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3316
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3317 Compiling Emacs under MSDOS is extremely sensitive for proper memory
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3318 configuration. If you experience problems during compilation, consider
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3319 removing some or all memory resident programs (notably disk caches)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3320 and make sure that your memory managers are properly configured. See
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3321 the djgpp faq for configuration hints.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3322
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3323 *** Emacs compiled with DJGPP for MS-DOS/MS-Windows cannot access files
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3324 in the directory with the special name `dev' under the root of any
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3325 drive, e.g. `c:/dev'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3326
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3327 This is an unfortunate side-effect of the support for Unix-style
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3328 device names such as /dev/null in the DJGPP runtime library. A
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3329 work-around is to rename the problem directory to another name.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3330
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3331 *** MS-DOS+DJGPP: Problems on MS-DOG if DJGPP v2.0 is used to compile Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3332
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3333 There are two DJGPP library bugs which cause problems:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3334
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3335 * Running `shell-command' (or `compile', or `grep') you get
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3336 `Searching for program: permission denied (EACCES), c:/command.com';
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3337 * After you shell to DOS, Ctrl-Break kills Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3338
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3339 To work around these bugs, you can use two files in the msdos
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3340 subdirectory: `is_exec.c' and `sigaction.c'. Compile them and link
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3341 them into the Emacs executable `temacs'; then they will replace the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3342 incorrect library functions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3343
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3344 *** MS-DOS: Emacs compiled for MSDOS cannot find some Lisp files, or other
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3345 run-time support files, when long filename support is enabled.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3346
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3347 Usually, this problem will manifest itself when Emacs exits
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3348 immediately after flashing the startup screen, because it cannot find
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3349 the Lisp files it needs to load at startup. Redirect Emacs stdout
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3350 and stderr to a file to see the error message printed by Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3351
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3352 Another manifestation of this problem is that Emacs is unable to load
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3353 the support for editing program sources in languages such as C and
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3354 Lisp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3355
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3356 This can happen if the Emacs distribution was unzipped without LFN
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3357 support, thus causing long filenames to be truncated to the first 6
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3358 characters and a numeric tail that Windows 95 normally attaches to it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3359 You should unzip the files again with a utility that supports long
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3360 filenames (such as djtar from DJGPP or InfoZip's UnZip program
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3361 compiled with DJGPP v2). The MSDOG section of the file INSTALL
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3362 explains this issue in more detail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3363
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3364 Another possible reason for such failures is that Emacs compiled for
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3365 MSDOS is used on Windows NT, where long file names are not supported
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3366 by this version of Emacs, but the distribution was unpacked by an
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3367 unzip program that preserved the long file names instead of truncating
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3368 them to DOS 8+3 limits. To be useful on NT, the MSDOS port of Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3369 must be unzipped by a DOS utility, so that long file names are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3370 properly truncated.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3371
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3372 ** Archaic window managers and toolkits
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3373
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3374 *** OpenLook: Under OpenLook, the Emacs window disappears when you type M-q.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3375
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3376 Some versions of the Open Look window manager interpret M-q as a quit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3377 command for whatever window you are typing at. If you want to use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3378 Emacs with that window manager, you should try to configure the window
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3379 manager to use some other command. You can disable the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3380 shortcut keys entirely by adding this line to ~/.OWdefaults:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3381
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3382 OpenWindows.WindowMenuAccelerators: False
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3383
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3384 **** twm: A position you specified in .Xdefaults is ignored, using twm.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3385
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3386 twm normally ignores "program-specified" positions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3387 You can tell it to obey them with this command in your `.twmrc' file:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3388
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3389 UsePPosition "on" #allow clients to request a position
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3390
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3391 ** Bugs related to old DEC hardware
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3392
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3393 *** The Compose key on a DEC keyboard does not work as Meta key.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3394
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3395 This shell command should fix it:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3396
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3397 xmodmap -e 'keycode 0xb1 = Meta_L'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3398
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3399 *** Keyboard input gets confused after a beep when using a DECserver
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3400 as a concentrator.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3401
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3402 This problem seems to be a matter of configuring the DECserver to use
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3403 7 bit characters rather than 8 bit characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3404
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3405 * Build problems on legacy systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3406
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3407 ** BSD/386 1.0: --with-x-toolkit option configures wrong.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3408
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3409 This problem is due to bugs in the shell in version 1.0 of BSD/386.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3410 The workaround is to edit the configure file to use some other shell,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3411 such as bash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3412
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3413 ** Digital Unix 4.0: Emacs fails to build, giving error message
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3414 Invalid dimension for the charset-ID 160
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3415
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3416 This is due to a bug or an installation problem in GCC 2.8.0.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3417 Installing a more recent version of GCC fixes the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3418
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3419 ** Digital Unix 4.0: Failure in unexec while dumping emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3420
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3421 This problem manifests itself as an error message
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3422
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3423 unexec: Bad address, writing data section to ...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3424
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3425 The user suspects that this happened because his X libraries
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3426 were built for an older system version,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3427
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3428 ./configure --x-includes=/usr/include --x-libraries=/usr/shlib
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3429
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3430 made the problem go away.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3431
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3432 ** Sunos 4.1.1: there are errors compiling sysdep.c.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3433
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3434 If you get errors such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3435
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3436 "sysdep.c", line 2017: undefined structure or union
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3437 "sysdep.c", line 2017: undefined structure or union
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3438 "sysdep.c", line 2019: nodename undefined
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3439
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3440 This can result from defining LD_LIBRARY_PATH. It is very tricky
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3441 to use that environment variable with Emacs. The Emacs configure
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3442 script links many test programs with the system libraries; you must
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3443 make sure that the libraries available to configure are the same
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3444 ones available when you build Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3445
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3446 ** SunOS 4.1.1: You get this error message from GNU ld:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3447
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3448 /lib/libc.a(_Q_sub.o): Undefined symbol __Q_get_rp_rd referenced from text segment
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3449
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3450 The problem is in the Sun shared C library, not in GNU ld.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3451
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3452 The solution is to install Patch-ID# 100267-03 from Sun.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3453
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3454 ** Sunos 4.1: Undefined symbols when linking using --with-x-toolkit.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3455
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3456 If you get the undefined symbols _atowc _wcslen, _iswprint, _iswspace,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3457 _iswcntrl, _wcscpy, and _wcsncpy, then you need to add -lXwchar after
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3458 -lXaw in the command that links temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3459
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3460 This problem seems to arise only when the international language
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3461 extensions to X11R5 are installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3462
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3463 ** SunOS: Emacs gets error message from linker on Sun.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3464
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3465 If the error message says that a symbol such as `f68881_used' or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3466 `ffpa_used' or `start_float' is undefined, this probably indicates
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3467 that you have compiled some libraries, such as the X libraries,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3468 with a floating point option other than the default.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3469
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3470 It's not terribly hard to make this work with small changes in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3471 crt0.c together with linking with Fcrt1.o, Wcrt1.o or Mcrt1.o.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3472 However, the easiest approach is to build Xlib with the default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3473 floating point option: -fsoft.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3474
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3475 ** SunOS: Undefined symbols _dlopen, _dlsym and/or _dlclose.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3476
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3477 If you see undefined symbols _dlopen, _dlsym, or _dlclose when linking
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3478 with -lX11, compile and link against the file mit/util/misc/dlsym.c in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3479 the MIT X11R5 distribution. Alternatively, link temacs using shared
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3480 libraries with s/sunos4shr.h. (This doesn't work if you use the X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3481 toolkit.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3482
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3483 If you get the additional error that the linker could not find
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3484 lib_version.o, try extracting it from X11/usr/lib/X11/libvim.a in
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3485 X11R4, then use it in the link.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3486
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3487 ** SunOS4, DGUX 5.4.2: --with-x-toolkit version crashes when used with shared libraries.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3488
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3489 On some systems, including Sunos 4 and DGUX 5.4.2 and perhaps others,
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3490 unexec doesn't work properly with the shared library for the X
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3491 toolkit. You might be able to work around this by using a nonshared
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3492 libXt.a library. The real fix is to upgrade the various versions of
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3493 unexec and/or ralloc. We think this has been fixed on Sunos 4
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3494 and Solaris in version 19.29.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3495
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3496 ** HPUX 10.20: Emacs crashes during dumping on the HPPA machine.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3497
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3498 This seems to be due to a GCC bug; it is fixed in GCC 2.8.1.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3499
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3500 ** VMS: Compilation errors on VMS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3501
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3502 You will get warnings when compiling on VMS because there are
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3503 variable names longer than 32 (or whatever it is) characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3504 This is not an error. Ignore it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3505
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3506 VAX C does not support #if defined(foo). Uses of this construct
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3507 were removed, but some may have crept back in. They must be rewritten.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3508
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3509 There is a bug in the C compiler which fails to sign extend characters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3510 in conditional expressions. The bug is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3511 char c = -1, d = 1;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3512 int i;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3513
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3514 i = d ? c : d;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3515 The result is i == 255; the fix is to typecast the char in the
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3516 conditional expression as an (int). Known occurrences of such
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3517 constructs in Emacs have been fixed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3518
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3519 ** Vax C compiler bugs affecting Emacs.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3520
Dave Love <fx@gnu.org>
parents:
diff changeset
3521 You may get one of these problems compiling Emacs:
Dave Love <fx@gnu.org>
parents:
diff changeset
3522
Dave Love <fx@gnu.org>
parents:
diff changeset
3523 foo.c line nnn: compiler error: no table entry for op STASG
Dave Love <fx@gnu.org>
parents:
diff changeset
3524 foo.c: fatal error in /lib/ccom
Dave Love <fx@gnu.org>
parents:
diff changeset
3525
Dave Love <fx@gnu.org>
parents:
diff changeset
3526 These are due to bugs in the C compiler; the code is valid C.
Dave Love <fx@gnu.org>
parents:
diff changeset
3527 Unfortunately, the bugs are unpredictable: the same construct
Dave Love <fx@gnu.org>
parents:
diff changeset
3528 may compile properly or trigger one of these bugs, depending
Dave Love <fx@gnu.org>
parents:
diff changeset
3529 on what else is in the source file being compiled. Even changes
Dave Love <fx@gnu.org>
parents:
diff changeset
3530 in header files that should not affect the file being compiled
Dave Love <fx@gnu.org>
parents:
diff changeset
3531 can affect whether the bug happens. In addition, sometimes files
Dave Love <fx@gnu.org>
parents:
diff changeset
3532 that compile correctly on one machine get this bug on another machine.
Dave Love <fx@gnu.org>
parents:
diff changeset
3533
Dave Love <fx@gnu.org>
parents:
diff changeset
3534 As a result, it is hard for me to make sure this bug will not affect
Dave Love <fx@gnu.org>
parents:
diff changeset
3535 you. I have attempted to find and alter these constructs, but more
Dave Love <fx@gnu.org>
parents:
diff changeset
3536 can always appear. However, I can tell you how to deal with it if it
Dave Love <fx@gnu.org>
parents:
diff changeset
3537 should happen. The bug comes from having an indexed reference to an
Dave Love <fx@gnu.org>
parents:
diff changeset
3538 array of Lisp_Objects, as an argument in a function call:
Dave Love <fx@gnu.org>
parents:
diff changeset
3539 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3540 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3541 ... foo (5, args[i], ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3542 putting the argument into a temporary variable first, as in
Dave Love <fx@gnu.org>
parents:
diff changeset
3543 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3544 Lisp_Object tem;
Dave Love <fx@gnu.org>
parents:
diff changeset
3545 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3546 tem = args[i];
Dave Love <fx@gnu.org>
parents:
diff changeset
3547 ... foo (r, tem, ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3548 causes the problem to go away.
Dave Love <fx@gnu.org>
parents:
diff changeset
3549 The `contents' field of a Lisp vector is an array of Lisp_Objects,
Dave Love <fx@gnu.org>
parents:
diff changeset
3550 so you may see the problem happening with indexed references to that.
Dave Love <fx@gnu.org>
parents:
diff changeset
3551
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3552 ** 68000 C compiler problems
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3553
Dave Love <fx@gnu.org>
parents:
diff changeset
3554 Various 68000 compilers have different problems.
Dave Love <fx@gnu.org>
parents:
diff changeset
3555 These are some that have been observed.
Dave Love <fx@gnu.org>
parents:
diff changeset
3556
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3557 *** Using value of assignment expression on union type loses.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3558 This means that x = y = z; or foo (x = z); does not work
Dave Love <fx@gnu.org>
parents:
diff changeset
3559 if x is of type Lisp_Object.
Dave Love <fx@gnu.org>
parents:
diff changeset
3560
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3561 *** "cannot reclaim" error.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3562
Dave Love <fx@gnu.org>
parents:
diff changeset
3563 This means that an expression is too complicated. You get the correct
Dave Love <fx@gnu.org>
parents:
diff changeset
3564 line number in the error message. The code must be rewritten with
Dave Love <fx@gnu.org>
parents:
diff changeset
3565 simpler expressions.
Dave Love <fx@gnu.org>
parents:
diff changeset
3566
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3567 *** XCONS, XSTRING, etc macros produce incorrect code.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3568
Dave Love <fx@gnu.org>
parents:
diff changeset
3569 If temacs fails to run at all, this may be the cause.
Dave Love <fx@gnu.org>
parents:
diff changeset
3570 Compile this test program and look at the assembler code:
Dave Love <fx@gnu.org>
parents:
diff changeset
3571
Dave Love <fx@gnu.org>
parents:
diff changeset
3572 struct foo { char x; unsigned int y : 24; };
Dave Love <fx@gnu.org>
parents:
diff changeset
3573
Dave Love <fx@gnu.org>
parents:
diff changeset
3574 lose (arg)
Dave Love <fx@gnu.org>
parents:
diff changeset
3575 struct foo arg;
Dave Love <fx@gnu.org>
parents:
diff changeset
3576 {
Dave Love <fx@gnu.org>
parents:
diff changeset
3577 test ((int *) arg.y);
Dave Love <fx@gnu.org>
parents:
diff changeset
3578 }
Dave Love <fx@gnu.org>
parents:
diff changeset
3579
Dave Love <fx@gnu.org>
parents:
diff changeset
3580 If the code is incorrect, your compiler has this problem.
Dave Love <fx@gnu.org>
parents:
diff changeset
3581 In the XCONS, etc., macros in lisp.h you must replace (a).u.val with
Dave Love <fx@gnu.org>
parents:
diff changeset
3582 ((a).u.val + coercedummy) where coercedummy is declared as int.
Dave Love <fx@gnu.org>
parents:
diff changeset
3583
Dave Love <fx@gnu.org>
parents:
diff changeset
3584 This problem will not happen if the m-...h file for your type
Dave Love <fx@gnu.org>
parents:
diff changeset
3585 of machine defines NO_UNION_TYPE. That is the recommended setting now.
Dave Love <fx@gnu.org>
parents:
diff changeset
3586
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3587 *** C compilers lose on returning unions.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3588
Dave Love <fx@gnu.org>
parents:
diff changeset
3589 I hear that some C compilers cannot handle returning a union type.
Dave Love <fx@gnu.org>
parents:
diff changeset
3590 Most of the functions in GNU Emacs return type Lisp_Object, which is
Dave Love <fx@gnu.org>
parents:
diff changeset
3591 defined as a union on some rare architectures.
Dave Love <fx@gnu.org>
parents:
diff changeset
3592
Dave Love <fx@gnu.org>
parents:
diff changeset
3593 This problem will not happen if the m-...h file for your type
Dave Love <fx@gnu.org>
parents:
diff changeset
3594 of machine defines NO_UNION_TYPE.
Dave Love <fx@gnu.org>
parents:
diff changeset
3595
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3596
65088
f05a048483cc Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64489
diff changeset
3597 Copyright 1987, 1988, 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
f05a048483cc Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64489
diff changeset
3598 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
48174
ca63c953d54b Add copyright notice and permission notice.
Richard M. Stallman <rms@gnu.org>
parents: 47995
diff changeset
3599
ca63c953d54b Add copyright notice and permission notice.
Richard M. Stallman <rms@gnu.org>
parents: 47995
diff changeset
3600 Copying and redistribution of this file with or without modification
ca63c953d54b Add copyright notice and permission notice.
Richard M. Stallman <rms@gnu.org>
parents: 47995
diff changeset
3601 are permitted without royalty provided this notice is preserved.
ca63c953d54b Add copyright notice and permission notice.
Richard M. Stallman <rms@gnu.org>
parents: 47995
diff changeset
3602
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3603 Local variables:
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3604 mode: outline
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3605 paragraph-separate: "[ ]*$"
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3606 end:
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3607
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3608 arch-tag: 49fc0d95-88cb-4715-b21c-f27fb5a4764a