Cabal
A framework for packaging Haskell software
Version on this page: | 3.10.3.0 |
LTS Haskell 23.0: | 3.10.3.0 |
Stackage Nightly 2024-12-09: | 3.10.3.0 |
Latest on Hackage: | 3.14.0.0 |
Cabal-3.10.3.0@sha256:4a36954a66769eef90353daa0dbb07d43e49c228281383c7e4134445d495f714,12313
Module documentation for 3.10.3.0
- Distribution
- Distribution.Backpack
- Distribution.Backpack.ComponentsGraph
- Distribution.Backpack.Configure
- Distribution.Backpack.ConfiguredComponent
- Distribution.Backpack.DescribeUnitId
- Distribution.Backpack.FullUnitId
- Distribution.Backpack.LinkedComponent
- Distribution.Backpack.ModSubst
- Distribution.Backpack.ModuleShape
- Distribution.Backpack.PreModuleShape
- Distribution.Compat
- Distribution.Compat.CreatePipe
- Distribution.Compat.Directory
- Distribution.Compat.Environment
- Distribution.Compat.FilePath
- Distribution.Compat.Internal
- Distribution.Compat.Internal.TempFile
- Distribution.Compat.Prelude
- Distribution.Compat.Process
- Distribution.Compat.ResponseFile
- Distribution.Compat.Stack
- Distribution.Compat.Time
- Distribution.Make
- Distribution.PackageDescription
- Distribution.ReadE
- Distribution.Simple
- Distribution.Simple.Bench
- Distribution.Simple.Build
- Distribution.Simple.BuildPaths
- Distribution.Simple.BuildTarget
- Distribution.Simple.BuildToolDepends
- Distribution.Simple.CCompiler
- Distribution.Simple.Command
- Distribution.Simple.Compiler
- Distribution.Simple.Configure
- Distribution.Simple.Flag
- Distribution.Simple.GHC
- Distribution.Simple.GHCJS
- Distribution.Simple.Glob
- Distribution.Simple.Haddock
- Distribution.Simple.HaskellSuite
- Distribution.Simple.Hpc
- Distribution.Simple.Install
- Distribution.Simple.InstallDirs
- Distribution.Simple.LocalBuildInfo
- Distribution.Simple.PackageDescription
- Distribution.Simple.PackageIndex
- Distribution.Simple.PreProcess
- Distribution.Simple.Program
- Distribution.Simple.Program.Ar
- Distribution.Simple.Program.Builtin
- Distribution.Simple.Program.Db
- Distribution.Simple.Program.Find
- Distribution.Simple.Program.GHC
- Distribution.Simple.Program.HcPkg
- Distribution.Simple.Program.Hpc
- Distribution.Simple.Program.Internal
- Distribution.Simple.Program.Ld
- Distribution.Simple.Program.ResponseFile
- Distribution.Simple.Program.Run
- Distribution.Simple.Program.Script
- Distribution.Simple.Program.Strip
- Distribution.Simple.Program.Types
- Distribution.Simple.Register
- Distribution.Simple.Setup
- Distribution.Simple.ShowBuildInfo
- Distribution.Simple.SrcDist
- Distribution.Simple.Test
- Distribution.Simple.UHC
- Distribution.Simple.UserHooks
- Distribution.Simple.Utils
- Distribution.TestSuite
- Distribution.Types
- Distribution.Utils
- Distribution.Verbosity
- Distribution.Backpack
The Cabal library package
See the Cabal web site for more information.
If you also want the cabal
command-line program, you need the
cabal-install package in addition to this library.
More information
Please see the Cabal web site, the user guide and the API documentation. There is additional information available on the development wiki.
Bugs
Please report bugs and feature requests to Cabal’s bug tracker.
Your help
To help Cabal’s development, it is enormously helpful to know from Cabal’s users what their most pressing problems are with Cabal and Hackage. You may have a favourite Cabal bug or limitation. Look at Cabal’s bug tracker. Ensure that the problem is reported there and adequately described. Comment on the issue to report how much of a problem the bug is for you. Subscribe to the issues’s notifications to discussed requirements and keep informed on progress. For feature requests, it is helpful if there is a description of how you would expect to interact with the new feature.
Source code
You can get the master development branch using:
$ git clone https://github.com/haskell/cabal.git
Credits
See the AUTHORS
file.
Authors of the original Cabal specification:
- Isaac Jones
- Simon Marlow
- Ross Patterson
- Simon Peyton Jones
- Malcolm Wallace
Changes
3.10.3.0 Hécate January 2024
3.10.2.1 Hécate October 2023
3.10.2.0 Hécate August 2023
3.10.1.0 Mikolaj Konarski March 2023
3.8.1.0 Mikolaj Konarski August 2022
3.6.3.0 March 2022
3.6.2.0 Emily Pillmore October 2021
3.6.1.0 Emily Pillmore August 2021
3.6.0.0 Emily Pillmore August 2021
3.4.1.0 Emily Pillmore October 2021
3.4.0.0 Oleg Grenrus February 2021
3.2.1.0 Oleg Grenrus October 2020
- Pass
cxx-options
with-optcxx
for GHC >= 8.10 - Use process jobs when calling subprocesses
- Require custom-setup for
cabal-version: 1.24
and later - Accept
linux-androideabi
as an alias for Android - Fix ghci being launched before other sources are built
- Require cabal-versions >=1.25 to be exact
3.2.0.0 Herbert Valerio Riedel April 2020
- Change free text
String
fields to useShortText
in package description and installed package info. - Split
Distribution.Types.Flag
andDistribution.Types.ConfVar
Distribution.Types.GenericPackageDescription
. - Add GHC-8.10 support, including new extensions to
Language.Haskell.Extension
. - Use more
NonEmpty
instead of ordinary lists. - Add
Distribution.Utils.Structured
for fingeprintingBinary
blobs. - Add
null
,length
andunsafeFromUTF8BS
toDistribution.Utils.ShortText
. - Refactor
Distribution.Utils.IOData
module. - Rename
Distribution.Compat.MD5
toDistribution.Utils.MD5
. - Add
safeHead
,safeTail
,safeLast
toDistribution.Utils.Generic
. - Add
unsnoc
andunsnocNE
toDistribution.Utils.Generic
. - Add
Set'
modifier toDistribution.Parsec.Newtypes
. - Add
Distribution.Compat.Async
.
3.0.2.0 Herbert Valerio Riedel April 2020
- Disallow spaces around colon
:
in Dependencybuild-depends
syntax (#6538). - Make
configure
accept anypkg-config --modversion
output (#6541).
3.0.1.0 Herbert Valerio Riedel April 2020
- Add GHC-8.8 flags to
normaliseGhcFlags
(#6379). - Typo fixes (#6372).
- Limit version number parts to contain at most 9 digits (#6386).
- Fix boundless sublibrary dependency parse failure (#5846).
cabal check
verifiescpp-options
more pedantically, allowing only options starting with-D
and-U
.- Don’t rebuild world when new ghc flags that affect how error messages are presented is specified.
- Fix dropExeExtension behaviour on Windows (#6287).
3.0.0.0 Mikhail Glushenkov August 2019
- The 3.0 migration guide gives advice on adapting Custom setup scripts to backwards-incompatible changes in this release: https://github.com/haskell/cabal/wiki/3.0-migration-guide.
- Due to #5119, the
cabal check
warning for bounds on internal libraries has been disabled. - Introduce set notation for
^>=
and==
operators (#5906). - ‘check’ reports warnings for various ghc-*-options fields separately (#5342).
KnownExtension
: added new extensionsDerivingVia
andEmptyDataDeriving
.- Add
extra-dynamic-library-flavours
, to specify extra dynamic library flavours to build and install from a .cabal file. autoconfUserHooks
now passes--host=$HOST
when cross-compiling- Introduce multiple public libraries feature
(#5526).
- New build-depends syntax
- Add a set of library components to the
Dependency
datatype - New
visibility
field in thelibrary
stanza - New
LibraryVisibility
field inInstalledPackageInfo
- New syntax for the
--dependency
Cabal flag
- Static linking
- Add
--enable-executable-static
flag for building fully static executables (GHC’s normal “statish” linking links Haskell libraries statically, but libc and system dependencies dynamically). This new flag links everything statically. - Note you likely want to link against
musl
or another libc that supports fully static linking;glibc
has some issues with fully static linking.
- Add
- Fix corrupted config file header for non-ASCII package names (2557).
- Extend
Distribution.Simple.Utils.rewriteFileEx
from ASCII to UTF-8 encoding. - Change the arguments of
Newtype
class to better suit @DeriveAnyClass@ usage, add default implementation in terms ofcoerce
/unsafeCoerce
. - Implement support for response file arguments to defaultMain* and cabal-install.
- Uniformly provide ‘Semigroup’ instances for
base < 4.9
viasemigroups
package - Implement `{cmm,asm}-{sources,options} buildinfo fields for separate compilation of C– and ASM source files (#6033).
- Setting
debug-info
now implieslibrary-stripping: False
and `executable-stripping: False) (#2702) Setup.hs copy
andinstall
now work in the presence ofdata-files
that use**
syntax (#6125).
2.4.1.1 Mikhail Glushenkov December 2018
- Fix
--with-compiler
failing to locate compiler on Windows (#5753). - Cabal can once again be built with GHC 7.8 and 7.6 (#5730).
2.4.1.0 Mikhail Glushenkov November 2018
- Warnings in autogenerated files are now silenced (#5678).
- Improved recompilation avoidance, especially when using GHC 8.6 (#5589).
- Do not error on empty packagedbs in
getInstalledPackages
(#5516).
2.4.0.1 Mikhail Glushenkov September 2018
- Allow arguments to be passed to
Setup.hs haddock
forbuild-type:configure
(#5503).
2.4.0.0 Mikhail Glushenkov September 2018
- Due to #5119, the
cabal check
warning for bounds on internal libraries has been disabled. Distribution.Simple.Haddock
now checks to ensure that it does not erroneously call Haddock with no target modules. (#5232, #5459).- Add
getting
(less general thanto
) Lens combinator,non
) and an optics to access the modules in a component of aPackageDescription
by theComponentName
:componentBuildInfo
andcomponentModules
- Linker
ld-options
are now passed to GHC as-optl
options (#4925). - Add
readGhcEnvironmentFile
to parse GHC environment files. - Drop support for GHC 7.4, since it is out of our support window (and has been for over a year!)
- Deprecate
preSDist
,sDistHook
, andpostSDist
in service ofnew-sdist
, since they violate key invariants of the new-build ecosystem. Useautogen-modules
andbuild-tool-depends
instead. (#5389). - Added
--repl-options
flag toSetup repl
used to pass flags to the underlying repl without affecting theLocalBuildInfo
(#4247, #5287) KnownExtension
: added new extensionsBlockArguments
(#5101),NumericUnderscores
(#5130,QuantifiedConstraints
, andStarIsType
.buildDepends
is removed fromPackageDescription
. It had long been uselessly hanging about as top-level build-depends already got put into per-component condition trees anyway. Now it’s finally been put out of its misery (#4383).- Added
Eta
toCompilerFlavor
and to known compilers. cabal haddock
now generates per-component documentation (#5226).- Wildcard improvements:
- Allow
**
wildcards indata-files
,extra-source-files
andextra-doc-files
. These allow a limited form of recursive matching, and requirecabal-version: 2.4
. (#5284, #3178, et al.) - With
cabal-version: 2.4
, when matching a wildcard, the requirement for the full extension to match exactly has been loosened. Instead, if the wildcard’s extension is a suffix of the file’s extension, the file will be selected. For example, previouslyfoo.en.html
would not match*.html
, andfoo.solaris.tar.gz
would not match*.tar.gz
, but now both do. This may lead to files unexpectedly being included bysdist
; please audit your package descriptions if you rely on this behaviour to keep sensitive data out of distributed packages (#5372, #784, #5057). - Wildcard syntax errors (misplaced
*
, etc), wildcards that refer to missing directories, and wildcards that do not match anything are now all detected bycabal check
. - Wildcard (‘globbing’) functions have been moved from
Distribution.Simple.Utils
toDistribution.Simple.Glob
and have been refactored.
- Allow
- Fixed
cxx-options
andcxx-sources
buildinfo fields for separate compilation of C++ source files to correctly build and link non-library components (#5309). - Reduced warnings generated by hsc2hs and c2hs when
cxx-options
field is present in a component. cabal check
now warns if-j
is used inghc-options
in a Cabal file. (#5277)install-includes
now works as expected with foreign libraries (#5302).- Removed support for JHC.
- Options listed in
ghc-options
,cc-options
,ld-options
,cxx-options
,cpp-options
are not deduplicated anymore (#4449). - Deprecated
cabal hscolour
in favour ofcabal haddock --hyperlink-source
(#5236). - Recognize
powerpc64le
as architecture PPC64. - Cabal now deduplicates more
-I
and-L
and flags to avoidE2BIG
(#5356). - With
build-type: configure
, avoid using backslashes to delimit path components on Windows and warn about other unsafe characters in the path to the source directory on all platforms (#5386). Distribution.PackageDescription.Check.checkPackageFiles
now accepts aVerbosity
argument.- Added a parameter to
Distribution.Backpack.ConfiguredComponent.toConfiguredComponent
in order to fix #5409. - Partially silence
abi-depends
warnings (#5465). - Foreign libraries are now linked against the threaded RTS when the ‘ghc-options: -threaded’ flag is used (#5431).
- Pass command line arguments to
hsc2hs
using response files when possible (#3122).
2.2.0.1 Mikhail Glushenkov March 2018
- Fix
checkPackageFiles
for relative directories (#5206)
2.2.0.0 Mikhail Glushenkov March 2018
- The 2.2 migration guide gives advice on adapting Custom setup scripts to backwards-incompatible changes in this release: https://github.com/haskell/cabal/wiki/2.2-migration-guide.
- New Parsec-based parser for
.cabal
files is now the default. This brings memory consumption and speed improvements, as well as making new syntax extensions easier to implement. - Support for common stanzas (#4751).
- Added elif-conditionals to
.cabal
syntax (#4750). - The package license information can now be specified using the
SPDX syntax. This requires setting
cabal-version
to 2.2+ (#2547, #5050). - Support for GHC’s numeric -g debug levels (#4673).
- Compilation with section splitting is now supported via the
--enable-split-sections
flag (#4819) - Fields with mandatory commas (e.g. build-depends) may now have a leading or a trailing comma (either one, not both) (#4953)
- Added
virtual-modules
field, to allow modules that are not built but registered (#4875). - Use better defaulting for
build-type
; renamePackageDescription
’sbuildType
field tobuildTypeRaw
and introduce newbuildType
function (#4958) D.T.PackageDescription.allBuildInfo
now returns all build infos, not only for buildable components (#5087).- Removed
UnknownBuildType
constructor fromBuildType
(#5003). - Added
HexFloatLiterals
toKnownExtension
. - Cabal will no longer try to build an empty set of
inputModules
(#4890). copyComponent
andinstallIncludeFiles
will now look for include headers in the build directory (dist/build/...
by default) as well (#4866).- Added
cxx-options
andcxx-sources
buildinfo fields for separate compilation of C++ source files (#3700). - Removed unused
--allow-newer
/--allow-older
support fromSetup configure
(#4527). - Changed
FlagAssignment
to be an opaquenewtype
(#4849). - Changed
rawSystemStdInOut
to use proper type to represent binary and textual data; newDistribution.Utils.IOData
module; removed obsoletestartsWithBOM
,fileHasBOM
,fromUTF8
, andtoUTF8
functions; add newtoUTF8BS
/toUTF8LBS
encoding functions. (#4666) - Added a
cabal check
warning when the.cabal
file name does not match package name (#4592). - The
ar
program now receives its arguments via a response file (@file
). Old behaviour can be restored with--disable-response-files
argument toconfigure
orinstall
(#4596). - Added
.Lens
modules, with optics for package description data types (#4701). - Support for building with Win32 version 2.6 (#4835).
- Change
compilerExtensions
andghcOptExtensionMap
to containMaybe Flag
s, since a supported extension can lack a flag (#4443). - Pretty-printing of
.cabal
files is slightly different due to parser changes. For an example, see https://mail.haskell.org/pipermail/cabal-devel/2017-December/010414.html. --hyperlink-source
now uses Haddock’s hyperlinker backend when Haddock is new enough, falling back to HsColour otherwise.D.S.defaultHookedPackageDesc
has been deprecated in favour ofD.S.findHookedPackageDesc
(#4874).D.S.getHookedBuildInfo
now takes an additional parameter specifying the build directory path (#4874).- Emit warning when encountering unknown GHC versions (#415).
2.0.1.1 Mikhail Glushenkov December 2017
- Don’t pass
other-modules
to stub executable for detailed-0.9 (#4918). - Hpc: Use relative .mix search paths (#4917).
2.0.1.0 Mikhail Glushenkov November 2017
- Support for GHC’s numeric -g debug levels (#4673).
- Added a new
Distribution.Verbosity.modifyVerbosity
combinator (#4724). - Added a new
cabal check
warning about unused, undeclared or non-Unicode flags. Also, it warns about leading dash, which is unusable but accepted if it’s unused in conditionals. (#4687) - Modify
allBuildInfo
to include foreign library info (#4763). - Documentation fixes.
2.0.0.2 Mikhail Glushenkov July 2017
- See http://coldwa.st/e/blog/2017-09-09-Cabal-2-0.html for more detailed release notes.
- The 2.0 migration guide gives advice on adapting Custom setup scripts to backwards-incompatible changes in this release: https://github.com/haskell/cabal/wiki/2.0-migration-guide
- Add CURRENT_PACKAGE_VERSION to cabal_macros.h (#4319)
- Dropped support for versions of GHC earlier than 6.12 (#3111).
- GHC compatibility window for the Cabal library has been extended to five years (#3838).
- Convenience/internal libraries are now supported (#269).
An internal library is declared using the stanza
library 'libname'
. Packages which use internal libraries can result in multiple registrations; thus--gen-pkg-config
can now output a directory of registration scripts rather than a single file. - Backwards incompatible change to preprocessor interface:
the function in
PPSuffixHandler
now takes an additionalComponentLocalBuildInfo
specifying the build information of the component being preprocessed. - Backwards incompatible change to
cabal_macros.h
(#1893): we now generate a macro file for each component which contains only information about the direct dependencies of that component. Consequently,dist/build/autogen/cabal_macros.h
contains only the macros for the library, and is not generated if a package has no library; to find the macros for an executable namedfoobar
, look indist/build/foobar/autogen/cabal_macros.h
. Similarly, if you usedautogenModulesDir
you should now useautogenComponentModulesDir
, which now requires aComponentLocalBuildInfo
argument as well in order to disambiguate which component the autogenerated files are for. - Backwards incompatible change to
Component
:TestSuite
andBenchmark
no longer havetestEnabled
andbenchmarkEnabled
. If you usedenabledTests
orenabledBenchmarks
, please instead useenabledTestLBIs
andenabledBenchLBIs
(you will need aLocalBuildInfo
for these functions.) Additionally, the semantics ofwithTest
andwithBench
have changed: they now iterate over all buildable such components, regardless of whether or not they have been enabled; if you only want enabled components, usewithTestLBI
andwithBenchLBI
.finalizePackageDescription
is deprecated: its replacementfinalizePD
now takes an extra argumentComponentRequestedSpec
which specifies what components are to be enabled: use this instead of modifying theComponent
in aGenericPackageDescription
. (As it’s not possible now,finalizePackageDescription
will assume tests/benchmarks are disabled.) If you only need to test if a component is buildable (i.e., it is marked buildable in the Cabal file) use the new functioncomponentBuildable
. - Backwards incompatible change to
PackageName
(#3896):PackageName
is now opaque; conversion to/fromString
now works via (old)unPackageName
and (new)mkPackageName
functions. - Backwards incompatible change to
ComponentId
(#3917):ComponentId
is now opaque; conversion to/fromString
now works viaunComponentId
andmkComponentId
functions. - Backwards incompatible change to
AbiHash
(#3921):AbiHash
is now opaque; conversion to/fromString
now works viaunAbiHash
andmkAbiHash
functions. - Backwards incompatible change to
FlagName
(#4062):FlagName
is now opaque; conversion to/fromString
now works viaunFlagName
andmkFlagName
functions. - Backwards incompatible change to
Version
(#3905): Version is now opaque; conversion to/from[Int]
now works viaversionNumbers
andmkVersion
functions. - Add support for
--allow-older
(dual to--allow-newer
) (#3466) - Improved an error message for process output decoding errors (#3408).
getComponentLocalBuildInfo
,withComponentsInBuildOrder
andcomponentsInBuildOrder
are deprecated in favor of a new interface inDistribution.Types.LocalBuildInfo
.- New
autogen-modules
field. Modules that are built automatically at setup, like Paths_PACKAGENAME or others created with a build-type custom, appear onother-modules
for the Library, Executable, Test-Suite or Benchmark stanzas or also onexposed-modules
for libraries but are not really on the package when distributed. This makes commands like sdist fail because the file is not found, so with this new field modules that appear there are treated the same way as Paths_PACKAGENAME was and there is no need to create complex build hooks. Just add the module names onother-modules
andexposed-modules
as always and on the newautogen-modules
besides. (#3656). - New
./Setup configure
flag--cabal-file
, allowing multiple.cabal
files in a single directory (#3553). Primarily intended for internal use. - Macros in
cabal_macros.h
are now ifndef’d, so that they don’t cause an error if the macro is already defined. (#3041) ./Setup configure
now accepts a single argument specifying the component to be configured. The semantics of this mode of operation are described in https://github.com/ghc-proposals/ghc-proposals/pull/4- Internal
build-tools
dependencies are now added to PATH upon invocation of GHC, so that they can be conveniently used via-pgmF
. (#1541) - Add support for new caret-style version range operator
^>=
(#3705) - Verbosity
-v
now takes an extended format which allows specifying exactly what you want to be logged. The format is[silent|normal|verbose|debug] flags
, where flags is a space separated list of flags. At the moment, only the flags +callsite and +callstack are supported; these report the call site/stack of a logging output respectively (these are only supported if Cabal is built with GHC 8.0/7.10.2 or greater, respectively). - New
Distribution.Utils.ShortText.ShortText
type for representing short text strings compactly (#3898) - Cabal no longer supports using a version bound to disambiguate between an internal and external package (#4020). This should not affect many people, as this mode of use already did not work with the dependency solver.
- Support for “foreign libraries” (#2540), which are Haskell libraries intended to be used by foreign languages like C. Foreign libraries only work with GHC 7.8 and later.
- Added a technical preview version of integrated doctest support (#4480).
- Added a new
scope
field to the executable stanza. Executables withscope: private
get installed into $libexecdir/$libexecsubdir. Additionally $libexecdir now has a subdir structure similar to $lib(sub)dir to allow installing private executables of different packages and package versions alongside one another. Private executables are those that are expected to be run by other programs rather than users. (#3461)
1.24.2.0 Mikhail Glushenkov December 2016
- Fixed a bug in the handling of non-buildable components (#4094).
- Reverted a PVP-noncompliant API change in 1.24.1.0 (#4123).
- Bumped the directory upper bound to < 1.4 (#4158).
1.24.1.0 Ryan Thomas October 2016
- API addition:
differenceVersionRanges
(#3519). - Fixed reexported-modules display mangling (#3928).
- Check that the correct cabal-version is specified when the extra-doc-files field is present (#3825).
- Fixed an incorrect invocation of GetShortPathName that was causing build failures on Windows (#3649).
- Linker flags are now set correctly on GHC >= 7.8 (#3443).
1.24.0.0 Ryan Thomas March 2016
- Support GHC 8.
- Deal with extra C sources from preprocessors (#238).
- Include cabal_macros.h when running c2hs (#2600).
- Don’t recompile C sources unless needed (#2601).
- Read
builddir
option fromCABAL_BUILDDIR
environment variable. - Add
--profiling-detail=$level
flag with a default for libraries and executables ofexported-functions
andtoplevel-functions
respectively (GHC’s-fprof-auto-{exported,top}
flags) (#193). - New
custom-setup
stanza to specify setup deps. Setup is also built with the cabal_macros.h style macros, for conditional compilation. - Support Haddock response files (#2746).
- Fixed a bug in the Text instance for Platform (#2862).
- New
setup haddock
option:--for-hackage
(#2852). - New
--show-detail=direct
; like streaming, but allows the test program to detect that is connected to a terminal, and works reliable with a non-threaded runtime (#2911, and serves as a work-around for #2398) - Library support for multi-instance package DBs (#2948).
- Improved the
./Setup configure
solver (#3082, #3076). - The
--allow-newer
option can be now used with./Setup configure
(#3163). - Added a way to specify extra locations to find OS X frameworks
in (
extra-framework-dirs
). Can be used both in.cabal
files and as an argument to./Setup configure
(#3158). - Macros
VERSION_$pkgname
andMIN_VERSION_$pkgname
are now also generated for the current package. (#3235). - Backpack is supported! Two new fields supported in Cabal
files: signatures and mixins; and a new flag
to setup scripts,
--instantiate-with
. See https://github.com/ezyang/ghc-proposals/blob/backpack/proposals/0000-backpack.rst for more details.
1.22.8.0 Ryan Thomas March 2016
- Distribution.Simple.Setup: remove job cap. Fixes #3191.
- Check all object file suffixes for recompilation. Fixes #3128.
- Move source files under
src/
. Fixes #3003.
1.22.7.0 Ryan Thomas January 2016
- Backport #3012 to the 1.22 branch
- Cabal.cabal: change build-type to Simple
- Add foldl’ import
- The Cabal part for fully gcc-like response files
1.22.6.0 Ryan Thomas December 2015
- Relax upper bound to allow upcoming binary-0.8
1.22.5.0 Ryan Thomas November 2015
- Don’t recompile C sources unless needed (#2601). (Luke Iannini)
- Support Haddock response files.
- Add frameworks when linking a dynamic library.
1.22.4.0 Ryan Thomas June 2015
- Add libname install-dirs variable, use it by default. Fixes #2437. (Edward Z. Yang)
- Reduce temporary directory name length, fixes #2502. (Edward Z. Yang)
- Workaround for #2527. (Mikhail Glushenkov)
1.22.3.0 Ryan Thomas April 2015
- Fix for the ghcjs-pkg version number handling (Luite Stegeman)
- filterConfigureFlags: filter more flags (Mikhail Glushenkov)
- Cabal check will fail on -fprof-auto passed as a ghc-option - Fixes #2479 (John Chee)
1.22.2.0 Ryan Thomas March 2015
- Don’t pass
--{en,dis}able-profiling
to old setup. - Add -Wall police
- Fix dependencies on
old-time
- Fix test interface detailed-0.9 with GHC 7.10
- Fix HPC tests with GHC 7.10
- Make sure to pass the package key to ghc
- Use
--package-{name|version}
when available for Haddock when available - Put full package name and version in library names
- Fully specify package key format, so external tools can generate it.
1.22.0.0 Johan Tibell January 2015
- Support GHC 7.10.
- Experimental support for emitting DWARF debug info.
- Preliminary support for relocatable packages.
- Allow cabal to be used inside cabal exec environments.
- hpc: support multiple “ways” (e.g. profiling and vanilla).
- Support GHCJS.
- Improved command line documentation.
- Add
-none
constraint syntax for version ranges (#2093). - Make the default doc index file path compiler/arch/os-dependent (#2136).
- Warn instead of dying when generating documentation and hscolour isn’t installed (455f51622fa38347db62197a04bb0fa5b928ff17).
- Support the new BinaryLiterals extension (1f25ab3c5eff311ada73c6c987061b80e9bbebd9).
- Warn about
ghc-prof-options: -auto-all
incabal check
(#2162). - Add preliminary support for multiple instances of the same package version installed side-by-side (#2002).
- New binary build config format - faster build times (#2076).
- Support module thinning and renaming (#2038).
- Add a new license type: UnspecifiedLicense (#2141).
- Remove support for Hugs and nhc98 (#2168).
- Invoke
tar
with--formar ustar
if possible insdist
(#1903). - Replace
--enable-library-coverage
with--enable-coverage
, which enables program coverage for all components (#1945). - Suggest that
ExitFailure 9
is probably due to memory exhaustion (#1522). - Drop support for Haddock < 2.0 (#1808, #1718).
- Make
cabal test
/cabal bench
build only what’s needed for running tests/benchmarks (#1821). - Build shared libraries by default when linking executables dynamically.
- Build profiled libraries by default when profiling executables.
1.20.0.4 Ryan Thomas January 2016
- Cabal.cabal: change build-type to Simple.
1.20.0.1 Johan Tibell May 2014
- Fix streaming test output.
1.20.0.0 Johan Tibell April 2014
- Rewrite user guide
- Fix repl Ctrl+C handling
- Add haskell-suite compiler support
- Add HADDOCK_VERSION define
- Allow specifying exact dependency version using hash
- Rename extra-html-files to extra-doc-files
- Add parallel build support for GHC 7.8 and later
- Don’t call ranlib on OS X
- Avoid re-linking executables, test suites, and benchmarks unnecessarily, shortening build times
- Add
--allow-newer
which allows upper version bounds to be ignored - Add
--enable-library-stripping
- Add command for freezing dependencies
- Allow repl to be used outside Cabal packages
- Add
--require-sandbox
- Don’t use
--strip-unneeded
on OS X or iOS - Add new license-files field got additional licenses
- Fix if(solaris) on some Solaris versions
- Don’t use -dylib-install-name on OS X with GHC > 7.8
- Add DragonFly as a known OS
- Improve pretty-printing of Cabal files
- Add test flag
--show-details=streaming
for real-time test output - Add exec command
1.10.2.0 Duncan Coutts June 2011
- Include test suites in cabal sdist
- Fix for conditionals in test suite stanzas in
.cabal
files - Fix permissions of directories created during install
- Fix for global builds when $HOME env var is not set
1.10.1.0 Duncan Coutts February 2011
- Improved error messages when test suites are not enabled
- Template parameters allowed in test
--test-option(s)
flag - Improved documentation of the test feature
- Relaxed QA check on cabal-version when using test-suite sections
haddock
command now allows both--hoogle
and--html
at the same time- Find ghc-version-specific instances of the hsc2hs program
- Preserve file executable permissions in sdist tarballs
- Pass gcc location and flags to ./configure scripts
- Get default gcc flags from ghc
1.10.0.0 Duncan Coutts November 2010
- New cabal test feature
- Initial support for UHC
- New default-language and other-languages fields (e.g. Haskell98/2010)
- New default-extensions and other-extensions fields
- Deprecated extensions field (for packages using cabal-version >=1.10)
- Cabal-version field must now only be of the form
>= x.y
- Removed deprecated
--copy-prefix=
feature - Auto-reconfigure when
.cabal
file changes - Workaround for haddock overwriting .hi and .o files when using TH
- Extra cpp flags used with hsc2hs and c2hs (-D${os}_BUILD_OS etc)
- New cpp define VERSION_ gives string version of dependencies
- User guide source now in markdown format for easier editing
- Improved checks and error messages for C libraries and headers
- Removed BSD4 from the list of suggested licenses
- Updated list of known language extensions
- Fix for include paths to allow C code to import FFI stub.h files
- Fix for intra-package dependencies on OSX
- Stricter checks on various bits of
.cabal
file syntax - Minor fixes for c2hs
1.8.0.6 Duncan Coutts June 2010
- Fix
register --global/--user
1.8.0.4 Duncan Coutts March 2010
- Set dylib-install-name for dynalic libs on OSX
- Stricter configure check that compiler supports a package’s extensions
- More configure-time warnings
- Hugs can compile Cabal lib again
- Default datadir now follows prefix on Windows
- Support for finding installed packages for hugs
- Cabal version macros now have proper parenthesis
- Reverted change to filter out deps of non-buildable components
- Fix for registering inplace when using a specific package db
- Fix mismatch between $os and $arch path template variables
- Fix for finding ar.exe on Windows, always pick ghc’s version
- Fix for intra-package dependencies with ghc-6.12
1.8.0.2 Duncan Coutts December 2009
- Support for GHC-6.12
- New unique installed package IDs which use a package hash
- Allow executables to depend on the lib within the same package
- Dependencies for each component apply only to that component (previously applied to all the other components too)
- Added new known license MIT and versioned GPL and LGPL
- More liberal package version range syntax
- Package registration files are now UTF8
- Support for LHC and JHC-0.7.2
- Deprecated RecordPuns extension in favour of NamedFieldPuns
- Deprecated PatternSignatures extension in favor of ScopedTypeVariables
- New VersionRange semantic view as a sequence of intervals
- Improved package quality checks
- Minor simplification in a couple
Setup.hs
hooks - Beginnings of a unit level testsuite using QuickCheck
- Various bug fixes
- Various internal cleanups
1.6.0.2 Duncan Coutts February 2009
- New configure-time check for C headers and libraries
- Added language extensions present in ghc-6.10
- Added support for NamedFieldPuns extension in ghc-6.8
- Fix in configure step for ghc-6.6 on Windows
- Fix warnings in
Path_pkgname.hs
module on Windows - Fix for exotic flags in ld-options field
- Fix for using pkg-config in a package with a lib and an executable
- Fix for building haddock docs for exes that use the Paths module
- Fix for installing header files in subdirectories
- Fix for the case of building profiling libs but not ordinary libs
- Fix read-only attribute of installed files on Windows
- Ignore ghc -threaded flag when profiling in ghc-6.8 and older
1.6.0.1 Duncan Coutts October 2008
- Export a compat function to help alex and happy
1.6.0.0 Duncan Coutts October 2008
- Support for ghc-6.10
- Source control repositories can now be specified in
.cabal
files - Bug report URLs can be now specified in
.cabal
files - Wildcards now allowed in data-files and extra-source-files fields
- New syntactic sugar for dependencies
build-depends: foo ==1.2.*
- New cabal_macros.h provides macros to test versions of dependencies
- Relocatable bindists now possible on unix via env vars
- New
exposed
field allows packages to be not exposed by default - Install dir flags can now use $os and $arch variables
- New
--builddir
flag allows multiple builds from a single sources dir - cc-options now only apply to .c files, not for -fvia-C
- cc-options are not longer propagated to dependent packages
- The cpp/cc/ld-options fields no longer use
,
as a separator - hsc2hs is now called using gcc instead of using ghc as gcc
- New api for manipulating sets and graphs of packages
- Internal api improvements and code cleanups
- Minor improvements to the user guide
- Miscellaneous minor bug fixes
1.4.0.2 Duncan Coutts August 2008
- Fix executable stripping default
- Fix striping exes on OSX that export dynamic symbols (like ghc)
- Correct the order of arguments given by
--prog-options=
- Fix corner case with overlapping user and global packages
- Fix for modules that use pre-processing and
.hs-boot
files - Clarify some points in the user guide and readme text
- Fix verbosity flags passed to sub-command like haddock
- Fix
sdist --snapshot
- Allow meta-packages that contain no modules or C code
- Make the generated Paths module -Wall clean on Windows
1.4.0.1 Duncan Coutts June 2008
- Fix a bug which caused
.
to always be in the sources search path - Haddock-2.2 and later do now support the
--hoogle
flag
1.4.0.0 Duncan Coutts June 2008
- Rewritten command line handling support
- Command line completion with bash
- Better support for Haddock 2
- Improved support for nhc98
- Removed support for ghc-6.2
- Haddock markup in
.lhs
files now supported - Default colour scheme for highlighted source code
- Default prefix for
--user
installs is now$HOME/.cabal
- All
.cabal
files are treaded as UTF-8 and must be valid - Many checks added for common mistakes
- New
--package-db=
option for specific package databases - Many internal changes to support cabal-install
- Stricter parsing for version strings, eg dissalows “1.05”
- Improved user guide introduction
- Programatica support removed
- New options
--program-prefix/suffix
allows eg versioned programs - Support packages that use
.hs-boot
files - Fix sdist for Main modules that require preprocessing
- New configure -O flag with optimisation level 0–2
- Provide access to “
x-
” extension fields through the Cabal api - Added check for broken installed packages
- Added warning about using inconsistent versions of dependencies
- Strip binary executable files by default with an option to disable
- New options to add site-specific include and library search paths
- Lift the restriction that libraries must have exposed-modules
- Many bugs fixed.
- Many internal structural improvements and code cleanups
1.2.4.0 Duncan Coutts June 2008
- Released with GHC 6.8.3
- Backported several fixes and minor improvements from Cabal-1.4
- Use a default colour scheme for sources with hscolour >=1.9
- Support
--hyperlink-source
for Haddock >= 2.0 - Fix for running in a non-writable directory
- Add OSX -framework arguments when linking executables
- Updates to the user guide
- Allow build-tools names to include + and _
- Export autoconfUserHooks and simpleUserHooks
- Export ccLdOptionsBuildInfo for
Setup.hs
scripts - Export unionBuildInfo and make BuildInfo an instance of Monoid
- Fix to allow the
main-is
module to use a pre-processor
1.2.3.0 Duncan Coutts Nov 2007
- Released with GHC 6.8.2
- Includes full list of GHC language extensions
- Fix infamous
dist/conftest.c
bug - Fix
configure --interfacedir=
- Find ld.exe on Windows correctly
- Export PreProcessor constructor and mkSimplePreProcessor
- Fix minor bug in unlit code
- Fix some markup in the haddock docs
1.2.2.0 Duncan Coutts Nov 2007
- Released with GHC 6.8.1
- Support haddock-2.0
- Support building DSOs with GHC
- Require reconfiguring if the
.cabal
file has changed - Fix os(windows) configuration test
- Fix building documentation
- Fix building packages on Solaris
- Other minor bug fixes
1.2.1 Duncan Coutts Oct 2007
- To be included in GHC 6.8.1
- New field
cpp-options
used when preprocessing Haskell modules - Fixes for hsc2hs when using ghc
- C source code gets compiled with -O2 by default
- OS aliases, to allow os(windows) rather than requiring os(mingw32)
- Fix cleaning of
stub
files - Fix cabal-setup, command line ui that replaces
runhaskell Setup.hs
- Build docs even when dependent packages docs are missing
- Allow the
--html-dir
to be specified at configure time - Fix building with ghc-6.2
- Other minor bug fixes and build fixes
1.2.0 Duncan Coutts Sept 2007
- To be included in GHC 6.8.x
- New configurations feature
- Can make haddock docs link to highlighted sources (with hscolour)
- New flag to allow linking to haddock docs on the web
- Supports pkg-config
- New field
build-tools
for tool dependencies - Improved c2hs support
- Preprocessor output no longer clutters source dirs
- Separate
includes
andinstall-includes
fields - Makefile command to generate makefiles for building libs with GHC
- New
--docdir
configure flag - Generic
--with-prog
--prog-args
configure flags - Better default installation paths on Windows
- Install paths can be specified relative to each other
- License files now installed
- Initial support for NHC (incomplete)
- Consistent treatment of verbosity
- Reduced verbosity of configure step by default
- Improved helpfulness of output messages
- Help output now clearer and fits in 80 columns
- New setup register
--gen-pkg-config
flag for distros - Major internal refactoring, hooks api has changed
- Dozens of bug fixes
1.1.6.2 Duncan Coutts May 2007
- Released with GHC 6.6.1
- Handle windows text file encoding for
.cabal
files - Fix compiling a executable for profiling that uses Template Haskell
- Other minor bug fixes and user guide clarifications
1.1.6.1 Duncan Coutts Oct 2006
- fix unlit code
- fix escaping in register.sh
1.1.6 Duncan Coutts Oct 2006
- Released with GHC 6.6
- Added support for hoogle
- Allow profiling and normal builds of libs to be chosen independently
- 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 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
beforeclean
orsdist
- Added support for ghc’s
-split-objs
- Initial support for JHC
- Ignore extension fields in
.cabal
files (fields beginning 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 Sept 2005
- WARNING: Interfaces not documented in the user’s guide may change in future releases.
- Move building of GHCi .o libs to the build phase rather than register phase. (from Duncan Coutts)
- Use .tar.gz for source package extension
- Uses GHC instead of cpphs if the latter is not available
- Added experimental “command hooks” which completely override the default behavior of a command.
- Some bugfixes
1.1.1 Isaac Jones July 2005
- WARNING: Interfaces not documented in the user’s guide may change in future releases.
- Handles recursive modules for GHC 6.2 and GHC 6.4.
- Added
setup test
command (Used with UserHook) - implemented handling of _stub.{c,h,o} files
- Added support for profiling
- Changed install prefix of libraries (pref/pkgname-version to prefix/pkgname-version/compname-version)
- Added pattern guards as a language extension
- Moved some functionality to Language.Haskell.Extension
- Register / unregister .bat files for windows
- Exposed more of the API
- Added support for the hide-all-packages flag in GHC > 6.4
- Several bug fixes
1.0 Isaac Jones March 11 2005
- Released with GHC 6.4, Hugs March 2005, and nhc98 1.18
- Some sanity checking
0.5 Isaac Jones Wed Feb 19 2005
- WARNING: this is a pre-release and the interfaces are still likely to change until we reach a 1.0 release.
- Hooks interfaces changed
- Added preprocessors to user hooks
- No more executable-modules or hidden-modules. Use
other-modules
instead. - Certain fields moved into BuildInfo, much refactoring
extra-libs
->extra-libraries
- Added
--gen-script
to configure and unconfigure. modules-ghc
(etc) nowghc-modules
(etc)- added new fields including
synopsis
- Lots of bug fixes
- spaces can sometimes be used instead of commas
- A user manual has appeared (Thanks, ross!)
- for ghc 6.4, configures versioned depends properly
- more features to
./setup haddock
0.4 Isaac Jones Sun Jan 16 2005
-
Much thanks to all the awesome fptools hackers who have been working hard to build the Haskell Cabal!
-
Interface Changes:
-
WARNING: this is a pre-release and the interfaces are still likely to change until we reach a 1.0 release.
-
Instead of Package.description, you should name your description files .cabal. In particular, we suggest that you name it .cabal, but this is not enforced (yet). Multiple
.cabal
files in the same directory is an error, at least for now. -
./setup install --install-prefix
is gone. Use./setup copy
--copy-prefix
instead. -
The
Modules
field is gone. Usehidden-modules
,exposed-modules
, andexecutable-modules
. -
Build-depends
is now a package-only field, and can’t go into executable stanzas. Build-depends is a package-to-package relationship. -
Some new fields. Use the Source.
-
-
New Features
-
Cabal is now included as a package in the CVS version of fptools. That means it’ll be released as
-package Cabal
in future versions of the compilers, and if you are a bleeding-edge user, you can grab it from the CVS repository with the compilers. -
Hugs compatibility and NHC98 compatibility should both be improved.
-
Hooks Interface / Autoconf compatibility: Most of the hooks interface is hidden for now, because it’s not finalized. I have exposed only
defaultMainWithHooks
anddefaultUserHooks
. This allows you to use a ./configure script to preprocessfoo.buildinfo
, which gets merged withfoo.cabal
. In future releases, we’ll expose UserHooks, but we’re definitely going to change the interface to those. The interface to the two functions I’ve exposed should stay the same, though. -
./setup haddock is a baby feature which pre-processes the source code with hscpp and runs haddock on it. This is brand new and hardly tested, so you get to knock it around and see what you think.
-
Some commands now actually implement verbosity.
-
The preprocessors have been tested a bit more, and seem to work OK. Please give feedback if you use these.
-
0.3 Isaac Jones Sun Jan 16 2005
- Unstable snapshot release
- From now on, stable releases are even.
0.2 Isaac Jones
- Adds more HUGS support and preprocessor support.