--- a/PROBLEMS	Wed May 09 13:43:58 2001 +0000
+++ b/PROBLEMS	Wed May 09 13:46:55 2001 +0000
@@ -20,10 +20,10 @@
 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
@@ -552,60 +552,53 @@
 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
-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).
 
-*** X11 not detected.
+*** Syntax errors running configure scripts, make failing with exit code 127
+    in inexplicable situations, etc.
 
-This is usually because xmkmf is not in your path or 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. I recommend replacing sh.exe with bash.exe, this will
-mean configure is slower but more reliable.
+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.
 
-*** 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.
+*** Lots of compile errors, esp. on lines containing macro definitions
+    terminated by backslashes.
 
-*** ^G does not work on hung subprocesses.
-
-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.
-
-*** The XEmacs executable crashes at startup.
+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.
 
-This can be caused by many things.
+*** Errors from make like /c:not found.
 
-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.
+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).
 
 *** The info files will not build.
 
-makeinfo that ships with cygwin (all versions) is a noop. You need to
+makeinfo that ships with Cygwin (all versions) doesn't work.  You need to
 obtain makeinfo from somewhere or build it yourself.
 
-*** I have no graphics.
-
-You need to obtain the various graphics libraries. Pre-built versions
-of these and the X libraries are located on the XEmacs website in
-ftp://ftp.xemacs.org/pub/aux/cygwin*.
+*** XEmacs hangs while attempting to rebuild the .elc files.
 
-*** There are no images in the toolbar buttons.
+Check to make sure you're not configuring with rel-alloc.  The relocating
+allocator does not currently work under Cygwin due to bugs in Cygwin's
+mmap().
 
-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.
+*** Trying to build with X, but X11 not detected.
+
+This is usually because xmkmf is not in your path or because you are
+using the default cygwin shell. (See above.)
 
 
 * Problems with running XEmacs
@@ -1704,13 +1697,37 @@
 
 
 ** 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)