How to use this cross-compiler
==============================

This bundle was compiled on Fedora Core 4, but it should
also work well on most recent Linux distros.  It includes
C and C++, and it is very easy to use.


1.  Unpack it:

    tar jxf xmingw-3.4.4.tar.bz2

2.  After unpacking, move it to /usr/local/xmingw.
    You need to be root.

    mv xmingw /usr/local

3.  Prepend /usr/local/xmingw/bin to your PATH.

    csh:
    setenv PATH /usr/local/xmingw/bin:$PATH

    bash:
    export PATH=/usr/local/xmingw/bin:$PATH

    Do -not- add /usr/local/xmingw/i686-pc-mingw32/bin
    to your path.  This will almost certainly conflict with
    your system compiler, and cause bad things to happen.


4.  Invoke the compiler by name, not as 'gcc' or 'g++'.  Again,
    this avoids conflicts with your system tools.


    i686-pc-mingw32-gcc test.c -o test.exe

    i686-pc-mingw32-g++ test.cpp -o test.exe



    In your Makefile, this is easily done:

    CC = i686-pc-mingw32-gcc

    CXX = i686-pc-mingw32-g++


    Then use explicitly.  Example (remember to use tabs):
    ==============
    myfile.o: myfile.c
        $(CC) -o myfile.o $(CFLAGS) $(INC) myfile.c

    anotherfile.o: anotherfile.cpp
    	$(CXX) -o anotherfile.o $(CFLAGS) $(INC) anotherfile.cpp




    Or use it implicitly.  Example:
    ==============
    .cpp.o:
        $(CXX) $(CFLAGS) $(INC) -c -o $@ $<

    .c.o:
        $(CC) $(CFLAGS) $(INC) -c -o $@ $<



5.  Have fun!









Bob Jamison
(ishmal)