Getting started (for the experienced)
=====================================

Get yourself a copy of mingw-get, extract the archive into your "MinGW"
directory following established rules.


Getting started (for the inexperienced)
=======================================

Note: The mingw-get version number in this document was valid at the time
of writing. Be sure to adapt to the current version when you read this!

1) Create a "MinGW" directory somewhere.
    ! Keep the path as short as possible, you'll thank me later
    ! Make sure the path leading up to your "MinGW" directory does *not*
      contain spaces or non-ASCII characters.
      For example, "C:\MinGW" and "D:\bin\mingw" are good choices but
      "C:\Program Files\MinGW" is a very bad idea!
1) point your browser of choice at http://sourceforge.net/projects/mingw/files/
1) click "Installer"
1) click "mingw-get"
1) click "mingw-get-0.4-alpha-1"
1) download "mingw-get-0.4-mingw32-alpha-1-bin.zip"
1) extract the contents of "mingw-get-0.4-mingw32-alpha-1-bin.zip" into
  your "MinGW" directory


Installing MinGW and MSYS
=========================

Note: If you're behind a restrictive/authenticating corporate firewall
and mingw-get fails to download the package catalogues or packages you
should start Internet Explorer and navigate to some website like
www.mingw.org, then try again.

Open a command prompt (cmd.exe), navigate to your "MinGW/bin" directory
and execute following commands::
    mingw-get update
    mingw-get install mingw-get
    copy ..\var\lib\mingw-get\data\defaults.xml ..\var\lib\mingw-get\data\profile.xml
    mingw-get install mingw32-gcc
    mingw-get install mingw32-g++
    mingw-get install mingw-developer-toolkit
    ..\msys\1.0\msys.bat

You will find yourself looking at a bash session. Right click the icon
in the title bar and click "Properties". Go to the "Options" tab and
enable "QuickEdit Mode". Go to the "Font" tab and select "Lucida Console".
Click the "OK" button.

Back in your bash session, execute /postinstall/pi.sh to finilize your
MinGW/MSYS installation. It should look something like this:
    $ /postinstall/pi.sh

    This is a post install process that will try to normalize between
    your MinGW install if any as well as your previous MSYS installs
    if any.  I don't have any traps as aborts will not hurt anything.
    Do you wish to continue with the post install? [yn ] y

    Do you have MinGW installed? [yn ] y

    Please answer the following in the form of c:/foo/bar.
    Where is your MinGW installation? C:/MinGW

    Creating /etc/fstab with mingw mount bindings.
            Normalizing your MSYS environment.

    You have script /bin/cmd
    You have both /bin/ftp.exe and /bin/ftp.
    Removing /bin/ftp.

    Oh joy, you do not have C:/MinGW/bin/make.exe. Keep it that way.

Close this bash session (type exit or ^D followed by <return> or
<enter>) and start "..\msys\1.0\msys.bat" again.

Optionally create yourself a shortcut to the above msys.bat file to
save yourself some typing time. If you do, remember to enable
"QuickEdit Mode" and change the "Font" settings as described above
for the shortcut you create.


Using msysgit
=============

Make sure autocrlf is set to false before cloning repositories!