1
0
mirror of https://github.com/IHaskell/IHaskell.git synced 2025-04-19 12:56:08 +00:00

update README with correct sandbox build instructions & Mac OS X considerations

This commit is contained in:
Bob Ippolito 2014-01-10 19:03:16 -08:00
parent 2de9734b7a
commit 33227602ef
2 changed files with 25 additions and 4 deletions

2
.gitignore vendored

@ -9,3 +9,5 @@ env
Hspec
todo
profile/profile.tar
.cabal-sandbox
cabal.sandbox.config

@ -72,6 +72,14 @@ export PATH=~/.cabal/bin:$PATH
export PATH=~/Library/Haskell/bin:$PATH
```
If you are using Mac OS X 10.9 (Mavericks) you will need to compile
cairo with gcc, not clang. This can be done as follows:
```bash
brew install gcc48
cabal install cairo --with-gcc=gcc-4.8
```
Compilation Tools
---
Install the `happy` parser generator tool and `cpphs` preprocessor:
@ -98,6 +106,18 @@ IHaskell console
There is a test notebook in the `IHaskell` directory. To try it, run IHaskell with `IHaskell notebook --serve=IHaskell`.
If you get a pip error while IHaskell is installing Python
dependencies on the first run (it will look like
`EOFError: EOF when reading a line`), then you can do the following
after ensuring that pip >= 1.5 is installed:
```bash
env PIP_EXISTS_ACTION=w IHaskell notebook
```
If it *still* doesn't work and you are using Mac OS X then
`brew upgrade python`. Some older versions of Homebrew's Python have a
broken version of distutils. Homebrew's version of Python 2.7.6 *does* work.
**Note**: You may have some trouble due to browser caches with the notebook interface if you also use IPython's notebook interface or have used it in the past. If something doesn't work or IPython says it can't connect to the notebook server, make sure to clear the browser cache in whatever browser you're using, or try another browser.
Contributing
@ -128,8 +148,8 @@ cd /path/to/IHaskell
```bash
cd /path/to/IHaskell
cabal sandbox init
cabal add-source ipython-kernel ihaskell-display/* ghc-parser
cabal install IHaskell $(ls --color=never ihaskell-display)
cabal sandbox add-source ipython-kernel ihaskell-display/* ghc-parser
cabal install IHaskell $(basename ihaskell-display/*)
```
**Loading IHaskell into GHCi for testing:**
@ -145,8 +165,7 @@ cd <path-to-IHaskell>
cabal repl
```
The will hide all packages not listed in the
`IHaskell.cabal`
This will hide all packages not listed in `IHaskell.cabal`
**Using GHCi directly**