#summary Instructions for building Hedgewars on Windows
#labels Phase-Implementation,Phase-Design,Phase-Support

= Prerequisites =

 # CMake - http://cmake.org/cmake/resources/software.html
 # FreePascal - http://www.freepascal.org/down/i386/win32-ftp.freepascal.org.var
 # Qt SDK - http://qt.nokia.com/downloads/sdk-windows-cpp-offline
 # TortoiseHg ( or command-line mercurial )
 # Source code of Hedgewars
 # Windows building archive - it contains everything you need to compile Hedgewars on Windows.

= Setup =
 # Install CMake, but please *ensure* you select "Add CMake to the system PATH for all users", so you can run CMake directly from command line.
 # Install FreePascal.
 # Install Qt SDK, with the "Custom" option:
  * Check "Qt SDK/Miscellaneous/MinGW <any version>"!
  * Check "Qt SDK/Development Tools/Desktop Qt/Qt <your version>/Desktop Qt <your version> - Mingw (it's the first checkbox)
  * Uncheck "Qt SDK/Development Tools/Symbian Toolchains"
  * Uncheck "Qt SDK/Development Tools/Harmattan"
 # Install TortoiseHg / mercurial
 # Restart the computer
 # Download the Hedgewars source, using mercurial:
  # Using TortoiseHg
   * Right-click in any folder on your computer
   * Select Tortoise HG -> Clone.
   * In the _Source_ textbox enter: https://hedgewars.googlecode.com/hg/
   * Press clone
  # Command-line mercurial
   * If you have Windows 7 skip the next 3 steps, and instead, SHIFT + Right click in the folder where you want to download the source.
   * Start _Run..._ ( WINDOWS Key + R , or Start -> Run... )
   * Enter:
{{{
cmd.exe
}}} 
   * Navigate to where you want to download the source
   * Type and execute ( The initial clone of the repository will take a while, is about 550MiB or so... ):
{{{
hg clone https://hedgewars.googlecode.com/hg/ trunk
}}}
 # Extract the Windows Building Archive to the hedgewars source folder, in the *bin* directory
 # Go to the "bin/build_windows.bat" file, and modify the following:
  * SET PASCAL=<put the path to the directory that contains fpc's executable (fpc.exe)> (for example: c:\FPC\2.4.4\bin\i386-win32\)
  * SET SET QTDIR=<path to the QtSDK\Desktop\Qt\<your version>> (for example: c:\QtSDK\Desktop\Qt\4.7.3\)
 # You can now build hedgewars, by running the *bin/build_windows.bat* command.

= Building process =
Run the *bin/build_windows.bat* file each time you want to build the source.