Changes between Version 48 and Version 49 of Building/Windows


Ignore:
Timestamp:
Mar 16, 2009 10:43:46 AM (6 years ago)
Author:
simonmar
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Building/Windows

    v48 v49  
    11 
    2 [[PageOutline]] 
    32 
    4 = Instructions for building under Windows = 
    5 This section gives detailed instructions for how to build  
    6 GHC from source on your Windows machine. Similar instructions for 
    7 installing and running GHC may be found in the user guide. In general, 
    8 Win95/Win98 behave the same, and WinNT/Win2k behave the same. 
    9  
    10 Make sure you read the preceding section on [wiki:Building/PlatformsScriptsFileNames platforms] 
    11 before reading section. 
    12 You don't need Cygwin or MSYS to ''use'' GHC,  
    13 but you do need one or the other to ''build'' GHC. 
    14  
    15 == Summary == 
    16  
    17  1. [wiki:Building/Prerequisites#PreparingaWindowssystem Get the tools you need for development] 
    18  2. Get the [wiki:Building/GettingTheSources GHC sources] 
    19  3. [wiki:Building/Windows/SSH Configure SSH] (if you need it) 
    20  4. [wiki:Building/Windows#BuildingGHC Do the build] 
    21  
    22 == Building GHC == 
    23  
    24 OK!   
    25 Now go read the documentation above on building from source ([wiki:Building/QuickStart Quick start: just building and installing GHC]);  
    26 the bullets below only tell 
    27 you about Windows-specific wrinkles. Also look in the section that immediately follows 
    28 this one for typical failure cases and what do to about them. 
    29  
    30  * After {{{sh boot}}} run {{{./configure}}} in 
    31    {{{$(TOP)/}}} thus: 
    32    {{{ 
    33 $ ./configure --host=i386-unknown-mingw32 
    34          --with-gcc=c:/mingw/bin/gcc 
    35          --with-ld=c:/mingw/bin/ld.exe 
    36 }}} 
    37    This is the point at which you specify that you are building GHC-mingw 
    38    (see [wiki:Building/PlatformsScriptsFileNames#MinGW MinGW]).  
    39    [[br]] 
    40    Both these options are important! It's possible to get into 
    41    trouble using the wrong C compiler! 
    42    [[br]] 
    43  
    44  * You almost certainly want to set 
    45    {{{ 
    46 SplitObjs = NO 
    47 }}} 
    48    in your {{{build.mk}}} configuration file (see [wiki:Building/Using#Gettingthebuildyouwant Getting the build you want]). 
    49    This tells the build system not to split each library into a myriad of little object files, one 
    50    for each function.  Doing so reduces binary sizes for statically-linked binaries, but on Windows 
    51    it dramatically increases the time taken to build the libraries in the first place. 
     3If you're looking for instructions for building GHC on Windows, they are now incorporated in the main [wiki:Building Building Guide]. 
    524 
    535== A Windows build log using Cygwin ==