@@ -0,0 +1,47 @@
1+# Installation information
3+If you are having difficulty installing the PureScript compiler, feel free to
4+ask for help! A good place is the #purescript IRC channel on Freenode, or
5+alternatively Stack Overflow.
7+## Using prebuilt binaries
9+The prebuilt binaries are compiled with GHC 7.8.3, and therefore they should
10+run on any operating system supported by GHC 7.8.3, such as:
12+* Windows 2000 or later,
14+* Linux ??? (we're not sure what the minimum version is).
16+This list is not exhaustive. If your OS is too old or not listed, or if the
17+binaries fail to run, you may be able to install the compiler by building it
18+from source; see below.
20+It's probably safe to assume that other prebuilt distributions (eg, Homebrew,
21+Chocolatey, AUR, npm) use the same binaries, and therefore have the same
24+## Compiling from source
26+GHC 7.6.1 or newer is required to compile from source. The easiest way is to
30+$ cabal update && cabal install purescript
33+The PureScript compiler has been known to run on OS X 10.6 when built with GHC
36+## The "curses" library
38+`psci` depends on the `curses` library (via the Haskell package `terminfo`). If
39+you are having difficulty running the compiler, it may be because the `curses`
42+On Linux, you will probably need to install `ncurses` manually. On Ubuntu, for
43+example, this can be done by running:
46+$ sudo apt-get install libncurses5-dev