[PATCH] README.MinGW

[Martin Brecher]

Hi all, -

attached is a diff to correct some issues in README.MinGW, mostly minor
flaws, except for some additional help and fixed URLs.

Kudos to all for making GNUstep run on the beast :-)

Greetings,
Martin
--
I love the smell of Blue Screens in the morning.

--- README.MinGW        Thu Jan  9 18:05:42 2003
+++ README.MinGW.new    Sun Feb 23 17:56:08 2003
@@ -1,11 +1,12 @@
-Date:  09-Jan-2003 (tested under windoze-xp)
+Date:  09-Jan-2003 (tested under Windows XP)
+Update: 23-Feb-2003 (also tested under Windows 2000)
 Author: Richard Frith-Macdonald <rfm@gnu.org>
 
 PURPOSE
 -------
 
 This document is intended to provide a step by step instruction on how
-to get the GNUstep base library into a usable state on a recent windows
+to get the GNUstep base library into a usable state on a recent Windows
 operating system (XP, 2000, and probably NT).
 
 MinGW is a collection of header files and import libraries that allow
@@ -34,10 +35,10 @@
 PRELIMINARIES
 -------------
 
-Before we start, we need to get some preliminary windoze software -
+Before we start, we need to get some preliminary Windows software -
 a tool for fetching source code via CVS.
 
-If you don't want to use windows tools for this, you can get the
+If you don't want to use Windows tools for this, you can get the
 latest cygwin distribution and use the cvs client in that. The following is
 for people who don't want to download all that cygwin stuff.
 
@@ -46,7 +47,7 @@
 to be a system administrator on your machine to install this software.
 You should be able to use it without changing/setting any special
 configuration options.  The one thing to remember is that the checkbox
-to select whether to use unix line terminators instead of windows/DOS
+to select whether to use UNIX line terminators instead of Windows/DOS
 line terminators should be set to the unix option.
 
 
@@ -72,7 +73,7 @@
 
 You may need to edit /mingw/include/winsock2.h to change the size of the
 sa_data field in the sockaddr structure from 14 to 22 ... this is because
-newer versions of windoze have changed the layout of this structure.
+newer versions of Windows have changed the layout of this structure.
 This modification is needed to be able to correctly determine the
 network interface details for your machine.
 
@@ -87,8 +88,8 @@
 variables to point to the home directory you wish to work from (though
 the defaults may be ok for you).
 NB. This home directory for building software must *not* contain spaces.
-(aside - MSYS uses the unix-style HOME environment variable, but windows
-programs, including GNUstep programs under windows, use the HOMEDRIVE and
+(aside - MSYS uses the UNIX-style HOME environment variable, but Windows
+programs, including GNUstep programs under Windows, use the HOMEDRIVE and
 HOMEPATH environment variables to build a windows-style path for the home
 directory.  eg. if HOMEDRIVE is C: and HOMEPATH is \MyHome then the path
 to the home directory is C:\MyHome).
@@ -156,7 +157,11 @@
 export GNUSTEP_SYSTEM_ROOT=/C/GNUstep/System
 . $GNUSTEP_SYSTEM_ROOT/Makefiles/GNUstep.sh
 
-
+NOTE: Sometimes the HOME variable may already be set by Windows to be
+%USERPROFILE% (which is the Windows variable that contains the path of
+your home folder). MSYS has problems with that as it doesn't recognise
+that %USERPROFILE% is a variable name. Be sure to check that if you run
+into errors.
 
 Building and installing FFCALL
 ------------------------------
@@ -175,8 +180,12 @@
  --libdir=$GNUSTEP_SYSTEM_ROOT/Libraries/ix86/mingw32 \
  --includedir=$GNUSTEP_SYSTEM_ROOT/Headers
 
-Having configured the ffcall library, you can now build and install
-it simply by typing:
+Having configured the ffcall library, you have to 
+
+  mkdir $GNUSTEP_SYSTEM_ROOT/Libraries/ix86
+  
+because the directory doesn't seem to be created automatically.
+Now you can now build and install it simply by typing:
 
   make
   make install
@@ -212,7 +221,7 @@
   Needed for multilingual character support (unicode etc)
 
   Get the binary package from
-  http://www.fh-frankfurt.de/~igor/projects/libxml
+  http://www.zlatkovic.com/projects/libxml/index.html 
   Unpack this and
     cp include/iconv.h $GNUSTEP_SYSTEM_ROOT/Headers
     cp lib/iconv.lib $GNUSTEP_SYSTEM_ROOT/Libraries/ix86/mingw32/libiconv.a
@@ -224,14 +233,19 @@
 
   Get the binary packages from -
   http://prdownloads.sourceforge.net/gnuwin32/tiff-3.5.7-lib.zip
+  http://prdownloads.sourceforge.net/gnuwin32/tiff-3.5.7-bin.zip
   http://prdownloads.sourceforge.net/gnuwin32/libjpeg-6b-lib.zip
   http://prdownloads.sourceforge.net/gnuwin32/libjpeg-6b-bin.zip
   http://prdownloads.sourceforge.net/gnuwin32/zlib-1.1.4-lib.zip
+  http://prdownloads.sourceforge.net/gnuwin32/zlib-1.1.4-bin.zip
+  
   Unpack and install
   the header (.h) files in $GNUSTEP_SYSTEM_ROOT/Headers
   the library (.lib) files in $GNUSTEP_SYSTEM_ROOT/Libraries/ix86/mingw32
   the dll files in $GNUSTEP_SYSTEM_ROOT/Tools/ix86/mingw32
 
+  Be sure to rename the .lib files to .a!
+
 
 
 The following are libraries which are not currently used, but which will
@@ -241,7 +255,7 @@
   Needed for XML parsing support, for MacOS-X compatible
   property lists, and for documentation processing.
   NB. at the time of writing, XML support in GNUstep base has *not*
-  been ported to windows - but when it is, you will need this package.
+  been ported to Windows - but when it is, you will need this package.
 
   Get the binary package from
   http://www.fh-frankfurt.de/~igor/projects/libxml
@@ -255,7 +269,7 @@
 openssl
   Needed for the SSL bundle, providing HTTPS support for NSURL.
   NB. at the time of writing, SSL support in GNUstep base has *not*
-  been ported to windows - but when it is, you will need this package.
+  been ported to Windows - but when it is, you will need this package.
   Get the binary package from
   http://www.kix.or.jp/~fujino/openssl
   Unpack this and
@@ -293,8 +307,8 @@
 Building and installing GNUstep-back
 ------------------------------------
 
-This software is PRE-ALPHA ... it is present in CVS for people who which to
-help porting the GNUstep backend to windows!
+This software is PRE-ALPHA ... it is present in CVS for people who wish to
+help porting the GNUstep backend to Windows!
 
 In the back directory, type
 
@@ -306,6 +320,13 @@
 
 Troubleshooting
 ---------------
+
+Issues with updating:
+Before attempting to update your GNUstep installation, be sure to stop/kill
+all running GNUstep programs or services (i.e. gdomap, gdnc, gpbs) since
+Windows cannot overwrite files that are currently in use.
+
+
 
 Good Sites for Pre-Compiled Binaries
 ------------------------------------