annotate etc/PROBLEMS @ 91512:bc1d66655d41

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