Skip to content

Commit 6d5c302

Browse files
committed
Discuss ghcup in tutorial installation instructions
The instructions as written will not work on Ubuntu systems, which provide an extremely out-of-date Haskell toolchain. Addresses issue #1540 #1540
1 parent 7ef9730 commit 6d5c302

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

doc/tutorial/install.rst

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,3 +40,29 @@ nix
4040
`Nix <https://nixos.org/nix/>`_ users should feel free to take a look at
4141
the `nix/shell.nix` file in the repository and use it to provision a suitable
4242
environment to build and run the examples.
43+
44+
Note for Ubuntu users
45+
--------
46+
47+
Ubuntu's packages for `ghc`, `cabal`, and `stack` are years out of date.
48+
If the instructions above fail for you,
49+
try replacing the Ubuntu packages with up-to-date versions.
50+
First remove the installed versions:
51+
52+
.. code-block:: bash
53+
54+
# remove the obsolete versions
55+
$ sudo apt remove ghc haskell-stack cabal-install
56+
57+
Then install fresh versions of the Haskell toolchain
58+
using the `ghcup <https://www.haskell.org/ghcup/install/>`_ installer.
59+
60+
As of February 2022, one easy way to do this is by running a bootstrap script:
61+
62+
.. code-block:: bash
63+
64+
$ curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
65+
66+
The script is interactive and will prompt you for details about what
67+
you want installed and where. To install manually,
68+
see `the detailed instructions <https://www.haskell.org/ghcup/install/#manual-install>`_.

0 commit comments

Comments
 (0)