	  Minimalist GNU-Win32 / Cross Platform Development
	      Version 0.1 based on mingw32 version 0.1.4
			      23.06.97
		   Werner Koch <werner.koch@guug.de>

This is a system to create native win32 applications by using
a crosscompiler hosted on a Unix system. It is tested on Linux v2 and
works on i386 CPUs.

You need some additional source packages from the FSF

   The GNU compiler:  gcc-2.7.2.1
   The binary utilities (LD, as etc. ): binutils-2.8.1
   The win32 headers: windows32api-xxxx

Get them from the nearest mirror of "prep.ai.mit.edu".

The original package (for a native Win32 compiler) was created by
Colin Peters <colin@bird.fu.is.saga-u.ac.jp> and is based on the Cygwin32
Development kit (which uses a DLL to create a unix like environment).


The Introduction from Colin's original package:
-----------------------------------------------
Mingw32 is short for the Minimalist GNU-Win32 package, and it is a
package which allows you to use GCC (as supplied by Cygnus in their GNU-
Win32 or Cygwin32 package) the GNU compiler, on Win32 platforms like
Windows 95 or NT, to compile "native" programs.

In this case "native" means programs which don't require extra DLLs like
the Cygwin DLL. Mingw32 programs use CRTDLL.DLL to provide their C run
time library functions, and CRTDLL.DLL is supplied with all current
Win32 platforms. Thus the programs are light weight and easy to
distribute, they also do not automatically fall under the GNU Public
License as programs written with the GPL version of Cygwin32 do.

How to Install:
---------------

1) Get the 3 required packages (gcc, binutils and windows32api) and
   untar them. You need exactly these versions, because some small
   patches will be applied.

2) Untar this packages (okay, you done it already).

3) Run "./Configure" and answer all questions

4) Run "make install" and everything gets installed. You should be root or
   have all rights in the install-directory (/usr/local by default).

5) Include the "<install-path>/bin" directory into your PATH; because this
   is usually "/usr/local/bin" you actually don't have to do it.
   The tools can be called by prefixing them with "i386--mingw32-".


How to create simple programs:
------------------------------
This is easy: Name your compiler "i386--ming32-gcc" and it behaves just
like standard gcc (but the output file are suffixed with ".exe");


How to create DLLs:
-------------------
Include the option "-dll" in the commandline and use ldsh (a tool which
come with WkLib). You can also do it manually.

    1) Compile using "-c -dll".
    2) Link using the option "--base-file a.base"
    3) Create the relocation infos by running dlltool with the option
       "--base-file a.base"
    4) Link again and include the object file created by dlltool (with the
       relocation infos)
    5) Power on a Windoze95 or WinNT box and test the files.
       Hint: Use Samba on your Linux box to share your development tree
       with the windoze box.



Bugs:
-----
Send bug reports or questions to

    wk-mingw32@isil.d.shuttle.de

--
