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

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

You need some additional source packages from the FSF

   The GNU compiler:  gcc-2.95.2
   The binary utilities (LD, as etc. ): binutils 2.8.1 or >= 2.9.1

   I think you need GNU make to install this package

Get them from the nearest mirror of "ftp.gnu.org".

The original package (for a native W32 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 2 required packages (gcc and binutils) 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.


How to create simple programs:
------------------------------
This is easy: get the name of the compiler by using the command

   mingw32 --get-path gcc

or call gcc directly using:

   mingw32 gcc options_and_files_for_gcc

gcc works just like the standard gcc with the only exception that the
excutable files are name ".exe".  Autoconf based programs may work
with the option "--host i386--ming32".  For compiling GTK+ based
programs you should pass the option "-fnative-struct" to gcc


How to create DLLs:
-------------------
Include the option "-dll" in the commandline and use ldsh (a tool which
comes 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

    cpd-bugs@openit.de

There is a mailing list <cpd-list@openit.de>; to subscribe send a mail with
a subject of "subscribe" to <cpd-list-request@openit.de>


