79dfcc2fa4d00852f656720dd9c6b968807872fd
[ghc.git] / doc / windows.md
1 # Building on Windows\r
2 \r
3 Here are a list of instructions to build GHC, from source, on Windows. I tested these instructions on a clean machine using the [free Windows 10 VirtualBox image](https://dev.windows.com/en-us/microsoft-edge/tools/vms/windows/) (I bumped the VM CPUs to 4, and RAM to 4096Mb). These instructions are not currently the official GHC building instructions, but might be simpler and more robust than those.\r
4 \r
5 The first step is to [install Stack](https://www.stackage.org/stack/windows-x86_64-installer) (I just accepted all the defaults), then open a command prompt and run:\r
6 \r
7         stack setup\r
8         stack install happy alex\r
9         stack exec -- pacman -S gcc binutils git automake-wrapper tar make patch autoconf --noconfirm\r
10         stack exec -- git clone --recursive git://git.haskell.org/ghc.git\r
11         cd ghc\r
12         stack exec -- git clone git://github.com/snowleopard/hadrian\r
13         stack build --stack-yaml=hadrian/stack.yaml --only-dependencies\r
14         stack exec --stack-yaml=hadrian/stack.yaml -- hadrian/build.bat -j\r
15 \r
16 The entire process should take about an hour.\r
17 \r
18 #### Future ideas\r
19 \r
20 Here are some alternatives that have been considered, but not yet tested. Use the instructions above.\r
21 \r
22 * The `pacman` install of `gcc` is probably not necessary, but it does pull in a lot of tools, some of which probably are necessary. Ideally thin the list down.\r
23 * Happy/Alex should be able to be installed by adding them as `build-tools` in the Cabal file.\r