summaryrefslogtreecommitdiff
path: root/hadrian/doc/windows.md
diff options
context:
space:
mode:
authorBen Gamari <ben@smart-cactus.org>2017-12-08 12:42:35 -0500
committerBen Gamari <ben@smart-cactus.org>2017-12-08 13:22:41 -0500
commit7733e44dd4ba7e7a0a9f3456e6ddc32decbcf5a3 (patch)
tree79c5e7151d760e6c7617d8450fb9ec2a10560989 /hadrian/doc/windows.md
parent5695f462f604fc63cbb45a7f3073bc114f9b475f (diff)
downloadhaskell-7733e44dd4ba7e7a0a9f3456e6ddc32decbcf5a3.tar.gz
Rip out hadrian subtree
Sadly subtrees haven't worked quite as well as we would have liked for developers. See Hadrian #440.
Diffstat (limited to 'hadrian/doc/windows.md')
-rw-r--r--hadrian/doc/windows.md69
1 files changed, 0 insertions, 69 deletions
diff --git a/hadrian/doc/windows.md b/hadrian/doc/windows.md
deleted file mode 100644
index b374074474..0000000000
--- a/hadrian/doc/windows.md
+++ /dev/null
@@ -1,69 +0,0 @@
-# Building GHC on Windows
-
-[![Windows status](https://img.shields.io/appveyor/ci/snowleopard/hadrian/master.svg?label=Windows)](https://ci.appveyor.com/project/snowleopard/hadrian)
-
-Here is how you can build GHC, from source, on Windows. We assume that `git` and `stack` are installed
-(see [prerequisites](https://github.com/snowleopard/hadrian/blob/master/doc/windows.md#prerequisites)).
-
-```sh
-# Get GHC and Hadrian sources; git core.autocrlf should be set to false (see Prerequisites section)
-git clone --recursive git://git.haskell.org/ghc.git
-cd ghc
-git clone git://github.com/snowleopard/hadrian
-
-# Download and install the bootstrapping GHC and MSYS2
-cd hadrian
-stack setup
-
-# Install utilities required during the GHC build process
-stack exec -- pacman -S autoconf automake-wrapper make patch python tar --noconfirm
-
-# Build Hadrian and dependencies (including GHC dependencies Alex and Happy)
-stack build
-
-# Build GHC
-stack exec hadrian -- --directory ".." -j --flavour=quickest
-
-# Test GHC
-cd ..
-inplace\bin\ghc-stage2 -e 1+2
-```
-
-The entire process should take about 20 minutes. Note, this will build GHC without
-optimisations. If you need an optimised GHC, drop the `--flavour=quickest` flag from
-the build command line (this will slow down the build to about an hour).
-
-These are currently not the
-[official GHC building instructions](https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation/Windows),
-but are much simpler and may also be more robust.
-
-The `stack build` and `stack exec hadrian` commands can be replaced by an invocation
-of Hadrian's Stack-based build script: `build.stack.bat -j --flavour=quickest`. Use this
-script if you plan to work on Hadrian and/or rebuild GHC often.
-
-## Prerequisites
-
-The above works on a clean machine with `git` and `stack` installed (tested with default
-installation settings), which you can get from https://git-scm.com/download/win and
-https://www.stackage.org/stack/windows-x86_64-installer.
-
-Note that `git` should be configured to check out Unix-style line endings. The default behaviour
-of `git` on Windows is to check out Windows-style line endings which can cause issues during the
-build. This can be changed using the following command:
-
- git config --global core.autocrlf false
-
-If you would like to restore the default behaviour later run:
-
- git config --global core.autocrlf true
-
-## Testing
-
-These instructions have been tested on a clean Windows 10 machine using the
-[free VirtualBox image](https://dev.windows.com/en-us/microsoft-edge/tools/vms/windows/),
-and are also routinely tested on
-[Hadrian's AppVeyor CI instance](https://ci.appveyor.com/project/snowleopard/hadrian/history).
-
-## Notes
-
-Beware of the [current limitations of Hadrian](https://github.com/snowleopard/hadrian#current-limitations).