annotate etc/PROBLEMS @ 76044:bedbe56c20fc

(widget-default-create): Undo 2007-02-04 change. (editable-field): Document need to put some text before the %v escape in :format string.
author Kim F. Storm <storm@cua.dk>
date Thu, 22 Feb 2007 00:32:51 +0000
parents dc23aaa67696
children 0042363314f0 52a7f3f50b89
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
1 Copyright (C) 1987, 1988, 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
2 2001, 2002, 2003, 2004, 2005, 2006, 2007
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3 Free Software Foundation, Inc.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
4 See the end of the file for license conditions.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
5
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
6
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
7 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
8 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
9 and browsing through the outline headers.
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 * Emacs startup failures
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 ** 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
14
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
15 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
16
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
17 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
18
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
19 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
20 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
21 are:
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 - in your ~/.Xdefaults file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
24
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
25 - 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
26 /usr/X11R6/lib/app-defaults/Emacs or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
27 /usr/X11R6/lib/X11/app-defaults/Emacs
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 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
30 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
31 the problematic line(s) and correct them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
32
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
33 ** 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
34
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
35 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
36 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
37 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
38 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
39 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
40 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
41 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
42 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
43 not to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
44
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
45 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
46 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
47 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
48 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
49
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
50 ** 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
51
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
52 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
53 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
54 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
55 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
56 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
57 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
58
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
59 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
60 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
61 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
62 it constitutes a separate package.
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 ** 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
65
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
66 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
67
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
68 "Cannot open load file: fontset"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
69
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
70 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
71 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
72 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
73 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
74 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
75 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
76 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
77
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
78 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
79 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
80
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
81 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
82 file.
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 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
85 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
86 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
87
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
88 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
89
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
90 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
91 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
92 load-path.
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 ** 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
95
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
96 An example of such an error is:
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 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
99
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
100 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
101 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
102 present in 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 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
105
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
106 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
107 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
108 load-path.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
109
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
110 ** 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
111
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
112 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
113
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
114 --- 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
115 +++ 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
116 @@ -1,4 +1,4 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
117 -/* $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
118 +/* $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
119 /******************************************************************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
120
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
121 Copyright 1992, 1993, 1994 by FUJITSU LIMITED
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
122 @@ -166,8 +166,8 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
123 _XimMakeImName(lcd)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
124 XLCd lcd;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
125 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
126 - char* begin;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
127 - char* end;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
128 + char* begin = NULL;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
129 + char* end = NULL;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
130 char* ret;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
131 int i = 0;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
132 char* ximmodifier = XIMMODIFIER;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
133 @@ -182,7 +182,11 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
134 }
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
135 ret = Xmalloc(end - begin + 2);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
136 if (ret != NULL) {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
137 - (void)strncpy(ret, begin, end - begin + 1);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
138 + if (begin != NULL) {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
139 + (void)strncpy(ret, begin, end - begin + 1);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
140 + } else {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
141 + ret[0] = '\0';
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 ret[end - begin + 1] = '\0';
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 return ret;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
146
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
147 * Crash bugs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
148
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
149 ** Emacs crashes in x-popup-dialog.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
150
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
151 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
152 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
153 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
154 happens to exist on your X server).
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 ** Emacs crashes when you use Bibtex mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
157
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
158 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
159 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
160 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
161
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
162 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
163 (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
164
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
165 ** 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
166 a segmentation fault and core dump.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
167
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
168 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
169 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
170
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
171 x FILENAME, N bytes, B tape blocks
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
172
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
173 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
174 untar it :-).
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 ** 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
177 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
178 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
179 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
180 older version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
181
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
182 ** Emacs aborts inside the function `tparam1'.
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 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
185 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
186 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
187 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
188 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
189
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
190 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
191 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
192 terminfo when built.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
193
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
194 ** 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
195
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
196 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
197 reported to prevent the crashes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
198
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
199 ** Emacs crashes with SIGSEGV in XtInitializeWidgetClass.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
200
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
201 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
202
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
203 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
204 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
205 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
206 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
207
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
208 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
209 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
210
72780
de11751400bd Add "Emacs compiled with Gtk+ crashes when closing a display (x-close-connection)."
Jan Djärv <jan.h.d@swipnet.se>
parents: 71902
diff changeset
211 ** Emacs compiled with Gtk+ crashes when closing a display (x-close-connection).
de11751400bd Add "Emacs compiled with Gtk+ crashes when closing a display (x-close-connection)."
Jan Djärv <jan.h.d@swipnet.se>
parents: 71902
diff changeset
212
de11751400bd Add "Emacs compiled with Gtk+ crashes when closing a display (x-close-connection)."
Jan Djärv <jan.h.d@swipnet.se>
parents: 71902
diff changeset
213 This happens because of bugs in Gtk+. Gtk+ 2.10 seems to be OK. See bug
de11751400bd Add "Emacs compiled with Gtk+ crashes when closing a display (x-close-connection)."
Jan Djärv <jan.h.d@swipnet.se>
parents: 71902
diff changeset
214 http://bugzilla.gnome.org/show_bug.cgi?id=85715.
de11751400bd Add "Emacs compiled with Gtk+ crashes when closing a display (x-close-connection)."
Jan Djärv <jan.h.d@swipnet.se>
parents: 71902
diff changeset
215
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
216 * General runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
217
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
218 ** Lisp problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
219
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
220 *** 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
221
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
222 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
223 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
224 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
225 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
226
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
227 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
228 than the corresponding .el file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
229
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
230 *** 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
231
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
232 These control the actions of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
233 ~/.emacs is your Emacs init file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
234 EMACSLOADPATH overrides which directories the function
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
235 "load" will search.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
236
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
237 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
238 of them, then try again.
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 *** 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
241
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
242 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
243
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
244 "Lisp nesting exceeds max-lisp-eval-depth"
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 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
247 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
248 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
249 corrects that.
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 *** 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
252
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
253 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
254 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
255 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
256
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
257 *** 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
258 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
259 `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
260 '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
261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
262 ** Keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
264 *** "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
265
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
266 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
267 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
268 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
269 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
270 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
271 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
272
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
273 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
274 them to two different keys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
275
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
276 *** 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
277
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
278 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
279 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
280 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
281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
282 *** 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
283 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
284
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
285 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
286 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
287 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
288
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
289 set escape-character 17
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
290
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
291 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
292
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
293 ** Mailers and other helper programs
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 *** 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
296
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
297 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
298 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
299 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
300 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
301 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
302 old POP protocol.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
303
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
304 *** RMAIL gets error getting new mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
305
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
306 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
307 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
308 the protocol defined by /bin/mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
309
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
310 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
311 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
312 `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
313 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
314 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
315 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
316 SYSTEM, YOU CAN LOSE MAIL!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
317
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
318 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
319 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
320 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
321 `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
322
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
323 chgrp mail movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
324 chmod 2755 movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
325
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
326 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
327 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
328 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
329 `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
330 make install.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
331
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
332 chgrp mail movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
333 chmod 2755 movemail
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
334
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
335 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
336 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
337 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
338 /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
339 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
340 directory copy is ineffective.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
341
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
342 *** 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
343
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
344 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
345 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
346
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
347 ** Problems with hostname resolution
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
348
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
349 *** 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
350 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
351 *** 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
352 *** 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
353
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
354 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
355 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
356 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
357 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
358
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
359 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
360 the nameserver, but Emacs does not.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
361
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
362 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
363 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
364
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
365 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
366
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
367 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
368 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
369 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
370 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
371 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
372 be careful not to lose the others.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
373
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
374 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
375
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
376 #define LIBS_SYSTEM -lresolv
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
377
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
378 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
379 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
380 again to say this:
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 #define LIBS_SYSTEM -lresolv -lfoo -lbar
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 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
385
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
386 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
387 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
388 calls for specifying this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
389
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
390 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
391 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
392
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
393 ** NFS and RFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
394
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
395 *** 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
396 appear on disk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
397
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
398 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
399 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
400 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
401 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
402 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
403 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
404
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
405 *** 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
406 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
407 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
408 causes it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
409
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
410 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
411 call in the RFS server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
412
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
413 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
414 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
415 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
416 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
417
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
418 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
419
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
420 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
421 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
422 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
423 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
424 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
425 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
426 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
427
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
428 (as always, your line numbers may vary)
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 % rcsdiff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
431 RCS file: RCS/serversyscall.c,v
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
432 retrieving revision 1.2
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
433 diff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
434 *** /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
435 --- 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
436 ***************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
437 *** 163,169 ****
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
438 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
439 * No return sent for close or fsync!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
440 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
441 ! if (syscall == RSYS_close || syscall == RSYS_fsync)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
442 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
443 else
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 --- 166,172 ----
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
446 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
447 * No return sent for close or fsync!
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 ! if (syscall == RSYS_close)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
450 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
451 else
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
452 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
453
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
454 ** PSGML
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
455
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
456 *** 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
457 `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
458 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
459
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
460 *** PSGML conflicts with sgml-mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
461
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
462 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
463 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
464 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
465 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
466 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
467 (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
468 (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
469
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
470 *** 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
471 (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
472 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
473 earlier versions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
474
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
475 --- 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
476 +++ 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
477 @@ -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
478 (setq sgml-buffer-parse-state nil))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
479 (cond
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
480 ((stringp entity) ; a file name
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
481 - (save-excursion (insert-file-contents entity))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
482 + (insert-file-contents entity)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
483 (setq default-directory (file-name-directory entity)))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
484 ((consp (sgml-entity-text entity)) ; external id?
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
485 (let* ((extid (sgml-entity-text entity))
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
486
56754
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
487 ** AUCTeX
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
488
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
489 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
490 it.
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
491
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
492 *** Emacs 21 freezes when visiting a TeX file with AUCTeX installed.
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
493
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
494 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
495 these problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
496
56754
5ea587a67aae Update AUCTeX information.
David Kastrup <dak@gnu.org>
parents: 56734
diff changeset
497 *** 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
498
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
499 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
500 byte-compiled with Emacs 21.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
501
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
502 ** 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
503
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 *** 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
505
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
506 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
507 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
508 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
509 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
510 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
511 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
512
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
513 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
514 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
515
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
516 ** Miscellaneous problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
517
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
518 *** Self-documentation messages are garbled.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
519
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
520 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
521 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
522 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
523
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
524 *** 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
525 terminal type.
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 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
528 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
529 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
530 emulates.
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 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
533 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
534 it only if it is undefined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
535
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
536 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
537
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
538 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
539 happen in a non-login shell.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
540
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
541 *** 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
542
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
543 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
544 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
545 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
546 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
547
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
548 if ($?EMACS) then
72833
81a55a7dc3c3 * etc/NEWS: In terminal-oriented subshells, the EMACS environment
Paul Eggert <eggert@twinsun.com>
parents: 72780
diff changeset
549 if ("$EMACS" =~ /*) then
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
550 unset edit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
551 stty -icrnl -onlcr -echo susp ^Z
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
552 endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
553 endif
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 *** 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
556
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
557 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
558 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
559 /etc/hosts file, something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
560
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
561 127.0.0.1 localhost
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
562 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
563
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
564 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
565
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
566 *** 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
567
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
568 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
569 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
570 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
571 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
572 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
573 ftp client. On a Debian system, type
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 update-alternatives --config ftp
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 and then choose /usr/bin/netkit-ftp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
578
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
579 *** JPEG images aren't displayed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
580
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
581 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
582 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
583 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
584 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
585
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
586 *** Dired is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
587
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
588 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
589 time. Possible reasons for this include:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
590
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
591 - 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
592 response time extremely slow (dozens of seconds);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
593
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
594 - 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
595
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
596 - slow operation of some versions of `df'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
597
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
598 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
599 `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
600 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
601 (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
602
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
603 *** 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
604 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
605
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
606 *** 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
607
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
608 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
609 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
610 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
611 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
612
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
613 *** 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
614
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
615 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
616 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
617 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
618
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
619 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
620
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
621 *** 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
622 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
623 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
624 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
625 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
626
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
627 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
628 process invokes Emacs several times.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
629
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
630 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
631 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
632 can be found.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
633
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
634 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
635 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
636 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
637
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
638 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
639 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
640 backtraces like this:
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 (dbx) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
643 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
644 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
645 ["/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
646 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
647 ["/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
648 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
649 ["/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
650 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
651 ["/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
652
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
653 (`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
654 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
655 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
656 to work around the problem.
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 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
659
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
660 *** 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
661 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
662
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
663 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
664 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
665 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
666
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
667 *** 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
668
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
669 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
670 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
671 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
672 support for 8-bit characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
673
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
674 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
675 this at your shell's prompt:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
676
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
677 ispell -vv
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 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
680 "!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
681 does not.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
682
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
683 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
684 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
685 Then rebuild the speller.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
686
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
687 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
688 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
689
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
690 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
691 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
692 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
693 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
694 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
695
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
696 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
697 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
698 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
699 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
700
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
701 * Runtime problems related to font handling
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
702
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
703 ** 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
704
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
705 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
706 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
707 many different fonts, collected into a fontset.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
708
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
709 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
710 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
711 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
712
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
713 The intlfonts distribution includes a full spectrum of fonts that can
71541
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
714 display all the characters Emacs supports. The etl-unicode collection
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
715 of fonts (available from <URL:ftp://ftp.x.org/contrib/fonts/> and
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
716 <URL:ftp://ftp.xfree86.org/pub/mirror/X.Org/contrib/fonts/>) includes
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
717 fonts that can display many Unicode characters; they can also be used
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
718 by ps-print and ps-mule to print Unicode characters.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
720 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
721 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
722 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
723 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
724 of this character to display a space.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
725
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
726 ** 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
727
71541
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
728 You may have bad X11 fonts; try installing the intlfonts distribution
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
729 or the etl-unicode collection (see the previous entry).
56734
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 ** 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
732
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
733 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
734 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
735 lines do not overlap.
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 ** Loading fonts is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
738
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
739 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
740 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
741 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
742 "fonts.scale".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
743
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
744 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
745 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
746
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
747 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
748 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
749 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
750
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
751 ** 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
752
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
753 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
754 `{' 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
755 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
756 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
757 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
758 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
759 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
760 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
761 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
762 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
763
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
764 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
765 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
766 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
767 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
768
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
769 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
770 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
771 fontification by setting the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
772 `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
773 be done _after_ turning on Font Lock.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
774
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
775 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
776 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
777
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
778 ** 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
779 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
780
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
781 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
782 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
783 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
784
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
785 ** 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
786
2f5fd6b2684b * PROBLEMS: Characters are displayed as empty boxes or
Jan Djärv <jan.h.d@swipnet.se>
parents: 52494
diff changeset
787 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
788 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
789 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
790 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
791 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
792 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
793 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
794 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
795 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
796 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
797 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
798
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
799 ** 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
800
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
801 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
802 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
803 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
804 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
805
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
806 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
807
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
808 emacs.waitForWM: false
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
809
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
810 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
811 frame's parameter list, like this:
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 (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
814
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
815 (this should go into your `.emacs' file).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
816
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
817 ** Underlines appear at the wrong position.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
818
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
819 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
820 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
821 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
822 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
823 `.emacs'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
824
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
825 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
826 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
827 property.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
828
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
829 ** 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
830
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
831 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
832 (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
833 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
834 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
835 gives the appearance of "double spacing".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
836
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
837 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
838 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
839
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
840 * Internationalization problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
841
73155
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
842 ** M-{ does not work on a Spanish PC keyboard.
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
843
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
844 Many Spanish keyboards seem to ignore that combination. Emacs can't
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
845 do anything about it.
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
846
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
847 ** 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
848
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
849 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
850 minimal character repertoires (whereas the encoding part of the font
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
851 name is meant to be a reasonable indication of the repertoire
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
852 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
853 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
854 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
855 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
856 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
857 include in the fontset spec:
47994
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
858
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
859 mule-unicode-2500-33ff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
860 mule-unicode-e000-ffff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
861 mule-unicode-0100-24ff:-gnu-unifont-*-iso10646-1
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
862
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
863 ** 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
864
65518
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
865 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
866 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
867 CJK characters belonging to these legacy charsets:
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
868
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
869 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
870
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
871 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
872 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
873 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
874 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
875
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
876 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
877 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
878 (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
879 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
880 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
881 substituted with the Unicode `replacement character', and you lose
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
882 information.
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
883
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
884 ** Mule-UCS loads very slowly.
46677
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
885
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
886 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
887 library, which is the usual interface to Mule-UCS. Apply the
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
888 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
889 though loading will still be slower than in Emacs 20. (Some
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
890 distributions, such as Debian, may already have applied such a patch.)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
891
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
892 --- 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
893 +++ lisp/un-define.el 19 Apr 2002 18:34:26 -0000
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
894 @@ -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
895
46677
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
896 (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
897 (lambda (x)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
898 - (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
899 - (lambda (y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
900 - (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
901 - (nth 0 y) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
902 - (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
903 - (coding-system-put (car y) 'alias-coding-systems (list (car x))))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
904 - (cdr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
905 + (if (fboundp 'register-char-codings)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
906 + ;; 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
907 + ;; register-char-codings may be very slow for these coding
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
908 + ;; system definitions.
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
909 + (let ((y (cadr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
910 + (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
911 + (car x) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
912 + (nth 3 y) (nth 4 y) (nth 5 y)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
913 + (mapcar
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
914 + (lambda (y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
915 + (mucs-define-coding-system
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
916 + (nth 0 y) (nth 1 y) (nth 2 y)
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
917 + (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
918 + (coding-system-put (car y) 'alias-coding-systems (list (car x)))))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
919 + (cdr x)))
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
920 `((utf-8
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
921 (utf-8-unix
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
922 ?u "UTF-8 coding system"
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
923
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
924 Note that Emacs has native support for Unicode, roughly equivalent to
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
925 Mule-UCS's, so you may not need it.
86e8d59e2e49 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 46658
diff changeset
926
65362
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
927 ** 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
928
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
929 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
930 ...)' 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
931 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
932 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
933 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
934
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
935 --- 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
936 +++ 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
937 @@ -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
938 (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
939 (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
940 ; (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
941 - `(progn
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
942 - (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
943 - (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
944 - ,@result)))
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
945 + ;; 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
946 + ;; 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
947 + ;; return (possibly empty) *list* of forms. Do this. Do not rely
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
948 + ;; on byte compiler to remove extra `progn's in `(progn ...)'
65362
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
949 + ;; form.
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
950 + `((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
951 + (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
952 + ,@result)))
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
953
65362
601c1d04dcb1 Show a patch for Mule-UCS to make it byte-compiled
Kenichi Handa <handa@m17n.org>
parents: 65134
diff changeset
954 ;;; 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
955 (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
956
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
957 ** 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
958
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
959 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
960 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
961 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
962 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
963 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
964 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
965
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
966 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
967
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
968 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
969
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
970 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
971 problem.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
972
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
973 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
974 `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
975 `xset fp rehash'.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
976
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
977 ** 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
978
36813
fcca57f520e5 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 36550
diff changeset
979 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
980 slots now. The current built-in Unicode support is actually more
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
981 flexible. (Use option `utf-translate-cjk-mode' if you need CJK
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
982 support.) Files encoded as emacs-mule using oc-unicode aren't
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
983 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
984
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
985 ** After a while, Emacs slips into unibyte mode.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
986
Dave Love <fx@gnu.org>
parents:
diff changeset
987 The VM mail package, which is not part of Emacs, sometimes does
Dave Love <fx@gnu.org>
parents:
diff changeset
988 (standard-display-european t)
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
989 That should be changed to
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
990 (standard-display-european 1 t)
Dave Love <fx@gnu.org>
parents:
diff changeset
991
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
992 * X runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
993
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
994 ** X keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
995
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
996 *** You "lose characters" after typing Compose Character key.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
997
Dave Love <fx@gnu.org>
parents:
diff changeset
998 This is because the Compose Character key is defined as the keysym
Dave Love <fx@gnu.org>
parents:
diff changeset
999 Multi_key, and Emacs (seeing that) does the proper X11
Dave Love <fx@gnu.org>
parents:
diff changeset
1000 character-composition processing. If you don't want your Compose key
Dave Love <fx@gnu.org>
parents:
diff changeset
1001 to do that, you can redefine it with xmodmap.
Dave Love <fx@gnu.org>
parents:
diff changeset
1002
Dave Love <fx@gnu.org>
parents:
diff changeset
1003 For example, here's one way to turn it into a Meta key:
Dave Love <fx@gnu.org>
parents:
diff changeset
1004
Dave Love <fx@gnu.org>
parents:
diff changeset
1005 xmodmap -e "keysym Multi_key = Meta_L"
Dave Love <fx@gnu.org>
parents:
diff changeset
1006
Dave Love <fx@gnu.org>
parents:
diff changeset
1007 If all users at your site of a particular keyboard prefer Meta to
Dave Love <fx@gnu.org>
parents:
diff changeset
1008 Compose, you can make the remapping happen automatically by adding the
Dave Love <fx@gnu.org>
parents:
diff changeset
1009 xmodmap command to the xdm setup script for that display.
Dave Love <fx@gnu.org>
parents:
diff changeset
1010
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1011 *** 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
1012
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1013 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
1014
69953
6a69cc2e7e0c (C-SPC fails ...): Explicitly say fcitx in the header.
Kenichi Handa <handa@m17n.org>
parents: 69926
diff changeset
1015 *** C-SPC fails to work on Fedora GNU/Linux (or with fcitx input method).
63756
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1016
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1017 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
1018 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
1019 from using the C-SPC key for `set-mark-command'.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1020
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1021 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
1022 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
1023 However, that requires root access.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1024
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1025 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
1026
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
1027 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
1028
69926
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1029 The same problem happens on any other system if you are using fcitx
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1030 (Chinese input method) which by default use C-SPC for toggling. If
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1031 you want to use fcitx with Emacs, you have two choices. Toggle fcitx
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1032 by another key (e.g. C-\) by modifying ~/.fcitx/config, or be
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1033 accustomed to use C-@ for `set-mark-command'.
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
1034
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1035 *** 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
1036
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1037 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
1038 for character composition.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1039
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1040 *** 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
1041
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1042 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
1043 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
1044 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
1045 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
1046 purposes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1047
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1048 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
1049 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
1050
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1051 *** 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
1052
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1053 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
1054 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
1055 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
1056 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
1057 change this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1058
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1059 *** 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
1060
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1061 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
1062 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
1063 --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
1064
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1065 *** Inability to send an Alt-modified key, when Emacs is communicating
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1066 directly with an X server.
Dave Love <fx@gnu.org>
parents:
diff changeset
1067
Dave Love <fx@gnu.org>
parents:
diff changeset
1068 If you have tried to bind an Alt-modified key as a command, and it
Dave Love <fx@gnu.org>
parents:
diff changeset
1069 does not work to type the command, the first thing you should check is
Dave Love <fx@gnu.org>
parents:
diff changeset
1070 whether the key is getting through to Emacs. To do this, type C-h c
Dave Love <fx@gnu.org>
parents:
diff changeset
1071 followed by the Alt-modified key. C-h c should say what kind of event
Dave Love <fx@gnu.org>
parents:
diff changeset
1072 it read. If it says it read an Alt-modified key, then make sure you
Dave Love <fx@gnu.org>
parents:
diff changeset
1073 have made the key binding correctly.
Dave Love <fx@gnu.org>
parents:
diff changeset
1074
Dave Love <fx@gnu.org>
parents:
diff changeset
1075 If C-h c reports an event that doesn't have the Alt modifier, it may
Dave Love <fx@gnu.org>
parents:
diff changeset
1076 be because your X server has no key for the Alt modifier. The X
Dave Love <fx@gnu.org>
parents:
diff changeset
1077 server that comes from MIT does not set up the Alt modifier by
Dave Love <fx@gnu.org>
parents:
diff changeset
1078 default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1079
Dave Love <fx@gnu.org>
parents:
diff changeset
1080 If your keyboard has keys named Alt, you can enable them as follows:
Dave Love <fx@gnu.org>
parents:
diff changeset
1081
Dave Love <fx@gnu.org>
parents:
diff changeset
1082 xmodmap -e 'add mod2 = Alt_L'
Dave Love <fx@gnu.org>
parents:
diff changeset
1083 xmodmap -e 'add mod2 = Alt_R'
Dave Love <fx@gnu.org>
parents:
diff changeset
1084
Dave Love <fx@gnu.org>
parents:
diff changeset
1085 If the keyboard has just one key named Alt, then only one of those
Dave Love <fx@gnu.org>
parents:
diff changeset
1086 commands is needed. The modifier `mod2' is a reasonable choice if you
Dave Love <fx@gnu.org>
parents:
diff changeset
1087 are using an unmodified MIT version of X. Otherwise, choose any
Dave Love <fx@gnu.org>
parents:
diff changeset
1088 modifier bit not otherwise used.
Dave Love <fx@gnu.org>
parents:
diff changeset
1089
Dave Love <fx@gnu.org>
parents:
diff changeset
1090 If your keyboard does not have keys named Alt, you can use some other
Dave Love <fx@gnu.org>
parents:
diff changeset
1091 keys. Use the keysym command in xmodmap to turn a function key (or
Dave Love <fx@gnu.org>
parents:
diff changeset
1092 some other 'spare' key) into Alt_L or into Alt_R, and then use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1093 commands show above to make them modifier keys.
Dave Love <fx@gnu.org>
parents:
diff changeset
1094
Dave Love <fx@gnu.org>
parents:
diff changeset
1095 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
Dave Love <fx@gnu.org>
parents:
diff changeset
1096 into Meta. This is because of the great importance of Meta in Emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
1097
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1098 ** Window-manager and toolkit-related problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1099
73196
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1100 *** Gnome: Emacs receives input directly from the keyboard, bypassing XIM.
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1101
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1102 This seems to happen when gnome-settings-daemon version 2.12 or later
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1103 is running. If gnome-settings-daemon is not running, Emacs receives
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1104 input through XIM without any problem. Furthermore, this seems only
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1105 to happen in *.UTF-8 locales; zh_CN.GB2312 and zh_CN.GBK locales, for
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1106 example, work fine. A bug report has been filed in the Gnome
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1107 bugzilla: http://bugzilla.gnome.org/show_bug.cgi?id=357032
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1108
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1109 *** 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
1110
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1111 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
1112 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
1113 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
1114 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
1115 been filed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1116
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1117 *** 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
1118 or messed up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1119
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1120 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
1121 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
1122 background.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1123
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1124 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
1125 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
1126 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
1127 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
1128 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
1129
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1130 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
1131 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
1132 (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
1133 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
1134 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
1135 present or commented out:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1136
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1137 Emacs.default.attributeForeground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1138 Emacs.default.attributeBackground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1139 Emacs*Foreground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1140 Emacs*Background
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 *** 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
1143
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1144 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
1145 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
1146 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
1147 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
1148 while, Emacs may print a message:
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1149
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1150 Timed out waiting for property-notify event
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1151
58825
a1e4505728bf * PROBLEMS: Update information about klipper on KDE.
Jan Djärv <jan.h.d@swipnet.se>
parents: 57229
diff changeset
1152 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
1153 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
1154
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1155 *** 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
1156
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1157 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
1158 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
1159 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
1160 and uncheck "Allow Primary Windows On Top".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1161
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1162 *** 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
1163 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
1164 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
1165 problem disappears.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1166
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1167 *** 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
1168 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
1169 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
1170 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
1171 "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
1172 used with neXtaw at run time.
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 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
1175 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
1176 built Emacs with.
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 *** 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
1179
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1180 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
1181 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
1182 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
1183 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
1184
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1185 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
1186 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
1187
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1188 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
1189 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
1190 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
1191
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1192 *** LessTif: Problems in Emacs built with LessTif.
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 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
1195 emulation for which it is set up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1197 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
1198 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
1199 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
1200 --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
1201 successful. The binary GNU/Linux package
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1202 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
1203 menu placement.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1204
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1205 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
1206 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
1207 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
1208 developers.
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 *** 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
1211
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1212 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
1213
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1214 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
1215
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1216 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
1217 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
1218 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
1219 the resource prevents the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1220
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1221 ** General X problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1222
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1223 *** 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
1224
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1225 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
1226 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
1227 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
1228 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
1229
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1230 Here's how to do this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1231
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1232 (set-scroll-bar-mode 'right)
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 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
1235 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
1236 to normal, do
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1237
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1238 (set-scroll-bar-mode 'left)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1239
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1240 *** Error messages about undefined colors on X.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1241
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1242 The messages might say something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1243
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1244 Unable to load color "grey95"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1245
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1246 (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
1247
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1248 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
1249
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1250 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
1251 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
1252 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
1253
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1254 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
1255
69398
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1256 "undefined color" messages can also occur if the RgbPath entry in the
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1257 X configuration file is incorrect, or the rgb.txt file is not where
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1258 X expects to find it.
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1259
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1260 *** Improving performance with slow X connections.
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 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
1263 be carried out at the same time:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1264
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1265 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
1266 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
1267 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
1268 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
1269 package.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1270
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1271 2) If the connection is very slow, you might also want to consider
75433
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1272 switching off scroll bars, menu bar, and tool bar. Adding the
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1273 following forms to your .emacs file will accomplish that, but only
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1274 after the the initial frame is displayed:
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1275
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1276 (scroll-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1277 (menu-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1278 (tool-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1279
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1280 For still quicker startup, put these X resources in your .Xdefaults
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1281 file:
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1282
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1283 Emacs.verticalScrollBars: off
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1284 Emacs.menuBar: off
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1285 Emacs.toolBar: off
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1286
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1287 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
1288 forwarded X connection (ssh -XC remotehostname emacs ...).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1289
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1290 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
1291 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
1292 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
1293 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
1294 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
1295 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
1296 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
1297 -noatomsfile -nowinattr -cheaterrors -cheatevents
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1298 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
1299 For more about lbxproxy, see:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1300 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
1301
73631
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1302 5) If copying and killing is slow, try to disable the interaction with the
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1303 native system's clipboard by adding these lines to your .emacs file:
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1304 (setq interprogram-cut-function nil)
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1305 (setq interprogram-paste-function nil)
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1306
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1307 *** 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
1308
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1309 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
1310 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
1311 likely to cause it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1312
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1313 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
1314
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1315 *** 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
1316
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1317 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
1318 that replacing the mouse made it stop.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1319
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1320 *** 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
1321
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1322 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
1323 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
1324 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
1325 the Files menu).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1326
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1327 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
1328 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
1329 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
1330 workaround can be found.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1331
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1332 *** 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
1333 parameter attributes) on protocol request 93'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1334
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1335 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
1336 emacs*Cursor: black
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1337 (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
1338 that isn't a color.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1339
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1340 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
1341
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1342 *** Slow startup on X11R6 with X windows.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1343
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1344 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
1345 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
1346 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
1347 font.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1348
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1349 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
1350 your font path, like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1351
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1352 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
1353
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1354 *** 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
1355
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1356 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
1357
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1358 Emacs*geometry: 80x55+0+0
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1359
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1360 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
1361 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
1362 want, rewrite the resource.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1363
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1364 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
1365 -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
1366 the user's ~/.Xdefaults and ~/.Xdefaults-* files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1367
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1368 *** 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
1369 *** `emacs -geometry 80x20' finds a file named `80x20'.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1370
Dave Love <fx@gnu.org>
parents:
diff changeset
1371 One cause of such problems is having (setq term-file-prefix nil) in
Dave Love <fx@gnu.org>
parents:
diff changeset
1372 your .emacs file. Another cause is a bad value of EMACSLOADPATH in
Dave Love <fx@gnu.org>
parents:
diff changeset
1373 the environment.
Dave Love <fx@gnu.org>
parents:
diff changeset
1374
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1375 *** Emacs fails to get default settings from X Windows server.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1376
Dave Love <fx@gnu.org>
parents:
diff changeset
1377 The X library in X11R4 has a bug; it interchanges the 2nd and 3rd
Dave Love <fx@gnu.org>
parents:
diff changeset
1378 arguments to XGetDefaults. Define the macro XBACKWARDS in config.h to
Dave Love <fx@gnu.org>
parents:
diff changeset
1379 tell Emacs to compensate for this.
Dave Love <fx@gnu.org>
parents:
diff changeset
1380
Dave Love <fx@gnu.org>
parents:
diff changeset
1381 I don't believe there is any way Emacs can determine for itself
Dave Love <fx@gnu.org>
parents:
diff changeset
1382 whether this problem is present on a given system.
Dave Love <fx@gnu.org>
parents:
diff changeset
1383
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1384 *** X Windows doesn't work if DISPLAY uses a hostname.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1385
Dave Love <fx@gnu.org>
parents:
diff changeset
1386 People have reported kernel bugs in certain systems that cause Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1387 not to work with X Windows if DISPLAY is set using a host name. But
Dave Love <fx@gnu.org>
parents:
diff changeset
1388 the problem does not occur if DISPLAY is set to `unix:0.0'. I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1389 the bug has to do with SIGIO or FIONREAD.
Dave Love <fx@gnu.org>
parents:
diff changeset
1390
Dave Love <fx@gnu.org>
parents:
diff changeset
1391 You may be able to compensate for the bug by doing (set-input-mode nil nil).
Dave Love <fx@gnu.org>
parents:
diff changeset
1392 However, that has the disadvantage of turning off interrupts, so that
Dave Love <fx@gnu.org>
parents:
diff changeset
1393 you are unable to quit out of a Lisp program by typing C-g.
Dave Love <fx@gnu.org>
parents:
diff changeset
1394
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
1395 The easy way to do this is to put
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1396
Dave Love <fx@gnu.org>
parents:
diff changeset
1397 (setq x-sigio-bug t)
Dave Love <fx@gnu.org>
parents:
diff changeset
1398
Dave Love <fx@gnu.org>
parents:
diff changeset
1399 in your site-init.el file.
Dave Love <fx@gnu.org>
parents:
diff changeset
1400
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1401 * Runtime problems on character termunals
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1402
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1403 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1404
Dave Love <fx@gnu.org>
parents:
diff changeset
1405 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being
Dave Love <fx@gnu.org>
parents:
diff changeset
1406 used. C-s/C-q flow control is bad for Emacs editors because it takes
Dave Love <fx@gnu.org>
parents:
diff changeset
1407 away C-s and C-q as user commands. Since editors do not output long
Dave Love <fx@gnu.org>
parents:
diff changeset
1408 streams of text without user commands, there is no need for a
Dave Love <fx@gnu.org>
parents:
diff changeset
1409 user-issuable "stop output" command in an editor; therefore, a
Dave Love <fx@gnu.org>
parents:
diff changeset
1410 properly designed flow control mechanism would transmit all possible
Dave Love <fx@gnu.org>
parents:
diff changeset
1411 input characters without interference. Designing such a mechanism is
Dave Love <fx@gnu.org>
parents:
diff changeset
1412 easy, for a person with at least half a brain.
Dave Love <fx@gnu.org>
parents:
diff changeset
1413
Dave Love <fx@gnu.org>
parents:
diff changeset
1414 There are three possible reasons why flow control could be taking place:
Dave Love <fx@gnu.org>
parents:
diff changeset
1415
Dave Love <fx@gnu.org>
parents:
diff changeset
1416 1) Terminal has not been told to disable flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1417 2) Insufficient padding for the terminal in use
Dave Love <fx@gnu.org>
parents:
diff changeset
1418 3) Some sort of terminal concentrator or line switch is responsible
Dave Love <fx@gnu.org>
parents:
diff changeset
1419
Dave Love <fx@gnu.org>
parents:
diff changeset
1420 First of all, many terminals have a set-up mode which controls whether
Dave Love <fx@gnu.org>
parents:
diff changeset
1421 they generate XON/XOFF flow control characters. This must be set to
Dave Love <fx@gnu.org>
parents:
diff changeset
1422 "no XON/XOFF" in order for Emacs to work. Sometimes there is an
Dave Love <fx@gnu.org>
parents:
diff changeset
1423 escape sequence that the computer can send to turn flow control off
Dave Love <fx@gnu.org>
parents:
diff changeset
1424 and on. If so, perhaps the termcap `ti' string should turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1425 control off, and the `te' string should turn it on.
Dave Love <fx@gnu.org>
parents:
diff changeset
1426
Dave Love <fx@gnu.org>
parents:
diff changeset
1427 Once the terminal has been told "no flow control", you may find it
Dave Love <fx@gnu.org>
parents:
diff changeset
1428 needs more padding. The amount of padding Emacs sends is controlled
Dave Love <fx@gnu.org>
parents:
diff changeset
1429 by the termcap entry for the terminal in use, and by the output baud
Dave Love <fx@gnu.org>
parents:
diff changeset
1430 rate as known by the kernel. The shell command `stty' will print
Dave Love <fx@gnu.org>
parents:
diff changeset
1431 your output baud rate; `stty' with suitable arguments will set it if
Dave Love <fx@gnu.org>
parents:
diff changeset
1432 it is wrong. Setting to a higher speed causes increased padding. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1433 the results are wrong for the correct speed, there is probably a
Dave Love <fx@gnu.org>
parents:
diff changeset
1434 problem in the termcap entry. You must speak to a local Unix wizard
Dave Love <fx@gnu.org>
parents:
diff changeset
1435 to fix this. Perhaps you are just using the wrong terminal type.
Dave Love <fx@gnu.org>
parents:
diff changeset
1436
Dave Love <fx@gnu.org>
parents:
diff changeset
1437 For terminals that lack a "no flow control" mode, sometimes just
Dave Love <fx@gnu.org>
parents:
diff changeset
1438 giving lots of padding will prevent actual generation of flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1439 codes. You might as well try it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1440
Dave Love <fx@gnu.org>
parents:
diff changeset
1441 If you are really unlucky, your terminal is connected to the computer
Dave Love <fx@gnu.org>
parents:
diff changeset
1442 through a concentrator which sends XON/XOFF flow control to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1443 computer, or it insists on sending flow control itself no matter how
Dave Love <fx@gnu.org>
parents:
diff changeset
1444 much padding you give it. Unless you can figure out how to turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1445 control off on this concentrator (again, refer to your local wizard),
Dave Love <fx@gnu.org>
parents:
diff changeset
1446 you are screwed! You should have the terminal or concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1447 replaced with a properly designed one. In the mean time, some drastic
Dave Love <fx@gnu.org>
parents:
diff changeset
1448 measures can make Emacs semi-work.
Dave Love <fx@gnu.org>
parents:
diff changeset
1449
Dave Love <fx@gnu.org>
parents:
diff changeset
1450 You can make Emacs ignore C-s and C-q and let the operating system
Dave Love <fx@gnu.org>
parents:
diff changeset
1451 handle them. To do this on a per-session basis, just type M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1452 enable-flow-control RET. You will see a message that C-\ and C-^ are
Dave Love <fx@gnu.org>
parents:
diff changeset
1453 now translated to C-s and C-q. (Use the same command M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1454 enable-flow-control to turn *off* this special mode. It toggles flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1455 control handling.)
Dave Love <fx@gnu.org>
parents:
diff changeset
1456
Dave Love <fx@gnu.org>
parents:
diff changeset
1457 If C-\ and C-^ are inconvenient for you (for example, if one of them
Dave Love <fx@gnu.org>
parents:
diff changeset
1458 is the escape character of your terminal concentrator), you can choose
Dave Love <fx@gnu.org>
parents:
diff changeset
1459 other characters by setting the variables flow-control-c-s-replacement
Dave Love <fx@gnu.org>
parents:
diff changeset
1460 and flow-control-c-q-replacement. But choose carefully, since all
Dave Love <fx@gnu.org>
parents:
diff changeset
1461 other control characters are already used by emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
1462
Dave Love <fx@gnu.org>
parents:
diff changeset
1463 IMPORTANT: if you type C-s by accident while flow control is enabled,
Dave Love <fx@gnu.org>
parents:
diff changeset
1464 Emacs output will freeze, and you will have to remember to type C-q in
Dave Love <fx@gnu.org>
parents:
diff changeset
1465 order to continue.
Dave Love <fx@gnu.org>
parents:
diff changeset
1466
Dave Love <fx@gnu.org>
parents:
diff changeset
1467 If you work in an environment where a majority of terminals of a
Dave Love <fx@gnu.org>
parents:
diff changeset
1468 certain type are flow control hobbled, you can use the function
Dave Love <fx@gnu.org>
parents:
diff changeset
1469 `enable-flow-control-on' to turn on this flow control avoidance scheme
Dave Love <fx@gnu.org>
parents:
diff changeset
1470 automatically. Here is an example:
Dave Love <fx@gnu.org>
parents:
diff changeset
1471
Dave Love <fx@gnu.org>
parents:
diff changeset
1472 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
Dave Love <fx@gnu.org>
parents:
diff changeset
1473
Dave Love <fx@gnu.org>
parents:
diff changeset
1474 If this isn't quite correct (e.g. you have a mixture of flow-control hobbled
Dave Love <fx@gnu.org>
parents:
diff changeset
1475 and good vt200 terminals), you can still run enable-flow-control
Dave Love <fx@gnu.org>
parents:
diff changeset
1476 manually.
Dave Love <fx@gnu.org>
parents:
diff changeset
1477
Dave Love <fx@gnu.org>
parents:
diff changeset
1478 I have no intention of ever redesigning the Emacs command set for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1479 assumption that terminals use C-s/C-q flow control. XON/XOFF flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1480 control technique is a bad design, and terminals that need it are bad
Dave Love <fx@gnu.org>
parents:
diff changeset
1481 merchandise and should not be purchased. Now that X is becoming
Dave Love <fx@gnu.org>
parents:
diff changeset
1482 widespread, XON/XOFF seems to be on the way out. If you can get some
Dave Love <fx@gnu.org>
parents:
diff changeset
1483 use out of GNU Emacs on inferior terminals, more power to you, but I
Dave Love <fx@gnu.org>
parents:
diff changeset
1484 will not make Emacs worse for properly designed systems for the sake
Dave Love <fx@gnu.org>
parents:
diff changeset
1485 of inferior systems.
Dave Love <fx@gnu.org>
parents:
diff changeset
1486
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1487 ** Control-S and Control-Q commands are ignored completely.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1488
Dave Love <fx@gnu.org>
parents:
diff changeset
1489 For some reason, your system is using brain-damaged C-s/C-q flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1490 control despite Emacs's attempts to turn it off. Perhaps your
Dave Love <fx@gnu.org>
parents:
diff changeset
1491 terminal is connected to the computer through a concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1492 that wants to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1493
Dave Love <fx@gnu.org>
parents:
diff changeset
1494 You should first try to tell the concentrator not to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1495 If you succeed in this, try making the terminal work without
Dave Love <fx@gnu.org>
parents:
diff changeset
1496 flow control, as described in the preceding section.
Dave Love <fx@gnu.org>
parents:
diff changeset
1497
Dave Love <fx@gnu.org>
parents:
diff changeset
1498 If that line of approach is not successful, map some other characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1499 into C-s and C-q using keyboard-translate-table. The example above
Dave Love <fx@gnu.org>
parents:
diff changeset
1500 shows how to do this with C-^ and C-\.
Dave Love <fx@gnu.org>
parents:
diff changeset
1501
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1502 ** Screen is updated wrong, but only on one kind of terminal.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1503
Dave Love <fx@gnu.org>
parents:
diff changeset
1504 This could mean that the termcap entry you are using for that
Dave Love <fx@gnu.org>
parents:
diff changeset
1505 terminal is wrong, or it could mean that Emacs has a bug handing
Dave Love <fx@gnu.org>
parents:
diff changeset
1506 the combination of features specified for that terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1507
Dave Love <fx@gnu.org>
parents:
diff changeset
1508 The first step in tracking this down is to record what characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1509 Emacs is sending to the terminal. Execute the Lisp expression
Dave Love <fx@gnu.org>
parents:
diff changeset
1510 (open-termscript "./emacs-script") to make Emacs write all
Dave Love <fx@gnu.org>
parents:
diff changeset
1511 terminal output into the file ~/emacs-script as well; then do
Dave Love <fx@gnu.org>
parents:
diff changeset
1512 what makes the screen update wrong, and look at the file
Dave Love <fx@gnu.org>
parents:
diff changeset
1513 and decode the characters using the manual for the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1514 There are several possibilities:
Dave Love <fx@gnu.org>
parents:
diff changeset
1515
Dave Love <fx@gnu.org>
parents:
diff changeset
1516 1) The characters sent are correct, according to the terminal manual.
Dave Love <fx@gnu.org>
parents:
diff changeset
1517
Dave Love <fx@gnu.org>
parents:
diff changeset
1518 In this case, there is no obvious bug in Emacs, and most likely you
Dave Love <fx@gnu.org>
parents:
diff changeset
1519 need more padding, or possibly the terminal manual is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1520
Dave Love <fx@gnu.org>
parents:
diff changeset
1521 2) The characters sent are incorrect, due to an obscure aspect
Dave Love <fx@gnu.org>
parents:
diff changeset
1522 of the terminal behavior not described in an obvious way
Dave Love <fx@gnu.org>
parents:
diff changeset
1523 by termcap.
Dave Love <fx@gnu.org>
parents:
diff changeset
1524
Dave Love <fx@gnu.org>
parents:
diff changeset
1525 This case is hard. It will be necessary to think of a way for
Dave Love <fx@gnu.org>
parents:
diff changeset
1526 Emacs to distinguish between terminals with this kind of behavior
Dave Love <fx@gnu.org>
parents:
diff changeset
1527 and other terminals that behave subtly differently but are
Dave Love <fx@gnu.org>
parents:
diff changeset
1528 classified the same by termcap; or else find an algorithm for
Dave Love <fx@gnu.org>
parents:
diff changeset
1529 Emacs to use that avoids the difference. Such changes must be
Dave Love <fx@gnu.org>
parents:
diff changeset
1530 tested on many kinds of terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1531
Dave Love <fx@gnu.org>
parents:
diff changeset
1532 3) The termcap entry is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1533
Dave Love <fx@gnu.org>
parents:
diff changeset
1534 See the file etc/TERMS for information on changes
Dave Love <fx@gnu.org>
parents:
diff changeset
1535 that are known to be needed in commonly used termcap entries
Dave Love <fx@gnu.org>
parents:
diff changeset
1536 for certain terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1537
Dave Love <fx@gnu.org>
parents:
diff changeset
1538 4) The characters sent are incorrect, and clearly cannot be
Dave Love <fx@gnu.org>
parents:
diff changeset
1539 right for any terminal with the termcap entry you were using.
Dave Love <fx@gnu.org>
parents:
diff changeset
1540
Dave Love <fx@gnu.org>
parents:
diff changeset
1541 This is unambiguously an Emacs bug, and can probably be fixed
Dave Love <fx@gnu.org>
parents:
diff changeset
1542 in termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c.
Dave Love <fx@gnu.org>
parents:
diff changeset
1543
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1544 ** 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
1545
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1546 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
1547 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
1548 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
1549 control on the local system.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1550
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1551 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
1552 (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
1553 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
1554 "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
1555
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1556 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
1557 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
1558 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
1559
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1560 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
1561 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
1562 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
1563 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
1564
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1565 (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
1566
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1567 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
1568 info.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1569
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1570 ** Output from Control-V is slow.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1571
Dave Love <fx@gnu.org>
parents:
diff changeset
1572 On many bit-map terminals, scrolling operations are fairly slow.
Dave Love <fx@gnu.org>
parents:
diff changeset
1573 Often the termcap entry for the type of terminal in use fails
Dave Love <fx@gnu.org>
parents:
diff changeset
1574 to inform Emacs of this. The two lines at the bottom of the screen
Dave Love <fx@gnu.org>
parents:
diff changeset
1575 before a Control-V command are supposed to appear at the top after
Dave Love <fx@gnu.org>
parents:
diff changeset
1576 the Control-V command. If Emacs thinks scrolling the lines is fast,
Dave Love <fx@gnu.org>
parents:
diff changeset
1577 it will scroll them to the top of the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
1578
Dave Love <fx@gnu.org>
parents:
diff changeset
1579 If scrolling is slow but Emacs thinks it is fast, the usual reason is
Dave Love <fx@gnu.org>
parents:
diff changeset
1580 that the termcap entry for the terminal you are using does not
Dave Love <fx@gnu.org>
parents:
diff changeset
1581 specify any padding time for the `al' and `dl' strings. Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1582 concludes that these operations take only as much time as it takes to
Dave Love <fx@gnu.org>
parents:
diff changeset
1583 send the commands at whatever line speed you are using. You must
Dave Love <fx@gnu.org>
parents:
diff changeset
1584 fix the termcap entry to specify, for the `al' and `dl', as much
Dave Love <fx@gnu.org>
parents:
diff changeset
1585 time as the operations really take.
Dave Love <fx@gnu.org>
parents:
diff changeset
1586
Dave Love <fx@gnu.org>
parents:
diff changeset
1587 Currently Emacs thinks in terms of serial lines which send characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1588 at a fixed rate, so that any operation which takes time for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1589 terminal to execute must also be padded. With bit-map terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1590 operated across networks, often the network provides some sort of
Dave Love <fx@gnu.org>
parents:
diff changeset
1591 flow control so that padding is never needed no matter how slow
Dave Love <fx@gnu.org>
parents:
diff changeset
1592 an operation is. You must still specify a padding time if you want
Dave Love <fx@gnu.org>
parents:
diff changeset
1593 Emacs to realize that the operation takes a long time. This will
Dave Love <fx@gnu.org>
parents:
diff changeset
1594 cause padding characters to be sent unnecessarily, but they do
Dave Love <fx@gnu.org>
parents:
diff changeset
1595 not really cost much. They will be transmitted while the scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
1596 is happening and then discarded quickly by the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1597
Dave Love <fx@gnu.org>
parents:
diff changeset
1598 Most bit-map terminals provide commands for inserting or deleting
Dave Love <fx@gnu.org>
parents:
diff changeset
1599 multiple lines at once. Define the `AL' and `DL' strings in the
Dave Love <fx@gnu.org>
parents:
diff changeset
1600 termcap entry to say how to do these things, and you will have
Dave Love <fx@gnu.org>
parents:
diff changeset
1601 fast output without wasted padding characters. These strings should
Dave Love <fx@gnu.org>
parents:
diff changeset
1602 each contain a single %-spec saying how to send the number of lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1603 to be scrolled. These %-specs are like those in the termcap
Dave Love <fx@gnu.org>
parents:
diff changeset
1604 `cm' string.
Dave Love <fx@gnu.org>
parents:
diff changeset
1605
Dave Love <fx@gnu.org>
parents:
diff changeset
1606 You should also define the `IC' and `DC' strings if your terminal
Dave Love <fx@gnu.org>
parents:
diff changeset
1607 has a command to insert or delete multiple characters. These
Dave Love <fx@gnu.org>
parents:
diff changeset
1608 take the number of positions to insert or delete as an argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
1609
Dave Love <fx@gnu.org>
parents:
diff changeset
1610 A `cs' string to set the scrolling region will reduce the amount
Dave Love <fx@gnu.org>
parents:
diff changeset
1611 of motion you see on the screen when part of the screen is scrolled.
Dave Love <fx@gnu.org>
parents:
diff changeset
1612
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1613 ** You type Control-H (Backspace) expecting to delete characters.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1614
Dave Love <fx@gnu.org>
parents:
diff changeset
1615 Put `stty dec' in your .login file and your problems will disappear
Dave Love <fx@gnu.org>
parents:
diff changeset
1616 after a day or two.
Dave Love <fx@gnu.org>
parents:
diff changeset
1617
Dave Love <fx@gnu.org>
parents:
diff changeset
1618 The choice of Backspace for erasure was based on confusion, caused by
Dave Love <fx@gnu.org>
parents:
diff changeset
1619 the fact that backspacing causes erasure (later, when you type another
Dave Love <fx@gnu.org>
parents:
diff changeset
1620 character) on most display terminals. But it is a mistake. Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
1621 of text is not the same thing as backspacing followed by failure to
Dave Love <fx@gnu.org>
parents:
diff changeset
1622 overprint. I do not wish to propagate this confusion by conforming
Dave Love <fx@gnu.org>
parents:
diff changeset
1623 to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1624
Dave Love <fx@gnu.org>
parents:
diff changeset
1625 For this reason, I believe `stty dec' is the right mode to use,
Dave Love <fx@gnu.org>
parents:
diff changeset
1626 and I have designed Emacs to go with that. If there were a thousand
Dave Love <fx@gnu.org>
parents:
diff changeset
1627 other control characters, I would define Control-h to delete as well;
Dave Love <fx@gnu.org>
parents:
diff changeset
1628 but there are not very many other control characters, and I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1629 that providing the most mnemonic possible Help character is more
Dave Love <fx@gnu.org>
parents:
diff changeset
1630 important than adapting to people who don't use `stty dec'.
Dave Love <fx@gnu.org>
parents:
diff changeset
1631
Dave Love <fx@gnu.org>
parents:
diff changeset
1632 If you are obstinate about confusing buggy overprinting with deletion,
Dave Love <fx@gnu.org>
parents:
diff changeset
1633 you can redefine Backspace in your .emacs file:
Dave Love <fx@gnu.org>
parents:
diff changeset
1634 (global-set-key "\b" 'delete-backward-char)
Dave Love <fx@gnu.org>
parents:
diff changeset
1635 You can probably access help-command via f1.
Dave Love <fx@gnu.org>
parents:
diff changeset
1636
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1637 ** 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
1638
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1639 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
1640 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
1641 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
1642 "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
1643 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
1644 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
1645 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
1646 "colors".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1647
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1648 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
1649 ``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
1650 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
1651 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
1652 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
1653 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
1654 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
1655 capability).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1656
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1657 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
1658 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
1659 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
1660 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
1661
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1662 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
1663 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
1664 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
1665 `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
1666 emulator.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1667
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
1668 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
1669 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
1670 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
1671 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
1672
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1673 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
1674 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
1675 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
1676 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
1677 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
1678 `global-font-lock-mode'.
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 * Runtime problems specific to individual Unix variants
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1681
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1682 ** GNU/Linux
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1683
63126
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1684 *** 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
1685
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1686 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
1687 read corrupted process output.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1688
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1689 *** 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
1690
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1691 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
1692 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
1693
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1694 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
1695 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
1696 the script:
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1697
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1698 #!/bin/bash
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1699 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
1700 exec ssh "$@"
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1701
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1702 *** 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
1703 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
1704
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1705 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
1706 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
1707 known to work.
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 *** 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
1710 the Meta key stops working.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1711
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1712 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
1713 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
1714 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
1715 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
1716 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
1717 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
1718 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
1719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1720 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
1721 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
1722 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
1723 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
1724 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
1725 modifier:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1726
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1727 xmodmap -pk | egrep -i "meta|alt"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1728
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1729 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
1730 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
1731
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1732 xkbprint 0:0 /tmp/k.ps
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1733
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1734 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
1735 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
1736 keys can serve as Meta.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1737
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1738 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
1739 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
1740
71200
d004c9d874b7 Fix typo.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 69953
diff changeset
1741 *** GNU/Linux: slow startup on Linux-based GNU systems.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1742
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1743 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
1744 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
1745
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1746 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
1747 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
1748 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
1749 networked and non-networked machines.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1750
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1751 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
1752
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1753 **** Networked Case.
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 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
1756 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
1757 (replace HOSTNAME with your host name):
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 127.0.0.1 HOSTNAME
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 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
1762 lines:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1763
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1764 order hosts, bind
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1765 multi on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1766
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1767 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
1768 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
1769 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
1770 dynamically allocate ip addresses).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1771
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1772 **** Non-Networked Case.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1773
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1774 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
1775 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
1776 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
1777 `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
1778 file is not necessary with this approach.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1779
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1780 *** 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
1781
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1782 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
1783 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
1784 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
1785 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
1786 (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
1787 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
1788 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
1789 always blinks.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1790
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1791 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
1792 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
1793 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
1794 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
1795 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
1796 cursor instead of the hardware cursor.
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 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
1799 `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
1800 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
1801 produce a modified terminfo entry.
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 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
1804 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
1805
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1806 *** 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
1807
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1808 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
1809 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
1810 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
1811 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
1812
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1813 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
1814
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1815 ** Mac OS X
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1816
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1817 *** 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
1818
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1819 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
1820 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
1821 .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
1822 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
1823
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1824 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
1825 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
1826 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
1827 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
1828
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1829 *** 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
1830
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1831 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
1832 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
1833 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
1834
68771
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1835 *** Mac OS X 10.3.9 (Carbon): QuickTime 7.0.4 updater breaks build.
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1836
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1837 On the above environment, build fails at the link stage with the
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1838 message like "Undefined symbols: _HICopyAccessibilityActionDescription
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1839 referenced from QuickTime expected to be defined in Carbon". A
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1840 workaround is to use QuickTime 7.0.1 reinstaller.
a49c90df9eb9 (Mac OS X): Add QuickTime 7.0.4 / Mac OS X 10.3.9 breakage.
YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
parents: 68640
diff changeset
1841
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1842 ** FreeBSD
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 *** 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
1845 directories that have the +t bit.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1846
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1847 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
1848 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
1849 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
1850 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
1851
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1852 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
1853 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
1854
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1855 *** 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
1856
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1857 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
1858 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
1859 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
1860
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1861 $ kbdcontrol -d >emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1862
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1863 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
1864 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
1865 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
1866 to look like this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1867
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1868 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
1869
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1870 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
1871
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1872 $ kbdcontrol -l emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1873
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1874 ** HP-UX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1875
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1876 *** 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
1877
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1878 christos@theory.tn.cornell.edu says:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1879
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1880 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
1881 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
1882 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
1883 but tty is giving it back 3.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1884
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1885 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
1886 word:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1887
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1888 if (`tty` == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1889
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1890 should be changed to:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1891
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1892 if ("`tty`" == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1893
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1894 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
1895 and into .login.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1896
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1897 *** 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
1898
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1899 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
1900 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
1901 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
1902 value is just ten seconds.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1903
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1904 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
1905
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1906 *** 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
1907 other non-English HP keyboards too).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1908
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1909 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
1910 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
1911 configures the X server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1912
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1913 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1914 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1915 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1916 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1917
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1918 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1919 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1920 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1921 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1922 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1923 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1924 EOF
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 *** 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
1927 Emacs built with Motif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1928
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1929 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
1930 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
1931
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1932 *** 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
1933
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1934 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
1935 rights, containing this text:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1936
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 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1939 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1940 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1941 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1942
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1943 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1944 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1945 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1946 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1947 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1948 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1949 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1950 --------------------------------
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1951
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1952 *** 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
1953
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1954 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
1955
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1956 ** AIX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1957
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1958 *** AIX: Trouble using ptys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1959
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1960 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
1961 Use `smit pty' to reinstall them properly.
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 *** 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
1964
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1965 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
1966
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1967 *aixterm.Translations: #override <Key>BackSpace: string(0x7f)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1968 aixterm*ttyModes: erase ^?
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1969
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1970 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
1971
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1972 *** 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
1973 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
1974 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
1975 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
1976
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1977 *** 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
1978
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1979 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
1980 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
1981 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
1982 is to use the default compiler `cc'.
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 *** 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
1985 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
1986
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1987 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
1988 `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
1989 Definitions" to make them defined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1990
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1991 ** Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1992
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1993 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
1994 section on legacy systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1995
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1996 *** 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
1997
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1998 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
1999 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
2000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2001 *** Problem with remote X server on Suns.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2002
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2003 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
2004 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
2005 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
2006 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
2007
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2008 *** 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
2009
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2010 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
2011 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
2012 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
2013
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2014 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
2015 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
2016 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
2017 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
2018
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2019 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
2020 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
2021
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2022 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
2023 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
2024 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
2025
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2026 *** 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
2027
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2028 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
2029 Rebuild it on Solaris 8.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2030
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2031 *** 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
2032 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
2033
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2034 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
2035
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2036 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
2037
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2038 *** 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
2039 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
2040
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2041 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
2042
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2043 /usr/openwin/lib/locale/iso8859-15/Compose
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2044
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2045 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
2046
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2047 Ctrl<t> <quotedbl> <Y> : "\276" threequarters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2048
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2049 that should read:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2050
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2051 Ctrl<T> <quotedbl> <Y> : "\276" threequarters
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2052
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2053 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
2054
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2055 ** Irix
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 *** 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
2058
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2059 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
2060
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2061 *** 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
2062
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2063 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
2064 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
2065 to allocate ptys reliably.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2066
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2067 * Runtime problems specific to MS-Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2068
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2069 ** Windows 95 and networking.
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2070
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2071 To support server sockets, Emacs 22.1 loads ws2_32.dll. If this file
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2072 is missing, all Emacs networking features are disabled.
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2073
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2074 Old versions of Windows 95 may not have the required DLL. To use
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2075 Emacs' networking features on Windows 95, you must install the
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2076 "Windows Socket 2" update available from MicroSoft's support Web.
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2077
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2078 ** 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
2079
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2080 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
2081 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
2082 problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2083
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2084 ** 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
2085
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2086 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
2087 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
2088 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
2089 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
2090 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
2091
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2092 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
2093 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
2094 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
2095 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
2096 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
2097 pop-up menu interaction.
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 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
2100 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
2101
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2102 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
2103 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
2104 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
2105 after moving back into it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2106
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2107 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
2108 not as severely as in 21.1.
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 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
2111 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
2112
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2113 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
2114 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
2115 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
2116 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
2117 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
2118 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
2119 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
2120 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
2121 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
2122 yet.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2123
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2124 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
2125 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
2126 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
2127 library function.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2128
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2129 ** 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
2130
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2131 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
2132 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
2133 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
2134 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
2135 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
2136
74660
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2137 ** Cygwin build of Emacs hangs after rebasing Cygwin DLLs
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2138
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2139 Usually, on Cygwin, one needs to rebase the DLLs if an application
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2140 aborts with a message like this:
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2141
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2142 C:\cygwin\bin\python.exe: *** unable to remap C:\cygwin\bin\cygssl.dll to
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2143 same address as parent(0xDF0000) != 0xE00000
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2144
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2145 However, since Cygwin DLL 1.5.17 was released, after such rebasing,
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2146 Emacs hangs.
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2147
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2148 This was reported to happen for Emacs 21.2 and also for the pretest of
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2149 Emacs 22.1 on Cygwin.
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2150
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2151 To work around this, build Emacs like this:
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2152
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2153 LDFLAGS='-Wl,--enable-auto-import -Wl,--enable-auto-image-base' ./configure
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2154 make LD='$(CC)'
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2155 make LD='$(CC)' install
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2156
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2157 This produces an Emacs binary that is independent of rebasing.
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2158
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2159 Note that you _must_ use LD='$(CC)' in the last two commands above, to
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2160 prevent GCC from passing the "--image-base 0x20000000" option to the
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2161 linker, which is what it does by default. That option produces an
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2162 Emacs binary with the base address 0x20000000, which will cause Emacs
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2163 to hang after Cygwin DLLs are rebased.
353ff7e82e90 Document problems with rebasing Cygwin DLLs.
Eli Zaretskii <eliz@gnu.org>
parents: 73673
diff changeset
2164
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2165 ** 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
2166
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2167 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
2168 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
2169 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
2170 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
2171 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
2172
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2173 ** 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
2174
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2175 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
2176 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
2177 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
2178 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
2179 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
2180 confuses ange-ftp.
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 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
2183 (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
2184 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
2185 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
2186 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
2187 client's executable. For example:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2188
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2189 (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
2190
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2191 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
2192 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
2193
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2194 (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
2195
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2196 ** 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
2197
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2198 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
2199 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
2200
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2201 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
2202 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
2203 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
2204 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
2205 has):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2206
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2207 (setq printer-name "") ;; notepad takes the default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2208 (setq lpr-command "notepad") ;; notepad
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2209 (setq lpr-switches nil) ;; not needed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2210 (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
2211
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2212 ** 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
2213
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2214 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
2215 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
2216 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
2217 work when an antivirus package is installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2218
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2219 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
2220 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
2221 or disable it entirely.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2222
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2223 ** 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
2224
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2225 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
2226 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
2227 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
2228 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
2229 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
2230 "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
2231 generic mouse driver might help.
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 ** 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
2234
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2235 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
2236 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
2237 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
2238 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
2239
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2240 ** 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
2241 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
2242 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
2243 seen.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2244
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2245 ** 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
2246 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
2247
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2248 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
2249
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2250 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
2251 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
2252 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
2253 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
2254 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
2255 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
2256
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2257 ** 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
2258
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2259 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
2260 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
2261 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
2262 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
2263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2264 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
2265 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
2266 problem lies in the X-server settings.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2267
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2268 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
2269 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
2270 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
2271 selection".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2272
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2273 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
2274 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
2275 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
2276 here.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2277
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2278 * Build-time problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2279
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2280 ** Configuration
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 *** 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
2283
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2284 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
2285 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
2286 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
2287
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2288 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
2289 `--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
2290 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
2291 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
2292 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
2293 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
2294
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2295 ** Compilation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2296
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2297 *** 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
2298
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2299 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
2300 (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
2301 (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
2302 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
2303 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
2304 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
2305 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
2306 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
2307
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2308 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
2309 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
2310 (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
2311 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
2312
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2313 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
2314 (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
2315 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
2316 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
2317 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
2318 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
2319 `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
2320 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
2321 `/etc/auto.home'.
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 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
2324 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
2325 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
2326 to work around the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2327
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2328 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
2329 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
2330 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
2331 `/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
2332
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2333 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
2334
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2335 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
2336
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2337 *** 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
2338
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2339 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
2340 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
2341 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
2342 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
2343 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
2344 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
2345 ". .", 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
2346 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
2347 variables).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2348
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2349 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
2350 `-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
2351 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
2352 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
2353 run the script like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2354
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2355 CPP='gcc -E -traditional' ./configure ...
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 (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
2358 the script).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2359
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2360 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
2361 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
2362
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2363 *** 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
2364 *** 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
2365
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2366 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
2367 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
2368 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
2369 configure script.
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 *** 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
2372
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2373 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
2374 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
2375 Emacs's configure script.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2376
75211
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2377 *** Building a 32-bit executable on a 64-bit GNU/Linux architecture.
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2378
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2379 First ensure that the necessary 32-bit system libraries and include
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2380 files are installed. Then use:
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2381
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2382 env CC="gcc -m32" ./configure --build=i386-linux-gnu \
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2383 --x-libraries=/usr/X11R6/lib
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2384
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2385 (using the location of the 32-bit X libraries on your system).
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2386
73673
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2387 *** Building the Cygwin port for MS-Windows can fail with some GCC version
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2388
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2389 Building Emacs 22 with Cygwin builds of GCC 3.4.4-1 and 3.4.4-2 is
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2390 reported to either fail or cause Emacs to segfault at run time. In
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2391 addition, the Cygwin GCC 3.4.4-2 has problems with generating debug
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2392 info. Cygwin users are advised not to use these versions of GCC for
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2393 compiling Emacs. GCC versions 4.0.3 and 4.1.1 reportedly build a
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2394 working Cygwin binary of Emacs, so we recommend these GCC versions.
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2395
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2396 *** Building the native MS-Windows port with Cygwin GCC can fail.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2397
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2398 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
2399 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
2400 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
2401 __MSVCRT__, like so:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2402
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2403 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
2404
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2405 *** 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
2406
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2407 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
2408 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
2409 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
2410
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2411 *** 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
2412
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2413 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
2414
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2415 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
2416 Invalid ENCODE: value in TIT dictionary
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2417 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
2418 '0xffffffff'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2419 Stop.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2420
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2421 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
2422 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
2423 `*.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
2424 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
2425 or EOL conversions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2426
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2427 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
2428 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
2429 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
2430 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
2431 mangling them.
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 *** 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
2434
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2435 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
2436 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
2437 patch to assert.h should solve this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2438
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2439 *** 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
2440 --- 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
2441 ***************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2442 *** 41,47 ****
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2443 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2444 * If not debugging, assert does nothing.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2445 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2446 ! #define assert(x) ((void)0);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2447
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2448 #else /* debugging enabled */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2449
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2450 --- 41,47 ----
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2451 /*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2452 * If not debugging, assert does nothing.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2453 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2454 ! #define assert(x) ((void)0)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2455
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2456 #else /* debugging enabled */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2457
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2458
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2459 ** Linking
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2460
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2461 *** 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
2462 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
2463
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2464 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
2465 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
2466 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
2467 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
2468 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
2469 link stage.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2470
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2471 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
2472
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2473 make CC=gcc
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2474
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2475 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
2476 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
2477
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2478 *** AIX 1.3 ptf 0013: Link failure.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2479
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2480 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
2481 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
2482 workaround/fix is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2483
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2484 cd /lib
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2485 ar xv libc_s.a NLtmtime.o
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2486 ar dv libc_s.a NLtmtime.o
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2487
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2488 *** 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
2489 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
2490 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
2491
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2492 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
2493 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
2494 you build Emacs:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2495
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2496 cp /usr/lib/libIM.a .
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2497 chmod 664 libIM.a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2498 ranlib libIM.a
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2499
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2500 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
2501 Makefile).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2502
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2503 *** 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
2504
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2505 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
2506
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2507 /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
2508
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2509 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
2510
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2511 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
2512 cannot easily arrange to supply them.
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 *** 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
2515
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2516 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
2517
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2518 *** `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
2519
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2520 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
2521 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
2522 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
2523 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
2524 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
2525
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2526 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
2527
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2528 ** Dumping
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 *** 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
2531
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2532 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
2533 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
2534 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
2535 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
2536 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
2537 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
2538 newer). Read the next item.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2539
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2540 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
2541 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
2542 workaround is known.
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2543
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2544 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
2545
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2546 cat /proc/sys/kernel/exec-shield
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2547
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2548 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
2549 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
2550 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
2551
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2552 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
2553
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2554 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
2555 execution of this command:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2556
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2557 ./temacs --batch --load loadup [dump|bootstrap]
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2558
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2559 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
2560 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
2561 command when running temacs like this:
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2562
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2563 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
2564
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2565
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2566 *** 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
2567
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2568 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
2569 `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
2570 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
2571 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
2572 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
2573 command:
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2574
64489
86ac75fb6283 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63969
diff changeset
2575 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
2576
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2577 or
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2578
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2579 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
2580
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2581 *** 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
2582
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2583 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
2584 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
2585
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2586 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
2587 space available on the machine.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2588
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2589 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
2590 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
2591 for large blocks (many pages).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2592
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2593 *** 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
2594 *** 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
2595 *** 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
2596 *** or, temacs gets errors dumping emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2597
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2598 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
2599 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
2600 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
2601
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2602 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
2603 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
2604 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
2605 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
2606 when unpacking the shell archive.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2607
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2608 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
2609 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
2610 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
2611
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2612 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
2613 nonprinting characters, you can fix them:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2614
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2615 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
2616 2) Delete all the .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2617 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
2618 (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
2619 4) Remake emacs. It should work now.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2620 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
2621 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
2622 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
2623 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
2624 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
2625 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
2626 and remake temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2627 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
2628
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2629 *** temacs prints "Pure Lisp storage exhausted".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2630
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2631 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
2632 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
2633 space than was allocated.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2634
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2635 This could be caused by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2636 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
2637 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
2638 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
2639 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
2640 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
2641 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
2642 deleting that file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2643 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
2644 (not from the directory you expected).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2645 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
2646 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
2647 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
2648 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
2649 the space required.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2650
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2651 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
2652 of PURESIZE in puresize.h.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2653
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2654 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
2655 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
2656 problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2657
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2658 *** 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
2659
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2660 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
2661 C backtrace printed by GDB:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2662
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2663 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2664 (gdb) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2665 #0 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2666 #1 0x1942ca4 in init_obarray ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2667 #2 0x18b3500 in main ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2668 #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
2669
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2670 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
2671 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
2672 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
2673 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
2674 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
2675 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
2676 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
2677 distribution:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2678
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2679 #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
2680 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
2681 know what's really going on here. */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2682 /* 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
2683 0x10000000. */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2684 #if defined __linux__
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2685 #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
2686 #define DATA_SEG_BITS 0x10000000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2687 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2688 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2689 #endif /* 0 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2690
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2691 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
2692 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
2693 should now succeed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2694
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2695 ** Installation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2696
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2697 *** 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
2698
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2699 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
2700 supplies the `install-info' command.
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 ** First execution
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 *** 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
2705
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2706 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
2707 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
2708 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
2709 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
2710
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2711 emacs: ASCII text, with no line terminators
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2712
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2713 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
2714 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
2715
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2716 *** 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
2717
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2718 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
2719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2720 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
2721 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
2722 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
2723 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
2724
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2725 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
2726 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
2727 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
2728 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
2729 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
2730
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2731 * Emacs 19 problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2732
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2733 ** 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
2734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2735 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
2736 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
2737 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
2738 where-is-internal in an obsolete way.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2739
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2740 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
2741
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2742 * Runtime problems on legacy systems
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 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
2745 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
2746 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
2747
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2748 ** Ancient operating systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2749
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2750 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
2751
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2752 *** 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
2753
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2754 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
2755 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
2756
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2757 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
2758 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
2759 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
2760
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2761 (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
2762
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2763 *** 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
2764
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2765 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
2766 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
2767 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
2768 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
2769
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2770 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
2771 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
2772
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2773 *** 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
2774
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2775 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
2776 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
2777 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
2778
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2779 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
2780
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2781 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
2782 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
2783 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
2784 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
2785
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2786 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
2787 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
2788
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2789 *** 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
2790
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2791 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
2792 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
2793
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2794 *** ISC Unix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2795
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2796 **** 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
2797
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2798 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
2799 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
2800 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
2801 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
2802 processes die, in particular pcnfsd.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2803
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2804 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
2805 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
2806
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2807 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
2808
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2809 *** SunOS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2810
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2811 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
2812
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2813 **** 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
2814 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
2815 _get_wmShellWidgetClass
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2816 _get_applicationShellWidgetClass
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2817
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2818 **** 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
2819
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2820 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
2821 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
2822
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2823 **** 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
2824
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2825 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
2826 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
2827 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
2828 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
2829 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
2830 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
2831 obtain the destination address.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2832
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2833 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
2834 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
2835 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
2836 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
2837 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
2838 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
2839 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
2840
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2841 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
2842 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
2843 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
2844 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
2845 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
2846
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2847 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
2848 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
2849
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2850 **** 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
2851
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2852 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
2853 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
2854 /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
2855
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2856 **** 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
2857
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2858 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
2859 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
2860 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
2861 it can do perfectly well for SunOS).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2862
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2863 **** 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
2864
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2865 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
2866 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
2867
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2868 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
2869 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
2870 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
2871 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
2872 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
2873
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2874 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
2875 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
2876
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2877 **** 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
2878 (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
2879
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2880 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
2881
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2882 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
2883 or link libXmu statically.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2884
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2885 **** 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
2886
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2887 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
2888 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
2889 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
2890 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
2891
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2892 *** Apollo Domain
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2893
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2894 **** Shell mode ignores interrupts on Apollo Domain.
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 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
2897
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2898 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
2899
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2900 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
2901 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
2902
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2903 % cd /dev
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2904 % ls pty*
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2905 # 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
2906 % /etc/crpty 8
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2907 # creates eight new pty's
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2908
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2909 *** Irix
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 *** 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
2912
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2913 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
2914 as of 8 Dec 1998.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2915
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2916 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
2917
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2918 *** 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
2919 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
2920
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2921 Substituting nonexistent environment variable ""
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2922
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2923 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
2924 003082 August 11, 1998.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2925
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2926 *** OPENSTEP
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2927
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2928 **** 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
2929
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2930 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
2931 following message:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2932
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2933 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
2934
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2935 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
2936 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
2937 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
2938
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2939 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
2940 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2941 return(UPDATE_SYNTAX_TABLE_FORWARD(from));
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2942 }/*update_syntax_table_forward*/
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2943
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2944 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
2945 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
2946
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2947 *** Solaris 2.x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2948
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2949 **** 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
2950
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2951 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
2952 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
2953 as GCC.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2954
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2955 **** 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
2956
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2957 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
2958 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
2959 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
2960
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2961 **** 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
2962
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2963 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
2964 version of Solaris that you are using.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2965
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2966 **** 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
2967
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2968 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
2969 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
2970
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2971 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
2972
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2973 **** 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
2974
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2975 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
2976 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
2977 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
2978 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
2979 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
2980
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2981 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
2982 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
2983 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
2984 for certain.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2985
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2986 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
2987 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
2988 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
2989
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2990 (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
2991 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
2992
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2993 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
2994 bug-gnu-emacs@gnu.org.
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 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
2997 Solaris 2.5.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2998
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2999 **** 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
3000 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
3001
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3002 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
3003 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
3004
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3005 #if ThreadedX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3006 #define SharedX11Reqs -lthread
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3007 #endif
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 to:
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 #if OSMinorVersion < 4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3012 #if ThreadedX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3013 #define SharedX11Reqs -lthread
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3014 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3015 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3016
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3017 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
3018 (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
3019 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
3020 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
3021 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
3022
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3023 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
3024 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
3025 Solaris 2.4, not on 2.3.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3026
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3027 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
3028 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
3029 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
3030 patch.
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 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
3033 he changed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3034 #define ThreadedX YES
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3035 to
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3036 #define ThreadedX NO
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3037 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
3038 `-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
3039 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
3040
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3041 **** 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
3042
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3043 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
3044 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
3045 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
3046 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
3047 described in the Solaris FAQ
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3048 <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
3049 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
3050
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3051 **** 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
3052 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
3053 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
3054 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
3055 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
3056 and the default CFLAGS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3057
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3058 **** 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
3059
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3060 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
3061 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
3062 (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
3063 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
3064 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
3065 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
3066 are currently recommended for your host.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3067
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3068 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
3069 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
3070 105284-18 might fix it again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3071
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3072 **** 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
3073
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3074 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
3075 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
3076 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
3077 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
3078
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3079 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
3080 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
3081 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
3082 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
3083 should do.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3084
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3085 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
3086 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
3087 libraries.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3088
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3089 *** 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
3090
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
3091 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
3092 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
3093
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3094 **** 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
3095
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3096 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
3097 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
3098 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
3099
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3100 *** 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
3101
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3102 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
3103
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3104 *** 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
3105
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3106 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
3107 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
3108 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
3109 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
3110 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
3111 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
3112
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3113 *** Ultrix and Digital Unix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3114
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3115 **** 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
3116
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3117 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
3118 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
3119 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
3120 hand.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3121
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3122 **** 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
3123
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3124 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
3125 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
3126 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
3127 `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
3128 in Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3129
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3130 **** 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
3131
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3132 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
3133 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
3134 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
3135 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
3136
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3137 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
3138 anything it loads. Yuck - some solution.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3139
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3140 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
3141 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
3142 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
3143 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
3144
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3145 *** SVr4
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3146
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3147 **** 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
3148
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3149 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
3150 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
3151 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
3152
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3153 **** 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
3154
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3155 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
3156 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
3157 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
3158
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3159 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
3160 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
3161 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
3162 configure script) that reads:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3163 #define SYSTEM_MALLOC
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3164 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
3165 the kernel bug.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3166
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3167 *** 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
3168
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
3169 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
3170 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
3171
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3172 **** 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
3173
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3174 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
3175 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
3176 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
3177 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
3178 syms.h.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3179
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3180 **** 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
3181
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3182 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
3183 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
3184 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
3185 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
3186 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
3187
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3188 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
3189 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
3190
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3191 /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
3192
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3193 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
3194 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
3195 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
3196 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
3197 information.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3198
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3199 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
3200 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
3201 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
3202
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3203 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
3204 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
3205 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
3206 icons.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3207
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3208 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
3209 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
3210 ("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
3211 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
3212
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3213 **** 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
3214
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3215 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
3216 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
3217
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3218 **** 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
3219
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3220 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
3221 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
3222 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
3223
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3224 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
3225
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3226 *** 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
3227
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3228 **** 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
3229
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3230 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
3231 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
3232 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
3233
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3234 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
3235 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
3236 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
3237 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
3238 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
3239
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3240 *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
3241 *Background: scoBackground
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3242 *Foreground: scoForeground
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3243
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3244 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
3245 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
3246
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3247 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
3248 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
3249 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
3250
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3251 (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
3252 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
3253 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
3254 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
3255 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
3256 /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
3257 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
3258 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
3259
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3260 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
3261 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
3262
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3263 **** 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
3264
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3265 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
3266 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
3267 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
3268 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
3269 GCC.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3270
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3271 **** 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
3272
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3273 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
3274 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
3275 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
3276 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
3277 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
3278 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
3279
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3280 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
3281 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
3282
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3283 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
3284
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3285 # /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
3286 # /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
3287 # /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
3288 # /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
3289 # /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
3290
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3291 (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
3292 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
3293
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3294 *** Linux 1.x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3295
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3296 **** 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
3297
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3298 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
3299 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
3300 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
3301
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3302 **** 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
3303 truncated on GNU/Linux systems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3304
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3305 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
3306 1.3.75.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3307
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3308 ** 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
3309
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3310 *** 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
3311
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3312 `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
3313 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
3314
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3315 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
3316 "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
3317 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
3318
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3319 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
3320 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
3321 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
3322
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3323 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
3324 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
3325 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
3326 stdin.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3327
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3328 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
3329
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3330 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
3331
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3332 *** 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
3333 --- 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
3334 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3335 *** 68,74 ****
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3336 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3337 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3338 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3339 ! $console = "con";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3340 $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
3341 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3342
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3343 --- 68,74 ----
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3344 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3345 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3346 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3347 ! $console = "";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3348 $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
3349 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3350
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3351
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3352 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
3353 *** 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
3354 --- 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
3355 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3356 *** 22,28 ****
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3357 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3358 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3359 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
3360 ! $console = "con";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3361 $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
3362 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3363 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3364 --- 22,28 ----
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3365 $rcfile=".perldb";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3366 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3367 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
3368 ! $console = "";
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3369 $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
3370 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3371 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3372
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3373 *** 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
3374
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3375 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
3376 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
3377
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3378 *** 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
3379
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3380 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
3381 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
3382 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
3383 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
3384
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3385 *** 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
3386
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3387 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
3388 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
3389 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
3390 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
3391 PATH.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3392
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3393 ** MS-DOS
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 *** 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
3396
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3397 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
3398 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
3399 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
3400 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
3401 the front of your PATH environment variable.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3402
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3403 *** 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
3404 like make-docfile.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3405
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3406 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
3407 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
3408 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
3409 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
3410
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3411 *** Emacs compiled with DJGPP complains at startup:
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 "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
3414
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3415 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
3416 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
3417 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
3418 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
3419 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
3420 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
3421 [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
3422 `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
3423 your system works as before.
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 *** MS-DOS: Emacs crashes at startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3426
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3427 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
3428 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
3429 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
3430 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
3431 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
3432
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3433 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
3434 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
3435 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
3436 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
3437
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3438 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
3439 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
3440 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
3441 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
3442 the djgpp faq for configuration hints.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3443
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3444 *** 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
3445 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
3446 drive, e.g. `c:/dev'.
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 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
3449 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
3450 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
3451
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3452 *** 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
3453
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3454 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
3455
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3456 * 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
3457 `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
3458 * 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
3459
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3460 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
3461 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
3462 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
3463 incorrect library functions.
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 *** 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
3466 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
3467
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3468 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
3469 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
3470 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
3471 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
3472
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3473 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
3474 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
3475 Lisp.
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 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
3478 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
3479 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
3480 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
3481 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
3482 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
3483 explains this issue in more detail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3484
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3485 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
3486 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
3487 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
3488 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
3489 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
3490 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
3491 properly truncated.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3492
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3493 ** Archaic window managers and toolkits
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3494
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3495 *** 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
3496
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3497 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
3498 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
3499 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
3500 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
3501 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
3502
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3503 OpenWindows.WindowMenuAccelerators: False
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3504
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3505 **** 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
3506
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3507 twm normally ignores "program-specified" positions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3508 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
3509
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3510 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
3511
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3512 ** Bugs related to old DEC hardware
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 *** 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
3515
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3516 This shell command should fix it:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3517
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3518 xmodmap -e 'keycode 0xb1 = Meta_L'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3519
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3520 *** 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
3521 as a concentrator.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3522
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3523 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
3524 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
3525
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3526 * Build problems on legacy systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3527
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3528 ** 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
3529
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3530 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
3531 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
3532 such as bash.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3533
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3534 ** 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
3535 Invalid dimension for the charset-ID 160
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3536
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3537 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
3538 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
3539
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3540 ** 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
3541
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3542 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
3543
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3544 unexec: Bad address, writing data section to ...
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3545
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3546 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
3547 were built for an older system version,
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3548
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3549 ./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
3550
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3551 made the problem go away.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3552
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3553 ** 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
3554
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3555 If you get errors such as
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3556
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3557 "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
3558 "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
3559 "sysdep.c", line 2019: nodename undefined
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3560
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3561 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
3562 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
3563 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
3564 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
3565 ones available when you build Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3566
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3567 ** 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
3568
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3569 /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
3570
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3571 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
3572
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3573 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
3574
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3575 ** 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
3576
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3577 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
3578 _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
3579 -lXaw in the command that links temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3580
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3581 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
3582 extensions to X11R5 are installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3583
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3584 ** 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
3585
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3586 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
3587 `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
3588 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
3589 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
3590
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3591 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
3592 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
3593 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
3594 floating point option: -fsoft.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3595
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3596 ** 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
3597
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3598 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
3599 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
3600 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
3601 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
3602 toolkit.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3603
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3604 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
3605 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
3606 X11R4, then use it in the link.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3607
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3608 ** 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
3609
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3610 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
3611 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
3612 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
3613 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
3614 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
3615 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
3616
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3617 ** 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
3618
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3619 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
3620
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3621 ** VMS: Compilation errors on VMS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3622
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3623 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
3624 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
3625 This is not an error. Ignore it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3626
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3627 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
3628 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
3629
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3630 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
3631 in conditional expressions. The bug is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3632 char c = -1, d = 1;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3633 int i;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3634
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3635 i = d ? c : d;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3636 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
3637 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
3638 constructs in Emacs have been fixed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3639
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3640 ** Vax C compiler bugs affecting Emacs.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3641
Dave Love <fx@gnu.org>
parents:
diff changeset
3642 You may get one of these problems compiling Emacs:
Dave Love <fx@gnu.org>
parents:
diff changeset
3643
Dave Love <fx@gnu.org>
parents:
diff changeset
3644 foo.c line nnn: compiler error: no table entry for op STASG
Dave Love <fx@gnu.org>
parents:
diff changeset
3645 foo.c: fatal error in /lib/ccom
Dave Love <fx@gnu.org>
parents:
diff changeset
3646
Dave Love <fx@gnu.org>
parents:
diff changeset
3647 These are due to bugs in the C compiler; the code is valid C.
Dave Love <fx@gnu.org>
parents:
diff changeset
3648 Unfortunately, the bugs are unpredictable: the same construct
Dave Love <fx@gnu.org>
parents:
diff changeset
3649 may compile properly or trigger one of these bugs, depending
Dave Love <fx@gnu.org>
parents:
diff changeset
3650 on what else is in the source file being compiled. Even changes
Dave Love <fx@gnu.org>
parents:
diff changeset
3651 in header files that should not affect the file being compiled
Dave Love <fx@gnu.org>
parents:
diff changeset
3652 can affect whether the bug happens. In addition, sometimes files
Dave Love <fx@gnu.org>
parents:
diff changeset
3653 that compile correctly on one machine get this bug on another machine.
Dave Love <fx@gnu.org>
parents:
diff changeset
3654
Dave Love <fx@gnu.org>
parents:
diff changeset
3655 As a result, it is hard for me to make sure this bug will not affect
Dave Love <fx@gnu.org>
parents:
diff changeset
3656 you. I have attempted to find and alter these constructs, but more
Dave Love <fx@gnu.org>
parents:
diff changeset
3657 can always appear. However, I can tell you how to deal with it if it
Dave Love <fx@gnu.org>
parents:
diff changeset
3658 should happen. The bug comes from having an indexed reference to an
Dave Love <fx@gnu.org>
parents:
diff changeset
3659 array of Lisp_Objects, as an argument in a function call:
Dave Love <fx@gnu.org>
parents:
diff changeset
3660 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3661 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3662 ... foo (5, args[i], ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3663 putting the argument into a temporary variable first, as in
Dave Love <fx@gnu.org>
parents:
diff changeset
3664 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3665 Lisp_Object tem;
Dave Love <fx@gnu.org>
parents:
diff changeset
3666 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3667 tem = args[i];
Dave Love <fx@gnu.org>
parents:
diff changeset
3668 ... foo (r, tem, ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3669 causes the problem to go away.
Dave Love <fx@gnu.org>
parents:
diff changeset
3670 The `contents' field of a Lisp vector is an array of Lisp_Objects,
Dave Love <fx@gnu.org>
parents:
diff changeset
3671 so you may see the problem happening with indexed references to that.
Dave Love <fx@gnu.org>
parents:
diff changeset
3672
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3673 ** 68000 C compiler problems
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3674
Dave Love <fx@gnu.org>
parents:
diff changeset
3675 Various 68000 compilers have different problems.
Dave Love <fx@gnu.org>
parents:
diff changeset
3676 These are some that have been observed.
Dave Love <fx@gnu.org>
parents:
diff changeset
3677
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3678 *** Using value of assignment expression on union type loses.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3679 This means that x = y = z; or foo (x = z); does not work
Dave Love <fx@gnu.org>
parents:
diff changeset
3680 if x is of type Lisp_Object.
Dave Love <fx@gnu.org>
parents:
diff changeset
3681
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3682 *** "cannot reclaim" error.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3683
Dave Love <fx@gnu.org>
parents:
diff changeset
3684 This means that an expression is too complicated. You get the correct
Dave Love <fx@gnu.org>
parents:
diff changeset
3685 line number in the error message. The code must be rewritten with
Dave Love <fx@gnu.org>
parents:
diff changeset
3686 simpler expressions.
Dave Love <fx@gnu.org>
parents:
diff changeset
3687
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3688 *** XCONS, XSTRING, etc macros produce incorrect code.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3689
Dave Love <fx@gnu.org>
parents:
diff changeset
3690 If temacs fails to run at all, this may be the cause.
Dave Love <fx@gnu.org>
parents:
diff changeset
3691 Compile this test program and look at the assembler code:
Dave Love <fx@gnu.org>
parents:
diff changeset
3692
Dave Love <fx@gnu.org>
parents:
diff changeset
3693 struct foo { char x; unsigned int y : 24; };
Dave Love <fx@gnu.org>
parents:
diff changeset
3694
Dave Love <fx@gnu.org>
parents:
diff changeset
3695 lose (arg)
Dave Love <fx@gnu.org>
parents:
diff changeset
3696 struct foo arg;
Dave Love <fx@gnu.org>
parents:
diff changeset
3697 {
Dave Love <fx@gnu.org>
parents:
diff changeset
3698 test ((int *) arg.y);
Dave Love <fx@gnu.org>
parents:
diff changeset
3699 }
Dave Love <fx@gnu.org>
parents:
diff changeset
3700
Dave Love <fx@gnu.org>
parents:
diff changeset
3701 If the code is incorrect, your compiler has this problem.
Dave Love <fx@gnu.org>
parents:
diff changeset
3702 In the XCONS, etc., macros in lisp.h you must replace (a).u.val with
Dave Love <fx@gnu.org>
parents:
diff changeset
3703 ((a).u.val + coercedummy) where coercedummy is declared as int.
Dave Love <fx@gnu.org>
parents:
diff changeset
3704
Dave Love <fx@gnu.org>
parents:
diff changeset
3705 This problem will not happen if the m-...h file for your type
Dave Love <fx@gnu.org>
parents:
diff changeset
3706 of machine defines NO_UNION_TYPE. That is the recommended setting now.
Dave Love <fx@gnu.org>
parents:
diff changeset
3707
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3708 *** C compilers lose on returning unions.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3709
Dave Love <fx@gnu.org>
parents:
diff changeset
3710 I hear that some C compilers cannot handle returning a union type.
Dave Love <fx@gnu.org>
parents:
diff changeset
3711 Most of the functions in GNU Emacs return type Lisp_Object, which is
Dave Love <fx@gnu.org>
parents:
diff changeset
3712 defined as a union on some rare architectures.
Dave Love <fx@gnu.org>
parents:
diff changeset
3713
Dave Love <fx@gnu.org>
parents:
diff changeset
3714 This problem will not happen if the m-...h file for your type
Dave Love <fx@gnu.org>
parents:
diff changeset
3715 of machine defines NO_UNION_TYPE.
Dave Love <fx@gnu.org>
parents:
diff changeset
3716
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3717
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3718 This file is part of GNU Emacs.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3719
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3720 GNU Emacs is free software; you can redistribute it and/or modify
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3721 it under the terms of the GNU General Public License as published by
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3722 the Free Software Foundation; either version 2, or (at your option)
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3723 any later version.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3724
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3725 GNU Emacs is distributed in the hope that it will be useful,
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3726 but WITHOUT ANY WARRANTY; without even the implied warranty of
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3727 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3728 GNU General Public License for more details.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3729
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3730 You should have received a copy of the GNU General Public License
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3731 along with GNU Emacs; see the file COPYING. If not, write to the
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3732 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3733 Boston, MA 02110-1301, USA.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3734
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3735
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3736 Local variables:
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3737 mode: outline
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3738 paragraph-separate: "[ ]*$"
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3739 end:
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3740
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3741 arch-tag: 49fc0d95-88cb-4715-b21c-f27fb5a4764a