+Known Problems with GNU Emacs
+
Copyright (C) 1987, 1988, 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
- 2001, 2002, 2003, 2004, 2005, 2006, 2007
+ 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
Free Software Foundation, Inc.
See the end of the file for license conditions.
The fix is to install an unshared library that corresponds to what you
installed in the shared library, and then relink Emacs.
-On SunOS 4.1, simply define HAVE_RES_INIT.
-
If you have already installed the name resolver in the file libresolv.a,
then you need to compile Emacs to use that library. The easiest way to
do this is to add to config.h a definition of LIBS_SYSTEM, LIBS_MACHINE
** Miscellaneous problems
+*** Emacs uses 100% of CPU time
+
+This is a known problem with some versions of the Semantic package.
+The solution is to upgrade Semantic to version 2.0pre4 (distributed
+with CEDET 1.0pre4) or later.
+
*** Self-documentation messages are garbled.
This means that the file `etc/DOC-...' doesn't properly correspond
This can occur when two different versions of FontConfig are used.
For example, XFree86 4.3.0 has one version and Gnome usually comes
-with a newer version. Emacs compiled with --with-gtk will then use
+with a newer version. Emacs compiled with Gtk+ will then use
the newer version. In most cases the problem can be temporarily
fixed by stopping the application that has the error (it can be
Emacs or any other application), removing ~/.fonts.cache-1,
To prevent this, turn off the Exceed's "automatic font substitution"
feature (in the font part of the configuration window).
+** Subscript/superscript text in TeX is hard to read.
+
+If `tex-fontify-script' is non-nil, tex-mode displays
+subscript/superscript text in the faces subscript/superscript, which
+are smaller than the normal font and lowered/raised. With some fonts,
+nested superscripts (say) can be hard to read. Switching to a
+different font, or changing your antialiasing setting (on an LCD
+screen), can both make the problem disappear. Alternatively, customize
+the following variables: tex-font-script-display (how much to
+lower/raise); tex-suscript-height-ratio (how much smaller than
+normal); tex-suscript-height-minimum (minimum height).
+
* Internationalization problems
** M-{ does not work on a Spanish PC keyboard.
Mac OS X that causes process output to be truncated. To avoid this,
leave process-connection-type set to its default value of nil.
-*** Mac OS X 10.3.9 (Carbon): QuickTime 7.0.4 updater breaks build.
+*** Mac OS X 10.3.9 (Carbon): QuickTime updater breaks build.
-On the above environment, build fails at the link stage with the
-message like "Undefined symbols: _HICopyAccessibilityActionDescription
-referenced from QuickTime expected to be defined in Carbon". A
-workaround is to use QuickTime 7.0.1 reinstaller.
+Some QuickTime updaters such as 7.0.4 and 7.2.0 are known to break
+build at the link stage with the message like "Undefined symbols:
+_HICopyAccessibilityActionDescription referenced from QuickTime
+expected to be defined in Carbon". A workaround is to use a QuickTime
+reinstaller. Alternatively, you can link with the frameworks in the
+corresponding SDK by specifying LDFLAGS as
+"-Wl,-F/Developer/SDKs/MacOSX10.3.0.sdk/System/Library/Frameworks".
** FreeBSD
Note the lower case <t>. Changing this line should make C-t work.
+*** On Solaris, Emacs fails to set menu-bar-update-hook on startup, with error
+"Error in menu-bar-update-hook: (error Point before start of properties)".
+This seems to be a GCC optimization bug that occurs for GCC 4.1.2 (-g
+and -g -O2) and GCC 4.2.3 (-g -O and -g -O2). You can fix this by
+compiling with GCC 4.2.3 or CC 5.7, with no optimizations.
+
** Irix
*** Irix 6.5: Emacs crashes on the SGI R10K, when compiled with GCC.
When "ClearType" method is selected as the "method to smooth edges of
screen fonts" (in Display Properties, Appearance tab, under
"Effects"), there are various problems related to display of
-characters: 2-pixel trace is left behind when moving overlays, bold
-fonts can be hard to read, small portions of some characters could
-appear chopped, etc. This happens because, under ClearType,
-characters are drawn outside their advertised bounding box. Emacs 21
-disabled the use of ClearType, whereas Emacs 22 allows it and has some
-code to enlarge the width of the bounding box. Apparently, this
-display feature needs more changes to get it 100% right. A workaround
-is to disable ClearType.
+characters: Bold fonts can be hard to read, small portions of some
+characters could appear chopped, etc. This happens because, under
+ClearType, characters are drawn outside their advertised bounding box.
+Emacs 21 disabled the use of ClearType, whereas Emacs 22 allows it and
+has some code to enlarge the width of the bounding box. Apparently,
+this display feature needs more changes to get it 100% right. A
+workaround is to disable ClearType.
There are problems with display if mouse-tracking is enabled and the
mouse is moved off a frame, over another frame then back over the first
of Windows. This is caused by a deficiency in the underlying system
library function.
+The function set-time-zone-rule gives incorrect results for many
+non-US timezones. This is due to over-simplistic handling of
+daylight savings switchovers by the Windows libraries.
+
Files larger than 4GB cause overflow in the size (represented as a
32-bit integer) reported by `file-attributes'. This affects Dired as
well, since the Windows port uses a Lisp emulation of `ls' that relies
you proceed to type another non-modifier key before you let go of Alt
and Shift, the Alt and Shift act as modifiers in the usual way. A
more permanent work around is to change it to another key combination,
-or disable it in the keyboard control panel.
+or disable it in the "Regional and Language Options" applet of the
+Control Panel. (The exact sequence of mouse clicks in the "Regional
+and Language Options" applet needed to find the key combination that
+changes the keyboard layout depends on your Windows version; for XP,
+in the Languages tab, click "Details" and then "Key Settings".)
** Cygwin build of Emacs hangs after rebasing Cygwin DLLs
*** Building the native MS-Windows port with Cygwin GCC can fail.
-Emacs may not build using recent Cygwin builds of GCC, such as Cygwin
+Emacs may not build using some Cygwin builds of GCC, such as Cygwin
version 1.1.8, using the default configure settings. It appears to be
necessary to specify the -mwin32 flag when compiling, and define
__MSVCRT__, like so:
to detect the shell correctly. Try "make SHELL=cmd.exe", or if that
fails, try running make from Cygwin bash instead.
-*** Building the MS-Windows port with Leim fails in the `leim' directory.
-
-The error message might be something like this:
-
- Converting d:/emacs-21.3/leim/CXTERM-DIC/4Corner.tit to quail-package...
- Invalid ENCODE: value in TIT dictionary
- NMAKE : fatal error U1077: '"../src/obj-spd/i386/emacs.exe"' : return code
- '0xffffffff'
- Stop.
-
-This can happen if the Leim distribution is unpacked with a program
-which converts the `*.tit' files to DOS-style CR-LF text format. The
-`*.tit' files in the leim/CXTERM-DIC directory require Unix-style line
-endings to compile properly, because Emacs reads them without any code
-or EOL conversions.
-
-The solution is to make sure the program used to unpack Leim does not
-change the files' line endings behind your back. The GNU FTP site has
-in the `/gnu/emacs/windows' directory a program called `djtarnt.exe'
-which can be used to unpack `.tar.gz' and `.zip' archives without
-mangling them.
-
*** Building `ctags' for MS-Windows with the MinGW port of GCC fails.
This might happen due to a bug in the MinGW header assert.h, which
GCC problem specific to the macppc architecture, possibly only
occurring with older versions of GCC (e.g. 3.3.5).
+*** openSUSE 10.3: Segfault in bcopy during dumping.
+
+This is due to a bug in the bcopy implementation in openSUSE 10.3.
+It is/will be fixed in an openSUSE update.
+
** Installation
*** Installing Emacs gets an error running `install-info'.
The only known fix: Don't run display-time.
-*** SunOS
-
-SunOS 4.1.4 stopped shipping on Sep 30 1998.
-
-**** SunOS: You get linker errors
- ld: Undefined symbol
- _get_wmShellWidgetClass
- _get_applicationShellWidgetClass
-
-**** Sun 4.0.x: M-x shell persistently reports "Process shell exited abnormally with code 1".
-
-This happened on Suns as a result of what is said to be a bug in Sunos
-version 4.0.x. The only fix was to reboot the machine.
-
-**** SunOS4.1.1 and SunOS4.1.3: Mail is lost when sent to local aliases.
-
-Many emacs mail user agents (VM and rmail, for instance) use the
-sendmail.el library. This library can arrange for mail to be
-delivered by passing messages to the /usr/lib/sendmail (usually)
-program . In doing so, it passes the '-t' flag to sendmail, which
-means that the name of the recipient of the message is not on the
-command line and, therefore, that sendmail must parse the message to
-obtain the destination address.
-
-There is a bug in the SunOS4.1.1 and SunOS4.1.3 versions of sendmail.
-In short, when given the -t flag, the SunOS sendmail won't recognize
-non-local (i.e. NIS) aliases. It has been reported that the Solaris
-2.x versions of sendmail do not have this bug. For those using SunOS
-4.1, the best fix is to install sendmail V8 or IDA sendmail (which
-have other advantages over the regular sendmail as well). At the time
-of this writing, these official versions are available:
-
- Sendmail V8 on ftp.cs.berkeley.edu in /ucb/sendmail:
- sendmail.8.6.9.base.tar.Z (the base system source & documentation)
- sendmail.8.6.9.cf.tar.Z (configuration files)
- sendmail.8.6.9.misc.tar.Z (miscellaneous support programs)
- sendmail.8.6.9.xdoc.tar.Z (extended documentation, with postscript)
-
- IDA sendmail on vixen.cso.uiuc.edu in /pub:
- sendmail-5.67b+IDA-1.5.tar.gz
-
-**** Sunos 4: You get the error ld: Undefined symbol __lib_version.
-
-This is the result of using cc or gcc with the shared library meant
-for acc (the Sunpro compiler). Check your LD_LIBRARY_PATH and delete
-/usr/lang/SC2.0.1 or some similar directory.
-
-**** SunOS 4.1.3: Emacs unpredictably crashes in _yp_dobind_soft.
-
-This happens if you configure Emacs specifying just `sparc-sun-sunos4'
-on a system that is version 4.1.3. You must specify the precise
-version number (or let configure figure out the configuration, which
-it can do perfectly well for SunOS).
-
-**** Sunos 4.1.3: Emacs gets hung shortly after startup.
-
-We think this is due to a bug in Sunos. The word is that
-one of these Sunos patches fixes the bug:
-
-100075-11 100224-06 100347-03 100482-05 100557-02 100623-03 100804-03 101080-01
-100103-12 100249-09 100496-02 100564-07 100630-02 100891-10 101134-01
-100170-09 100296-04 100377-09 100507-04 100567-04 100650-02 101070-01 101145-01
-100173-10 100305-15 100383-06 100513-04 100570-05 100689-01 101071-03 101200-02
-100178-09 100338-05 100421-03 100536-02 100584-05 100784-01 101072-01 101207-01
-
-We don't know which of these patches really matter. If you find out
-which ones, please inform bug-gnu-emacs@gnu.org.
-
-**** SunOS 4: Emacs processes keep going after you kill the X server
-(or log out, if you logged in using X).
-
-Someone reported that recompiling with GCC 2.7.0 fixed this problem.
-
-The fix to this is to install patch 100573 for OpenWindows 3.0
-or link libXmu statically.
-
**** Sunos 5.3: Subprocesses remain, hanging but not zombies.
A bug in Sunos 5.3 causes Emacs subprocesses to remain after Emacs
applies to ptys, and doesn't fix the problem with subprocesses
communicating through pipes.
-*** Apollo Domain
-
-**** Shell mode ignores interrupts on Apollo Domain.
-
-You may find that M-x shell prints the following message:
-
- Warning: no access to tty; thus no job control in this shell...
-
-This can happen if there are not enough ptys on your system.
-Here is how to make more of them.
-
- % cd /dev
- % ls pty*
- # shows how many pty's you have. I had 8, named pty0 to pty7)
- % /etc/crpty 8
- # creates eight new pty's
-
*** Irix
*** Irix 6.2: No visible display on mips-sgi-irix6.2 when compiling with GCC 2.8.1.
However, the easiest approach is to build Xlib with the default
floating point option: -fsoft.
-** SunOS: Undefined symbols _dlopen, _dlsym and/or _dlclose.
-
-If you see undefined symbols _dlopen, _dlsym, or _dlclose when linking
-with -lX11, compile and link against the file mit/util/misc/dlsym.c in
-the MIT X11R5 distribution. Alternatively, link temacs using shared
-libraries with s/sunos4shr.h. (This doesn't work if you use the X
-toolkit.)
-
-If you get the additional error that the linker could not find
-lib_version.o, try extracting it from X11/usr/lib/X11/libvim.a in
-X11R4, then use it in the link.
-
-** SunOS4, DGUX 5.4.2: --with-x-toolkit version crashes when used with shared libraries.
-
-On some systems, including Sunos 4 and DGUX 5.4.2 and perhaps others,
-unexec doesn't work properly with the shared library for the X
-toolkit. You might be able to work around this by using a nonshared
-libXt.a library. The real fix is to upgrade the various versions of
-unexec and/or ralloc. We think this has been fixed on Sunos 4
-and Solaris in version 19.29.
-
** HPUX 10.20: Emacs crashes during dumping on the HPPA machine.
This seems to be due to a GCC bug; it is fixed in GCC 2.8.1.