From 36e47066e5e493e92722f28519eb297c475a378c Mon Sep 17 00:00:00 2001 From: Emanuel Borsboom Date: Wed, 25 May 2016 20:54:57 -0700 Subject: [PATCH] doc/install_and_upgrade: warn about Homebrew (#2182) --- doc/install_and_upgrade.md | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/doc/install_and_upgrade.md b/doc/install_and_upgrade.md index 8222830507..4c8dbbf657 100644 --- a/doc/install_and_upgrade.md +++ b/doc/install_and_upgrade.md @@ -54,8 +54,24 @@ such. ## Mac OS X +### Manual download + +* Download the latest release: + * [Mac OS X 64-bit](https://www.stackage.org/stack/osx-x86_64) +* Extract the archive and place `stack` somewhere on your `$PATH` (see + [Path section below](#path)) +* Now you can run `stack` from the terminal. + +We generally test on the current version of Mac OS X, but stack is known to work on +Yosemite and Mavericks as well, and may also work on older versions (YMMV). + ### Using Homebrew +**Warning:** the Homebrew version of stack-1.1.2 has some +[problems](https://github.com/commercialhaskell/stack/issues/2182) not present +in the official binary distribution used in the manual download. As such, we +do not currently recommend installing Stack using Homebrew. + If you have a popular [brew](http://brew.sh/) tool installed, you can just do: ``` @@ -70,16 +86,7 @@ bottle"), but if `brew` starts trying to build everything from source (which will take hours), see [their FAQ on the topic](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/FAQ.md#why-do-you-compile-everything). -### Manual download - -* Download the latest release: - * [Mac OS X 64-bit](https://www.stackage.org/stack/osx-x86_64) -* Extract the archive and place `stack` somewhere on your `$PATH` (see - [Path section below](#path)) -* Now you can run `stack` from the terminal. -We generally test on the current version of Mac OS X, but stack is known to work on -Yosemite and Mavericks as well, and may also work on older versions (YMMV). ### Notes