annotate etc/PROBLEMS @ 111725:f861f9db770a

nnmail.el (nnmail-expiry-target-group): Protect against degenerate results from -accept-article.
author Katsumi Yamaoka <yamaoka@jpl.org>
date Fri, 26 Nov 2010 02:37:23 +0000
parents b2ce1b10b56f
children 707234851c48
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
92354
8b003678b429 Add header line.
Kim F. Storm <storm@cua.dk>
parents: 92148
diff changeset
1 Known Problems with GNU Emacs
8b003678b429 Add header line.
Kim F. Storm <storm@cua.dk>
parents: 92148
diff changeset
2
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3 Copyright (C) 1987, 1988, 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 106498
diff changeset
4 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
5 Free Software Foundation, Inc.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
6 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
7
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
8
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
9 This file describes various problems that have been encountered
101543
3c4f4b1a448b Fix initial comment on outline mode.
Glenn Morris <rgm@gnu.org>
parents: 101445
diff changeset
10 in compiling, installing and running GNU Emacs. Try doing C-c C-t
3c4f4b1a448b Fix initial comment on outline mode.
Glenn Morris <rgm@gnu.org>
parents: 101445
diff changeset
11 and browsing through the outline headers. (See C-h m for help on
108799
595ee9e6c0e6 * etc/PROBLEMS: Remove old information no longer of relevance.
Glenn Morris <rgm@gnu.org>
parents: 108798
diff changeset
12 Outline mode.) Information about systems that are no longer supported,
595ee9e6c0e6 * etc/PROBLEMS: Remove old information no longer of relevance.
Glenn Morris <rgm@gnu.org>
parents: 108798
diff changeset
13 and old Emacs releases, has been removed. Consult older versions of
595ee9e6c0e6 * etc/PROBLEMS: Remove old information no longer of relevance.
Glenn Morris <rgm@gnu.org>
parents: 108798
diff changeset
14 this file if you are interested in that information.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
15
90104
a01e7a9f1659 Revision: miles@gnu.org--gnu-2005/emacs--unicode--0--patch-14
Miles Bader <miles@gnu.org>
parents: 90103
diff changeset
16 * Mule-UCS doesn't work in Emacs 23.
89502
faa5bc8e8516 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 88123
diff changeset
17
faa5bc8e8516 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 88123
diff changeset
18 It's completely redundant now, as far as we know.
faa5bc8e8516 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 88123
diff changeset
19
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
20 * Emacs startup failures
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
21
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
22 ** 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
23
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
24 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
25
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
26 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
27
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
28 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
29 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
30 are:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
31
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
32 - in your ~/.Xdefaults file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
33
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
34 - 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
35 /usr/X11R6/lib/app-defaults/Emacs or
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
36 /usr/X11R6/lib/X11/app-defaults/Emacs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
37
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
38 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
39 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
40 the problematic line(s) and correct them.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
41
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
42 ** 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
43
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
44 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
45 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
46 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
47 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
48 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
49 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
50 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
51 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
52 not to work.
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 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
55 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
56 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
57 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
58
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
59 ** 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
60
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
61 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
62 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
63 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
64 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
65 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
66 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
67
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
68 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
69 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
70 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
71 it constitutes a separate package.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
72
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
73 ** 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
74
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
75 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
76
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
77 "Cannot open load file: fontset"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
78
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
79 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
80 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
81 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
82 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
83 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
84 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
85 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
86
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
87 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
88 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
89
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
90 The solution is to uncompress all .el files that don't have a .elc file.
56734
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 Another possible reason for such failures is stale *.elc files
108800
697926009964 * etc/PROBLEMS: Remove some more old information.
Glenn Morris <rgm@gnu.org>
parents: 108799
diff changeset
93 lurking somewhere on your load-path -- see the next section.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
94
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
95 ** 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
96
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
97 An example of such an error is:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
98
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
99 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
100
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
101 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
102 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
103 present in load-path:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
104
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
105 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
106
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
107 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
108 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
109 load-path.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
110
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
111 ** 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
112
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
113 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
114
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
115 --- 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
116 +++ 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
117 @@ -1,4 +1,4 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
118 -/* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
119 +/* $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
120 /******************************************************************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
121
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
122 Copyright 1992, 1993, 1994 by FUJITSU LIMITED
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
123 @@ -166,8 +166,8 @@
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
124 _XimMakeImName(lcd)
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
125 XLCd lcd;
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
126 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
127 - char* begin;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
128 - char* end;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
129 + char* begin = NULL;
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
130 + char* end = NULL;
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
131 char* ret;
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
132 int i = 0;
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
133 char* ximmodifier = XIMMODIFIER;
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
134 @@ -182,7 +182,11 @@
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
135 }
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
136 ret = Xmalloc(end - begin + 2);
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
137 if (ret != NULL) {
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
138 - (void)strncpy(ret, begin, end - begin + 1);
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
139 + if (begin != NULL) {
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
140 + (void)strncpy(ret, begin, end - begin + 1);
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
141 + } else {
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
142 + ret[0] = '\0';
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
143 + }
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
144 ret[end - begin + 1] = '\0';
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
145 }
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
146 return ret;
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
147
77765
294f1fe2765d Add "Emacs crashes on startup after a glibc upgrade."
Chong Yidong <cyd@stupidchicken.com>
parents: 77746
diff changeset
148 ** 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
149
294f1fe2765d Add "Emacs crashes on startup after a glibc upgrade."
Chong Yidong <cyd@stupidchicken.com>
parents: 77746
diff changeset
150 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
151 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
152 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
153
77766
811d56edd3fc Fix typo.
Chong Yidong <cyd@stupidchicken.com>
parents: 77765
diff changeset
154 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
155 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
156 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
157 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
158 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
159
294f1fe2765d Add "Emacs crashes on startup after a glibc upgrade."
Chong Yidong <cyd@stupidchicken.com>
parents: 77746
diff changeset
160 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
161
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
162 * Crash bugs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
163
108364
243bfb706af1 Add check for buggy version of GCC (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 108359
diff changeset
164 ** Emacs crashes when running in a terminal, if compiled with GCC 4.5.0
108359
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
165 This version of GCC is buggy: see
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
166
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
167 http://debbugs.gnu.org/cgi/bugreport.cgi?bug=6031
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
168 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=43904
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
169
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
170 You can work around this error in gcc-4.5 by omitting sibling call
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
171 optimization. To do this, configure Emacs with
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
172
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
173 CFLAGS="-g -O2 -fno-optimize-sibling-calls" ./configure
5c0ae0e21681 * PROBLEMS: Document gcc-4.5 bug (Bug#6031).
Chong Yidong <cyd@stupidchicken.com>
parents: 107685
diff changeset
174
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
175 ** Emacs crashes in x-popup-dialog.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
176
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
177 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
178 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
179 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
180 happens to exist on your X server).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
181
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
182 ** Emacs crashes when you use Bibtex mode.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
183
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
184 This 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
185 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
186 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
187
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
188 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
189 (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
190
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
191 ** 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
192 a segmentation fault and core dump.
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 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
195 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
196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
197 x FILENAME, N bytes, B tape blocks
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
198
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
199 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
200 untar it :-).
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 ** 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
203 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
204 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
205 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
206 older version.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
207
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
208 ** Emacs aborts inside the function `tparam1'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
209
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
210 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
211 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
212 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
213 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
214 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
215
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
216 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
217 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
218 terminfo when built.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
219
103293
ff7c2d7d29e6 Tweak entry about Exceed X server (Bug#3383).
Chong Yidong <cyd@stupidchicken.com>
parents: 102250
diff changeset
220 ** Emacs crashes when using some version of the Exceed X server.
ff7c2d7d29e6 Tweak entry about Exceed X server (Bug#3383).
Chong Yidong <cyd@stupidchicken.com>
parents: 102250
diff changeset
221
ff7c2d7d29e6 Tweak entry about Exceed X server (Bug#3383).
Chong Yidong <cyd@stupidchicken.com>
parents: 102250
diff changeset
222 Upgrading to a newer version of Exceed has been reported to prevent
ff7c2d7d29e6 Tweak entry about Exceed X server (Bug#3383).
Chong Yidong <cyd@stupidchicken.com>
parents: 102250
diff changeset
223 these crashes. You should consider switching to a free X server, such
ff7c2d7d29e6 Tweak entry about Exceed X server (Bug#3383).
Chong Yidong <cyd@stupidchicken.com>
parents: 102250
diff changeset
224 as Xming or Cygwin/X.
56734
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 ** Emacs crashes with SIGSEGV in XtInitializeWidgetClass.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
227
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
228 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
229
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
230 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
231 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
232 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
233 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
234
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
235 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
236 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
237
111178
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
238 ** When Emacs is compiled with Gtk+, closing a display kills Emacs.
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
239
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
240 There is a long-standing bug in GTK that prevents it from recovering
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
241 from disconnects: http://bugzilla.gnome.org/show_bug.cgi?id=85715.
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
242
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
243 Thus, for instance, when Emacs is run as a server on a text terminal,
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
244 and an X frame is created, and the X server for that frame crashes or
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
245 exits unexpectedly, Emacs must exit to prevent a GTK error that would
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
246 result in an endless loop.
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
247
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
248 If you need Emacs to be able to recover from closing displays, compile
b2ce1b10b56f Document GTK Emacs kill on display close in PROBLEMS.
Chong Yidong <cyd@stupidchicken.com>
parents: 109716
diff changeset
249 it with the Lucid toolkit instead of GTK.
100503
27f8c0a5cb19 Added some text about Gtk+ looping when X server dies.
Jan Djärv <jan.h.d@swipnet.se>
parents: 99131
diff changeset
250
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
251 * General runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
252
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
253 ** Lisp problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
254
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
255 *** 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
256
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
257 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
258 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
259 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
260 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
261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
262 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
263 than the corresponding .el file.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
264
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
265 *** 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
266
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
267 These control the actions of Emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
268 ~/.emacs is your Emacs init file.
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
269 EMACSLOADPATH overrides which directories the function "load" will search.
56734
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 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
272 of them, then try again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
273
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
274 *** 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
275
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
276 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
277
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
278 "Lisp nesting exceeds max-lisp-eval-depth"
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 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
281 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
282 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
283 corrects that.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
284
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
285 *** 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
286
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
287 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
288 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
289 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
290
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
291 *** 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
292 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
293 `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
294 '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
295
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
296 ** Keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
297
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
298 *** "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
299
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
300 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
301 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
302 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
303 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
304 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
305 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
306
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
307 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
308 them to two different keys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
309
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
310 *** 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
311
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
312 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
313 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
314 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
315
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
316 *** 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
317 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
318
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
319 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
320 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
321 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
322
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
323 set escape-character 17
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
324
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
325 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
326
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
327 ** Mailers and other helper programs
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
328
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
329 *** 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
330
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
331 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
332 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
333 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
334 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
335 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
336 old POP protocol.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
337
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
338 *** RMAIL gets error getting new mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
339
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
340 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
341 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
342 the protocol defined by /bin/mail.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
343
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
344 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
345 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
346 `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
347 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
348 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
349 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
350 SYSTEM, YOU CAN LOSE MAIL!
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
351
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
352 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
353 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
354 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
355 `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
356 make install.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
357
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
358 chgrp mail movemail
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
359 chmod 2755 movemail
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
360
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
361 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
362 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
363 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
364 /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
365 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
366 directory copy is ineffective.
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 *** 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
369
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
370 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
371 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
372
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
373 ** Problems with hostname resolution
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 *** 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
376 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
377 *** 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
378 *** 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
379
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
380 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
381 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
382 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
383 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
384
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
385 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
386 the nameserver, but Emacs does not.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
387
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
388 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
389 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
390
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
391 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
392 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
393 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
394 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
395 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
396 be careful not to lose the others.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
397
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
398 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
399
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
400 #define LIBS_SYSTEM -lresolv
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
401
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
402 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
403 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
404 again to say this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
405
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
406 #define LIBS_SYSTEM -lresolv -lfoo -lbar
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
407
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
408 *** 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
409
77311
443d25344bd0 Expand a bit on Emacs not knowing fqdn.
Glenn Morris <rgm@gnu.org>
parents: 77186
diff changeset
410 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
411 "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
412
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
413 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
414 (i.e. a name with at least one ".") either in /etc/hosts,
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
415 /etc/hostname, the NIS, or wherever your system calls for specifying this.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
416
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
417 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
418 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
419
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
420 ** NFS and RFS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
421
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
422 *** 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
423 appear on disk.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
424
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
425 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
426 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
427 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
428 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
429 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
430 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
431
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
432 *** 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
433 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
434 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
435 causes it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
436
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
437 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
438 call in the RFS server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
439
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
440 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
441 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
442 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
443 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
444
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
445 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
446
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
447 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
448 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
449 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
450 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
451 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
452 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
453 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
454
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
455 (as always, your line numbers may vary)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
456
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
457 % rcsdiff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
458 RCS file: RCS/serversyscall.c,v
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
459 retrieving revision 1.2
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
460 diff -c -r1.2 serversyscall.c
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
461 *** /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
462 --- 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
463 ***************
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
464 *** 163,169 ****
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
465 /*
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
466 * No return sent for close or fsync!
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
467 */
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
468 ! if (syscall == RSYS_close || syscall == RSYS_fsync)
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
469 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]);
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
470 else
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
471 {
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
472 --- 166,172 ----
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
473 /*
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
474 * No return sent for close or fsync!
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
475 */
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
476 ! if (syscall == RSYS_close)
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
477 proc->p_returnval = deallocate_fd(proc, msg->m_args[0]);
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
478 else
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
479 {
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
480
108800
697926009964 * etc/PROBLEMS: Remove some more old information.
Glenn Morris <rgm@gnu.org>
parents: 108799
diff changeset
481 ** PSGML conflicts with sgml-mode.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
482
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
483 PSGML package uses the same names of some variables (like keymap)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
484 as built-in sgml-mode.el because it was created as a replacement
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
485 of that package. The conflict will be shown if you load
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
486 sgml-mode.el before psgml.el. E.g. this could happen if you edit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
487 HTML page and then start to work with SGML or XML file. html-mode
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
488 (from sgml-mode.el) is used for HTML file and loading of psgml.el
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
489 (for sgml-mode or xml-mode) will cause an error.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
490
60158
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
491 ** PCL-CVS
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
492
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
493 *** Lines are not updated or new lines are added in the buffer upon commit.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
494
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
495 When committing files located higher in the hierarchy than the examined
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
496 directory, some versions of the CVS program return an ambiguous message
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
497 from which PCL-CVS cannot extract the full location of the committed
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
498 files. As a result, the corresponding lines in the PCL-CVS buffer are
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
499 not updated with the new revision of these files, and new lines are
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
500 added to the top-level directory.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
501
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
502 This can happen with CVS versions 1.12.8 and 1.12.9. Upgrade to CVS
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
503 1.12.10 or newer to fix this problem.
7c92649144ac Document problems with PCL-CVS wrt CVS v1.12.8 and 1.12.9.
Eli Zaretskii <eliz@gnu.org>
parents: 59996
diff changeset
504
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
505 ** Miscellaneous problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
506
78982
314950ad601e Mention problems with Semantic.
Eli Zaretskii <eliz@gnu.org>
parents: 78910
diff changeset
507 *** Emacs uses 100% of CPU time
314950ad601e Mention problems with Semantic.
Eli Zaretskii <eliz@gnu.org>
parents: 78910
diff changeset
508
314950ad601e Mention problems with Semantic.
Eli Zaretskii <eliz@gnu.org>
parents: 78910
diff changeset
509 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
510 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
511 with CEDET 1.0pre4) or later.
78982
314950ad601e Mention problems with Semantic.
Eli Zaretskii <eliz@gnu.org>
parents: 78910
diff changeset
512
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
513 *** Self-documentation messages are garbled.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
514
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
515 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
516 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
517 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
518
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
519 *** 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
520 terminal type.
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 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
523 environment variable. The terminal emulator uses that variable to
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
524 provide the information on the special terminal type that Emacs emulates.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
525
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
526 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
527 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
528 it only if it is undefined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
529
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
530 if ( ! ${?TERMCAP} ) setenv TERMCAP ~/my-termcap-file
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
531
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
532 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
533 happen in a non-login shell.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
534
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
535 *** 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
536
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
537 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
538 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
539 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
540 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
541
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
542 if ($?EMACS) then
72833
81a55a7dc3c3 * etc/NEWS: In terminal-oriented subshells, the EMACS environment
Paul Eggert <eggert@twinsun.com>
parents: 72780
diff changeset
543 if ("$EMACS" =~ /*) then
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
544 unset edit
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
545 stty -icrnl -onlcr -echo susp ^Z
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
546 endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
547 endif
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 *** 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
550
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
551 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
552 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
553 /etc/hosts file, something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
554
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
555 127.0.0.1 localhost
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
556 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
557
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
558 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
559
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
560 *** 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
561
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
562 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
563 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
564 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
565 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
566 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
567 ftp client. On a Debian system, type
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
568
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
569 update-alternatives --config ftp
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
570
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
571 and then choose /usr/bin/netkit-ftp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
572
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
573 *** JPEG images aren't displayed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
574
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
575 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
576 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
577 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
578 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
579
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
580 *** Dired is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
581
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
582 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
583 time. Possible reasons for this include:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
584
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
585 - 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
586 response time extremely slow (dozens of seconds);
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
587
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
588 - 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
589
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
590 - slow operation of some versions of `df'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
591
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
592 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
593 `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
594 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
595 (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
596
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
597 *** 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
598
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
599 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
600 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
601 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
602
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
603 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
604
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
605 *** 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
606 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
607 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
608 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
609 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
610
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
611 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
612 process invokes Emacs several times.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
613
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
614 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
615 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
616 can be found.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
617
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
618 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
619 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
620 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
621
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
622 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
623 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
624 backtraces like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
625
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
626 (dbx) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
627 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
628 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
629 ["/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
630 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
631 ["/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
632 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
633 ["/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
634 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
635 ["/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
636
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
637 (`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
638 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
639 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
640 to work around the problem.
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 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
643
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
644 *** 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
645 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
646
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
647 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
648 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
649 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
650
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
651 *** 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
652
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
653 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
654 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
655 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
656 support for 8-bit characters.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
657
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
658 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
659 this at your shell's prompt:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
660
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
661 ispell -vv
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 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
664 "!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
665 does not.
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 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
668 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
669 Then rebuild the speller.
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 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
672 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
673
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
674 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
675 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
676 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
677 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
678 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
679
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
680 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
681 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
682 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
683 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
684
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
685 * Runtime problems related to font handling
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
686
99131
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
687 ** Characters are displayed as empty boxes or with wrong font under X.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
688
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
689 *** This can occur when two different versions of FontConfig are used.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
690 For example, XFree86 4.3.0 has one version and Gnome usually comes
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
691 with a newer version. Emacs compiled with Gtk+ will then use the
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
692 newer version. In most cases the problem can be temporarily fixed by
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
693 stopping the application that has the error (it can be Emacs or any
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
694 other application), removing ~/.fonts.cache-1, and then start the
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
695 application again. If removing ~/.fonts.cache-1 and restarting
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
696 doesn't help, the application with problem must be recompiled with the
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
697 same version of FontConfig as the rest of the system uses. For KDE,
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
698 it is sufficient to recompile Qt.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
699
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
700 *** Some fonts have a missing glyph and no default character. This is
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
701 known to occur for character number 160 (no-break space) in some
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
702 fonts, such as Lucida but Emacs sets the display table for the unibyte
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
703 and Latin-1 version of this character to display a space.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
704
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
705 *** Some of the fonts called for in your fontset may not exist on your
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
706 X server.
56734
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 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
709 supports. To display the whole range of Emacs characters requires
99131
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
710 many different fonts, collected into a fontset. You can remedy the
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
711 problem by installing additional fonts.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
712
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
713 The intlfonts distribution includes a full spectrum of fonts that can
71541
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
714 display all the characters Emacs supports. The etl-unicode collection
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
715 of fonts (available from <URL:ftp://ftp.x.org/contrib/fonts/> and
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
716 <URL:ftp://ftp.xfree86.org/pub/mirror/X.Org/contrib/fonts/>) includes
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
717 fonts that can display many Unicode characters; they can also be used
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
718 by ps-print and ps-mule to print Unicode characters.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
720 ** 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
721
71541
f428905866be Mention etl-unicode fonts in addition to intlfonts.
Eli Zaretskii <eliz@gnu.org>
parents: 71200
diff changeset
722 You may have bad X11 fonts; try installing the intlfonts distribution
99131
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
723 or the etl-unicode collection (see above).
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
724
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
725 ** Under X, an unexpected monospace font is used as the default font.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
726
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
727 When compiled with XFT, Emacs tries to use a default font named
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
728 "monospace". This is a "virtual font", which the operating system
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
729 (Fontconfig) redirects to a suitable font such as DejaVu Sans Mono.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
730 On some systems, there exists a font that is actually named Monospace,
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
731 which takes over the virtual font. This is considered an operating
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
732 system bug; see
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
733
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
734 http://lists.gnu.org/archive/html/emacs-devel/2008-10/msg00696.html
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
735
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
736 If you encounter this problem, set the default font to a specific font
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
737 in your .Xresources or initialization file. For instance, you can put
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
738 the following in your .Xresources:
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
739
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
740 Emacs.font: DejaVu Sans Mono 12
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
741
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
742 ** Certain fonts make each line take one pixel more than it should.
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
743
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
744 This is because these fonts contain characters a little taller than
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
745 the font's nominal height. Emacs needs to make sure that lines do not
f6f4d415536b Document monospace font problems.
Chong Yidong <cyd@stupidchicken.com>
parents: 97990
diff changeset
746 overlap.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
747
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
748 ** Loading fonts is very slow.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
749
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
750 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
751 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
752 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
753 "fonts.scale".
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 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
756 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
757
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
758 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
759 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
760 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
761
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
762 ** 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
763
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
764 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
765 `{' 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
766 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
767 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
768 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
769 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
770 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
771 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
772 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
773 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
774
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
775 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
776 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
777 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
778 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
779
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
780 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
781 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
782 fontification by setting the variable
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
783 `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
784 be done _after_ turning on Font Lock.)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
785
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
786 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
787 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
788
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
789 ** 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
790 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
791
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
792 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
793 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
794 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
795
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
796 ** 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
797
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
798 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
799 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
800 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
801 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
802
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
803 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
804
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
805 emacs.waitForWM: false
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 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
808 frame's parameter list, like this:
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 (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
811
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
812 (this should go into your `.emacs' file).
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 ** Underlines appear at the wrong position.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
815
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
816 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
817 Examples are the font 7x13 on XFree prior to version 4.1, or the jmk
94606
72eafc3867a7 Derek Upham <sand at blarg.net> (tiny change)
Glenn Morris <rgm@gnu.org>
parents: 93759
diff changeset
818 neep font from the Debian xfonts-jmk package prior to version 3.0.17.
72eafc3867a7 Derek Upham <sand at blarg.net> (tiny change)
Glenn Morris <rgm@gnu.org>
parents: 93759
diff changeset
819 To circumvent this problem, set x-use-underline-position-properties
72eafc3867a7 Derek Upham <sand at blarg.net> (tiny change)
Glenn Morris <rgm@gnu.org>
parents: 93759
diff changeset
820 to nil in your `.emacs'.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
821
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
822 To see what is the value of UNDERLINE_POSITION defined by the font,
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
823 type `xlsfonts -lll FONT' and look at the font's UNDERLINE_POSITION property.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
824
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
825 ** 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
826
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
827 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
828 (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
829 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
830 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
831 gives the appearance of "double spacing".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
832
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
833 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
834 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
835
78910
ba829cdc5870 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
836 ** Subscript/superscript text in TeX is hard to read.
ba829cdc5870 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
837
84961
f4c187eb69f2 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
838 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
839 subscript/superscript text in the faces subscript/superscript, which
f4c187eb69f2 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
840 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
841 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
842 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
843 screen), can both make the problem disappear. Alternatively, customize
f4c187eb69f2 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
844 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
845 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
846 normal); tex-suscript-height-minimum (minimum height).
78910
ba829cdc5870 Mention Tex superscript font issue.
Glenn Morris <rgm@gnu.org>
parents: 78677
diff changeset
847
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
848 * Internationalization problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
849
73155
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
850 ** M-{ does not work on a Spanish PC keyboard.
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
851
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
852 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
853 do anything about it.
1428588c2074 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 72833
diff changeset
854
105000
c4fa6fe77406 * PROBLEMS: Document Athena/Lucid internationalization
Chong Yidong <cyd@stupidchicken.com>
parents: 103445
diff changeset
855 ** International characters aren't displayed under X.
c4fa6fe77406 * PROBLEMS: Document Athena/Lucid internationalization
Chong Yidong <cyd@stupidchicken.com>
parents: 103445
diff changeset
856
c4fa6fe77406 * PROBLEMS: Document Athena/Lucid internationalization
Chong Yidong <cyd@stupidchicken.com>
parents: 103445
diff changeset
857 *** Missing X fonts
47994
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
858
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
859 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
860 minimal character repertoires (whereas the encoding part of the font
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
861 name is meant to be a reasonable indication of the repertoire
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
862 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
863 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
864 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
865 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
866 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
867 include in the fontset spec:
47994
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
868
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
869 mule-unicode-2500-33ff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
870 mule-unicode-e000-ffff:-gnu-unifont-*-iso10646-1,\
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
871 mule-unicode-0100-24ff:-gnu-unifont-*-iso10646-1
f0fe517ae1cf XFree86 4 iso10646-1 fonts.
Dave Love <fx@gnu.org>
parents: 47785
diff changeset
872
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
873 ** 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
874
65518
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
875 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
876 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
877 CJK characters belonging to these legacy charsets:
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
878
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
879 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
880
a3cb8f9ce434 Fix the paragraph describing the limitation of
Kenichi Handa <handa@m17n.org>
parents: 65362
diff changeset
881 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
882 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
883 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
884 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
885
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
886 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
887 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
888 (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
889 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
890 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
891 substituted with the Unicode `replacement character', and you lose
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
892 information.
ce710f8e5a48 Correct Unicode stuff.
Dave Love <fx@gnu.org>
parents: 51132
diff changeset
893
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
894 ** 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
895
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
896 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
897 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
898 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
899 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
900 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
901 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
902
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
903 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
904
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
905 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
906
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
907 If this shows only ASCII glyphs, the font is indeed the source of the problem.
34721
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
908
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
909 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
910 `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
911 `xset fp rehash'.
4a8980d062ad Document problems with ISO-8859 fonts which actually include only
Eli Zaretskii <eliz@gnu.org>
parents: 34695
diff changeset
912
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
913 ** 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
914
36813
fcca57f520e5 *** empty log message ***
Dave Love <fx@gnu.org>
parents: 36550
diff changeset
915 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
916 slots now. The current built-in Unicode support is actually more
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
917 flexible. (Use option `utf-translate-cjk-mode' if you need CJK
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
918 support.) Files encoded as emacs-mule using oc-unicode aren't
cd3aedd0c69b utf bits. useXIM.
Dave Love <fx@gnu.org>
parents: 50825
diff changeset
919 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
920
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
921 ** After a while, Emacs slips into unibyte mode.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
922
Dave Love <fx@gnu.org>
parents:
diff changeset
923 The VM mail package, which is not part of Emacs, sometimes does
Dave Love <fx@gnu.org>
parents:
diff changeset
924 (standard-display-european t)
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 49396
diff changeset
925 That should be changed to
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
926 (standard-display-european 1 t)
Dave Love <fx@gnu.org>
parents:
diff changeset
927
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
928 * X runtime problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
929
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
930 ** X keyboard problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
931
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
932 *** You "lose characters" after typing Compose Character key.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
933
Dave Love <fx@gnu.org>
parents:
diff changeset
934 This is because the Compose Character key is defined as the keysym
Dave Love <fx@gnu.org>
parents:
diff changeset
935 Multi_key, and Emacs (seeing that) does the proper X11
Dave Love <fx@gnu.org>
parents:
diff changeset
936 character-composition processing. If you don't want your Compose key
Dave Love <fx@gnu.org>
parents:
diff changeset
937 to do that, you can redefine it with xmodmap.
Dave Love <fx@gnu.org>
parents:
diff changeset
938
Dave Love <fx@gnu.org>
parents:
diff changeset
939 For example, here's one way to turn it into a Meta key:
Dave Love <fx@gnu.org>
parents:
diff changeset
940
Dave Love <fx@gnu.org>
parents:
diff changeset
941 xmodmap -e "keysym Multi_key = Meta_L"
Dave Love <fx@gnu.org>
parents:
diff changeset
942
Dave Love <fx@gnu.org>
parents:
diff changeset
943 If all users at your site of a particular keyboard prefer Meta to
Dave Love <fx@gnu.org>
parents:
diff changeset
944 Compose, you can make the remapping happen automatically by adding the
Dave Love <fx@gnu.org>
parents:
diff changeset
945 xmodmap command to the xdm setup script for that display.
Dave Love <fx@gnu.org>
parents:
diff changeset
946
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
947 *** 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
948
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
949 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
950
69953
6a69cc2e7e0c (C-SPC fails ...): Explicitly say fcitx in the header.
Kenichi Handa <handa@m17n.org>
parents: 69926
diff changeset
951 *** 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
952
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
953 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
954 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
955 from using the C-SPC key for `set-mark-command'.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
956
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
957 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
958 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
959 However, that requires root access.
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
960
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
961 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
962
c1c472b86d74 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 63126
diff changeset
963 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
964
69926
0404d8fab507 (C-SPC fails ...): Add description for fcitx.
Kenichi Handa <handa@m17n.org>
parents: 69398
diff changeset
965 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
966 (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
967 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
968 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
969 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
970
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
971 *** 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
972
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
973 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
974 for character composition.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
975
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
976 *** 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
977
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
978 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
979 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
980 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
981 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
982 purposes.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
983
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
984 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
985 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
986
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
987 *** 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
988
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
989 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
990 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
991 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
992 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
993 change this.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
994
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
995 *** 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
996
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
997 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
998 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
999 --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
1000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1001 *** Inability to send an Alt-modified key, when Emacs is communicating
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1002 directly with an X server.
Dave Love <fx@gnu.org>
parents:
diff changeset
1003
Dave Love <fx@gnu.org>
parents:
diff changeset
1004 If you have tried to bind an Alt-modified key as a command, and it
Dave Love <fx@gnu.org>
parents:
diff changeset
1005 does not work to type the command, the first thing you should check is
Dave Love <fx@gnu.org>
parents:
diff changeset
1006 whether the key is getting through to Emacs. To do this, type C-h c
Dave Love <fx@gnu.org>
parents:
diff changeset
1007 followed by the Alt-modified key. C-h c should say what kind of event
Dave Love <fx@gnu.org>
parents:
diff changeset
1008 it read. If it says it read an Alt-modified key, then make sure you
Dave Love <fx@gnu.org>
parents:
diff changeset
1009 have made the key binding correctly.
Dave Love <fx@gnu.org>
parents:
diff changeset
1010
Dave Love <fx@gnu.org>
parents:
diff changeset
1011 If C-h c reports an event that doesn't have the Alt modifier, it may
Dave Love <fx@gnu.org>
parents:
diff changeset
1012 be because your X server has no key for the Alt modifier. The X
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1013 server that comes from MIT does not set up the Alt modifier by default.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1014
Dave Love <fx@gnu.org>
parents:
diff changeset
1015 If your keyboard has keys named Alt, you can enable them as follows:
Dave Love <fx@gnu.org>
parents:
diff changeset
1016
Dave Love <fx@gnu.org>
parents:
diff changeset
1017 xmodmap -e 'add mod2 = Alt_L'
Dave Love <fx@gnu.org>
parents:
diff changeset
1018 xmodmap -e 'add mod2 = Alt_R'
Dave Love <fx@gnu.org>
parents:
diff changeset
1019
Dave Love <fx@gnu.org>
parents:
diff changeset
1020 If the keyboard has just one key named Alt, then only one of those
Dave Love <fx@gnu.org>
parents:
diff changeset
1021 commands is needed. The modifier `mod2' is a reasonable choice if you
Dave Love <fx@gnu.org>
parents:
diff changeset
1022 are using an unmodified MIT version of X. Otherwise, choose any
Dave Love <fx@gnu.org>
parents:
diff changeset
1023 modifier bit not otherwise used.
Dave Love <fx@gnu.org>
parents:
diff changeset
1024
Dave Love <fx@gnu.org>
parents:
diff changeset
1025 If your keyboard does not have keys named Alt, you can use some other
Dave Love <fx@gnu.org>
parents:
diff changeset
1026 keys. Use the keysym command in xmodmap to turn a function key (or
Dave Love <fx@gnu.org>
parents:
diff changeset
1027 some other 'spare' key) into Alt_L or into Alt_R, and then use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1028 commands show above to make them modifier keys.
Dave Love <fx@gnu.org>
parents:
diff changeset
1029
Dave Love <fx@gnu.org>
parents:
diff changeset
1030 Note that if you have Alt keys but no Meta keys, Emacs translates Alt
Dave Love <fx@gnu.org>
parents:
diff changeset
1031 into Meta. This is because of the great importance of Meta in Emacs.
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 ** Window-manager and toolkit-related problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1034
106268
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1035 *** Metacity: Resizing Emacs or ALT-Tab causes X to be unresponsive.
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1036
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1037 This happens sometimes when using Metacity. Resizing Emacs or ALT-Tab:bing
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1038 makes the system unresponsive to the mouse or the keyboard. Killing Emacs
109478
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
1039 or shifting out from X11 and back again usually cures it (i.e. Ctrl-Alt-F1
106268
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1040 and then Alt-F7). A bug for it is here:
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1041 https://bugs.launchpad.net/ubuntu/+source/metacity/+bug/231034.
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1042 Note that a permanent fix seems to be to disable "assistive technologies".
da7a85775258 Mention Metacity hang on Emacs resize.
Jan Djärv <jan.h.d@swipnet.se>
parents: 106175
diff changeset
1043
73196
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1044 *** 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
1045
8c94e11c22ec * PROBLEMS: Document Emacs/XIM/gnome-settings-terminal clash.
Chong Yidong <cyd@stupidchicken.com>
parents: 73155
diff changeset
1046 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
1047 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
1048 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
1049 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
1050 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
1051 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
1052
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1053 *** 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
1054
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1055 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
1056 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
1057 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
1058 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
1059 been filed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1060
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1061 *** 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
1062 or messed up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1063
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1064 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
1065 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
1066 background.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1067
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1068 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
1069 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
1070 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
1071 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
1072 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
1073
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1074 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
1075 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
1076 (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
1077 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
1078 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
1079 present or commented out:
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 Emacs.default.attributeForeground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1082 Emacs.default.attributeBackground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1083 Emacs*Foreground
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1084 Emacs*Background
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1085
78119
2d028479c671 Mention gtk-engines-qt problem.
Jan Djärv <jan.h.d@swipnet.se>
parents: 78014
diff changeset
1086 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
1087 Emacs is compiled with Gtk+.
2d028479c671 Mention gtk-engines-qt problem.
Jan Djärv <jan.h.d@swipnet.se>
parents: 78014
diff changeset
1088 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
1089
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1090 *** 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
1091
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1092 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
1093 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
1094 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
1095 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
1096 while, Emacs may print a message:
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1097
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1098 Timed out waiting for property-notify event
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1099
58825
a1e4505728bf * PROBLEMS: Update information about klipper on KDE.
Jan Djärv <jan.h.d@swipnet.se>
parents: 57229
diff changeset
1100 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
1101 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
1102
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1103 *** 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
1104
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1105 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
1106 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
1107 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
1108 and uncheck "Allow Primary Windows On Top".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1109
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1110 *** 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
1111 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
1112 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
1113 problem disappears.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1114
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1115 *** 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
1116 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
1117 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
1118 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
1119 "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
1120 used with neXtaw at run time.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1121
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1122 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
1123 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
1124 built Emacs with.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1125
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1126 *** 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
1127
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1128 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
1129 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
1130 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
1131 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
1132
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1133 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
1134 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
1135
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1136 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
1137 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
1138 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
1139
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1140 *** LessTif: Problems in Emacs built with LessTif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1141
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1142 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
1143 emulation for which it is set up.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1144
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1145 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
1146 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
1147 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
1148 --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
1149 successful. The binary GNU/Linux package
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1150 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
1151 menu placement.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1152
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1153 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
1154 locks up, grabbing all mouse and keyboard events. We still don't know
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1155 what causes these problems; they are not reproducible by Emacs developers.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1156
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1157 *** 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
1158
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1159 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
1160
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1161 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
1162
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1163 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
1164 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
1165 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
1166 the resource prevents the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1167
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1168 ** General X problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1169
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1170 *** 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
1171
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1172 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
1173 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
1174 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
1175 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
1176
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1177 Here's how to do this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1178
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1179 (set-scroll-bar-mode 'right)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1180
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1181 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
1182 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
1183 to normal, do
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1184
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1185 (set-scroll-bar-mode 'left)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1186
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1187 *** Error messages about undefined colors on X.
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 The messages might say something like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1190
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1191 Unable to load color "grey95"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1192
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1193 (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
1194
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1195 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
1196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1197 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
1198 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
1199 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
1200
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1201 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
1202
69398
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1203 "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
1204 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
1205 X expects to find it.
15b9fd17967e *** empty log message ***
Eli Zaretskii <eliz@gnu.org>
parents: 68771
diff changeset
1206
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1207 *** Improving performance with slow X connections.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1208
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1209 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
1210 be carried out at the same time:
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 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
1213 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
1214 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
1215 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
1216 package.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1217
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1218 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
1219 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
1220 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
1221 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
1222
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1223 (scroll-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1224 (menu-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1225 (tool-bar-mode -1)
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1226
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1227 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
1228 file:
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1229
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1230 Emacs.verticalScrollBars: off
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1231 Emacs.menuBar: off
34fa35e88871 More details about disabling features that hamper performance with slow
Eli Zaretskii <eliz@gnu.org>
parents: 75343
diff changeset
1232 Emacs.toolBar: off
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1233
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1234 3) Use ssh to forward the X connection, and enable compression on this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1235 forwarded X connection (ssh -XC remotehostname emacs ...).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1236
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1237 4) Use lbxproxy on the remote end of the connection. This is an interface
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1238 to the low bandwidth X extension in most modern X servers, which
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1239 improves performance dramatically, at the slight expense of correctness
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1240 of the X protocol. lbxproxy acheives the performance gain by grouping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1241 several X requests in one TCP packet and sending them off together,
77139
8658cdd16704 Fix some typos.
Glenn Morris <rgm@gnu.org>
parents: 77076
diff changeset
1242 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
1243 packet. The switches that seem to work best for emacs are:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1244 -noatomsfile -nowinattr -cheaterrors -cheatevents
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1245 Note that the -nograbcmap option is known to cause problems.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1246 For more about lbxproxy, see:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1247 http://www.xfree86.org/4.3.0/lbxproxy.1.html
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1248
73631
4ec24926fb8f Add Tip to speed up copy/kill for remote X session.
Kim F. Storm <storm@cua.dk>
parents: 73196
diff changeset
1249 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
1250 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
1251 (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
1252 (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
1253
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1254 *** 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
1255
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1256 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
1257 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
1258 likely to cause it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1259
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1260 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
1261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1262 *** 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
1263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1264 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
1265 that replacing the mouse made it stop.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1266
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1267 *** 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
1268
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1269 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
1270 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
1271 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
1272 the Files menu).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1273
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1274 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
1275 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
1276 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
1277 workaround can be found.
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 *** 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
1280 parameter attributes) on protocol request 93'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1281
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1282 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
1283 emacs*Cursor: black
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1284 (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
1285 that isn't a color.)
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 fix is to correct your X resources.
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 *** Slow startup on X11R6 with X windows.
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 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
1292 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
1293 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
1294 font.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1295
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1296 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
1297 your font path, like this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1298
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1299 xset -fp /usr/X11R6/lib/X11/fonts/Type1/
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1300
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1301 *** 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
1302
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1303 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
1304
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1305 Emacs*geometry: 80x55+0+0
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 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
1308 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
1309 want, rewrite the resource.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1310
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1311 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
1312 -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
1313 the user's ~/.Xdefaults and ~/.Xdefaults-* files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1314
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1315 *** Emacs 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
1316 *** `emacs -geometry 80x20' finds a file named `80x20'.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1317
Dave Love <fx@gnu.org>
parents:
diff changeset
1318 One cause of such problems is having (setq term-file-prefix nil) in
Dave Love <fx@gnu.org>
parents:
diff changeset
1319 your .emacs file. Another cause is a bad value of EMACSLOADPATH in
Dave Love <fx@gnu.org>
parents:
diff changeset
1320 the environment.
Dave Love <fx@gnu.org>
parents:
diff changeset
1321
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1322 *** X Windows doesn't work if DISPLAY uses a hostname.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1323
Dave Love <fx@gnu.org>
parents:
diff changeset
1324 People have reported kernel bugs in certain systems that cause Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1325 not to work with X Windows if DISPLAY is set using a host name. But
Dave Love <fx@gnu.org>
parents:
diff changeset
1326 the problem does not occur if DISPLAY is set to `unix:0.0'. I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1327 the bug has to do with SIGIO or FIONREAD.
Dave Love <fx@gnu.org>
parents:
diff changeset
1328
Dave Love <fx@gnu.org>
parents:
diff changeset
1329 You may be able to compensate for the bug by doing (set-input-mode nil nil).
Dave Love <fx@gnu.org>
parents:
diff changeset
1330 However, that has the disadvantage of turning off interrupts, so that
Dave Love <fx@gnu.org>
parents:
diff changeset
1331 you are unable to quit out of a Lisp program by typing C-g.
Dave Love <fx@gnu.org>
parents:
diff changeset
1332
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1333 *** Prevent double pastes in X
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1334
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1335 The problem: a region, such as a command, is pasted twice when you copy
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1336 it with your mouse from GNU Emacs to an xterm or an RXVT shell in X.
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1337 The solution: try the following in your X configuration file,
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1338 /etc/X11/xorg.conf This should enable both PS/2 and USB mice for
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1339 single copies. You do not need any other drivers or options.
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1340
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1341 Section "InputDevice"
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1342 Identifier "Generic Mouse"
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1343 Driver "mousedev"
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1344 Option "Device" "/dev/input/mice"
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1345 EndSection
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1346
77139
8658cdd16704 Fix some typos.
Glenn Morris <rgm@gnu.org>
parents: 77076
diff changeset
1347 * Runtime problems on character terminals
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1348
107518
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1349 ** The meta key does not work on xterm.
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1350 Typing M-x rings the terminal bell, and inserts a string like ";120~".
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1351 For recent xterm versions (>= 216), Emacs uses xterm's modifyOtherKeys
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1352 feature to generate strings for key combinations that are not
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1353 otherwise usable. One circumstance in which this can cause problems
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1354 is if you have specified the X resource
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1355
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1356 xterm*VT100.Translations
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1357
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1358 to contain translations that use the meta key. Then xterm will not
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1359 use meta in modified function-keys, which confuses Emacs. To fix
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1360 this, you can remove the X resource or put this in your init file:
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1361
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1362 (xterm-remove-modify-other-keys)
ca9132805f76 Document Bug#5541.
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
1363
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1364 ** Emacs spontaneously displays "I-search: " at the bottom of the screen.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1365
Dave Love <fx@gnu.org>
parents:
diff changeset
1366 This means that Control-S/Control-Q (XON/XOFF) "flow control" is being
Dave Love <fx@gnu.org>
parents:
diff changeset
1367 used. C-s/C-q flow control is bad for Emacs editors because it takes
Dave Love <fx@gnu.org>
parents:
diff changeset
1368 away C-s and C-q as user commands. Since editors do not output long
Dave Love <fx@gnu.org>
parents:
diff changeset
1369 streams of text without user commands, there is no need for a
Dave Love <fx@gnu.org>
parents:
diff changeset
1370 user-issuable "stop output" command in an editor; therefore, a
Dave Love <fx@gnu.org>
parents:
diff changeset
1371 properly designed flow control mechanism would transmit all possible
Dave Love <fx@gnu.org>
parents:
diff changeset
1372 input characters without interference. Designing such a mechanism is
Dave Love <fx@gnu.org>
parents:
diff changeset
1373 easy, for a person with at least half a brain.
Dave Love <fx@gnu.org>
parents:
diff changeset
1374
Dave Love <fx@gnu.org>
parents:
diff changeset
1375 There are three possible reasons why flow control could be taking place:
Dave Love <fx@gnu.org>
parents:
diff changeset
1376
Dave Love <fx@gnu.org>
parents:
diff changeset
1377 1) Terminal has not been told to disable flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1378 2) Insufficient padding for the terminal in use
Dave Love <fx@gnu.org>
parents:
diff changeset
1379 3) Some sort of terminal concentrator or line switch is responsible
Dave Love <fx@gnu.org>
parents:
diff changeset
1380
Dave Love <fx@gnu.org>
parents:
diff changeset
1381 First of all, many terminals have a set-up mode which controls whether
Dave Love <fx@gnu.org>
parents:
diff changeset
1382 they generate XON/XOFF flow control characters. This must be set to
103445
a53a6689e178 Merge in a few snippets just deleted from faq.texi.
Glenn Morris <rgm@gnu.org>
parents: 103293
diff changeset
1383 "no XON/XOFF" in order for Emacs to work. (For example, on a VT220
a53a6689e178 Merge in a few snippets just deleted from faq.texi.
Glenn Morris <rgm@gnu.org>
parents: 103293
diff changeset
1384 you may select "No XOFF" in the setup menu.) Sometimes there is an
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1385 escape sequence that the computer can send to turn flow control off
Dave Love <fx@gnu.org>
parents:
diff changeset
1386 and on. If so, perhaps the termcap `ti' string should turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1387 control off, and the `te' string should turn it on.
Dave Love <fx@gnu.org>
parents:
diff changeset
1388
Dave Love <fx@gnu.org>
parents:
diff changeset
1389 Once the terminal has been told "no flow control", you may find it
Dave Love <fx@gnu.org>
parents:
diff changeset
1390 needs more padding. The amount of padding Emacs sends is controlled
Dave Love <fx@gnu.org>
parents:
diff changeset
1391 by the termcap entry for the terminal in use, and by the output baud
Dave Love <fx@gnu.org>
parents:
diff changeset
1392 rate as known by the kernel. The shell command `stty' will print
Dave Love <fx@gnu.org>
parents:
diff changeset
1393 your output baud rate; `stty' with suitable arguments will set it if
Dave Love <fx@gnu.org>
parents:
diff changeset
1394 it is wrong. Setting to a higher speed causes increased padding. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1395 the results are wrong for the correct speed, there is probably a
Dave Love <fx@gnu.org>
parents:
diff changeset
1396 problem in the termcap entry. You must speak to a local Unix wizard
Dave Love <fx@gnu.org>
parents:
diff changeset
1397 to fix this. Perhaps you are just using the wrong terminal type.
Dave Love <fx@gnu.org>
parents:
diff changeset
1398
Dave Love <fx@gnu.org>
parents:
diff changeset
1399 For terminals that lack a "no flow control" mode, sometimes just
Dave Love <fx@gnu.org>
parents:
diff changeset
1400 giving lots of padding will prevent actual generation of flow control
Dave Love <fx@gnu.org>
parents:
diff changeset
1401 codes. You might as well try it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1402
Dave Love <fx@gnu.org>
parents:
diff changeset
1403 If you are really unlucky, your terminal is connected to the computer
Dave Love <fx@gnu.org>
parents:
diff changeset
1404 through a concentrator which sends XON/XOFF flow control to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1405 computer, or it insists on sending flow control itself no matter how
Dave Love <fx@gnu.org>
parents:
diff changeset
1406 much padding you give it. Unless you can figure out how to turn flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1407 control off on this concentrator (again, refer to your local wizard),
Dave Love <fx@gnu.org>
parents:
diff changeset
1408 you are screwed! You should have the terminal or concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1409 replaced with a properly designed one. In the mean time, some drastic
Dave Love <fx@gnu.org>
parents:
diff changeset
1410 measures can make Emacs semi-work.
Dave Love <fx@gnu.org>
parents:
diff changeset
1411
Dave Love <fx@gnu.org>
parents:
diff changeset
1412 You can make Emacs ignore C-s and C-q and let the operating system
Dave Love <fx@gnu.org>
parents:
diff changeset
1413 handle them. To do this on a per-session basis, just type M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1414 enable-flow-control RET. You will see a message that C-\ and C-^ are
Dave Love <fx@gnu.org>
parents:
diff changeset
1415 now translated to C-s and C-q. (Use the same command M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
1416 enable-flow-control to turn *off* this special mode. It toggles flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1417 control handling.)
Dave Love <fx@gnu.org>
parents:
diff changeset
1418
Dave Love <fx@gnu.org>
parents:
diff changeset
1419 If C-\ and C-^ are inconvenient for you (for example, if one of them
Dave Love <fx@gnu.org>
parents:
diff changeset
1420 is the escape character of your terminal concentrator), you can choose
Dave Love <fx@gnu.org>
parents:
diff changeset
1421 other characters by setting the variables flow-control-c-s-replacement
Dave Love <fx@gnu.org>
parents:
diff changeset
1422 and flow-control-c-q-replacement. But choose carefully, since all
Dave Love <fx@gnu.org>
parents:
diff changeset
1423 other control characters are already used by emacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
1424
Dave Love <fx@gnu.org>
parents:
diff changeset
1425 IMPORTANT: if you type C-s by accident while flow control is enabled,
Dave Love <fx@gnu.org>
parents:
diff changeset
1426 Emacs output will freeze, and you will have to remember to type C-q in
Dave Love <fx@gnu.org>
parents:
diff changeset
1427 order to continue.
Dave Love <fx@gnu.org>
parents:
diff changeset
1428
Dave Love <fx@gnu.org>
parents:
diff changeset
1429 If you work in an environment where a majority of terminals of a
Dave Love <fx@gnu.org>
parents:
diff changeset
1430 certain type are flow control hobbled, you can use the function
Dave Love <fx@gnu.org>
parents:
diff changeset
1431 `enable-flow-control-on' to turn on this flow control avoidance scheme
Dave Love <fx@gnu.org>
parents:
diff changeset
1432 automatically. Here is an example:
Dave Love <fx@gnu.org>
parents:
diff changeset
1433
Dave Love <fx@gnu.org>
parents:
diff changeset
1434 (enable-flow-control-on "vt200" "vt300" "vt101" "vt131")
Dave Love <fx@gnu.org>
parents:
diff changeset
1435
Dave Love <fx@gnu.org>
parents:
diff changeset
1436 If this isn't quite correct (e.g. you have a mixture of flow-control hobbled
Dave Love <fx@gnu.org>
parents:
diff changeset
1437 and good vt200 terminals), you can still run enable-flow-control
Dave Love <fx@gnu.org>
parents:
diff changeset
1438 manually.
Dave Love <fx@gnu.org>
parents:
diff changeset
1439
Dave Love <fx@gnu.org>
parents:
diff changeset
1440 I have no intention of ever redesigning the Emacs command set for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1441 assumption that terminals use C-s/C-q flow control. XON/XOFF flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1442 control technique is a bad design, and terminals that need it are bad
Dave Love <fx@gnu.org>
parents:
diff changeset
1443 merchandise and should not be purchased. Now that X is becoming
Dave Love <fx@gnu.org>
parents:
diff changeset
1444 widespread, XON/XOFF seems to be on the way out. If you can get some
Dave Love <fx@gnu.org>
parents:
diff changeset
1445 use out of GNU Emacs on inferior terminals, more power to you, but I
Dave Love <fx@gnu.org>
parents:
diff changeset
1446 will not make Emacs worse for properly designed systems for the sake
Dave Love <fx@gnu.org>
parents:
diff changeset
1447 of inferior systems.
Dave Love <fx@gnu.org>
parents:
diff changeset
1448
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1449 ** Control-S and Control-Q commands are ignored completely.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1450
Dave Love <fx@gnu.org>
parents:
diff changeset
1451 For some reason, your system is using brain-damaged C-s/C-q flow
Dave Love <fx@gnu.org>
parents:
diff changeset
1452 control despite Emacs's attempts to turn it off. Perhaps your
Dave Love <fx@gnu.org>
parents:
diff changeset
1453 terminal is connected to the computer through a concentrator
Dave Love <fx@gnu.org>
parents:
diff changeset
1454 that wants to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1455
Dave Love <fx@gnu.org>
parents:
diff changeset
1456 You should first try to tell the concentrator not to use flow control.
Dave Love <fx@gnu.org>
parents:
diff changeset
1457 If you succeed in this, try making the terminal work without
Dave Love <fx@gnu.org>
parents:
diff changeset
1458 flow control, as described in the preceding section.
Dave Love <fx@gnu.org>
parents:
diff changeset
1459
Dave Love <fx@gnu.org>
parents:
diff changeset
1460 If that line of approach is not successful, map some other characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1461 into C-s and C-q using keyboard-translate-table. The example above
Dave Love <fx@gnu.org>
parents:
diff changeset
1462 shows how to do this with C-^ and C-\.
Dave Love <fx@gnu.org>
parents:
diff changeset
1463
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1464 ** Screen is updated wrong, but only on one kind of terminal.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1465
Dave Love <fx@gnu.org>
parents:
diff changeset
1466 This could mean that the termcap entry you are using for that
Dave Love <fx@gnu.org>
parents:
diff changeset
1467 terminal is wrong, or it could mean that Emacs has a bug handing
Dave Love <fx@gnu.org>
parents:
diff changeset
1468 the combination of features specified for that terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1469
Dave Love <fx@gnu.org>
parents:
diff changeset
1470 The first step in tracking this down is to record what characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1471 Emacs is sending to the terminal. Execute the Lisp expression
Dave Love <fx@gnu.org>
parents:
diff changeset
1472 (open-termscript "./emacs-script") to make Emacs write all
Dave Love <fx@gnu.org>
parents:
diff changeset
1473 terminal output into the file ~/emacs-script as well; then do
Dave Love <fx@gnu.org>
parents:
diff changeset
1474 what makes the screen update wrong, and look at the file
Dave Love <fx@gnu.org>
parents:
diff changeset
1475 and decode the characters using the manual for the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1476 There are several possibilities:
Dave Love <fx@gnu.org>
parents:
diff changeset
1477
Dave Love <fx@gnu.org>
parents:
diff changeset
1478 1) The characters sent are correct, according to the terminal manual.
Dave Love <fx@gnu.org>
parents:
diff changeset
1479
Dave Love <fx@gnu.org>
parents:
diff changeset
1480 In this case, there is no obvious bug in Emacs, and most likely you
Dave Love <fx@gnu.org>
parents:
diff changeset
1481 need more padding, or possibly the terminal manual is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1482
Dave Love <fx@gnu.org>
parents:
diff changeset
1483 2) The characters sent are incorrect, due to an obscure aspect
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1484 of the terminal behavior not described in an obvious way by termcap.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1485
Dave Love <fx@gnu.org>
parents:
diff changeset
1486 This case is hard. It will be necessary to think of a way for
Dave Love <fx@gnu.org>
parents:
diff changeset
1487 Emacs to distinguish between terminals with this kind of behavior
Dave Love <fx@gnu.org>
parents:
diff changeset
1488 and other terminals that behave subtly differently but are
Dave Love <fx@gnu.org>
parents:
diff changeset
1489 classified the same by termcap; or else find an algorithm for
Dave Love <fx@gnu.org>
parents:
diff changeset
1490 Emacs to use that avoids the difference. Such changes must be
Dave Love <fx@gnu.org>
parents:
diff changeset
1491 tested on many kinds of terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1492
Dave Love <fx@gnu.org>
parents:
diff changeset
1493 3) The termcap entry is wrong.
Dave Love <fx@gnu.org>
parents:
diff changeset
1494
Dave Love <fx@gnu.org>
parents:
diff changeset
1495 See the file etc/TERMS for information on changes
Dave Love <fx@gnu.org>
parents:
diff changeset
1496 that are known to be needed in commonly used termcap entries
Dave Love <fx@gnu.org>
parents:
diff changeset
1497 for certain terminals.
Dave Love <fx@gnu.org>
parents:
diff changeset
1498
Dave Love <fx@gnu.org>
parents:
diff changeset
1499 4) The characters sent are incorrect, and clearly cannot be
Dave Love <fx@gnu.org>
parents:
diff changeset
1500 right for any terminal with the termcap entry you were using.
Dave Love <fx@gnu.org>
parents:
diff changeset
1501
Dave Love <fx@gnu.org>
parents:
diff changeset
1502 This is unambiguously an Emacs bug, and can probably be fixed
Dave Love <fx@gnu.org>
parents:
diff changeset
1503 in termcap.c, tparam.c, term.c, scroll.c, cm.c or dispnew.c.
Dave Love <fx@gnu.org>
parents:
diff changeset
1504
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1505 ** 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
1506
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1507 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
1508 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
1509 On such systems, emacs on the remote system cannot disable flow
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1510 control on the local system. Sometimes `rlogin -8' will avoid this problem.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1511
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1512 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
1513 (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
1514 stty command, before starting the rlogin process. On many systems,
103445
a53a6689e178 Merge in a few snippets just deleted from faq.texi.
Glenn Morris <rgm@gnu.org>
parents: 103293
diff changeset
1515 "stty start u stop u" will do this. On some systems, use
109478
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
1516 "stty -ixon" instead.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1517
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1518 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
1519 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
1520 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
1521
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1522 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
1523 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
1524 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
1525 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
1526
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1527 (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
1528
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1529 See the entry about spontaneous display of I-search (above) for more info.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1530
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1531 ** Output from Control-V is slow.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1532
Dave Love <fx@gnu.org>
parents:
diff changeset
1533 On many bit-map terminals, scrolling operations are fairly slow.
Dave Love <fx@gnu.org>
parents:
diff changeset
1534 Often the termcap entry for the type of terminal in use fails
Dave Love <fx@gnu.org>
parents:
diff changeset
1535 to inform Emacs of this. The two lines at the bottom of the screen
Dave Love <fx@gnu.org>
parents:
diff changeset
1536 before a Control-V command are supposed to appear at the top after
Dave Love <fx@gnu.org>
parents:
diff changeset
1537 the Control-V command. If Emacs thinks scrolling the lines is fast,
Dave Love <fx@gnu.org>
parents:
diff changeset
1538 it will scroll them to the top of the screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
1539
Dave Love <fx@gnu.org>
parents:
diff changeset
1540 If scrolling is slow but Emacs thinks it is fast, the usual reason is
Dave Love <fx@gnu.org>
parents:
diff changeset
1541 that the termcap entry for the terminal you are using does not
Dave Love <fx@gnu.org>
parents:
diff changeset
1542 specify any padding time for the `al' and `dl' strings. Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
1543 concludes that these operations take only as much time as it takes to
Dave Love <fx@gnu.org>
parents:
diff changeset
1544 send the commands at whatever line speed you are using. You must
Dave Love <fx@gnu.org>
parents:
diff changeset
1545 fix the termcap entry to specify, for the `al' and `dl', as much
Dave Love <fx@gnu.org>
parents:
diff changeset
1546 time as the operations really take.
Dave Love <fx@gnu.org>
parents:
diff changeset
1547
Dave Love <fx@gnu.org>
parents:
diff changeset
1548 Currently Emacs thinks in terms of serial lines which send characters
Dave Love <fx@gnu.org>
parents:
diff changeset
1549 at a fixed rate, so that any operation which takes time for the
Dave Love <fx@gnu.org>
parents:
diff changeset
1550 terminal to execute must also be padded. With bit-map terminals
Dave Love <fx@gnu.org>
parents:
diff changeset
1551 operated across networks, often the network provides some sort of
Dave Love <fx@gnu.org>
parents:
diff changeset
1552 flow control so that padding is never needed no matter how slow
Dave Love <fx@gnu.org>
parents:
diff changeset
1553 an operation is. You must still specify a padding time if you want
Dave Love <fx@gnu.org>
parents:
diff changeset
1554 Emacs to realize that the operation takes a long time. This will
Dave Love <fx@gnu.org>
parents:
diff changeset
1555 cause padding characters to be sent unnecessarily, but they do
Dave Love <fx@gnu.org>
parents:
diff changeset
1556 not really cost much. They will be transmitted while the scrolling
Dave Love <fx@gnu.org>
parents:
diff changeset
1557 is happening and then discarded quickly by the terminal.
Dave Love <fx@gnu.org>
parents:
diff changeset
1558
Dave Love <fx@gnu.org>
parents:
diff changeset
1559 Most bit-map terminals provide commands for inserting or deleting
Dave Love <fx@gnu.org>
parents:
diff changeset
1560 multiple lines at once. Define the `AL' and `DL' strings in the
Dave Love <fx@gnu.org>
parents:
diff changeset
1561 termcap entry to say how to do these things, and you will have
Dave Love <fx@gnu.org>
parents:
diff changeset
1562 fast output without wasted padding characters. These strings should
Dave Love <fx@gnu.org>
parents:
diff changeset
1563 each contain a single %-spec saying how to send the number of lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1564 to be scrolled. These %-specs are like those in the termcap
Dave Love <fx@gnu.org>
parents:
diff changeset
1565 `cm' string.
Dave Love <fx@gnu.org>
parents:
diff changeset
1566
Dave Love <fx@gnu.org>
parents:
diff changeset
1567 You should also define the `IC' and `DC' strings if your terminal
Dave Love <fx@gnu.org>
parents:
diff changeset
1568 has a command to insert or delete multiple characters. These
Dave Love <fx@gnu.org>
parents:
diff changeset
1569 take the number of positions to insert or delete as an argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
1570
Dave Love <fx@gnu.org>
parents:
diff changeset
1571 A `cs' string to set the scrolling region will reduce the amount
Dave Love <fx@gnu.org>
parents:
diff changeset
1572 of motion you see on the screen when part of the screen is scrolled.
Dave Love <fx@gnu.org>
parents:
diff changeset
1573
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1574 ** You type Control-H (Backspace) expecting to delete characters.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
1575
Dave Love <fx@gnu.org>
parents:
diff changeset
1576 Put `stty dec' in your .login file and your problems will disappear
Dave Love <fx@gnu.org>
parents:
diff changeset
1577 after a day or two.
Dave Love <fx@gnu.org>
parents:
diff changeset
1578
Dave Love <fx@gnu.org>
parents:
diff changeset
1579 The choice of Backspace for erasure was based on confusion, caused by
Dave Love <fx@gnu.org>
parents:
diff changeset
1580 the fact that backspacing causes erasure (later, when you type another
Dave Love <fx@gnu.org>
parents:
diff changeset
1581 character) on most display terminals. But it is a mistake. Deletion
Dave Love <fx@gnu.org>
parents:
diff changeset
1582 of text is not the same thing as backspacing followed by failure to
Dave Love <fx@gnu.org>
parents:
diff changeset
1583 overprint. I do not wish to propagate this confusion by conforming
Dave Love <fx@gnu.org>
parents:
diff changeset
1584 to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
1585
Dave Love <fx@gnu.org>
parents:
diff changeset
1586 For this reason, I believe `stty dec' is the right mode to use,
Dave Love <fx@gnu.org>
parents:
diff changeset
1587 and I have designed Emacs to go with that. If there were a thousand
Dave Love <fx@gnu.org>
parents:
diff changeset
1588 other control characters, I would define Control-h to delete as well;
Dave Love <fx@gnu.org>
parents:
diff changeset
1589 but there are not very many other control characters, and I think
Dave Love <fx@gnu.org>
parents:
diff changeset
1590 that providing the most mnemonic possible Help character is more
Dave Love <fx@gnu.org>
parents:
diff changeset
1591 important than adapting to people who don't use `stty dec'.
Dave Love <fx@gnu.org>
parents:
diff changeset
1592
Dave Love <fx@gnu.org>
parents:
diff changeset
1593 If you are obstinate about confusing buggy overprinting with deletion,
Dave Love <fx@gnu.org>
parents:
diff changeset
1594 you can redefine Backspace in your .emacs file:
Dave Love <fx@gnu.org>
parents:
diff changeset
1595 (global-set-key "\b" 'delete-backward-char)
Dave Love <fx@gnu.org>
parents:
diff changeset
1596 You can probably access help-command via f1.
Dave Love <fx@gnu.org>
parents:
diff changeset
1597
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1598 ** 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
1599
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1600 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
1601 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
1602 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
1603 "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
1604 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
1605 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
1606 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
1607 "colors".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1608
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1609 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
1610 ``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
1611 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
1612 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
1613 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
1614 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
1615 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
1616 capability).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1617
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1618 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
1619 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
1620 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
1621 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
1622
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1623 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
1624 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
1625 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
1626 `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
1627 emulator.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1628
59996
aac0a33f5772 Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents: 58825
diff changeset
1629 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
1630 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
1631 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
1632 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
1633
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1634 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
1635 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
1636 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
1637 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
1638 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
1639 `global-font-lock-mode'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1640
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1641 * Runtime problems specific to individual Unix variants
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1642
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1643 ** GNU/Linux
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1644
63126
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1645 *** 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
1646
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1647 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
1648 read corrupted process output.
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1649
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1650 *** 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
1651
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1652 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
1653 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
1654
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1655 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
1656 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
1657 the script:
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1658
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1659 #!/bin/bash
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1660 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
1661 exec ssh "$@"
33a466a1789c Linux kernel 2.6.10 may corrupt process output.
Kim F. Storm <storm@cua.dk>
parents: 60158
diff changeset
1662
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1663 *** 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
1664 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
1665
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1666 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
1667 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
1668 known to work.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1669
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1670 *** 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
1671 the Meta key stops working.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1672
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1673 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
1674 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
1675 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
1676 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
1677 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
1678 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
1679 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
1680
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1681 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
1682 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
1683 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
1684 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
1685 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
1686 modifier:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1687
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1688 xmodmap -pk | egrep -i "meta|alt"
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1689
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1690 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
1691 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
1692
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1693 xkbprint 0:0 /tmp/k.ps
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1694
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1695 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
1696 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
1697 keys can serve as Meta.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1698
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1699 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
1700 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
1701
71200
d004c9d874b7 Fix typo.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 69953
diff changeset
1702 *** 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
1703
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1704 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
1705 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
1706
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1707 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
1708 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
1709 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
1710 networked and non-networked machines.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1711
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1712 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
1713
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1714 **** Networked Case.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1715
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1716 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
1717 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
1718 (replace HOSTNAME with your host name):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1719
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1720 127.0.0.1 HOSTNAME
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1721
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1722 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
1723 lines:
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 order hosts, bind
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1726 multi on
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1727
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1728 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
1729 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
1730 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
1731 dynamically allocate ip addresses).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1732
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1733 **** Non-Networked Case.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1735 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
1736 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
1737 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
1738 `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
1739 file is not necessary with this approach.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1740
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1741 *** 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
1742
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1743 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
1744 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
1745 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
1746 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
1747 (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
1748 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
1749 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
1750 always blinks.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1751
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1752 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
1753 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
1754 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
1755 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
1756 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
1757 cursor instead of the hardware cursor.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1758
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1759 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
1760 `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
1761 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
1762 produce a modified terminfo entry.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1763
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1764 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
1765 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
1766
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1767 *** 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
1768
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1769 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
1770 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
1771 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
1772 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
1773
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1774 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
1775
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1776 ** FreeBSD
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1777
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1778 *** 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
1779 directories that have the +t bit.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1780
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1781 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
1782 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
1783 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
1784 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
1785
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1786 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
1787 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
1788
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1789 *** 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
1790
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1791 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
1792 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
1793 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
1794
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1795 $ kbdcontrol -d >emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1796
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1797 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
1798 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
1799 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
1800 to look like this
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1801
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1802 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
1803
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1804 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
1805
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1806 $ kbdcontrol -l emacs.kbd
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1807
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1808 ** HP-UX
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1809
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1810 *** 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
1811
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1812 christos@theory.tn.cornell.edu says:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1813
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1814 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
1815 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
1816 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
1817 but tty is giving it back 3.
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 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
1820 word:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1821
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1822 if (`tty` == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1823
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1824 should be changed to:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1825
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1826 if ("`tty`" == "/dev/console")
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1827
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1828 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
1829 and into .login.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1830
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1831 *** 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
1832
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1833 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
1834 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
1835 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
1836 value is just ten seconds.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1837
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1838 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
1839
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1840 *** 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
1841 other non-English HP keyboards too).
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 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
1844 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
1845 configures the X server.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1846
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1847 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1848 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1849 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1850 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1851
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1852 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1853 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1854 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1855 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1856 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1857 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1858 EOF
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 *** 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
1861 Emacs built with Motif.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1862
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1863 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
1864 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
1865
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1866 *** 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
1867
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1868 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
1869 rights, containing this text:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1870
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1871 --------------------------------
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1872 xmodmap 2> /dev/null - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1873 keysym Alt_L = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1874 keysym Alt_R = Meta_R
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1875 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1876
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1877 xmodmap - << EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1878 clear mod1
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1879 keysym Mode_switch = NoSymbol
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1880 add mod1 = Meta_L
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1881 keysym Meta_R = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1882 add mod2 = Mode_switch
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1883 EOF
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1884 --------------------------------
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1885
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1886 *** 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
1887
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1888 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
1889
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1890 ** AIX
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 *** AIX: Trouble using ptys.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1893
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1894 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
1895 Use `smit pty' to reinstall them properly.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1896
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1897 *** 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
1898
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1899 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
1900
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1901 *aixterm.Translations: #override <Key>BackSpace: string(0x7f)
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1902 aixterm*ttyModes: erase ^?
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1903
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1904 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
1905
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1906 *** 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
1907 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
1908 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
1909 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
1910
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1911 *** 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
1912
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1913 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
1914 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
1915 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
1916 is to use the default compiler `cc'.
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 *** 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
1919 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
1920
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1921 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
1922 `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
1923 Definitions" to make them defined.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1924
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1925 ** Solaris
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1926
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1927 We list bugs in current versions here. See also the section on legacy
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1928 systems.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1929
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1930 *** 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
1931
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1932 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
1933 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
1934
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1935 *** Problem with remote X server on Suns.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1936
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1937 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
1938 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
1939 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
1940 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
1941
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
1942 *** Solaris 2.6: Emacs crashes with SIGBUS or SIGSEGV on Solaris after you delete a frame.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1943
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1944 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
1945 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
1946 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
1947
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1948 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
1949 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
1950 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
1951 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
1952
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1953 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
1954 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
1955
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1956 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
1957 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
1958 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
1959
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1960 *** 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
1961
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1962 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
1963 Rebuild it on Solaris 8.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1964
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1965 *** 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
1966 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
1967
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1968 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
1969
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
1970 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
1971
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1972 *** 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
1973 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
1974
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1975 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
1976
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1977 /usr/openwin/lib/locale/iso8859-15/Compose
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1978
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1979 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
1980
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1981 Ctrl<t> <quotedbl> <Y> : "\276" threequarters
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1982
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1983 that should read:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1984
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
1985 Ctrl<T> <quotedbl> <Y> : "\276" threequarters
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1986
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1987 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
1988
80121
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1989 *** On Solaris, Emacs fails to set menu-bar-update-hook on startup, with error
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1990 "Error in menu-bar-update-hook: (error Point before start of properties)".
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1991 This seems to be a GCC optimization bug that occurs for GCC 4.1.2 (-g
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1992 and -g -O2) and GCC 4.2.3 (-g -O and -g -O2). You can fix this by
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1993 compiling with GCC 4.2.3 or CC 5.7, with no optimizations.
288a07952e03 Add "Point before start of properties" bug.
Chong Yidong <cyd@stupidchicken.com>
parents: 79767
diff changeset
1994
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1995 ** Irix
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1996
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1997 *** 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
1998
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
1999 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
2000
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2001 *** 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
2002
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2003 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
2004 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
2005 to allocate ptys reliably.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2006
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2007 * Runtime problems specific to MS-Windows
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2008
101624
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2009 ** PATH can contain unexpanded environment variables
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2010
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2011 Old releases of TCC (version 9) and 4NT (up to version 8) do not correctly
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2012 expand App Paths entries of type REG_EXPAND_SZ. When Emacs is run from TCC
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2013 and such an entry exists for emacs.exe, exec-path will contain the
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2014 unexpanded entry. This has been fixed in TCC 10. For more information,
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2015 see bug#2062.
6033e5211761 * PROBLEMS (Windows): Add entry about TCC/4NT and App Paths keys.
Juanma Barranquero <lekktu@gmail.com>
parents: 101543
diff changeset
2016
101445
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2017 ** Setting w32-pass-rwindow-to-system and w32-pass-lwindow-to-system to nil
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2018 does not prevent the Start menu from popping up when the left or right
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2019 ``Windows'' key is pressed.
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2020
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2021 This was reported to happen when XKeymacs is installed. At least with
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2022 XKeymacs Version 3.47, deactivating XKeymacs when Emacs is active is
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2023 not enough to avoid its messing with the keyboard input. Exiting
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2024 XKeymacs completely is reported to solve the problem.
296066356761 Mention trouble with XKeymacs and the Windows keys.
Eli Zaretskii <eliz@gnu.org>
parents: 100972
diff changeset
2025
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2026 ** Windows 95 and networking.
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2027
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2028 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
2029 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
2030
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2031 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
2032 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
2033 "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
2034
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2035 ** 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
2036
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2037 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
2038 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
2039 problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2040
80730
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2041 ** Emacs crashes when opening a file with a UNC path and rails-mode is loaded.
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2042
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2043 Loading rails-mode seems to interfere with UNC path handling. This has been
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2044 reported as a bug against both Emacs and rails-mode, so look for an updated
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2045 rails-mode that avoids this crash, or avoid using UNC paths if using
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2046 rails-mode.
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2047
548fc19ce253 bug #719
Jason Rumney <jasonr@gnu.org>
parents: 80338
diff changeset
2048 ** Known problems with the MS-Windows port of Emacs 22.3
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2049
80338
28af19e6b167 M-x term does not work on Windows.
Jason Rumney <jasonr@gnu.org>
parents: 80127
diff changeset
2050 M-x term does not work on MS-Windows. TTY emulation on Windows is
28af19e6b167 M-x term does not work on Windows.
Jason Rumney <jasonr@gnu.org>
parents: 80127
diff changeset
2051 undocumented, and programs such as stty which are used on posix platforms
28af19e6b167 M-x term does not work on Windows.
Jason Rumney <jasonr@gnu.org>
parents: 80127
diff changeset
2052 to control tty emulation do not exist for native windows terminals.
28af19e6b167 M-x term does not work on Windows.
Jason Rumney <jasonr@gnu.org>
parents: 80127
diff changeset
2053
66452
50f2dd53cf9a Added note about create-fontset-from-ascii-font problem on MS-Windows.
Jason Rumney <jasonr@gnu.org>
parents: 65518
diff changeset
2054 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
2055 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
2056 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
2057 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
2058 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
2059
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2060 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
2061 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
2062 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
2063 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
2064 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
2065 pop-up menu interaction.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2066
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2067 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
2068 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
2069
77076
9bc027540c27 Describe problems on Windows with ClearType enabled.
Eli Zaretskii <eliz@gnu.org>
parents: 77047
diff changeset
2070 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
2071 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
2072 "Effects"), there are various problems related to display of
80125
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2073 characters: Bold fonts can be hard to read, small portions of some
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2074 characters could appear chopped, etc. This happens because, under
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2075 ClearType, characters are drawn outside their advertised bounding box.
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2076 Emacs 21 disabled the use of ClearType, whereas Emacs 22 allows it and
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2077 has some code to enlarge the width of the bounding box. Apparently,
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2078 this display feature needs more changes to get it 100% right. A
a1e7a4fcb970 Fixed part of Cleartype problem.
Jason Rumney <jasonr@gnu.org>
parents: 80121
diff changeset
2079 workaround is to disable ClearType.
77076
9bc027540c27 Describe problems on Windows with ClearType enabled.
Eli Zaretskii <eliz@gnu.org>
parents: 77047
diff changeset
2080
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2081 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
2082 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
2083 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
2084 after moving back into it.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2085
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2086 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
2087 not as severely as in 21.1.
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 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
2090 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
2091
77047
e764b3b9820d Update information about non-support of Windows input methods.
Eli Zaretskii <eliz@gnu.org>
parents: 76934
diff changeset
2092 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
2093 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
2094 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
2095 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
2096 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
2097 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
2098 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
2099
e764b3b9820d Update information about non-support of Windows input methods.
Eli Zaretskii <eliz@gnu.org>
parents: 76934
diff changeset
2100 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
2101
e764b3b9820d Update information about non-support of Windows input methods.
Eli Zaretskii <eliz@gnu.org>
parents: 76934
diff changeset
2102 (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
2103 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
2104 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
2105 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
2106 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
2107 the input method.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2108
76824
213bd9333baa (MS-Windows problems): How to bind non-ASCII keys with modifiers.
Eli Zaretskii <eliz@gnu.org>
parents: 76763
diff changeset
2109 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
2110 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
2111 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
2112
213bd9333baa (MS-Windows problems): How to bind non-ASCII keys with modifiers.
Eli Zaretskii <eliz@gnu.org>
parents: 76763
diff changeset
2113 (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
2114
213bd9333baa (MS-Windows problems): How to bind non-ASCII keys with modifiers.
Eli Zaretskii <eliz@gnu.org>
parents: 76763
diff changeset
2115 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
2116 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
2117 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
2118
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2119 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
2120 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
2121 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
2122 library function.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2123
79164
58e889027356 display-time-world does not exist yet.
Jason Rumney <jasonr@gnu.org>
parents: 79163
diff changeset
2124 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
2125 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
2126 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
2127
77518
4dd556dec0f0 Mention problems with files larger than 4GB on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 77311
diff changeset
2128 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
2129 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
2130 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
2131 on `file-attributes'.
4dd556dec0f0 Mention problems with files larger than 4GB on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 77311
diff changeset
2132
78014
91d0311ee2cc Document that :data is unsupported for playing sound on Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 77815
diff changeset
2133 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
2134 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
2135
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2136 ** 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
2137
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2138 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
2139 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
2140 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
2141 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
2142 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
2143 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
2144 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
2145 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
2146 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
2147
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2148 ** 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
2149
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2150 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
2151 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
2152 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
2153 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
2154 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
2155
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2156 ** 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
2157
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2158 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
2159 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
2160 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
2161 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
2162 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
2163 confuses ange-ftp.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2164
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2165 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
2166 (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
2167 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
2168 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
2169 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
2170 client's executable. For example:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2171
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2172 (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
2173
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2174 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
2175 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
2176
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2177 (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
2178
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2179 ** 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
2180
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2181 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
2182 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
2183
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2184 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
2185 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
2186 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
2187 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
2188 has):
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2189
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2190 (setq printer-name "") ;; notepad takes the default
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2191 (setq lpr-command "notepad") ;; notepad
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2192 (setq lpr-switches nil) ;; not needed
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2193 (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
2194
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2195 ** 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
2196
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2197 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
2198 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
2199 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
2200 work when an antivirus package is installed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2201
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2202 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
2203 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
2204 or disable it entirely.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2205
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2206 ** 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
2207
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2208 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
2209 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
2210 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
2211 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
2212 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
2213 "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
2214 generic mouse driver might help.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2215
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2216 ** 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
2217
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2218 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
2219 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
2220 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
2221 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
2222
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2223 ** 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
2224 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
2225 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
2226 seen.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2227
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2228 ** 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
2229 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
2230
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2231 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
2232
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2233 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
2234 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
2235 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
2236 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
2237 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
2238 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
2239
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2240 ** 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
2241
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2242 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
2243 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
2244 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
2245 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
2246
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2247 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
2248 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
2249 problem lies in the X-server settings.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2250
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2251 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
2252 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
2253 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
2254 selection".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2255
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2256 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
2257 please call support for your X-server and see if you can get a fix.
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2258 If you do, please send it to bug-gnu-emacs@gnu.org so we can list it here.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2259
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2260 * Build-time problems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2261
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2262 ** Configuration
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2263
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2264 *** The `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
2265
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2266 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
2267 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
2268 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
2269
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2270 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
2271 `--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
2272 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
2273 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
2274 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
2275 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
2276
76934
6586f81fbf80 (Configuration): Add entries on compiler/preprocessor mismatch, and on
Glenn Morris <rgm@gnu.org>
parents: 76847
diff changeset
2277 *** `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
2278
6586f81fbf80 (Configuration): Add entries on compiler/preprocessor mismatch, and on
Glenn Morris <rgm@gnu.org>
parents: 76847
diff changeset
2279 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
2280 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
2281 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
2282 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
2283 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
2284
6586f81fbf80 (Configuration): Add entries on compiler/preprocessor mismatch, and on
Glenn Morris <rgm@gnu.org>
parents: 76847
diff changeset
2285 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
2286 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
2287 example).
6586f81fbf80 (Configuration): Add entries on compiler/preprocessor mismatch, and on
Glenn Morris <rgm@gnu.org>
parents: 76847
diff changeset
2288
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2289 ** Compilation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2290
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2291 *** 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
2292
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2293 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
2294 (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
2295 (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
2296 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
2297 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
2298 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
2299 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
2300 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
2301
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2302 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
2303 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
2304 (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
2305 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
2306
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2307 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
2308 (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
2309 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
2310 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
2311 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
2312 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
2313 `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
2314 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
2315 `/etc/auto.home'.
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 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
2318 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
2319 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
2320 to work around the problem.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2321
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2322 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
2323 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
2324 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
2325 `/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
2326
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2327 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
2328
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2329 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
2330
75211
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2331 *** 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
2332
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2333 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
2334 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
2335
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2336 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
2337 --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
2338
9cd33b55eebf Add information on compiling 32-bit Emacs on 64-bit GNU/Linux.
Glenn Morris <rgm@gnu.org>
parents: 74660
diff changeset
2339 (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
2340
109245
f5263c8dbdcc * etc/PROBLEMS: Update Cygwin GCC information. (Bug#6458)
Glenn Morris <rgm@gnu.org>
parents: 108364
diff changeset
2341 *** Building Emacs for Cygwin can fail with GCC 3
f5263c8dbdcc * etc/PROBLEMS: Update Cygwin GCC information. (Bug#6458)
Glenn Morris <rgm@gnu.org>
parents: 108364
diff changeset
2342
f5263c8dbdcc * etc/PROBLEMS: Update Cygwin GCC information. (Bug#6458)
Glenn Morris <rgm@gnu.org>
parents: 108364
diff changeset
2343 As of Emacs 22.1, there have been stability problems with Cygwin
f5263c8dbdcc * etc/PROBLEMS: Update Cygwin GCC information. (Bug#6458)
Glenn Morris <rgm@gnu.org>
parents: 108364
diff changeset
2344 builds of Emacs using GCC 3. Cygwin users are advised to use GCC 4.
73673
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2345
109692
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2346 *** Building Emacs 23.3 and later will fail under Cygwin 1.5.19
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2347
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2348 This is a consequence of a change to src/dired.c on 2010-07-27. The
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2349 issue is that Cygwin 1.5.19 did not have d_ino in 'struct dirent'.
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2350 See
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2351
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2352 http://lists.gnu.org/archive/html/emacs-devel/2010-07/msg01266.html
58882317bf04 * PROBLEMS: Mention problem with Cygwin 1.5.19.
Ken Brown <kbrown@cornell.edu>
parents: 109245
diff changeset
2353
107685
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2354 *** Building the native MS-Windows port fails due to unresolved externals
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2355
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2356 The linker error messages look like this:
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2357
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2358 oo-spd/i386/ctags.o:ctags.c:(.text+0x156e): undefined reference to `_imp__re_set_syntax'
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2359 collect2: ld returned 1 exit status
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2360
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2361 This happens because GCC finds an incompatible header regex.h
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2362 somewhere on the include path, before the version of regex.h supplied
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2363 with Emacs. One such incompatible version of regex.h is part of the
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2364 GnuWin32 Regex package.
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2365
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2366 The solution is to remove the incompatible regex.h from the include
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2367 path, when compiling Emacs. Alternatively, re-run the configure.bat
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2368 script with the "-isystem C:/GnuWin32/include" switch (adapt for your
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2369 system's place where you keep the GnuWin32 include files) -- this will
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2370 cause the compiler to search headers in the directories specified by
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2371 the Emacs Makefile _before_ it looks in the GnuWin32 include
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2372 directories.
dd8a8fd1397e Document problems on MS-Windows with incompatible regex.h headers.
Eli Zaretskii <eliz@gnu.org>
parents: 107518
diff changeset
2373
73673
dde3145743e4 Document problems with Cygwin builds of GCC 3.4.4.
Eli Zaretskii <eliz@gnu.org>
parents: 73631
diff changeset
2374 *** 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
2375
80126
6d1f448b6c77 Cygwin GCC builds that do not work are no longer recent.
Jason Rumney <jasonr@gnu.org>
parents: 80125
diff changeset
2376 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
2377 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
2378 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
2379 __MSVCRT__, like so:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2380
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2381 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
2382
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2383 *** 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
2384
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2385 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
2386 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
2387 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
2388
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2389 *** 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
2390
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2391 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
2392 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
2393 patch to assert.h should solve this:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2394
76275
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2395 *** 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
2396 --- 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
2397 ***************
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2398 *** 41,47 ****
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2399 /*
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2400 * 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
2401 */
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2402 ! #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
2403
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2404 #else /* debugging enabled */
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2405
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2406 --- 41,47 ----
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2407 /*
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2408 * 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
2409 */
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2410 ! #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
2411
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2412 #else /* debugging enabled */
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2413
f5dc9b3e2eea Fix last change. Indent the patch for assert.h one column.
Eli Zaretskii <eliz@gnu.org>
parents: 76273
diff changeset
2414
76273
1af36c639a87 Note added about the Visual Studio 2005 problem.
Jason Rumney <jasonr@gnu.org>
parents: 76209
diff changeset
2415 *** 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
2416
1af36c639a87 Note added about the Visual Studio 2005 problem.
Jason Rumney <jasonr@gnu.org>
parents: 76209
diff changeset
2417 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
2418 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
2419 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
2420 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
2421 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
2422 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
2423
101793
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2424 We recommend the use of the MinGW port of GCC for compiling Emacs, as
76273
1af36c639a87 Note added about the Visual Studio 2005 problem.
Jason Rumney <jasonr@gnu.org>
parents: 76209
diff changeset
2425 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
2426 software like Emacs.
1af36c639a87 Note added about the Visual Studio 2005 problem.
Jason Rumney <jasonr@gnu.org>
parents: 76209
diff changeset
2427
101793
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2428 *** Building the MS-Windows port with Visual Studio fails compiling emacs.rc
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2429
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2430 If the build fails with the following message then the problem
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2431 described here most likely applies:
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2432
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2433 ../nt/emacs.rc(1) : error RC2176 : old DIB in icons\emacs.ico; pass it
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2434 through SDKPAINT
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2435
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2436 The Emacs icon contains a high resolution PNG icon for Vista, which is
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2437 not recognized by older versions of the resource compiler. There are
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2438 several workarounds for this problem:
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2439 1. Use Free MinGW tools to compile, which do not have this problem.
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2440 2. Install the latest Windows SDK.
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2441 3. Replace emacs.ico with an older or edited icon.
65f8f3d1365d (CPP): Note problem with resource compiler of MSVC.
Jason Rumney <jasonr@gnu.org>
parents: 101624
diff changeset
2442
109478
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2443 *** Building the MS-Windows port complains about unknown escape sequences.
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2444
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2445 Errors and warnings can look like this:
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2446
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2447 w32.c:1959:27: error: \x used with no following hex digits
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2448 w32.c:1959:27: warning: unknown escape sequence '\i'
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2449
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2450 This happens when paths using backslashes are passed to the compiler or
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2451 linker (via -I and possibly other compiler flags); when these paths are
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2452 included in source code, the backslashes are interpreted as escape sequences.
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2453 See http://lists.gnu.org/archive/html/emacs-devel/2010-07/msg00995.html
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2454
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2455 The fix is to use forward slashes in all paths passed to the compiler.
2660703dfff3 * PROBLEMS: Add note about use of backslashes in Windows paths.
Juanma Barranquero <lekktu@gmail.com>
parents: 109302
diff changeset
2456
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2457 ** Linking
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2458
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2459 *** 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
2460 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
2461
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2462 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
2463 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
2464 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
2465 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
2466 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
2467 link stage.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2468
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2469 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
2470
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2471 make CC=gcc
56734
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 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
2474 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
2475
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2476 *** 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
2477
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2478 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
2479
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2480 /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
2481
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2482 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
2483
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2484 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
2485 cannot easily arrange to supply them.
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 *** 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
2488
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2489 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
2490
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2491 *** `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
2492
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2493 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
2494 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
2495 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
2496 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
2497 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
2498
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2499 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
2500
97990
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2501 ** Bootstrapping
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2502
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2503 Bootstrapping (compiling the .el files) is normally only necessary
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2504 with development builds, since the .elc files are pre-compiled in releases.
97990
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2505
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2506 *** "No rule to make target" with Ubuntu 8.04 make 3.81-3build1
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2507
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2508 Compiling the lisp files fails at random places, complaining:
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2509 "No rule to make target `/path/to/some/lisp.elc'".
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2510 The causes of this problem are not understood. Using GNU make 3.81 compiled
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2511 from source, rather than the Ubuntu version, worked. See Bug#327,821.
61fcd7a08a42 Mention Ubuntu make weirdness.
Glenn Morris <rgm@gnu.org>
parents: 97732
diff changeset
2512
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2513 ** Dumping
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2514
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2515 *** 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
2516
77139
8658cdd16704 Fix some typos.
Glenn Morris <rgm@gnu.org>
parents: 77076
diff changeset
2517 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
2518 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
2519 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
2520 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
2521 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
2522 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
2523 newer). Read the next item.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2524
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2525 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
2526 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
2527 workaround is known.
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2528
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2529 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
2530
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2531 cat /proc/sys/kernel/exec-shield
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2532
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2533 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
2534 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
2535 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
2536
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2537 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
2538
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2539 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
2540 execution of this command:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2541
57229
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2542 ./temacs --batch --load loadup [dump|bootstrap]
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2543
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2544 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
2545 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
2546 command when running temacs like this:
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2547
fb9de0d75bef * PROBLEMS: Updated exec-shield description.
Jan Djärv <jan.h.d@swipnet.se>
parents: 56914
diff changeset
2548 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
2549
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2550
63968
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2551 *** 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
2552
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2553 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
2554 `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
2555 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
2556 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
2557 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
2558 command:
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2559
64489
86ac75fb6283 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63969
diff changeset
2560 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
2561
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2562 or
679b14e71677 * PROBLEMS (Fedora Core 4 GNU/Linux: Segfault during dumping):
Jan Djärv <jan.h.d@swipnet.se>
parents: 63883
diff changeset
2563
71902
967a56f9d307 Emacs now requires ws2_32.dll on Windows.
Kim F. Storm <storm@cua.dk>
parents: 71541
diff changeset
2564 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
2565
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2566 *** 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
2567
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2568 This command is the final stage of building Emacs. It is run by the
97142
c3512b2085a0 * bitmaps/README:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 97043
diff changeset
2569 Makefile in the src subdirectory.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2570
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2571 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
2572 space available on the machine.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2573
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2574 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
2575 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
2576 for large blocks (many pages).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2577
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2578 *** 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
2579 *** 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
2580 *** 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
2581 *** or, temacs gets errors dumping emacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2582
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2583 This 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
2584 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
2585 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
2586
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2587 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
2588 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
2589 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
2590 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
2591 when unpacking the shell archive.
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 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
2594 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
2595 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
2596
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2597 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
2598 nonprinting characters, you can fix them:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2599
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2600 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
2601 2) Delete all the .elc files.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2602 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
2603 (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
2604 4) Remake emacs. It should work now.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2605 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
2606 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
2607 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
2608 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
2609 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
2610 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
2611 and remake temacs.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2612 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
2613
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2614 *** temacs prints "Pure Lisp storage exhausted".
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2615
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2616 This means that the Lisp code loaded from the .elc and .el files
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2617 during temacs -l loadup inc dump took up more space than was allocated.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2618
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2619 This could be caused by
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2620 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
2621 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
2622 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
2623 Note that ANY site-init.el or site-load.el is nonstandard;
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2624 if you have received Emacs from some other site and it contains a
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2625 site-init.el or site-load.el file, consider deleting that file.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2626 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
2627 (not from the directory you expected).
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2628 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
2629 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
2630 loaded instead. They take up more room, so you lose.
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2631 6) a bug in the Emacs distribution which underestimates the space required.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2632
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2633 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
2634 of PURESIZE in puresize.h.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2635
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2636 But in some of the cases listed above, this problem is a consequence
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2637 of something else that is wrong. Be sure to check and fix the real problem.
56734
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 *** 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
2640
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2641 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
2642 C backtrace printed by GDB:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2643
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2644 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2645 (gdb) where
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2646 #0 0x190c0c0 in Fmake_symbol ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2647 #1 0x1942ca4 in init_obarray ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2648 #2 0x18b3500 in main ()
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2649 #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
2650
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2651 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
2652 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
2653 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
2654 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
2655 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
2656 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
2657 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
2658 distribution:
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 #if 0 /* This breaks things on PPC GNU/Linux except for Yellowdog,
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2661 even with identical GCC, as, ld. Let's take it out until we
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2662 know what's really going on here. */
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2663 /* 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
2664 0x10000000. */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2665 #if defined __linux__
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2666 #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
2667 #define DATA_SEG_BITS 0x10000000
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2668 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2669 #endif
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2670 #endif /* 0 */
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2671
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2672 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
2673 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
2674 should now succeed.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2675
77736
cf1eb9bac78f (Dumping): Mention OpenBSD macppc problem.
Glenn Morris <rgm@gnu.org>
parents: 77601
diff changeset
2676 *** OpenBSD 4.0 macppc: Segfault during dumping.
cf1eb9bac78f (Dumping): Mention OpenBSD macppc problem.
Glenn Morris <rgm@gnu.org>
parents: 77601
diff changeset
2677
cf1eb9bac78f (Dumping): Mention OpenBSD macppc problem.
Glenn Morris <rgm@gnu.org>
parents: 77601
diff changeset
2678 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
2679 --load loadup bootstrap' tries to load files.el. A workaround seems
98f25c40a396 Tweak previous change.
Glenn Morris <rgm@gnu.org>
parents: 77737
diff changeset
2680 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
2681 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
2682 GCC problem specific to the macppc architecture, possibly only
77746
98f25c40a396 Tweak previous change.
Glenn Morris <rgm@gnu.org>
parents: 77737
diff changeset
2683 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
2684
79018
e032ea593ebb Mention openSUSE bcopy issue.
Glenn Morris <rgm@gnu.org>
parents: 78998
diff changeset
2685 *** openSUSE 10.3: Segfault in bcopy during dumping.
e032ea593ebb Mention openSUSE bcopy issue.
Glenn Morris <rgm@gnu.org>
parents: 78998
diff changeset
2686
e032ea593ebb Mention openSUSE bcopy issue.
Glenn Morris <rgm@gnu.org>
parents: 78998
diff changeset
2687 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
2688 It is/will be fixed in an openSUSE update.
e032ea593ebb Mention openSUSE bcopy issue.
Glenn Morris <rgm@gnu.org>
parents: 78998
diff changeset
2689
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2690 ** Installation
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2691
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2692 *** 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
2693
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2694 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
2695 supplies the `install-info' command.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2696
76755
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2697 *** Installing to a directory with spaces in the name fails.
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2698
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2699 For example, if you call configure with a directory-related option
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2700 with spaces in the value, eg --enable-locallisppath='/path/with\ spaces'.
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2701 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
2702 must re-configure without using spaces.
f803dda9e616 *** empty log message ***
Glenn Morris <rgm@gnu.org>
parents: 76473
diff changeset
2703
77791
2281fafb5f9d Add "Installing to a directory with non-ASCII characters in the name fails".
Chong Yidong <cyd@stupidchicken.com>
parents: 77766
diff changeset
2704 *** 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
2705
2281fafb5f9d Add "Installing to a directory with non-ASCII characters in the name fails".
Chong Yidong <cyd@stupidchicken.com>
parents: 77766
diff changeset
2706 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
2707 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
2708 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
2709 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
2710 envvar.
2281fafb5f9d Add "Installing to a directory with non-ASCII characters in the name fails".
Chong Yidong <cyd@stupidchicken.com>
parents: 77766
diff changeset
2711
77601
19cb46e07cc9 David R. Linn <drl at jekyll.vuse.vanderbilt.edu>
Glenn Morris <rgm@gnu.org>
parents: 77518
diff changeset
2712 *** 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
2713
19cb46e07cc9 David R. Linn <drl at jekyll.vuse.vanderbilt.edu>
Glenn Morris <rgm@gnu.org>
parents: 77518
diff changeset
2714 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
2715 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
2716 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
2717 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
2718 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
2719 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
2720 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
2721 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
2722 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
2723 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
2724 Software Companion CDROM.
19cb46e07cc9 David R. Linn <drl at jekyll.vuse.vanderbilt.edu>
Glenn Morris <rgm@gnu.org>
parents: 77518
diff changeset
2725
19cb46e07cc9 David R. Linn <drl at jekyll.vuse.vanderbilt.edu>
Glenn Morris <rgm@gnu.org>
parents: 77518
diff changeset
2726 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
2727 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
2728 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
2729 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
2730
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2731 ** First execution
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2732
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2733 *** 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
2734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2735 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
2736 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
2737 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
2738 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
2739
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2740 emacs: ASCII text, with no line terminators
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2741
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2742 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
2743 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
2744
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2745 *** 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
2746
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2747 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
2748
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2749 1) On a system where getpagesize is not a system call, it is defined
109628
8e2c7c31861b Rename src/unexec.c => src/unexcoff.c.
Eli Zaretskii <eliz@gnu.org>
parents: 109478
diff changeset
2750 as a macro. If the definition (in both unex*.c and malloc.c) is wrong,
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2751 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
2752 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
2753
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2754 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
2755 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
2756 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
2757 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
2758 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
2759
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2760 * Runtime problems on legacy systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2761
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2762 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
2763 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
2764 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
2765
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2766 *** OPENSTEP 4.2: Compiling syntax.c with gcc 2.7.2.1 fails.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2767
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2768 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
2769 following message:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2770
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2771 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
2772
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2773 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
2774 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
2775 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
2776
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2777 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
2778 {
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2779 return(UPDATE_SYNTAX_TABLE_FORWARD(from));
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2780 }/*update_syntax_table_forward*/
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2781
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2782 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
2783 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
2784
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2785 *** Solaris 2.x
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2786
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2787 **** 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
2788
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2789 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
2790 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
2791 as GCC.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2792
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2793 **** 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
2794
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2795 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
2796 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
2797 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
2798
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2799 **** 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
2800
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2801 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
2802 version of Solaris that you are using.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2803
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2804 **** 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
2805
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2806 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
2807 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
2808 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
2809 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
2810 described in the Solaris FAQ
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2811 <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
2812 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
2813
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2814 **** 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
2815 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
2816 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
2817 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
2818 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
2819 and the default CFLAGS.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2820
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2821 **** 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
2822
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2823 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
2824 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
2825 (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
2826 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
2827 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
2828 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
2829 are currently recommended for your host.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2830
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2831 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
2832 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
2833 105284-18 might fix it again.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2834
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2835 **** 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
2836
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2837 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
2838 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
2839 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
2840 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
2841
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2842 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
2843 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
2844 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
2845 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
2846 should do.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2847
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2848 pen@lysator.liu.se says (Feb 1998) that the Compose key does work
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2849 if you link with the MIT X11 libraries instead of the Solaris X11 libraries.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2850
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2851 *** HP/UX 10: Large file support is disabled.
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2852 (HP/UX 10 was end-of-lifed in May 1999.)
108799
595ee9e6c0e6 * etc/PROBLEMS: Remove old information no longer of relevance.
Glenn Morris <rgm@gnu.org>
parents: 108798
diff changeset
2853 See the comments in src/s/hpux10-20.h.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2854
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2855 *** 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
2856
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2857 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
2858 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
2859 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
2860 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
2861 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
2862 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
2863
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2864 *** UnixWare 2.1: Error 12 (virtual memory exceeded) when dumping Emacs.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2865
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2866 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
2867 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
2868 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
2869 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
2870 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
2871 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
2872
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2873 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
2874 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
2875
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2876 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
2877
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2878 # /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
2879 # /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
2880 # /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
2881 # /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
2882 # /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
2883
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2884 (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
2885 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
2886
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2887 ** MS-Windows 95, 98, ME, and NT
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2888
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2889 *** 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
2890
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2891 `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
2892 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
2893
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2894 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
2895 "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
2896 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
2897
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2898 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
2899 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
2900 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
2901
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2902 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
2903 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
2904 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
2905 stdin.
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2906
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2907 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
2908
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2909 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
2910
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2911 *** 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
2912 --- 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
2913 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2914 *** 68,74 ****
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2915 $rcfile=".perldb";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2916 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2917 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2918 ! $console = "con";
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2919 $rcfile="perldb.ini";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2920 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2921
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2922 --- 68,74 ----
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2923 $rcfile=".perldb";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2924 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2925 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2926 ! $console = "";
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2927 $rcfile="perldb.ini";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2928 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2929
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2930
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2931 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
2932 *** 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
2933 --- 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
2934 ***************
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2935 *** 22,28 ****
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2936 $rcfile=".perldb";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2937 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2938 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
2939 ! $console = "con";
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2940 $rcfile="perldb.ini";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2941 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2942 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2943 --- 22,28 ----
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2944 $rcfile=".perldb";
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2945 }
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2946 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
2947 ! $console = "";
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
2948 $rcfile="perldb.ini";
56914
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 else {
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2951
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2952 *** 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
2953
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2954 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
2955 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
2956
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2957 *** 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
2958
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2959 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
2960 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
2961 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
2962 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
2963
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2964 *** 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
2965
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2966 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
2967 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
2968 particular, this has been reported when trying to compile a Java
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
2969 program in JDEE when javac.exe is installed, but not on the system PATH.
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
2970
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2971 ** MS-DOS
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2972
100561
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
2973 *** When compiling with DJGPP on MS-Windows NT or later, "config msdos" fails.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2974
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2975 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
2976 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
2977 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
2978 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
2979 the front of your PATH environment variable.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
2980
102250
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2981 *** When Emacs compiled with DJGPP runs on Windows 2000 and later, it cannot
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2982 find your HOME directory.
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2983
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2984 This was reported to happen when you click on "Save for future
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2985 sessions" button in a Customize buffer. You might see an error
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2986 message like this one:
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2987
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2988 basic-save-buffer-2: c:/FOO/BAR/~dosuser/: no such directory
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2989
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2990 (The telltale sign is the "~USER" part at the end of the directory
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2991 Emacs complains about, where USER is your username or the literal
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2992 string "dosuser", which is the default username set up by the DJGPP
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2993 startup file DJGPP.ENV.)
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2994
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2995 This happens when the functions `user-login-name' and
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2996 `user-real-login-name' return different strings for your username as
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2997 Emacs sees it. To correct this, make sure both USER and USERNAME
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2998 environment variables are set to the same value. Windows 2000 and
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
2999 later sets USERNAME, so if you want to keep that, make sure USER is
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
3000 set to the same value. If you don't want to set USER globally, you
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
3001 can do it in the [emacs] section of your DJGPP.ENV file.
1107d3965884 Mention problems with username in the MS-DOS port on MS-Windows.
Eli Zaretskii <eliz@gnu.org>
parents: 101793
diff changeset
3002
100561
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3003 *** When Emacs compiled with DJGPP runs on Vista, it runs out of memory.
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3004
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3005 If Emacs running on Vista displays "!MEM FULL!" in the mode line, you
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3006 are hitting the memory allocation bugs in the Vista DPMI server. See
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3007 msdos/INSTALL for how to work around these bugs (search for "Vista").
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3008
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3009 *** 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
3010 like make-docfile.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3011
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3012 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
3013 variable LFN) when Emacs distribution was unpacked and during
100561
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3014 compilation are not the same. See msdos/INSTALL for the explanation
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3015 of how to avoid this problem.
56734
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 *** Emacs compiled with DJGPP complains at startup:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3018
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3019 "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
3020
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3021 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
3022 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
3023 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
3024 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
3025 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
3026 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
3027 [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
3028 `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
3029 your system works as before.
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 *** MS-DOS: Emacs crashes at startup.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3032
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3033 Some users report that Emacs 19.29 requires dpmi memory management,
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
3034 and crashes on startup if the system does not have it. We don't
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3035 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
3036 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
3037 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
3038
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3039 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
3040 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
3041 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
3042 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
3043
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3044 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
3045 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
3046 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
3047 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
3048 the djgpp faq for configuration hints.
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 *** 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
3051 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
3052 drive, e.g. `c:/dev'.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3053
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3054 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
3055 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
3056 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
3057
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
3058 *** MS-DOS+DJGPP: Problems on MS-DOS if DJGPP v2.0 is used to compile Emacs.
56734
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 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
3061
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3062 * 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
3063 `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
3064 * 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
3065
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3066 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
3067 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
3068 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
3069 incorrect library functions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3070
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3071 *** 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
3072 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
3073
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3074 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
3075 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
3076 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
3077 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
3078
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3079 Another manifestation of this problem is that Emacs is unable to load
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
3080 the support for editing program sources in languages such as C and Lisp.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3081
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3082 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
3083 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
3084 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
3085 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
3086 filenames (such as djtar from DJGPP or InfoZip's UnZip program
100561
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3087 compiled with DJGPP v2). The file msdos/INSTALL explains this issue
c49d80bdf651 (MS-DOS): Document the problems on Vista.
Eli Zaretskii <eliz@gnu.org>
parents: 100504
diff changeset
3088 in more detail.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3089
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3090 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
3091 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
3092 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
3093 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
3094 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
3095 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
3096 properly truncated.
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 ** Archaic window managers and toolkits
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3099
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3100 *** 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
3101
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3102 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
3103 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
3104 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
3105 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
3106 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
3107
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3108 OpenWindows.WindowMenuAccelerators: False
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3109
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
3110 *** twm: A position you specified in .Xdefaults is ignored, using twm.
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3111
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3112 twm normally ignores "program-specified" positions.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3113 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
3114
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3115 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
3116
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3117 ** Bugs related to old DEC hardware
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 *** 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
3120
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3121 This shell command should fix it:
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3122
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3123 xmodmap -e 'keycode 0xb1 = Meta_L'
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3124
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3125 *** 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
3126 as a concentrator.
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 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
3129 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
3130
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3131 * Build problems on legacy systems
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3132
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3133 ** 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
3134
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3135 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
3136 `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
3137 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
3138 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
3139
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3140 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
3141 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
3142 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
3143 floating point option: -fsoft.
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3144
56914
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3145 ** 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
3146
ce4c0cb926e3 From Eric S. Raymond: More reorganization to exile old stuff to the
Eli Zaretskii <eliz@gnu.org>
parents: 56754
diff changeset
3147 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
3148
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3149 ** Vax C compiler bugs affecting Emacs.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3150
Dave Love <fx@gnu.org>
parents:
diff changeset
3151 You may get one of these problems compiling Emacs:
Dave Love <fx@gnu.org>
parents:
diff changeset
3152
Dave Love <fx@gnu.org>
parents:
diff changeset
3153 foo.c line nnn: compiler error: no table entry for op STASG
Dave Love <fx@gnu.org>
parents:
diff changeset
3154 foo.c: fatal error in /lib/ccom
Dave Love <fx@gnu.org>
parents:
diff changeset
3155
Dave Love <fx@gnu.org>
parents:
diff changeset
3156 These are due to bugs in the C compiler; the code is valid C.
Dave Love <fx@gnu.org>
parents:
diff changeset
3157 Unfortunately, the bugs are unpredictable: the same construct
Dave Love <fx@gnu.org>
parents:
diff changeset
3158 may compile properly or trigger one of these bugs, depending
Dave Love <fx@gnu.org>
parents:
diff changeset
3159 on what else is in the source file being compiled. Even changes
Dave Love <fx@gnu.org>
parents:
diff changeset
3160 in header files that should not affect the file being compiled
Dave Love <fx@gnu.org>
parents:
diff changeset
3161 can affect whether the bug happens. In addition, sometimes files
Dave Love <fx@gnu.org>
parents:
diff changeset
3162 that compile correctly on one machine get this bug on another machine.
Dave Love <fx@gnu.org>
parents:
diff changeset
3163
Dave Love <fx@gnu.org>
parents:
diff changeset
3164 As a result, it is hard for me to make sure this bug will not affect
Dave Love <fx@gnu.org>
parents:
diff changeset
3165 you. I have attempted to find and alter these constructs, but more
Dave Love <fx@gnu.org>
parents:
diff changeset
3166 can always appear. However, I can tell you how to deal with it if it
Dave Love <fx@gnu.org>
parents:
diff changeset
3167 should happen. The bug comes from having an indexed reference to an
Dave Love <fx@gnu.org>
parents:
diff changeset
3168 array of Lisp_Objects, as an argument in a function call:
Dave Love <fx@gnu.org>
parents:
diff changeset
3169 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3170 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3171 ... foo (5, args[i], ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3172 putting the argument into a temporary variable first, as in
Dave Love <fx@gnu.org>
parents:
diff changeset
3173 Lisp_Object *args;
Dave Love <fx@gnu.org>
parents:
diff changeset
3174 Lisp_Object tem;
Dave Love <fx@gnu.org>
parents:
diff changeset
3175 ...
Dave Love <fx@gnu.org>
parents:
diff changeset
3176 tem = args[i];
Dave Love <fx@gnu.org>
parents:
diff changeset
3177 ... foo (r, tem, ...)...
Dave Love <fx@gnu.org>
parents:
diff changeset
3178 causes the problem to go away.
Dave Love <fx@gnu.org>
parents:
diff changeset
3179 The `contents' field of a Lisp vector is an array of Lisp_Objects,
Dave Love <fx@gnu.org>
parents:
diff changeset
3180 so you may see the problem happening with indexed references to that.
Dave Love <fx@gnu.org>
parents:
diff changeset
3181
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3182 ** 68000 C compiler problems
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3183
Dave Love <fx@gnu.org>
parents:
diff changeset
3184 Various 68000 compilers have different problems.
Dave Love <fx@gnu.org>
parents:
diff changeset
3185 These are some that have been observed.
Dave Love <fx@gnu.org>
parents:
diff changeset
3186
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3187 *** Using value of assignment expression on union type loses.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3188 This means that x = y = z; or foo (x = z); does not work
Dave Love <fx@gnu.org>
parents:
diff changeset
3189 if x is of type Lisp_Object.
Dave Love <fx@gnu.org>
parents:
diff changeset
3190
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3191 *** "cannot reclaim" error.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3192
Dave Love <fx@gnu.org>
parents:
diff changeset
3193 This means that an expression is too complicated. You get the correct
Dave Love <fx@gnu.org>
parents:
diff changeset
3194 line number in the error message. The code must be rewritten with
Dave Love <fx@gnu.org>
parents:
diff changeset
3195 simpler expressions.
Dave Love <fx@gnu.org>
parents:
diff changeset
3196
56734
01528b0a38df Massively rearranged by category, to make environment
Eli Zaretskii <eliz@gnu.org>
parents: 56645
diff changeset
3197 *** XCONS, XSTRING, etc macros produce incorrect code.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3198
Dave Love <fx@gnu.org>
parents:
diff changeset
3199 If temacs fails to run at all, this may be the cause.
Dave Love <fx@gnu.org>
parents:
diff changeset
3200 Compile this test program and look at the assembler code:
Dave Love <fx@gnu.org>
parents:
diff changeset
3201
Dave Love <fx@gnu.org>
parents:
diff changeset
3202 struct foo { char x; unsigned int y : 24; };
Dave Love <fx@gnu.org>
parents:
diff changeset
3203
Dave Love <fx@gnu.org>
parents:
diff changeset
3204 lose (arg)
Dave Love <fx@gnu.org>
parents:
diff changeset
3205 struct foo arg;
Dave Love <fx@gnu.org>
parents:
diff changeset
3206 {
Dave Love <fx@gnu.org>
parents:
diff changeset
3207 test ((int *) arg.y);
Dave Love <fx@gnu.org>
parents:
diff changeset
3208 }
Dave Love <fx@gnu.org>
parents:
diff changeset
3209
Dave Love <fx@gnu.org>
parents:
diff changeset
3210 If the code is incorrect, your compiler has this problem.
Dave Love <fx@gnu.org>
parents:
diff changeset
3211 In the XCONS, etc., macros in lisp.h you must replace (a).u.val with
Dave Love <fx@gnu.org>
parents:
diff changeset
3212 ((a).u.val + coercedummy) where coercedummy is declared as int.
Dave Love <fx@gnu.org>
parents:
diff changeset
3213
96602
0e3e875ffade * lisp.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 95004
diff changeset
3214 This problem will only happen if USE_LISP_UNION_TYPE is manually
0e3e875ffade * lisp.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 95004
diff changeset
3215 defined in lisp.h.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3216
108807
2fde4b52f1ed * etc/PROBLEMS: Remove some more obsolete information.
Glenn Morris <rgm@gnu.org>
parents: 108800
diff changeset
3217 ** C compilers lose on returning unions.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3218
Dave Love <fx@gnu.org>
parents:
diff changeset
3219 I hear that some C compilers cannot handle returning a union type.
Dave Love <fx@gnu.org>
parents:
diff changeset
3220 Most of the functions in GNU Emacs return type Lisp_Object, which is
Dave Love <fx@gnu.org>
parents:
diff changeset
3221 defined as a union on some rare architectures.
Dave Love <fx@gnu.org>
parents:
diff changeset
3222
96602
0e3e875ffade * lisp.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 95004
diff changeset
3223 This problem will only happen if USE_LISP_UNION_TYPE is manually
0e3e875ffade * lisp.h:
Dan Nicolaescu <dann@ics.uci.edu>
parents: 95004
diff changeset
3224 defined in lisp.h.
25853
Dave Love <fx@gnu.org>
parents:
diff changeset
3225
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3226
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3227 This file is part of GNU Emacs.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3228
95004
cbf5528cf447 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94606
diff changeset
3229 GNU Emacs is free software: you can redistribute it and/or modify
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3230 it under the terms of the GNU General Public License as published by
95004
cbf5528cf447 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94606
diff changeset
3231 the Free Software Foundation, either version 3 of the License, or
cbf5528cf447 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94606
diff changeset
3232 (at your option) any later version.
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3233
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3234 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
3235 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
3236 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
3237 GNU General Public License for more details.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3238
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3239 You should have received a copy of the GNU General Public License
95004
cbf5528cf447 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94606
diff changeset
3240 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3241
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75433
diff changeset
3242
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3243 Local variables:
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3244 mode: outline
97732
8a5e7f0bc116 Prevent pasting a region twice on an xterm or rxvt in X.
Robert J. Chassell <bob@rattlesnake.com>
parents: 97535
diff changeset
3245 paragraph-separate: "[ ]*$"
41836
09535ed6868f Use outline-mode.
Eli Zaretskii <eliz@gnu.org>
parents: 41793
diff changeset
3246 end:
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3247
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52010
diff changeset
3248 arch-tag: 49fc0d95-88cb-4715-b21c-f27fb5a4764a