summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndrey Mokhov <andrey.mokhov@gmail.com>2019-01-27 22:34:30 +0000
committerBen Gamari <ben@smart-cactus.org>2019-01-31 12:46:51 -0500
commit780bcdaf66db9d7103ded03773609074ad92df54 (patch)
tree20c5c38482d70faab53549dde16ae2f897e8375c
parent86734329c4e0bdf5a8c0e92930de21d8d777758d (diff)
downloadhaskell-780bcdaf66db9d7103ded03773609074ad92df54.tar.gz
Hadrian: Update instructions for building on Windows
The `hadrian/doc/windows.md` file has falled out of date. In particular it still points to the old GitHub repository, and uses incorrect path to GHC. This patch fixes it.
-rw-r--r--hadrian/README.md2
-rw-r--r--hadrian/doc/windows.md47
2 files changed, 25 insertions, 24 deletions
diff --git a/hadrian/README.md b/hadrian/README.md
index a3b8a1b2c2..7b6646d655 100644
--- a/hadrian/README.md
+++ b/hadrian/README.md
@@ -262,7 +262,7 @@ projects), as well as Well-Typed.
[issues]: https://github.com/snowleopard/hadrian/issues
[ghc-preparation]: https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation
[ghc-windows-quick-build]: https://ghc.haskell.org/trac/ghc/wiki/Building/Preparation/Windows#AQuickBuild
-[windows-build]: https://github.com/snowleopard/hadrian/blob/master/doc/windows.md
+[windows-build]: https://gitlab.haskell.org/ghc/ghc/blob/master/hadrian/doc/windows.md
[ghc-split-objs-bug]: https://ghc.haskell.org/trac/ghc/ticket/11315
[test-issue]: https://github.com/snowleopard/hadrian/issues/197
[validation-issue]: https://github.com/snowleopard/hadrian/issues/187
diff --git a/hadrian/doc/windows.md b/hadrian/doc/windows.md
index 0ad2086547..aa59bc52fb 100644
--- a/hadrian/doc/windows.md
+++ b/hadrian/doc/windows.md
@@ -1,15 +1,13 @@
# 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 with minimal requirements.
+We only assume that `git` and `stack` are installed (see
+[prerequisites](https://github.com/snowleopard/hadrian/blob/master/doc/windows.md#prerequisites)).
-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)
+```
+# Get GHC 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
@@ -27,30 +25,33 @@ stack exec hadrian -- --directory ".." -j --flavour=quickest --configure
# Test GHC
cd ..
-inplace\bin\ghc-stage2 -e 1+2
+_build\stage1\bin\ghc -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).
+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.
+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
+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:
+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
@@ -61,10 +62,10 @@ If you would like to restore the default behaviour later run:
## 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).
+[free VirtualBox image](https://dev.windows.com/en-us/microsoft-edge/tools/vms/windows/).
+
+**TODO:** It would be useful to test the instructions routinely on CI.
## Notes
-Beware of the [current limitations of Hadrian](https://github.com/snowleopard/hadrian#current-limitations).
+Beware of the [current limitations of Hadrian](https://gitlab.haskell.org/ghc/ghc/blob/master/hadrian/README.md#current-limitations).