At Wed, 31 May 2006 10:30:14 -0700,
Isaac Jones wrote:
>
> I haven't had a chance to look at this, but could you explain to the
> list what it does? Like, we already have dh_haskell, does it use
> dh_haskell? Is it a set of debian/ files that are suitable for
> Haskell libs?
I would describe it as a 'reference package' or 'best practices' for
using cabal + dh_haskell. In my experience, people are going to try to
cabalize+debianize a package by copying a pre-existing package. So I
figure we should provide a canonical reference package that "does it
right".
It contains the extra files you would need to take a non-cabalized,
non-debianized haskell library, and cabalize and debianize it. You
could use this either as a starting point for a library you are about
to write, or you could copy the parts you need in order to package a
pre-existing library.
The following sample files are provided:
./Makefile
./debian
./debian/control
./debian/rules
./debian/changelog
./debian/compat
./debian/haskell-package-doc.docs
./debian/copyright
./Setup.hs
./Package.cabal
I believe that in most cases you can adapt the sample files to a
specific haskell library using these steps (which are included in the
repository):
(1) Rename Package.cabal to YourPackage.cabal
(2) Edit YourPackage.cabal
(3) update debian/copyright
(4) edit debian/control and:
(a) change occurances 'package' to 'yourpackage'
(b) modify the 'Description' fields
(c) add any extra Build-Depends
(5) edit debian/changelog
Documentation Generation Steps:
(6) Edit Makefile and change the 'doc' target as necessary - by
default it just attempts to build Haddock documentation
(7) rename debian/haskell-package-doc.docs to
debian/haskell-yourpackage-doc.docs
(8) edit the contents of haskell-yourpackage-doc.docs if neccessary
The above steps obviously assume you are familar with cabal and
debian.
j.