diff --git a/README b/README
index db8c956..4709211 100644
--- a/README
+++ b/README
@@ -2,7 +2,7 @@
 
 Wine is a program which allows running Microsoft Windows programs
 (including DOS, Windows 3.x and Win32 executables) on Unix.  It
-consists of a program loader which loads and executes an Microsoft
+consists of a program loader which loads and executes a Microsoft
 Windows binary, and a library that implements Windows API calls using
 their Unix or X11 equivalents. The library may also be used for
 porting Win32 code into native Unix executables.
@@ -12,22 +12,30 @@
 that you wrote it.
 
 
-2. COMPILATION
+2. REQUIREMENTS
 
-To compile and run Wine, you must have one of:
+To compile and run Wine, you must have one of the following:
 
 	Linux version 2.0.36 or above
 	FreeBSD-current or FreeBSD 3.0 or later
 	Solaris x86 2.5 or later
 
-You also need to have libXpm installed on your system. The sources for
-it are probably available on the ftp site where you got Wine. They can
-also be found on ftp.x.org and all its mirror sites. If you are using
-RedHat, install the xpm and xpm-devel packages.
+Although Linux version 2.0.x will mostly work, certain features
+(specifically LDT sharing) required for properly supporting Win32
+threads were not implemented until kernel version 2.2.  If you get
+consistent thread-related crashes, you may want to upgrade to 2.2.
 
-On x86 Systems gcc >= 2.7.2 is required. You also need flex and yacc.
-Bison will work as a replacement for yacc. If you are using RedHat, 
-install the flex and bison packages.
+You also need to have libXpm installed on your system. The sources for
+it are probably available on the FTP site where you got Wine. They can
+also be found on ftp.x.org and all its mirror sites. If you are using
+RedHat, install the xpm and xpm-devel packages. Debian users need
+xpm4.7, xpm4g, and xpm4g-dev 3.4j.
+
+On x86 Systems gcc >= 2.7.2 is required. You also need flex version 2.5
+or later and yacc. Bison will work as a replacement for yacc. If you are
+using RedHat, install the flex and bison packages.
+
+3. COMPILATION
 
 To build Wine, first run "./configure" and then run "make depend; make".
 This will build the library "libwine.a" and the program "wine".
@@ -49,7 +57,7 @@
 run "make depend; make".
 
 
-3. SETUP
+4. SETUP
 
 Once Wine has been built correctly, you can do "make install"; this
 will install the wine executable, the Wine man page, and a few other
@@ -66,7 +74,7 @@
 See www.winehq.com/config.html for further configuration hints.
 
 
-4. RUNNING PROGRAMS
+5. RUNNING PROGRAMS
 
 When invoking Wine, you may specify the entire path to the executable,
 or a filename only.
@@ -90,7 +98,7 @@
 see what information is required.
 
 
-5. GETTING MORE INFORMATION
+6. GETTING MORE INFORMATION
 
 FAQ:	The Wine FAQ is located at http://www.winehq.com/faq.html.
 
@@ -99,6 +107,9 @@
 	are available on the wine-patches mailing list; see 
 	http://www.winehq.com/dev.html#ml for more information.
 
+HOWTO:	A pre-release version of the Wine HOWTO is available at
+	http://www.westfalen.de/witch/wine-HOWTO.txt .
+
 Usenet:	Please browse old messages on http://www.dejanews.com/ to check whether 
 	your problem is already fixed before posting a bug report to the 
 	newsgroup. 
diff --git a/documentation/wine.man b/documentation/wine.man
index e5af0f8..89c710f 100644
--- a/documentation/wine.man
+++ b/documentation/wine.man
@@ -1,5 +1,5 @@
 .\" -*- nroff -*-
-.TH WINE 1 "February 3, 1999" "Version 990131" "Windows On Unix"
+.TH WINE 1 "April 26, 1999" "Version 990328" "Windows On Unix"
 .SH NAME
 wine \- run Windows programs on Unix
 .SH SYNOPSIS
@@ -21,22 +21,25 @@
 ones.  A large percentage of the API has been implemented, although there
 are still several major pieces of work left to do.
 .SH REQUIREMENTS
-At present, 
 .B wine
-will run under any Linux kernel more recent than 0.99.13, or
-under recent releases of NetBSD/i386, FreeBSD and OpenBSD/i386. Some bugs
-were fixed and additional features were added late in the Linux 2.0.x 
-series, so if you have an old Linux kernel, you may want to upgrade to the
-latest 2.0.x release. If you have FreeBSD, make sure you have the USER_LDT,
+requires kernel-level threads to run. Currently, only Linux version 2.0
+or later, FreeBSD-current or FreeBSD 3.0 or later, and Solaris x86
+version 2.5 or later are supported. Other operating systems which support
+kernel threads may be supported in the future.
+.PP
+Although Linux version 2.0 will mostly work, certain features (specifically
+LDT sharing) required for properly supporting Win32 threads were not
+implemented until kernel version 2.2. If you get consistent thread-related
+crashes, you may want to upgrade to 2.2. Also, some bugs were fixed and
+additional features were added late in the Linux 2.0.x series, so if you have
+a very old Linux kernel, you may want to upgrade to at least the latest 2.0.x
+release.
+.PP
+If you have FreeBSD, make sure you have the USER_LDT,
 SYSVSHM, SYSVSEM, and SYSVMSG options turned on in your kernel. If you
 are building Wine on Solaris, you will most likely need to build Wine
 with the GNU toolchain (gcc, gas, etc.)
 .PP
-The current support for multithreaded applications relies on the 
-.BR clone (2)
-system call, which is currently only available on Linux. It should be
-possible to implement this for other operating systems, however.
-.PP
 .B X
 must be installed.  To use Wine's support for multithreaded applications,
 your X libraries must be reentrant.  If you have libc6 (glibc2), or you 
@@ -54,7 +57,7 @@
 section to get it included in this man page.
 .PP
 .B gcc
-2.7.x or later is required to build
+2.7.2 or later is required to build
 .B wine.
 Versions earlier than 2.7.2.3 may have problems when certain files are
 compiled with optimization.
@@ -63,7 +66,7 @@
 currently doesn't work with wine.  The cause of this problem is unknown. 
 .PP
 .B flex
-and 
+version 2.5 or later and 
 .B yacc
 are required.  Bison can be used in replace of yacc. If you have Redhat,
 make sure the bison and flex packages are installed.