Update docs on installing for macOS/AArch64

commercialhaskell · Sep 25, 2023 · c14cc4d · c14cc4d
1 parent 850ebfa
commit c14cc4d
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 44 deletions.
diff --git a/doc/README.md b/doc/README.md
@@ -93,13 +93,7 @@ Windows.
         M2 chip. These chips use an architecture known as ARM64 or AArch64.
 
         For Mac computers with Apple silicon, the easiest way to install Stack
-        directly (rather than use GHCup) is to obtain the 'unofficial'
-        `osx-aarch64` binary distribution released by the GHCup developers and
-        copy it to a location on the PATH. `*.tar.gz` archive files containing
-        those binary distributions are available at the directories here:
-        [:material-cloud-download-outline:](https://downloads.haskell.org/ghcup/unofficial-bindists/stack/).
-
-        It is still possible to use the commands:
+        directly (rather than use GHCup) is to command:
 
         ~~~text
         curl -sSL https://get.haskellstack.org/ | sh
@@ -111,19 +105,14 @@ Windows.
         wget -qO- https://get.haskellstack.org/ | sh
         ~~~
 
-        However, those commands will download and install the version of Stack
-        for Intel-based Mac computers. Mac computers with Apple silicon will
-        use Apple's
-        [Rosetta 2 application](https://support.apple.com/en-gb/HT211861) to
-        use that version of Stack.
-
-        Apple's Terminal application will not detect automatically that Rosetta
-        has not yet been installed. Rosetta can be manually installed by
-        commanding:
+        !!! note
 
-        ~~~text
-        softwareupdate --install-rosetta
-        ~~~
+            The script at [get.haskellstack.org](https://get.haskellstack.org/)
+            will ask for root access using `sudo`. It needs such access in order
+            to use your platform's package manager to install dependencies and
+            to install to `/usr/local/bin`. If you prefer more control, follow
+            the manual installation instructions in the
+            [install and upgrade guide](install_and_upgrade.md).
 
 === "Windows"
 

diff --git a/doc/install_and_upgrade.md b/doc/install_and_upgrade.md
@@ -295,19 +295,8 @@ GitHub repository.
         Mac computers with Apple silicon have an M1, M1 Pro, M1 Max, M1 Ultra or
         M2 chip. These chips use an architecture known as ARM64 or AArch64.
 
-        The Stack repository uses GitHub-hosted runners to create binary
-        distributions for macOS. GitHub-hosted runners are not expected to be
-        available for macOS on Apple silicon until July to September 2023.
-
-        Consequently, for Mac computers with Apple silicon, the easiest way to
-        install Stack directly (rather than use GHCup) is to obtain the
-        'unofficial' `osx-aarch64` binary distribution released by the GHCup
-        developers and copy it to a location on the PATH. `*.tar.gz` archive
-        files containing those binary distributions are available at the
-        directories here:
-        [:material-cloud-download-outline:](https://downloads.haskell.org/ghcup/unofficial-bindists/stack/).
-
-        It is still possible to use the commands:
+        For Mac computers with Apple silicon, the easiest way to install Stack
+        directly (rather than use GHCup) is to command:
 
         ~~~text
         curl -sSL https://get.haskellstack.org/ | sh
@@ -319,19 +308,13 @@ GitHub repository.
         wget -qO- https://get.haskellstack.org/ | sh
         ~~~
 
-        However, those commands will download and install the version of Stack
-        for Intel-based Mac computers. Mac computers with Apple silicon will
-        use Apple's
-        [Rosetta 2 application](https://support.apple.com/en-gb/HT211861) to
-        use that version of Stack.
-
-        Apple's Terminal application will not detect automatically that Rosetta
-        has not yet been installed. Rosetta can be manually installed by
-        commanding:
+        !!! note
 
-        ~~~text
-        softwareupdate --install-rosetta
-        ~~~
+            The script at [get.haskellstack.org](https://get.haskellstack.org/)
+            will ask for root access using `sudo`. It needs such access in order
+            to use your platform's package manager to install dependencies and
+            to install to `/usr/local/bin`. If you prefer more control, follow
+            the manual installation instructions below.
 
         The installation of Stack or some packages (e.g. `network`) requiring C
         source compilation might fail with `configure: error: C compiler cannot
@@ -360,6 +343,18 @@ GitHub repository.
         compile x86-64 objects and attempt to link them with existing ARM64
         libraries, resulting in the error above.
 
+        ### Manual download
+
+        * Click
+          [:material-cloud-download-outline:](https://get.haskellstack.org/stable/osx-aarch64.tar.gz)
+          to download an archive file with the latest release for AArch64
+          architectures.
+
+        * Extract the archive and place `stack` somewhere on your PATH (see the
+          [Path](#path) section below).
+
+        * Now you can run Stack from the command line in a terminal.
+
     ### Using Homebrew
 
     [Homebrew](https://brew.sh/) is a popular package manager for macOS. If you