How do I create a suitable .tar.gz file for use with `cabal upload`?

Answer 1

From the wiki:

Since the code is cabalised, we can create a tarball with cabal-install directly (you can also use runhaskell Setup.hs sdist, but you need tar on your system 1):

$ cabal sdist
Building source dist for haq-0.0...
Source tarball created: dist/haq-0.0.tar.gz

This has the advantage that Cabal will do a bit more checking, and ensure that the tarball has the structure that HackageDB expects. Note that it does require the LICENSE file to exist. It packages up the files needed to build the project; to include other files (such as Test.hs in the above example, and our README), we need to add:

extra-source-files: Tests.hs README

to the .cabal file to have everything included.

Answer 2

Or if you're using darcs,

darcs dist

Note that 'cabal sdist' will only pick up files listed in the .cabal file, so you might need to add READMEs etc under "extra-source-files: "

You can check you've a valid tarball with

cabal check

which runs the same tests that Hackage will run.