update install instructions

This commit is contained in:
Greg Weber 2011-12-21 13:52:59 -03:00
parent bba851b8cf
commit 97393c2cdd

View File

@ -39,19 +39,22 @@ Please note that cabal-dev will not work in a virthualenv shell - you can't use
### virthualenv ### virthualenv
virthualenv will not work on Windows - Windows users should use only cabal-dev.
To just install Yesod from github, we only need cabal-dev. However, cabal-dev may be more hassle than it is worth when hacking on Yesod. To just install Yesod from github, we only need cabal-dev. However, cabal-dev may be more hassle than it is worth when hacking on Yesod.
We recommend using [virthualenv](http://hackage.haskell.org/package/virthualenv) when hacking on Yesod. We recommend using [virthualenv](http://hackage.haskell.org/package/virthualenv) when hacking on Yesod.
This is optional, but prevents your custom build of Yesod from interfering with your currently installed cabal packages. This is optional, but prevents your custom build of Yesod from interfering with your currently installed cabal packages.
virthualenv creates an isolated environment like cabal-dev. virthualenv creates an isolated environment like cabal-dev.
cabal-dev isolates a single cabal package, but virthualenv isolates multiple packages together. cabal-dev by default isolates a single cabal package, but virthualenv isolates multiple packages together.
cabal-dev can isolate multiple packages together by using the -s sandbox argument
virthualenv works at the shell level, so every shell must activate the virthualenv. virthualenv works at the shell level, so every shell must activate the virthualenv.
### cabal-src ### cabal-src
Michael just released the cabal-src tool. Whenever you would use `cabal install` for a local package, use `cabal-src-install` instead. Michael Snoyman just released the cabal-src tool, which helps resolve dependency conflicts when installing local packages.
Our installer script now uses cabal-src-install when it is available. Whenever you would use `cabal install` for a local package, use `cabal-src-install` instead. Our installer script now uses cabal-src-install when it is available.
### Building Yesod ### Building Yesod
@ -108,9 +111,11 @@ cabal-dev works very well if you are working on a single package, but it can be
### Use your development version of Yesod in your application ### Use your development version of Yesod in your application
Note that we have told you to install Yesod into a sandboxed virthualenv environment. Note that we have recommended to you to install Yesod into a sandboxed virthualenv environment.
This means it is not available through your user/global cabal database for your application. This is great for development, but when you want to use these development versions in your application that means they are not available through your user/global cabal database for your application.
Instead you should use `cabal-dev install` to retrieve these packages. You should just continue to use your yesod virthualenv shell for your application.
You can also use `cabal-dev install` to retrieve these packages.
cd to your application directory, and the reference the source list. cd to your application directory, and the reference the source list.
~~~ { .bash } ~~~ { .bash }