From aa0bd25a930dc7d61dc3b133bee1c64238e36d36 Mon Sep 17 00:00:00 2001
From: Mikhail Glushenkov <the.dead.shall.rise@gmail.com>
Date: Sun, 1 Sep 2013 00:54:40 +0200
Subject: [PATCH] Revert "Add basic sandbox documentation"
This reverts commit 6bfb5a200c2202baa313903c95ced835316b23aa.
The sandbox feature is already documented (see #1430).
Additionally, the documentation added in this commit is misleading:
'runhaskell Setup.hs sandbox CMD' doesn't work.
---
Cabal/doc/installing-packages.markdown | 39 --------------------------
1 file changed, 39 deletions(-)
diff --git a/Cabal/doc/installing-packages.markdown b/Cabal/doc/installing-packages.markdown
index c6d55287aa..909644ba6c 100644
--- a/Cabal/doc/installing-packages.markdown
+++ b/Cabal/doc/installing-packages.markdown
@@ -928,45 +928,6 @@ This command takes the following option:
: Append today's date (in "YYYYMMDD" format) to the version number for
the generated source package. The original package is unaffected.
-## setup sandbox ##
-
-By default, any dependencies of the package are installed into the
-global or user package databases (e.g. using `cabal install
---only-dependencies`). If you're building several different packages
-that have incompatible dependencies, this can cause the build to fail.
-By installing all dependencies in a package database specific to each
-sandbox, these problems can be avoided.
-
-Typical usage:
-
-~~~~~~~~~~~~~~~~
-runhaskell Setup.hs sandbox init # only once per directory
-runhaskell Setup.hs configure
-runhaskell Setup.hs build
-~~~~~~~~~~~~~~~~
-
-### setup sandbox init ###
-
-Create a sandbox. This command only needs to be run once per build
-directory (i.e. the directory in which the `.cabal` file resides).
-
-### setup sandbox delete ###
-
-Delete the sandbox and all package's installed into it.
-
-### setup sandbox add-source ###
-
-Make package source directory available to the sandbox. This lets you
-depend on yet unreleased packages while developing your current
-package.
-
-Example usage:
-
-~~~~~~~~~~~~~~~~
-runhaskell Setup.hs sandbox add-source ../otherpkg
-runhaskell Setup.hs configure
-~~~~~~~~~~~~~~~~
-
[dist-simple]: ../libraries/Cabal/Distribution-Simple.html
[dist-make]: ../libraries/Cabal/Distribution-Make.html
--
GitLab