Commit 5d4c36e1 authored by duncan.coutts@worc.ox.ac.uk's avatar duncan.coutts@worc.ox.ac.uk
Browse files

Update README, changelog and releaseNotes

parent 8991c329
Cabal home page:
http://www.haskell.org/cabal
WARNING If you already have Cabal installed, including GHC 6.4 users,
read "Working with older versions of Cabal" for information first! If
you do this out of order, stuff might get screwy. If stuff gets
screwy, post to libraries@haskell.org for help.
WARNING If you already have Cabal installed, and are using GHC 6.4.1
or earlier, read "Working with older versions of Cabal" for
information first! If you do this out of order, stuff might get
screwy. If stuff gets screwy, post to libraries@haskell.org for help.
-= Quirky things about the build system =-
* If you don't already have Cabal installed: "make install" as root,
then try "ghci -package Cabal" to test it. If you get an error
about multiple versions of Cabal, read the section below "Working
with older versions of Cabal" You were supposed to read this first.
* The cabal should build just like any other Cabal-ized package. If
you're using windows or have another means of building cabal
packages, you might want to ignore the GNUmakefile
altogether.
* GNUmakefile is the one you're probably interested in. If you see
Makefile, it is probably from the fptools build tree, and it won't
work on its own.
* The GNUmakefile wraps the standard Cabal setup script; the
GNUmakefile is a convinience for bootstrapping the system. "sudo
make install" should handle HUnit, generate the setup script,
configure, build, install, and register it in a standard location.
* HUnit is included both as a test case for Cabal, and because Cabal
uses HUnit for testing. Don't panic.
-= Working with older versions of Cabal =-
* Installing as root / Administrator (GHC's global package file)
-= Installing as root / Administrator (GHC's global package file) =-
This is the recommended method of installing Cabal.
If you have an older version of Cabal installed, you probably just
want to remove it:
run "make install" as root
$ ghc-pkg unregister Cabal
The Makefile wraps the standard Cabal setup script; the
Makefile is a convinience for bootstrapping the system. "sudo
make install" should generate the setup script, configure, build,
install, and register it in a standard location.
Cabal should build just like any other Cabal-ized packagem, so if you
you can't or don't want to use the Makefile, you can run:
ghc --make Setup.lhs -o setup
./setup configure
./setup build
sudo ./setup install
If you don't want to remove it, and want both the old and new versions
installed, that's fine... In order to use the new one after
installation you may have to specify which version you want when you
run ghci. For instance:
-= Installing as a user (no root or administer access) =-
$ ghci -package Cabal
...
ghc-6.4: Error; multiple packages match Cabal: Cabal-1.0, Cabal-1.1.3
$ ghci -package Cabal-1.1.3
...
(OK)
ghc --make Setup.lhs -o setup
./setup configure --prefix=$HOME --user
./setup build
./setup install --user
* Installing as a user (no root or administer access)
If you have cabal installed already, you can this command to remove
it:
$ ghc-pkg unregister Cabal --user
Additional notes for GHC-6.4.1 and older:
If:
1) Cabal is installed in the global package file (use ghc-pkg -l to see)
1) Cabal is installed in the global package file (use ghc-pkg list to see)
2) You don't have root access
......@@ -74,6 +47,23 @@ then this formula may help to hide the global version:
$ ghc-pkg describe Cabal-1.0 | ghc-pkg --user register -
$ ghc-pkg --user hide Cabal-1.0
-= Working with older versions of GHC and Cabal =-
If you have GHC 6.4.2 or later then it's recommended just to leave the
old version of Cabal installed (unless you are really sure that no
existing packages still needs it).
Prior to GHC 6.4.2 however, GHC didn't deal particularly well with
having multiple versions of packages installed at once. So if you are
using GHC 6.4.1 or older and you have an older version of Cabal
installed, you probably just want to remove it:
$ ghc-pkg unregister Cabal
or if you had Cabal installed just for your user account then:
$ ghc-pkg unregister Cabal --user
-= Your Help =-
Portability is one of the most important things about this project.
......@@ -87,6 +77,8 @@ The codebase is a very manageable size.
You can get the code from the web page; the version control system we
use is very open and welcoming to new developers.
darcs get --partial http://darcs.haskell.org/packages/Cabal
-= Debian Templates =-
Build a Debian source tree with:
......@@ -101,6 +93,7 @@ dependencies...
Cabal Coders:
- Krasimir Angelov
- Bjorn Bringert
- Duncan Coutts
- Isaac Jones
- David Himmelstrup (Lemmih)
- Simon Marlow
......
-*-change-log-*-
1.1.6 Duncan Coutts <duncan.coutts@worc.ox.ac.uk> Oct 2006
* Released with GHC 6.6
* Added support for hoogle
* Allow profiling and normal builds of libs to be chosen indepentantly
* Default installation directories on Win32 changed
* Register haddock docs with ghc-pkg
* Get haddock to make hyperlinks to dependent package docs
* Added BangPatterns language extension
* Various bug fixes
1.1.4 Duncan Coutts <duncan.coutts@worc.ox.ac.uk> May 2006
* Released with GHC 6.4.2
* Better support for packages that need to install header files
* cabal-setup added, but not installed by default yet
* Implemented "setup register --inplace"
* Have packages exposed by default with ghc-6.2
* It is no longer necessary to run 'configure' before 'clean' or 'sdist'
* Added support for ghc's -split-objs
* Initial support for JHC
* Ignore extension fields in .cabal files (fields begining with "x-")
* Some changes to command hooks API to improve consistency
* Hugs support improvements
* Added GeneralisedNewtypeDeriving language extension
* Added cabal-version field
* Support hidden modules with haddock
* Internal code refactoring
* More bug fixes
1.1.3 Isaac Jones <ijones@syntaxpolice.org> Sept 2005
* WARNING: Interfaces not documented in the user's guide may
change in future releases.
......@@ -10,6 +38,7 @@
* Added experimental "command hooks" which completely override the
default behavior of a command.
* Some bugfixes
1.1.1 Isaac Jones <ijones@syntaxpolice.org> July 2005
* WARNING: Interfaces not documented in the user's guide may
change in future releases.
......
......@@ -9,16 +9,16 @@ changes and installation instructions.
DOWNLOAD:
The Haskell Cabal has reached version 1.1.3. This pre-release has a
number of new features and bugfixes.
The Haskell Cabal has reached version 1.1.6.
Download the Cabal here (source and debian versions available):
http://www.haskell.org/cabal/download.html
BUGS:
Please report bugs and wish-list items to libraries@haskell.org and
Isaac Jones: ijones@syntaxpolice.org.
Please report bugs and wish-list items at:
http://hackage.haskell.org/trac/hackage
or send an email to libraries@haskell.org.
ABOUT:
......@@ -41,11 +41,6 @@ owners; and so on.
NOTES:
You cannot currently execute most setup scripts with "./Setup.lhs"
since most systems do not have a runHaskell executable installed. You
can compile it with ghc thusly: "ghc -package Cabal Setup.lhs -o
setup" and then use the "setup" executable after that.
This release is meant to provide the community with concrete
information about how the interfaces are shaping up. This release
does NOT fix the interfaces, we can't promise not to break anything
......@@ -60,4 +55,3 @@ especially the proposal, which will serve as documentation for this
release:
http://www.haskell.org/cabal/
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment