* README.MinGW: Add warnings about use of MSYS-RXVT, and about defective GnuWin32 versions of netpbm/libpng.

1 files changed, 17 insertions, 1 deletions

diff --git a/README.MinGW b/README.MinGW
index b567df6d..95ac8801 100644
--- a/README.MinGW
+++ b/README.MinGW
@@ -1,4 +1,4 @@
-    Copyright (C) 2003, 2004
+    Copyright (C) 2003, 2004, 2007
       Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
@@ -39,6 +39,15 @@
   BUILDING GROFF WITH MINGW
   -------------------------
 
+  *** WARNING ***
+  
+  Before commencing this procedure, you should ensure that you are running the
+  MSYS shell in a *native* Win32 console window, and not in any window managed
+  by the rxvt emulator provided with MSYS; (this emulator suffers from various
+  known defects, which will prevent successful completion of a groff build).
+
+  ******
+
   Assuming that you have obtained the appropriate groff distribution, and that
   you are already running an MSYS shell, then the configuration, compilation,
   and installation of groff, using MinGW, is performed in much the same way as
@@ -217,6 +226,13 @@
   Note that it is not necessary to install the above four packages in their
   entirety; of course, you may do so if you wish.
 
+  Further note that you are advised to avoid the netpbm-10.27 release from the
+  GnuWin32 download repository, as its pnmtopng.exe has been reported to fail
+  on even simple conversions, resulting in failure of the groff build process;
+  the earlier netpbm-10.18.4 has been found to work successfully.  Also, you
+  may find it necessary to use libpng-1.2.7, rather than libpng-1.2.8, in
+  conjunction with this earlier release of netpbm.
+
 
   GROFF RUNTIME ENVIRONMENT
   -------------------------