This commit was generated by cvs2svn to compensate for changes in r5086,

[chise/xemacs-chise.git.1] / PROBLEMS

diff --git a/PROBLEMS b/PROBLEMS
index 2daf276..8525d37 100644 (file)
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -20,10 +20,10 @@ info about the Outline mode.
 Also, Try finding the things you need using one of the search commands
 XEmacs provides (e.g. `C-s').
 
 Also, Try finding the things you need using one of the search commands
 XEmacs provides (e.g. `C-s').
 

-A general advice:
-    WATCH OUT for .emacs file!  ~/.emacs is your Emacs init file.  If
-    you observe strange problems, invoke XEmacs with the `-q' option
-    and see if you can repeat the problem.
+General advice:
+    WATCH OUT for your init file! (~/.xemacs/init.el or ~/.emacs)  If
+    you observe strange problems, invoke XEmacs with the `-vanilla'
+    option and see if you can repeat the problem.

 
 
 * Problems with building XEmacs
 
 
 * Problems with building XEmacs

@@ -552,12 +552,38 @@ Note: Much of the above entry is probably not valid for XEmacs 21.0
 and later.
 
 ** Cygwin
 and later.
 
 ** Cygwin

+

 *** In general use etc/check_cygwin_setup.sh to trap environment problems.
 
 The script etc/check_cygwin_setup.sh will attempt to detect whether
 *** In general use etc/check_cygwin_setup.sh to trap environment problems.
 
 The script etc/check_cygwin_setup.sh will attempt to detect whether

-you have a suitable environment for building. This script may not work
+you have a suitable environment for building.  This script may not work

 correctly if you are using ash instead of bash (see below).
 
 correctly if you are using ash instead of bash (see below).
 

+*** Syntax errors running configure scripts, make failing with exit code 127
+    in inexplicable situations, etc.
+
+This may be because you are using the default cygwin shell.  The
+default cygwin shell (/bin/sh.exe) is ash which appears to work in
+most circumstances but has some weird failure modes.  You need to
+replace the symlink with bash.exe.
+
+*** Lots of compile errors, esp. on lines containing macro definitions
+    terminated by backslashes.
+
+Your partition holding the source files is mounted binary.  It needs
+to be mounted text. (This will not screw up any binary files because
+the Cygwin utilities specify explicitly whether they want binary or
+text mode when working with source vs. binary files, which overrides
+the mount type.) To fix this, you just need to run the appropriate
+mount command once -- afterwards, the settings are remembered in the
+registry.
+
+*** Errors from make like /c:not found.
+
+make sure you set the environment variable MAKE_MODE to UNIX in your
+.bashrc, Control Panel (Windows 2000/NT), or AUTOEXEC.BAT (Windows
+98/95).
+

 *** X11 not detected.
 
 This is usually because xmkmf is not in your path or because you are
 *** X11 not detected.
 
 This is usually because xmkmf is not in your path or because you are

@@ -568,10 +594,9 @@ mean configure is slower but more reliable.
 
 *** Subprocesses do not work.
 
 
 *** Subprocesses do not work.
 

-You do not have "tty" in your CYGWIN32 (for b19) or CYGWIN (for b20)
-environment variable. This must be set in your autoexec.bat (win95) or
-the system properties (winnt) as it must be read before the cygwin dll
-initializes.
+You do not have "tty" in your CYGWIN environment variable. This must
+be set in your autoexec.bat (win95) or the system properties (winnt)
+as it must be read before the cygwin DLL initializes.

 
 *** ^G does not work on hung subprocesses.
 
 
 *** ^G does not work on hung subprocesses.
 

@@ -579,17 +604,6 @@ This is a known problem. It can be remedied with cygwin b20 or greater
 by defining BROKEN_SIGIO in src/s/cygwin32.h, however this currently
 leads to instability in XEmacs.
 
 by defining BROKEN_SIGIO in src/s/cygwin32.h, however this currently
 leads to instability in XEmacs.
 

-*** The XEmacs executable crashes at startup.
-
-This can be caused by many things.
-
-If you are running with X11 you need to have cygwin b19 or cygwin
-b20.1 or greater, cygwin b20 will not work.
-
-If you are running with cygwin b19 make sure you are using egcs 1.0.2
-rather than vanilla gcc. XEmacs builds by default with -O3 which does
-not work with the gcc that ships with b19. Alternatively use -O2.
-

 *** The info files will not build.
 
 makeinfo that ships with cygwin (all versions) is a noop. You need to
 *** The info files will not build.
 
 makeinfo that ships with cygwin (all versions) is a noop. You need to

@@ -597,9 +611,9 @@ obtain makeinfo from somewhere or build it yourself.
 
 *** I have no graphics.
 
 
 *** I have no graphics.
 

-You need to obtain the various graphics libraries. Pre-built versions
+You need to obtain the various graphics libraries.  Pre-built versions

 of these and the X libraries are located on the XEmacs website in
 of these and the X libraries are located on the XEmacs website in

-ftp://ftp.xemacs.org/pub/aux/cygwin*.
+ftp://ftp.xemacs.org/pub/aux/cygwin/.

 
 *** There are no images in the toolbar buttons.
 
 
 *** There are no images in the toolbar buttons.
 

@@ -734,7 +748,7 @@ may need to add "#define static" to the m- or the s- file.
 Try evaluating the form (setq lock-directory nil) and see if that helps.
 There is a problem with file-locking on some systems (possibly related
 to NFS) that I don't understand.  Please send mail to the address
 Try evaluating the form (setq lock-directory nil) and see if that helps.
 There is a problem with file-locking on some systems (possibly related
 to NFS) that I don't understand.  Please send mail to the address

-xemacs@xemacs.org if you figure this one out.
+xemacs-beta@xemacs.org if you figure this one out.

 
 *** When emacs starts up, I get lots of warnings about unknown keysyms.
 
 
 *** When emacs starts up, I get lots of warnings about unknown keysyms.
 

@@ -913,7 +927,7 @@ redisplay on the traditional terminals, or over slow lines can be very
 slow.
 
 If you are interested in fixing this, please let us know at
 slow.
 
 If you are interested in fixing this, please let us know at

-<xemacs@xemacs.org>.
+<xemacs-beta@xemacs.org>.

 
 *** Screen is updated wrong, but only on one kind of terminal.
 
 
 *** Screen is updated wrong, but only on one kind of terminal.
 

@@ -1305,6 +1319,27 @@ affected virtually all ioctl() calls.
 
 
 ** Linux
 
 
 ** Linux

+*** Debian
+**** XEmacs warns "Symbol `toggleClassRec' has different size in shared
+     object, consider re-linking / Symbol `labelClassRec' has different
+     size in shared object, consider re-linking / Warning: Representation
+     size 4 must match superclass's to override value"
+
+Sometimes this results in segfaults when using the tab control widget
+or a progress bar widget.
+
+Some versions of Debian install 3D versions of the Athena widget
+library as /usr/X11R6/lib/libXaw.so.  We have not yet solved the
+problem of identifying the actual library in use in ./configure, so it
+is possible for XEmacs to be compiled with reference to headers for
+"flat" Xaw but find a "3D" Xaw when loading.
+
+The straightforward solution is to rebuild XEmacs with additional
+configure options: --with-widgets=athena --with-athena=3d.
+
+There are several 3D Athena widget sets available; to see which ones
+are supported by XEmacs, use ./configure --usage.
+

 *** Mandrake
 
 The Mandrake Linux distribution is attempting to comprehensively
 *** Mandrake
 
 The Mandrake Linux distribution is attempting to comprehensively

@@ -1323,6 +1358,19 @@ XEmacs to use the Alt key" below.
 The color-gcc wrapper (see below) is in common use on the Mandrake
 platform.
 
 The color-gcc wrapper (see below) is in common use on the Mandrake
 platform.
 

+*** XEmacs configured with ESD crashes with a segmentation violation
+
+This often occurs when a progress bar pops up.
+
+The problem is that the ESD sound daemon manipulates interrupts in a
+way that disagrees with XEmacs.  The currently available workaround is
+not very satisfactory: remove ESD support.  Rebuild after
+reconfiguring with the option --with-sound=none[,native][,nas]
+
+The funny syntax (requiring the initial "none") is for backward
+compatibility, and may change.  Native sound and NAS do not cause the
+problem, so they may be added to the option to get some sound support.
+

 *** I want XEmacs to use the Alt key, not the XXX key, for Meta commands
 
 For historical reasons, XEmacs looks for a Meta key, then an Alt key.
 *** I want XEmacs to use the Alt key, not the XXX key, for Meta commands
 
 For historical reasons, XEmacs looks for a Meta key, then an Alt key.

@@ -1437,9 +1485,9 @@ file is not necessary with this approach.
 A newer problem is due to XEmacs changing to use the modern
 getaddrinfo() interface from the older gethostbyname() interface.  The
 solution above is insufficient, because getaddrinfo() by default tries
 A newer problem is due to XEmacs changing to use the modern
 getaddrinfo() interface from the older gethostbyname() interface.  The
 solution above is insufficient, because getaddrinfo() by default tries

-to get IPv6 information for localhost.  This always involves a dns
-lookup to get the CNAME, and the strategies above don't work.  It then
-falls back to IPv4 behavior.  This is good[tm]; trust us.
+to get IPv6 information for localhost (including the local X server).
+This always involves a dns lookup to get the CNAME, and the strategies
+above don't work.  It then falls back to IPv4 behavior.

 
 ***** Robust network case
 
 
 ***** Robust network case
 

@@ -1455,22 +1503,20 @@ IPv4 behavior.  Explicitly setting DISPLAY=127.0.0.1:0.0 (or whatever
 is appropriate) works in most cases.
 
 If you cannot or do not want to do that, you can hard code IPv4
 is appropriate) works in most cases.
 
 If you cannot or do not want to do that, you can hard code IPv4

-behavior in src/process-unix.c.  This is bad[tm], on your own head be
-it.  In the function unix_canonicalize_host_name() about ten lines
-down, change the statement
-
-  hints.ai_family = AF_UNSPEC;
-
-to
-
-  hints.ai_family = PF_INET;
+behavior in src/process-unix.c.  Add `--with-ipv6-cname=no" to your
+configure options and rebuild XEmacs.

 
 

-and rebuild XEmacs.
+*** XEmacs disappears after several sound events in succession

 
 

-getaddrinfo() is also called in src/sysdep.c:init_system_name() and in
-src/process-unix.c:unix_open_network_stream().  It should not be
-useful to make this change in either of those places.
+If esd is not running (e.g. you unchecked the run esd checkbox in the
+GNOME Configuration tool), every sound event will cause the esound
+client library to signal SIGUSR1.  It is not that difficult (hold down
+PgUp or PgDn, for example) to cause XEmacs to generate additional
+SIGUSR1 signals before the first handler has a chance to reset, so the
+second SIGUSR1 causes the default behavior of ending the process.

 
 

+The solution is either to build XEmacs with -sound=native,noesd or to make sure
+that esd is in fact running. 

 
 ** IRIX
 *** On Irix, I don't see the toolbar icons and I'm getting lots of
 
 ** IRIX
 *** On Irix, I don't see the toolbar icons and I'm getting lots of

@@ -1704,14 +1750,38 @@ GCC.
 
 
 ** Windows
 
 
 ** Windows

-*** Emacs exits with "X protocol error" when run with an X server for
-Windows.
+*** In general, the Windows code is less mature than the Unix code.
+
+The Windows code base is still changing quickly.  If you are
+experiencing problems, try the latest beta version to see if the
+problem still exists.  Also ask on xemacs-nt@xemacs.org.
+
+
+** Cygwin
+*** Subprocesses do not work.
+ 
+You do not have "tty" in your CYGWIN environment variable.  This must
+be set in your autoexec.bat (win95) or the system properties (winnt)
+as it must be read before the cygwin DLL initializes.
+
+*** ^G does not work on hung subprocesses.

 
 

-A certain X server for Windows had a bug which caused this.
-Supposedly the newer 32-bit version of this server doesn't have the
-problem.
+This is a known problem. It can be remedied by defining BROKEN_SIGIO
+in src/s/cygwin.h, however this currently leads to instability in XEmacs.
+(#### is this still true?)

 
 

+*** Errors from make like `/c:not found' when running `M-x compile'.

 
 

+Make sure you set the environment variable MAKE_MODE to UNIX in your
+init file (.xemacs/init.el), Control Panel (Windows 2000/NT), or
+AUTOEXEC.BAT (Windows 98/95).
+
+*** There are no images in the toolbar buttons.
+
+You need version 4.71 of commctrl.dll which does not ship with windows
+95. You can get this by installing IE 4.0 or downloading it from the
+microsoft website.
+ 

 
 * Compatibility problems (with Emacs 18, GNU Emacs, or previous XEmacs/lemacs)
 ==============================================================================
 
 * Compatibility problems (with Emacs 18, GNU Emacs, or previous XEmacs/lemacs)
 ==============================================================================