Integrate changes #9511,9514,9517 from maintperl into mainline.

README.win32 tweaks; add a note about alternative location for
getting a gcc-2.95.2 that will build perl properly on windows

add some notes about gutsy threading matters

many of the utilities interpolate literal paths within doublequotes
(fails on dosish platforms where path contains backslashes)

p4raw-link: @9517 on //depot/maint-5.6/perl: 541b948d383abe4f534f846ff692d582506919cf
p4raw-link: @9514 on //depot/maint-5.6/perl: c8c8f510c2814a9e3cbdb8e7ca306018e0f7c510
p4raw-link: @9511 on //depot/maint-5.6/perl: 58a9db026b6f67b774654d285ac34aceada86380

p4raw-id: //depot/perl@9518
p4raw-integrated: from //depot/maint-5.6/perl@9510 'copy in'
	utils/perldoc.PL x2p/find2perl.PL (@9312..) 'merge in'
	README.win32 (@9227..) x2p/s2p.PL (@9312..) pod/perlguts.pod
	(@9507..)

1 files changed, 42 insertions, 18 deletions

diff --git a/README.win32 b/README.win32
index 7d5ebd00fb..195170d1be 100644
--- a/README.win32
+++ b/README.win32
@@ -79,14 +79,14 @@ Fetch and install dmake somewhere on your path (follow the instructions
 in the README.NOW file).
 
 There exists a minor coexistence problem with dmake and Borland C++
-compilers. Namely, if a distribution have C files named with a mixed
+compilers.  Namely, if a distribution has C files named with mixed
 case letters, they will be compiled into appropriate .obj-files named
-with all lowercase letters, and every time when dmake will be invoked
+with all lowercase letters, and every time dmake is invoked
 to bring files up to date, it will try to recompile such files again.
-For example, Tk distribution have a lot of such files, resulting in
-multiple recompiling everytime dmake is invoked. To avoid this, you
-may use the script "sncfnmcs.pl" after successful build.  It is
-available in the win32 subdirectory.
+For example, Tk distribution has a lot of such files, resulting in
+needless recompiles everytime dmake is invoked.  To avoid this, you
+may use the script "sncfnmcs.pl" after a successful build.  It is
+available in the win32 subdirectory of the Perl source distribution.
 
 =item Command Shell
 
@@ -131,17 +131,41 @@ GCC-2.95.2 binaries can be downloaded from:
 
     ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/
 
+You also need dmake.  See L</"Make"> above on how to get it.
+
 The GCC-2.95.2 bundle comes with Mingw32 libraries and headers.
 
 Make sure you install the binaries that work with MSVCRT.DLL as indicated
 in the README for the GCC bundle.  You may need to set up a few environment
 variables (usually ran from a batch file).
 
-The version of gcc-2.95.2-msvcrt.exe released 7 November 1999 left out
-a fix for certain command line quotes, so be sure to download and install
-fixes/quote-fix-msvcrt.exe too.
+There are a couple of problems with the version of gcc-2.95.2-msvcrt.exe
+released 7 November 1999:
 
-You also need dmake.  See L</"Make"> above on how to get it.
+=over
+
+=item *
+
+It left out a fix for certain command line quotes.  To fix this, be sure
+to download and install the file fixes/quote-fix-msvcrt.exe from the above
+ftp location.
+
+=item *
+
+The definition of the fpos_t type in stdio.h may be wrong.  If your
+stdio.h has this problem, you will see an exception when running the
+test t/lib/io_xs.t.  To fix this, change the typedef for fpos_t from
+"long" to "long long" in the file i386-mingw32msvc/include/stdio.h,
+and rebuild.
+
+=back
+
+A potentially simpler to install (but probably soon-to-be-outdated) bundle
+of the above package with the mentioned fixes already applied is available
+here:
+
+    http://downloads.ActiveState.com/pub/staff/gsar/gcc-2.95.2-msvcrt.zip
+    ftp://ftp.ActiveState.com/pub/staff/gsar/gcc-2.95.2-msvcrt.zip
 
 =back
 
@@ -224,13 +248,13 @@ default path.  You will need to copy the DLLs reported by the messages
 from where Borland chose to install it, into the Windows system directory
 (usually somewhere like C:\WINNT\SYSTEM32) and rerun the test.
 
-If you're using Borland compiler versions 5.2 and below, you're risking
-to face a problem with finding incorrect header files. Don't be surprised
-when during compiling perl extension "Tk" you will fail because both perl
-and tk contain a header file with same name - "patchlevel.h".  The latest
-Borland compilers are free of this misbehaviour, and they even invented
-option -VI- for backward (bugward) compatibility as "Use old Borland
-search algorithm  to locate header files".
+If you're using Borland compiler versions 5.2 and below, you may run into
+problems finding the correct header files when building extensions.  For
+example, building the "Tk" extension may fail because both perl and Tk
+contain a header file called "patchlevel.h".  The latest Borland compiler
+(v5.5) is free of this misbehaviour, and it even supports an
+option -VI- for backward (bugward) compatibility for using the old Borland
+search algorithm  to locate header files.
 
 Please report any other failures as described under L<BUGS AND CAVEATS>.
 
@@ -687,6 +711,6 @@ Support for fork() emulation was added in 5.6 (ActiveState Tool Corp).
 
 Win9x support was added in 5.6 (Benjamin Stuhl).
 
-Last updated: 22 November 2000
+Last updated: 1 April 2001
 
 =cut