annotate etc/PROBLEMS @ 85114:5039706521c9

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