update CVE number, this is a new CVE
[cabal.git] / Cabal / ChangeLog.md
blobfd928c4de23c66d14d5ca12d13c360c1836e49a5
1 # 3.10.2.0 [Hécate](mailto:hecate+github@glitchbra.in) August 2023
2 * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.10.2.0.md
4 # 3.10.1.0 [Mikolaj Konarski](mailto:mikolaj@well-typed.com) March 2023
5 * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.10.1.0.md
7 # 3.8.1.0 [Mikolaj Konarski](mailto:mikolaj@well-typed.com) August 2022
8   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.8.1.0.md
10 # 3.6.3.0 March 2022
11   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.6.3.0.md
13 # 3.6.2.0 [Emily Pillmore](mailto:emilypi@cohomolo.gy) October 2021
14   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.6.2.0.md
16 # 3.6.1.0 [Emily Pillmore](mailto:emilypi@cohomolo.gy) August 2021
17   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.6.1.0.md
19 # 3.6.0.0 [Emily Pillmore](mailto:emilypi@cohomolo.gy) August 2021
20   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.6.0.0.md
22 # 3.4.1.0 [Emily Pillmore](mailto:emilypi@cohomolo.gy) October 2021
23   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.4.1.0.md
25 # 3.4.0.0 [Oleg Grenrus](mailto:oleg.grnerus@iki.fi) February 2021
26   * See https://github.com/haskell/cabal/blob/master/release-notes/Cabal-3.4.0.0.md
28 # 3.2.1.0 [Oleg Grenrus](mailto:oleg.grenris@iki.fi) October 2020
29   * Pass `cxx-options` with `-optcxx` for GHC >= 8.10
30   * Use process jobs when calling subprocesses
31   * Require custom-setup for `cabal-version: 1.24` and later
32   * Accept `linux-androideabi` as an alias for Android
33   * Fix ghci being launched before other sources are built
34   * Require cabal-versions >=1.25 to be exact
36 # 3.2.0.0 [Herbert Valerio Riedel](mailto:hvr@gnu.org) April 2020
37   * Change free text `String` fields to use `ShortText` in package description
38     and installed package info.
39   * Split `Distribution.Types.Flag` and `Distribution.Types.ConfVar`
40     `Distribution.Types.GenericPackageDescription`.
41   * Add GHC-8.10 support, including new extensions to
42     `Language.Haskell.Extension`.
43   * Use more `NonEmpty` instead of ordinary lists.
44   * Add `Distribution.Utils.Structured` for fingeprinting `Binary` blobs.
45   * Add `null`, `length` and `unsafeFromUTF8BS` to `Distribution.Utils.ShortText`.
46   * Refactor `Distribution.Utils.IOData` module.
47   * Rename `Distribution.Compat.MD5` to `Distribution.Utils.MD5`.
48   * Add `safeHead`, `safeTail`, `safeLast` to `Distribution.Utils.Generic`.
49   * Add `unsnoc` and `unsnocNE` to `Distribution.Utils.Generic`.
50   * Add `Set'` modifier to `Distribution.Parsec.Newtypes`.
51   * Add `Distribution.Compat.Async`.
53 # 3.0.2.0 [Herbert Valerio Riedel](mailto:hvr@gnu.org) April 2020
54   * Disallow spaces around colon `:` in Dependency `build-depends` syntax
55     ([#6538](https://github.com/haskell/cabal/pull/6538)).
56   * Make `configure` accept any `pkg-config --modversion` output
57     ([#6541](https://github.com/haskell/cabal/pull/6541)).
59 # 3.0.1.0 [Herbert Valerio Riedel](mailto:hvr@gnu.org) April 2020
60   * Add GHC-8.8 flags to `normaliseGhcFlags`
61     ([#6379](https://github.com/haskell/cabal/pull/6379)).
62   * Typo fixes
63     ([#6372](https://github.com/haskell/cabal/pull/6372)).
64   * Limit version number parts to contain at most 9 digits
65     ([#6386](https://github.com/haskell/cabal/pull/6386)).
66   * Fix boundless sublibrary dependency parse failure
67     ([#5846](https://github.com/haskell/cabal/issues/5846)).
68   * `cabal check` verifies `cpp-options` more pedantically, allowing only
69     options starting with `-D` and `-U`.
70   * Don’t rebuild world when new ghc flags that affect how error
71     messages are presented is specified.
72   * Fix dropExeExtension behaviour on Windows
73     ([#6287](https://github.com/haskell/cabal/pull/6287)).
75 # 3.0.0.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) August 2019
76   * The 3.0 migration guide gives advice on adapting Custom setup
77     scripts to backwards-incompatible changes in this release:
78     https://github.com/haskell/cabal/wiki/3.0-migration-guide.
79   * Due to [#5119](https://github.com/haskell/cabal/issues/5119), the
80     `cabal check` warning for bounds on internal libraries has been
81     disabled.
82   * Introduce set notation for `^>=` and `==` operators
83     ([#5906](https://github.com/haskell/cabal/pull/5906)).
84   * 'check' reports warnings for various ghc-\*-options fields separately
85     ([#5342](https://github.com/haskell/cabal/issues/5432)).
86   * `KnownExtension`: added new extensions `DerivingVia` and
87     `EmptyDataDeriving`.
88   * Add `extra-dynamic-library-flavours`, to specify extra dynamic library
89     flavours to build and install from a .cabal file.
90   * `autoconfUserHooks` now passes `--host=$HOST` when cross-compiling
91   * Introduce multiple public libraries feature
92     ([#5526](https://github.com/haskell/cabal/pull/5526)).
93     * New build-depends syntax
94     * Add a set of library components to the `Dependency` datatype
95     * New `visibility` field in the `library` stanza
96     * New `LibraryVisibility` field in `InstalledPackageInfo`
97     * New syntax for the `--dependency` Cabal flag
98   * Static linking
99     * Add `--enable-executable-static` flag for building fully
100       static executables (GHC's normal "statish" linking links
101       Haskell libraries statically, but libc and system dependencies
102       dynamically). This new flag links everything statically.
103     * Note you likely want to link against `musl` or another libc that
104       supports fully static linking;
105       [`glibc` has some issues](https://sourceware.org/glibc/wiki/FAQ#Even_statically_linked_programs_need_some_shared_libraries_which_is_not_acceptable_for_me.__What_can_I_do.3F)
106       with fully static linking.
107   * Fix corrupted config file header for non-ASCII package names
108     ([2557](https://github.com/haskell/cabal/issues/2557)).
109   * Extend `Distribution.Simple.Utils.rewriteFileEx` from ASCII to UTF-8 encoding.
110   * Change the arguments of `Newtype` class to better suit @DeriveAnyClass@ usage,
111     add default implementation in terms of `coerce` / `unsafeCoerce`.
112   * Implement support for response file arguments to defaultMain* and cabal-install.
113   * Uniformly provide 'Semigroup' instances for `base < 4.9` via `semigroups` package
114   * Implement `{cmm,asm}-{sources,options} buildinfo fields for
115     separate compilation of C-- and ASM source files (#6033).
116   * Setting `debug-info` now implies `library-stripping: False` and
117     `executable-stripping: False) ([#2702](https://github.com/haskell/cabal/issues/2702))
118   * `Setup.hs copy` and `install` now work in the presence of
119     `data-files` that use `**` syntax
120     ([#6125](https://github.com/haskell/cabal/issues/6125)).
122 ----
124 ### 2.4.1.1 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) December 2018
126   * Fix `--with-compiler` failing to locate compiler on Windows
127     ([#5753](https://github.com/haskell/cabal/pull/5753)).
128   * Cabal can once again be built with GHC 7.8 and 7.6
129     ([#5730](https://github.com/haskell/cabal/pull/5730)).
131 ### 2.4.1.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) November 2018
133   * Warnings in autogenerated files are now silenced
134     ([#5678](https://github.com/haskell/cabal/pull/5678)).
135   * Improved recompilation avoidance, especially when using GHC 8.6
136     ([#5589](https://github.com/haskell/cabal/pull/5589)).
137   * Do not error on empty packagedbs in `getInstalledPackages`
138     ([#5516](https://github.com/haskell/cabal/issues/5516)).
141 ### 2.4.0.1 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) September 2018
143   * Allow arguments to be passed to `Setup.hs haddock` for `build-type:configure`
144     ([#5503](https://github.com/haskell/cabal/issues/5503)).
146 # 2.4.0.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) September 2018
147   * Due to [#5119](https://github.com/haskell/cabal/issues/5119), the
148     `cabal check` warning for bounds on internal libraries has been
149     disabled.
150   * `Distribution.Simple.Haddock` now checks to ensure that it
151     does not erroneously call Haddock with no target modules.
152     ([#5232](https://github.com/haskell/cabal/issues/5232),
153     [#5459](https://github.com/haskell/cabal/issues/5459)).
154   * Add `getting` (less general than `to`) Lens combinator,
155     `non`) and an optics to access the modules in a component
156     of a `PackageDescription` by the `ComponentName`:
157     `componentBuildInfo` and `componentModules`
158   * Linker `ld-options` are now passed to GHC as `-optl` options
159     ([#4925](https://github.com/haskell/cabal/pull/4925)).
160   * Add `readGhcEnvironmentFile` to parse GHC environment files.
161   * Drop support for GHC 7.4, since it is out of our support window
162     (and has been for over a year!)
163   * Deprecate `preSDist`, `sDistHook`, and `postSDist` in service of
164     `new-sdist`, since they violate key invariants of the new-build
165     ecosystem. Use `autogen-modules` and `build-tool-depends` instead.
166     ([#5389](https://github.com/haskell/cabal/pull/5389)).
167   * Added `--repl-options` flag to `Setup repl` used to pass flags to the
168     underlying repl without affecting the `LocalBuildInfo`
169     ([#4247](https://github.com/haskell/cabal/issues/4247),
170     [#5287](https://github.com/haskell/cabal/pull/5287))
171   * `KnownExtension`: added new extensions `BlockArguments`
172     ([#5101](https://github.com/haskell/cabal/issues/5101)),
173     `NumericUnderscores`
174     ([#5130]((https://github.com/haskell/cabal/issues/5130)),
175     `QuantifiedConstraints`, and `StarIsType`.
176   * `buildDepends` is removed from `PackageDescription`. It had long been
177     uselessly hanging about as top-level build-depends already got put
178     into per-component condition trees anyway. Now it's finally been put
179     out of its misery
180     ([#4383](https://github.com/haskell/cabal/issues/4283)).
181   * Added `Eta` to `CompilerFlavor` and to known compilers.
182   * `cabal haddock` now generates per-component documentation
183     ([#5226](https://github.com/haskell/cabal/issues/5226)).
184   * Wildcard improvements:
185     * Allow `**` wildcards in `data-files`, `extra-source-files` and
186       `extra-doc-files`. These allow a limited form of recursive
187       matching, and require `cabal-version: 2.4`.
188       ([#5284](https://github.com/haskell/cabal/issues/5284),
189       [#3178](https://github.com/haskell/cabal/issues/3178), et al.)
190     * With `cabal-version: 2.4`, when matching a wildcard, the
191       requirement for the full extension to match exactly has been
192       loosened. Instead, if the wildcard's extension is a suffix of the
193       file's extension, the file will be selected. For example,
194       previously `foo.en.html` would not match `*.html`, and
195       `foo.solaris.tar.gz` would not match `*.tar.gz`, but now both
196       do. This may lead to files unexpectedly being included by `sdist`;
197       please audit your package descriptions if you rely on this
198       behaviour to keep sensitive data out of distributed packages
199       ([#5372](https://github.com/haskell/cabal/pull/5372),
200       [#784](https://github.com/haskell/cabal/issues/784),
201       [#5057](https://github.com/haskell/cabal/issues/5057)).
202     * Wildcard syntax errors (misplaced `*`, etc), wildcards that
203       refer to missing directories, and wildcards that do not match
204       anything are now all detected by `cabal check`.
205     * Wildcard ('globbing') functions have been moved from
206       `Distribution.Simple.Utils` to `Distribution.Simple.Glob` and
207       have been refactored.
208   * Fixed `cxx-options` and `cxx-sources` buildinfo fields for
209     separate compilation of C++ source files to correctly build and link
210     non-library components ([#5309](https://github.com/haskell/cabal/issues/5309)).
211   * Reduced warnings generated by hsc2hs and c2hs when `cxx-options` field
212     is present in a component.
213   * `cabal check` now warns if `-j` is used in `ghc-options` in a Cabal
214     file. ([#5277](https://github.com/haskell/cabal/issues/5277))
215   * `install-includes` now works as expected with foreign libraries
216     ([#5302](https://github.com/haskell/cabal/issues/5299)).
217   * Removed support for JHC.
218   * Options listed in `ghc-options`, `cc-options`, `ld-options`,
219     `cxx-options`, `cpp-options` are not deduplicated anymore
220     ([#4449](https://github.com/haskell/cabal/issues/4449)).
221   * Deprecated `cabal hscolour` in favour of `cabal haddock --hyperlink-source` ([#5236](https://github.com/haskell/cabal/pull/5236/)).
222   * Recognize `powerpc64le` as architecture PPC64.
223   * Cabal now deduplicates more `-I` and `-L` and flags to avoid `E2BIG`
224     ([#5356](https://github.com/haskell/cabal/issues/5356)).
225   * With `build-type: configure`, avoid using backslashes to delimit
226     path components on Windows and warn about other unsafe characters
227     in the path to the source directory on all platforms
228     ([#5386](https://github.com/haskell/cabal/issues/5386)).
229   * `Distribution.PackageDescription.Check.checkPackageFiles` now
230     accepts a `Verbosity` argument.
231   * Added a parameter to
232     `Distribution.Backpack.ConfiguredComponent.toConfiguredComponent` in order to fix
233     [#5409](https://github.com/haskell/cabal/issues/5409).
234   * Partially silence `abi-depends` warnings
235     ([#5465](https://github.com/haskell/cabal/issues/5465)).
236   * Foreign libraries are now linked against the threaded RTS when the
237     'ghc-options: -threaded' flag is used
238     ([#5431](https://github.com/haskell/cabal/pull/5431)).
239   * Pass command line arguments to `hsc2hs` using response files when possible
240     ([#3122](https://github.com/haskell/cabal/issues/3122)).
242 ----
244 ## 2.2.0.1 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) March 2018
246   * Fix `checkPackageFiles` for relative directories ([#5206](https://github.com/haskell/cabal/issues/5206))
249 # 2.2.0.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) March 2018
251   * The 2.2 migration guide gives advice on adapting Custom setup
252     scripts to backwards-incompatible changes in this release:
253     https://github.com/haskell/cabal/wiki/2.2-migration-guide.
254   * New Parsec-based parser for `.cabal` files is now the
255     default. This brings memory consumption and speed improvements, as
256     well as making new syntax extensions easier to implement.
257   * Support for common stanzas (#4751).
258   * Added elif-conditionals to `.cabal` syntax (#4750).
259   * The package license information can now be specified using the
260     SPDX syntax. This requires setting `cabal-version` to 2.2+ (#2547,
261     #5050).
262   * Support for GHC's numeric -g debug levels (#4673).
263   * Compilation with section splitting is now supported via the
264     `--enable-split-sections` flag (#4819)
265   * Fields with mandatory commas (e.g. build-depends) may now have a
266     leading or a trailing comma (either one, not both) (#4953)
267   * Added `virtual-modules` field, to allow modules that are not built
268     but registered (#4875).
269   * Use better defaulting for `build-type`; rename `PackageDescription`'s
270     `buildType` field to `buildTypeRaw` and introduce new `buildType`
271     function (#4958)
272   * `D.T.PackageDescription.allBuildInfo` now returns all build infos, not
273     only for buildable components (#5087).
274   * Removed `UnknownBuildType` constructor from `BuildType` (#5003).
275   * Added `HexFloatLiterals` to `KnownExtension`.
276   * Cabal will no longer try to build an empty set of `inputModules`
277     (#4890).
278   * `copyComponent` and `installIncludeFiles` will now look for
279     include headers in the build directory (`dist/build/...` by
280     default) as well (#4866).
281   * Added `cxx-options` and `cxx-sources` buildinfo fields for
282     separate compilation of C++ source files (#3700).
283   * Removed unused `--allow-newer`/`--allow-older` support from
284     `Setup configure` (#4527).
285   * Changed `FlagAssignment` to be an opaque `newtype` (#4849).
286   * Changed `rawSystemStdInOut` to use proper type to represent
287     binary and textual data; new `Distribution.Utils.IOData` module;
288     removed obsolete `startsWithBOM`, `fileHasBOM`, `fromUTF8`,
289     and `toUTF8` functions; add new `toUTF8BS`/`toUTF8LBS`
290     encoding functions. (#4666)
291   * Added a `cabal check` warning when the `.cabal` file name does
292     not match package name (#4592).
293   * The `ar` program now receives its arguments via a response file
294     (`@file`).  Old behaviour can be restored with
295     `--disable-response-files` argument to `configure` or
296     `install` (#4596).
297   * Added `.Lens` modules, with optics for package description data
298     types (#4701).
299   * Support for building with Win32 version 2.6 (#4835).
300   * Change `compilerExtensions` and `ghcOptExtensionMap` to contain
301     `Maybe Flag`s, since a supported extension can lack a flag (#4443).
302   * Pretty-printing of `.cabal` files is slightly different due to
303     parser changes. For an example, see
304     https://mail.haskell.org/pipermail/cabal-devel/2017-December/010414.html.
305   * `--hyperlink-source` now uses Haddock's hyperlinker backend when
306     Haddock is new enough, falling back to HsColour otherwise.
307   * `D.S.defaultHookedPackageDesc` has been deprecated in favour of
308     `D.S.findHookedPackageDesc` (#4874).
309   * `D.S.getHookedBuildInfo` now takes an additional parameter
310     specifying the build directory path (#4874).
311   * Emit warning when encountering unknown GHC versions (#415).
313 ### 2.0.1.1 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) December 2017
315   * Don't pass `other-modules` to stub executable for detailed-0.9
316   (#4918).
317   * Hpc: Use relative .mix search paths (#4917).
319 ## 2.0.1.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) November 2017
321   * Support for GHC's numeric -g debug levels (#4673).
322   * Added a new `Distribution.Verbosity.modifyVerbosity` combinator
323     (#4724).
324   * Added a new `cabal check` warning about unused, undeclared or
325     non-Unicode flags.  Also, it warns about leading dash, which is
326     unusable but accepted if it's unused in conditionals. (#4687)
327   * Modify `allBuildInfo` to include foreign library info (#4763).
328   * Documentation fixes.
330 ### 2.0.0.2 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) July 2017
332   * See http://coldwa.st/e/blog/2017-09-09-Cabal-2-0.html
333     for more detailed release notes.
334   * The 2.0 migration guide gives advice on adapting Custom setup
335     scripts to backwards-incompatible changes in this release:
336     https://github.com/haskell/cabal/wiki/2.0-migration-guide
337   * Add CURRENT_PACKAGE_VERSION to cabal_macros.h (#4319)
338   * Dropped support for versions of GHC earlier than 6.12 (#3111).
339   * GHC compatibility window for the Cabal library has been extended
340     to five years (#3838).
341   * Convenience/internal libraries are now supported (#269).
342     An internal library is declared using the stanza `library
343     'libname'`.  Packages which use internal libraries can
344     result in multiple registrations; thus `--gen-pkg-config`
345     can now output a directory of registration scripts rather than
346     a single file.
347   * Backwards incompatible change to preprocessor interface:
348     the function in `PPSuffixHandler` now takes an additional
349     `ComponentLocalBuildInfo` specifying the build information
350     of the component being preprocessed.
351   * Backwards incompatible change to `cabal_macros.h` (#1893): we now
352     generate a macro file for each component which contains only
353     information about the direct dependencies of that component.
354     Consequently, `dist/build/autogen/cabal_macros.h` contains
355     only the macros for the library, and is not generated if a
356     package has no library; to find the macros for an executable
357     named `foobar`, look in `dist/build/foobar/autogen/cabal_macros.h`.
358     Similarly, if you used `autogenModulesDir` you should now
359     use `autogenComponentModulesDir`, which now requires a
360     `ComponentLocalBuildInfo` argument as well in order to
361     disambiguate which component the autogenerated files are for.
362   * Backwards incompatible change to `Component`: `TestSuite` and
363     `Benchmark` no longer have `testEnabled` and
364     `benchmarkEnabled`.  If you used
365     `enabledTests` or `enabledBenchmarks`, please instead use
366     `enabledTestLBIs` and `enabledBenchLBIs`
367     (you will need a `LocalBuildInfo` for these functions.)
368     Additionally, the semantics of `withTest` and `withBench`
369     have changed: they now iterate over all buildable
370     such components, regardless of whether or not they have
371     been enabled; if you only want enabled components,
372     use `withTestLBI` and `withBenchLBI`.
373     `finalizePackageDescription` is deprecated:
374     its replacement `finalizePD` now takes an extra argument
375     `ComponentRequestedSpec` which specifies what components
376     are to be enabled: use this instead of modifying the
377     `Component` in a `GenericPackageDescription`.  (As
378     it's not possible now, `finalizePackageDescription`
379     will assume tests/benchmarks are disabled.)
380     If you only need to test if a component is buildable
381     (i.e., it is marked buildable in the Cabal file)
382     use the new function `componentBuildable`.
383   * Backwards incompatible change to `PackageName` (#3896):
384     `PackageName` is now opaque; conversion to/from `String` now works
385     via (old) `unPackageName` and (new) `mkPackageName` functions.
386   * Backwards incompatible change to `ComponentId` (#3917):
387     `ComponentId` is now opaque; conversion to/from `String` now works
388     via `unComponentId` and `mkComponentId` functions.
389   * Backwards incompatible change to `AbiHash` (#3921):
390     `AbiHash` is now opaque; conversion to/from `String` now works
391     via `unAbiHash` and `mkAbiHash` functions.
392   * Backwards incompatible change to `FlagName` (#4062):
393     `FlagName` is now opaque; conversion to/from `String` now works
394     via `unFlagName` and `mkFlagName` functions.
395   * Backwards incompatible change to `Version` (#3905):
396     Version is now opaque; conversion to/from `[Int]` now works
397     via `versionNumbers` and `mkVersion` functions.
398   * Add support for `--allow-older` (dual to `--allow-newer`) (#3466)
399   * Improved an error message for process output decoding errors
400   (#3408).
401   * `getComponentLocalBuildInfo`, `withComponentsInBuildOrder`
402     and `componentsInBuildOrder` are deprecated in favor of a
403     new interface in `Distribution.Types.LocalBuildInfo`.
404   * New `autogen-modules` field. Modules that are built automatically at
405     setup, like Paths_PACKAGENAME or others created with a build-type
406     custom, appear on `other-modules` for the Library, Executable,
407     Test-Suite or Benchmark stanzas or also on `exposed-modules` for
408     libraries but are not really on the package when distributed. This
409     makes commands like sdist fail because the file is not found, so with
410     this new field modules that appear there are treated the same way as
411     Paths_PACKAGENAME was and there is no need to create complex build
412     hooks. Just add the module names on `other-modules` and
413     `exposed-modules` as always and on the new `autogen-modules` besides.
414   (#3656).
415   * New `./Setup configure` flag `--cabal-file`, allowing multiple
416   `.cabal` files in a single directory (#3553). Primarily intended for
417   internal use.
418   * Macros in `cabal_macros.h` are now ifndef'd, so that they
419   don't cause an error if the macro is already defined. (#3041)
420   * `./Setup configure` now accepts a single argument specifying
421     the component to be configured.  The semantics of this mode
422     of operation are described in
423     <https://github.com/ghc-proposals/ghc-proposals/pull/4>
424   * Internal `build-tools` dependencies are now added to PATH
425     upon invocation of GHC, so that they can be conveniently
426     used via `-pgmF`. (#1541)
427   * Add support for new caret-style version range operator `^>=` (#3705)
428   * Verbosity `-v` now takes an extended format which allows
429     specifying exactly what you want to be logged.  The format is
430     `[silent|normal|verbose|debug] flags`, where flags is a space
431     separated list of flags. At the moment, only the flags
432     +callsite and +callstack are supported; these report the
433     call site/stack of a logging output respectively (these
434     are only supported if Cabal is built with GHC 8.0/7.10.2
435     or greater, respectively).
436   * New `Distribution.Utils.ShortText.ShortText` type for representing
437     short text strings compactly (#3898)
438   * Cabal no longer supports using a version bound to disambiguate
439     between an internal and external package (#4020).  This should
440     not affect many people, as this mode of use already did not
441     work with the dependency solver.
442   * Support for "foreign libraries" (#2540), which are Haskell
443     libraries intended to be used by foreign languages like C.
444     Foreign libraries only work with GHC 7.8 and later.
445   * Added a technical preview version of integrated doctest support (#4480).
446   * Added a new `scope` field to the executable stanza. Executables
447     with `scope: private` get installed into
448     $libexecdir/$libexecsubdir. Additionally $libexecdir now has a
449     subdir structure similar to $lib(sub)dir to allow installing
450     private executables of different packages and package versions
451     alongside one another.  Private executables are those that are
452     expected to be run by other programs rather than users. (#3461)
454 ## 1.24.2.0 [Mikhail Glushenkov](mailto:mikhail.glushenkov@gmail.com) December 2016
455   * Fixed a bug in the handling of non-buildable components (#4094).
456   * Reverted a PVP-noncompliant API change in 1.24.1.0 (#4123).
457   * Bumped the directory upper bound to < 1.4 (#4158).
459 ## 1.24.1.0 [Ryan Thomas](mailto:ryan@ryant.org) October 2016
460   * API addition: `differenceVersionRanges` (#3519).
461   * Fixed reexported-modules display mangling (#3928).
462   * Check that the correct cabal-version is specified when the
463   extra-doc-files field is present (#3825).
464   * Fixed an incorrect invocation of GetShortPathName that was
465   causing build failures on Windows (#3649).
466   * Linker flags are now set correctly on GHC >= 7.8 (#3443).
468 # 1.24.0.0 [Ryan Thomas](mailto:ryan@ryant.org) March 2016
469   * Support GHC 8.
470   * Deal with extra C sources from preprocessors (#238).
471   * Include cabal_macros.h when running c2hs (#2600).
472   * Don't recompile C sources unless needed (#2601).
473   * Read `builddir` option from `CABAL_BUILDDIR` environment variable.
474   * Add `--profiling-detail=$level` flag with a default for libraries
475     and executables of `exported-functions` and `toplevel-functions`
476     respectively (GHC's `-fprof-auto-{exported,top}` flags) (#193).
477   * New `custom-setup` stanza to specify setup deps. Setup is also built
478     with the cabal_macros.h style macros, for conditional compilation.
479   * Support Haddock response files (#2746).
480   * Fixed a bug in the Text instance for Platform (#2862).
481   * New `setup haddock` option: `--for-hackage` (#2852).
482   * New `--show-detail=direct`; like streaming, but allows the test
483     program to detect that is connected to a terminal, and works
484     reliable with a non-threaded runtime (#2911, and serves as a
485     work-around for #2398)
486   * Library support for multi-instance package DBs (#2948).
487   * Improved the `./Setup configure` solver (#3082, #3076).
488   * The `--allow-newer` option can be now used with `./Setup
489   configure` (#3163).
490   * Added a way to specify extra locations to find OS X frameworks
491   in (`extra-framework-dirs`). Can be used both in `.cabal` files and
492   as an argument to `./Setup configure` (#3158).
493   * Macros `VERSION_$pkgname` and `MIN_VERSION_$pkgname` are now
494   also generated for the current package. (#3235).
495   * Backpack is supported!  Two new fields supported in Cabal
496   files: signatures and mixins; and a new flag
497   to setup scripts, `--instantiate-with`.  See
498   https://github.com/ezyang/ghc-proposals/blob/backpack/proposals/0000-backpack.rst
499   for more details.
501 ----
503 ## 1.22.8.0 [Ryan Thomas](mailto:ryan@ryant.org) March 2016
504   * Distribution.Simple.Setup: remove job cap. Fixes #3191.
505   * Check all object file suffixes for recompilation. Fixes #3128.
506   * Move source files under `src/`. Fixes #3003.
508 ## 1.22.7.0 [Ryan Thomas](mailto:ryan@ryant.org) January 2016
509   * Backport #3012 to the 1.22 branch
510   * Cabal.cabal: change build-type to Simple
511   * Add foldl' import
512   * The Cabal part for fully gcc-like response files
514 ## 1.22.6.0 [Ryan Thomas](mailto:ryan@ryant.org) December 2015
515   * Relax upper bound to allow upcoming binary-0.8
517 ## 1.22.5.0 [Ryan Thomas](mailto:ryan@ryant.org) November 2015
518   * Don't recompile C sources unless needed (#2601). (Luke Iannini)
519   * Support Haddock response files.
520   * Add frameworks when linking a dynamic library.
522 ## 1.22.4.0 [Ryan Thomas](mailto:ryan@ryant.org) June 2015
523   * Add libname install-dirs variable, use it by default. Fixes #2437. (Edward Z. Yang)
524   * Reduce temporary directory name length, fixes #2502. (Edward Z. Yang)
525   * Workaround for #2527. (Mikhail Glushenkov)
527 ## 1.22.3.0 [Ryan Thomas](mailto:ryan@ryant.org) April 2015
528   * Fix for the ghcjs-pkg version number handling (Luite Stegeman)
529   * filterConfigureFlags: filter more flags (Mikhail Glushenkov)
530   * Cabal check will fail on -fprof-auto passed as a ghc-option - Fixes #2479 (John Chee)
532 ## 1.22.2.0 [Ryan Thomas](mailto:ryan@ryant.org) March 2015
533   * Don't pass `--{en,dis}able-profiling` to old setup.
534   * Add -Wall police
535   * Fix dependencies on `old-time`
536   * Fix test interface detailed-0.9 with GHC 7.10
537   * Fix HPC tests with GHC 7.10
538   * Make sure to pass the package key to ghc
539   * Use `--package-{name|version}` when available for Haddock when available
540   * Put full package name and version in library names
541   * Fully specify package key format, so external tools can generate it.
543 # 1.22.0.0 [Johan Tibell](mailto:johan.tibell@gmail.com) January 2015
544   * Support GHC 7.10.
545   * Experimental support for emitting DWARF debug info.
546   * Preliminary support for relocatable packages.
547   * Allow cabal to be used inside cabal exec environments.
548   * hpc: support multiple "ways" (e.g. profiling and vanilla).
549   * Support GHCJS.
550   * Improved command line documentation.
551   * Add `-none` constraint syntax for version ranges (#2093).
552   * Make the default doc index file path compiler/arch/os-dependent
553   (#2136).
554   * Warn instead of dying when generating documentation and hscolour
555   isn't installed (455f51622fa38347db62197a04bb0fa5b928ff17).
556   * Support the new BinaryLiterals extension
557   (1f25ab3c5eff311ada73c6c987061b80e9bbebd9).
558   * Warn about `ghc-prof-options: -auto-all` in `cabal check` (#2162).
559   * Add preliminary support for multiple instances of the same package
560   version installed side-by-side (#2002).
561   * New binary build config format - faster build times (#2076).
562   * Support module thinning and renaming (#2038).
563   * Add a new license type: UnspecifiedLicense (#2141).
564   * Remove support for Hugs and nhc98 (#2168).
565   * Invoke `tar` with `--formar ustar` if possible in `sdist` (#1903).
566   * Replace `--enable-library-coverage` with `--enable-coverage`, which
567   enables program coverage for all components (#1945).
568   * Suggest that `ExitFailure 9` is probably due to memory
569   exhaustion (#1522).
570   * Drop support for Haddock < 2.0 (#1808, #1718).
571   * Make `cabal test`/`cabal bench` build only what's needed for
572   running tests/benchmarks (#1821).
573   * Build shared libraries by default when linking executables dynamically.
574   * Build profiled libraries by default when profiling executables.
576 ----
578 ### 1.20.0.4 [Ryan Thomas](mailto:ryan@ryant.org) January 2016
579   * Cabal.cabal: change build-type to Simple.
581 ### 1.20.0.1 [Johan Tibell](mailto:johan.tibell@gmail.com) May 2014
582   * Fix streaming test output.
584 # 1.20.0.0 [Johan Tibell](mailto:johan.tibell@gmail.com) April 2014
585   * Rewrite user guide
586   * Fix repl Ctrl+C handling
587   * Add haskell-suite compiler support
588   * Add __HADDOCK_VERSION__ define
589   * Allow specifying exact dependency version using hash
590   * Rename extra-html-files to extra-doc-files
591   * Add parallel build support for GHC 7.8 and later
592   * Don't call ranlib on OS X
593   * Avoid re-linking executables, test suites, and benchmarks
594   unnecessarily, shortening build times
595   * Add `--allow-newer` which allows upper version bounds to be
596   ignored
597   * Add `--enable-library-stripping`
598   * Add command for freezing dependencies
599   * Allow repl to be used outside Cabal packages
600   * Add `--require-sandbox`
601   * Don't use `--strip-unneeded` on OS X or iOS
602   * Add new license-files field got additional licenses
603   * Fix if(solaris) on some Solaris versions
604   * Don't use -dylib-install-name on OS X with GHC > 7.8
605   * Add DragonFly as a known OS
606   * Improve pretty-printing of Cabal files
607   * Add test flag `--show-details=streaming` for real-time test output
608   * Add exec command
610 ----
612 ## 1.10.2.0 [Duncan Coutts](mailto:duncan@community.haskell.org) June 2011
613   * Include test suites in cabal sdist
614   * Fix for conditionals in test suite stanzas in `.cabal` files
615   * Fix permissions of directories created during install
616   * Fix for global builds when $HOME env var is not set
618 ## 1.10.1.0 [Duncan Coutts](mailto:duncan@community.haskell.org) February 2011
619   * Improved error messages when test suites are not enabled
620   * Template parameters allowed in test `--test-option(s)` flag
621   * Improved documentation of the test feature
622   * Relaxed QA check on cabal-version when using test-suite sections
623   * `haddock` command now allows both `--hoogle` and `--html` at the same time
624   * Find ghc-version-specific instances of the hsc2hs program
625   * Preserve file executable permissions in sdist tarballs
626   * Pass gcc location and flags to ./configure scripts
627   * Get default gcc flags from ghc
629 # 1.10.0.0 [Duncan Coutts](mailto:duncan@haskell.org) November 2010
630   * New cabal test feature
631   * Initial support for UHC
632   * New default-language and other-languages fields (e.g. Haskell98/2010)
633   * New default-extensions and other-extensions fields
634   * Deprecated extensions field (for packages using cabal-version >=1.10)
635   * Cabal-version field must now only be of the form `>= x.y`
636   * Removed deprecated `--copy-prefix=` feature
637   * Auto-reconfigure when `.cabal` file changes
638   * Workaround for haddock overwriting .hi and .o files when using TH
639   * Extra cpp flags used with hsc2hs and c2hs (-D${os}_BUILD_OS etc)
640   * New cpp define VERSION_<package> gives string version of dependencies
641   * User guide source now in markdown format for easier editing
642   * Improved checks and error messages for C libraries and headers
643   * Removed BSD4 from the list of suggested licenses
644   * Updated list of known language extensions
645   * Fix for include paths to allow C code to import FFI stub.h files
646   * Fix for intra-package dependencies on OSX
647   * Stricter checks on various bits of `.cabal` file syntax
648   * Minor fixes for c2hs
650 ----
652 ### 1.8.0.6 [Duncan Coutts](mailto:duncan@haskell.org) June 2010
653   * Fix `register --global/--user`
655 ### 1.8.0.4 [Duncan Coutts](mailto:duncan@haskell.org) March 2010
656   * Set dylib-install-name for dynalic libs on OSX
657   * Stricter configure check that compiler supports a package's extensions
658   * More configure-time warnings
659   * Hugs can compile Cabal lib again
660   * Default datadir now follows prefix on Windows
661   * Support for finding installed packages for hugs
662   * Cabal version macros now have proper parenthesis
663   * Reverted change to filter out deps of non-buildable components
664   * Fix for registering inplace when using a specific package db
665   * Fix mismatch between $os and $arch path template variables
666   * Fix for finding ar.exe on Windows, always pick ghc's version
667   * Fix for intra-package dependencies with ghc-6.12
669 # 1.8.0.2 [Duncan Coutts](mailto:duncan@haskell.org) December 2009
670   * Support for GHC-6.12
671   * New unique installed package IDs which use a package hash
672   * Allow executables to depend on the lib within the same package
673   * Dependencies for each component apply only to that component
674     (previously applied to all the other components too)
675   * Added new known license MIT and versioned GPL and LGPL
676   * More liberal package version range syntax
677   * Package registration files are now UTF8
678   * Support for LHC and JHC-0.7.2
679   * Deprecated RecordPuns extension in favour of NamedFieldPuns
680   * Deprecated PatternSignatures extension in favor of ScopedTypeVariables
681   * New VersionRange semantic view as a sequence of intervals
682   * Improved package quality checks
683   * Minor simplification in a couple `Setup.hs` hooks
684   * Beginnings of a unit level testsuite using QuickCheck
685   * Various bug fixes
686   * Various internal cleanups
688 ----
690 ### 1.6.0.2 [Duncan Coutts](mailto:duncan@haskell.org) February 2009
691   * New configure-time check for C headers and libraries
692   * Added language extensions present in ghc-6.10
693   * Added support for NamedFieldPuns extension in ghc-6.8
694   * Fix in configure step for ghc-6.6 on Windows
695   * Fix warnings in `Path_pkgname.hs` module on Windows
696   * Fix for exotic flags in ld-options field
697   * Fix for using pkg-config in a package with a lib and an executable
698   * Fix for building haddock docs for exes that use the Paths module
699   * Fix for installing header files in subdirectories
700   * Fix for the case of building profiling libs but not ordinary libs
701   * Fix read-only attribute of installed files on Windows
702   * Ignore ghc -threaded flag when profiling in ghc-6.8 and older
704 ### 1.6.0.1 [Duncan Coutts](mailto:duncan@haskell.org) October 2008
705   * Export a compat function to help alex and happy
707 # 1.6.0.0 [Duncan Coutts](mailto:duncan@haskell.org) October 2008
708   * Support for ghc-6.10
709   * Source control repositories can now be specified in `.cabal` files
710   * Bug report URLs can be now specified in `.cabal` files
711   * Wildcards now allowed in data-files and extra-source-files fields
712   * New syntactic sugar for dependencies `build-depends: foo ==1.2.*`
713   * New cabal_macros.h provides macros to test versions of dependencies
714   * Relocatable bindists now possible on unix via env vars
715   * New `exposed` field allows packages to be not exposed by default
716   * Install dir flags can now use $os and $arch variables
717   * New `--builddir` flag allows multiple builds from a single sources dir
718   * cc-options now only apply to .c files, not for -fvia-C
719   * cc-options are not longer propagated to dependent packages
720   * The cpp/cc/ld-options fields no longer use `,` as a separator
721   * hsc2hs is now called using gcc instead of using ghc as gcc
722   * New api for manipulating sets and graphs of packages
723   * Internal api improvements and code cleanups
724   * Minor improvements to the user guide
725   * Miscellaneous minor bug fixes
727 ----
729 ### 1.4.0.2 [Duncan Coutts](mailto:duncan@haskell.org) August 2008
730   * Fix executable stripping default
731   * Fix striping exes on OSX that export dynamic symbols (like ghc)
732   * Correct the order of arguments given by `--prog-options=`
733   * Fix corner case with overlapping user and global packages
734   * Fix for modules that use pre-processing and `.hs-boot` files
735   * Clarify some points in the user guide and readme text
736   * Fix verbosity flags passed to sub-command like haddock
737   * Fix `sdist --snapshot`
738   * Allow meta-packages that contain no modules or C code
739   * Make the generated Paths module -Wall clean on Windows
741 ### 1.4.0.1 [Duncan Coutts](mailto:duncan@haskell.org) June 2008
742   * Fix a bug which caused `.` to always be in the sources search path
743   * Haddock-2.2 and later do now support the `--hoogle` flag
745 # 1.4.0.0 [Duncan Coutts](mailto:duncan@haskell.org) June 2008
746   * Rewritten command line handling support
747   * Command line completion with bash
748   * Better support for Haddock 2
749   * Improved support for nhc98
750   * Removed support for ghc-6.2
751   * Haddock markup in `.lhs` files now supported
752   * Default colour scheme for highlighted source code
753   * Default prefix for `--user` installs is now `$HOME/.cabal`
754   * All `.cabal` files are treaded as UTF-8 and must be valid
755   * Many checks added for common mistakes
756   * New `--package-db=` option for specific package databases
757   * Many internal changes to support cabal-install
758   * Stricter parsing for version strings, eg dissalows "1.05"
759   * Improved user guide introduction
760   * Programatica support removed
761   * New options `--program-prefix/suffix` allows eg versioned programs
762   * Support packages that use `.hs-boot` files
763   * Fix sdist for Main modules that require preprocessing
764   * New configure -O flag with optimisation level 0--2
765   * Provide access to "`x-`" extension fields through the Cabal api
766   * Added check for broken installed packages
767   * Added warning about using inconsistent versions of dependencies
768   * Strip binary executable files by default with an option to disable
769   * New options to add site-specific include and library search paths
770   * Lift the restriction that libraries must have exposed-modules
771   * Many bugs fixed.
772   * Many internal structural improvements and code cleanups
774 ----
776 ## 1.2.4.0 [Duncan Coutts](mailto:duncan@haskell.org) June 2008
777   * Released with GHC 6.8.3
778   * Backported several fixes and minor improvements from Cabal-1.4
779   * Use a default colour scheme for sources with hscolour >=1.9
780   * Support `--hyperlink-source` for Haddock >= 2.0
781   * Fix for running in a non-writable directory
782   * Add OSX -framework arguments when linking executables
783   * Updates to the user guide
784   * Allow build-tools names to include + and _
785   * Export autoconfUserHooks and simpleUserHooks
786   * Export ccLdOptionsBuildInfo for `Setup.hs` scripts
787   * Export unionBuildInfo and make BuildInfo an instance of Monoid
788   * Fix to allow the `main-is` module to use a pre-processor
790 ## 1.2.3.0 [Duncan Coutts](mailto:duncan@haskell.org) Nov 2007
791   * Released with GHC 6.8.2
792   * Includes full list of GHC language extensions
793   * Fix infamous `dist/conftest.c` bug
794   * Fix `configure --interfacedir=`
795   * Find ld.exe on Windows correctly
796   * Export PreProcessor constructor and mkSimplePreProcessor
797   * Fix minor bug in unlit code
798   * Fix some markup in the haddock docs
800 ## 1.2.2.0 [Duncan Coutts](mailto:duncan@haskell.org) Nov 2007
801   * Released with GHC 6.8.1
802   * Support haddock-2.0
803   * Support building DSOs with GHC
804   * Require reconfiguring if the `.cabal` file has changed
805   * Fix os(windows) configuration test
806   * Fix building documentation
807   * Fix building packages on Solaris
808   * Other minor bug fixes
810 ## 1.2.1 [Duncan Coutts](mailto:duncan@haskell.org) Oct 2007
811   * To be included in GHC 6.8.1
812   * New field `cpp-options` used when preprocessing Haskell modules
813   * Fixes for hsc2hs when using ghc
814   * C source code gets compiled with -O2 by default
815   * OS aliases, to allow os(windows) rather than requiring os(mingw32)
816   * Fix cleaning of `stub` files
817   * Fix cabal-setup, command line ui that replaces `runhaskell Setup.hs`
818   * Build docs even when dependent packages docs are missing
819   * Allow the `--html-dir` to be specified at configure time
820   * Fix building with ghc-6.2
821   * Other minor bug fixes and build fixes
823 # 1.2.0  [Duncan Coutts](mailto:duncan.coutts@worc.ox.ac.uk) Sept 2007
824   * To be included in GHC 6.8.x
825   * New configurations feature
826   * Can make haddock docs link to highlighted sources (with hscolour)
827   * New flag to allow linking to haddock docs on the web
828   * Supports pkg-config
829   * New field `build-tools` for tool dependencies
830   * Improved c2hs support
831   * Preprocessor output no longer clutters source dirs
832   * Separate `includes` and `install-includes` fields
833   * Makefile command to generate makefiles for building libs with GHC
834   * New `--docdir` configure flag
835   * Generic `--with-prog` `--prog-args` configure flags
836   * Better default installation paths on Windows
837   * Install paths can be specified relative to each other
838   * License files now installed
839   * Initial support for NHC (incomplete)
840   * Consistent treatment of verbosity
841   * Reduced verbosity of configure step by default
842   * Improved helpfulness of output messages
843   * Help output now clearer and fits in 80 columns
844   * New setup register `--gen-pkg-config` flag for distros
845   * Major internal refactoring, hooks api has changed
846   * Dozens of bug fixes
848 ----
850 ### 1.1.6.2 [Duncan Coutts](mailto:duncan.coutts@worc.ox.ac.uk) May 2007
852   * Released with GHC 6.6.1
853   * Handle windows text file encoding for `.cabal` files
854   * Fix compiling a executable for profiling that uses Template Haskell
855   * Other minor bug fixes and user guide clarifications
857 ### 1.1.6.1 [Duncan Coutts](mailto:duncan.coutts@worc.ox.ac.uk) Oct 2006
859   * fix unlit code
860   * fix escaping in register.sh
862 ## 1.1.6  [Duncan Coutts](mailto:duncan.coutts@worc.ox.ac.uk) Oct 2006
864   * Released with GHC 6.6
865   * Added support for hoogle
866   * Allow profiling and normal builds of libs to be chosen independently
867   * Default installation directories on Win32 changed
868   * Register haddock docs with ghc-pkg
869   * Get haddock to make hyperlinks to dependent package docs
870   * Added BangPatterns language extension
871   * Various bug fixes
873 ## 1.1.4  [Duncan Coutts](mailto:duncan.coutts@worc.ox.ac.uk) May 2006
875   * Released with GHC 6.4.2
876   * Better support for packages that need to install header files
877   * cabal-setup added, but not installed by default yet
878   * Implemented `setup register --inplace`
879   * Have packages exposed by default with ghc-6.2
880   * It is no longer necessary to run `configure` before `clean` or `sdist`
881   * Added support for ghc's `-split-objs`
882   * Initial support for JHC
883   * Ignore extension fields in `.cabal` files (fields beginning with "`x-`")
884   * Some changes to command hooks API to improve consistency
885   * Hugs support improvements
886   * Added GeneralisedNewtypeDeriving language extension
887   * Added cabal-version field
888   * Support hidden modules with haddock
889   * Internal code refactoring
890   * More bug fixes
892 ## 1.1.3  [Isaac Jones](mailto:ijones@syntaxpolice.org) Sept 2005
894   * WARNING: Interfaces not documented in the user's guide may
895     change in future releases.
896   * Move building of GHCi .o libs to the build phase rather than
897   register phase. (from Duncan Coutts)
898   * Use .tar.gz for source package extension
899   * Uses GHC instead of cpphs if the latter is not available
900   * Added experimental "command hooks" which completely override the
901   default behavior of a command.
902   * Some bugfixes
904 # 1.1.1  [Isaac Jones](mailto:ijones@syntaxpolice.org) July 2005
906   * WARNING: Interfaces not documented in the user's guide may
907     change in future releases.
908   * Handles recursive modules for GHC 6.2 and GHC 6.4.
909   * Added `setup test` command (Used with UserHook)
910   * implemented handling of _stub.{c,h,o} files
911   * Added support for profiling
912   * Changed install prefix of libraries (pref/pkgname-version
913     to prefix/pkgname-version/compname-version)
914   * Added pattern guards as a language extension
915   * Moved some functionality to Language.Haskell.Extension
916   * Register / unregister .bat files for windows
917   * Exposed more of the API
918   * Added support for the hide-all-packages flag in GHC > 6.4
919   * Several bug fixes
921 ----
923 # 1.0  [Isaac Jones](mailto:ijones@syntaxpolice.org) March 11 2005
925   * Released with GHC 6.4, Hugs March 2005, and nhc98 1.18
926   * Some sanity checking
928 ----
930 # 0.5  [Isaac Jones](mailto:ijones@syntaxpolice.org) Wed Feb 19 2005
932   * __WARNING__: this is a pre-release and the interfaces are
933     still likely to change until we reach a 1.0 release.
934   * Hooks interfaces changed
935   * Added preprocessors to user hooks
936   * No more executable-modules or hidden-modules.  Use
937     `other-modules` instead.
938   * Certain fields moved into BuildInfo, much refactoring
939   * `extra-libs` -> `extra-libraries`
940   * Added `--gen-script` to configure and unconfigure.
941   * `modules-ghc` (etc) now `ghc-modules` (etc)
942   * added new fields including `synopsis`
943   * Lots of bug fixes
944   * spaces can sometimes be used instead of commas
945   * A user manual has appeared (Thanks, ross!)
946   * for ghc 6.4, configures versioned depends properly
947   * more features to `./setup haddock`
949 ----
951 # 0.4  [Isaac Jones](mailto:ijones@syntaxpolice.org) Sun Jan 16 2005
953   * Much thanks to all the awesome fptools hackers who have been
954   working hard to build the Haskell Cabal!
956   * __Interface Changes__:
958     * __WARNING__: this is a pre-release and the interfaces are still
959     likely to change until we reach a 1.0 release.
961     * Instead of Package.description, you should name your
962     description files <something>.cabal.  In particular, we suggest
963     that you name it <packagename>.cabal, but this is not enforced
964     (yet).  Multiple `.cabal` files in the same directory is an error,
965     at least for now.
967     * `./setup install --install-prefix` is gone.  Use `./setup copy`
968     `--copy-prefix` instead.
970     * The `Modules` field is gone.  Use `hidden-modules`,
971     `exposed-modules`, and `executable-modules`.
973     * `Build-depends` is now a package-only field, and can't go into
974     executable stanzas.  Build-depends is a package-to-package
975     relationship.
977     * Some new fields.  Use the Source.
979   * __New Features__
981     * Cabal is now included as a package in the CVS version of
982     fptools.  That means it'll be released as `-package Cabal` in
983     future versions of the compilers, and if you are a bleeding-edge
984     user, you can grab it from the CVS repository with the compilers.
986     * Hugs compatibility and NHC98 compatibility should both be
987     improved.
989     * Hooks Interface / Autoconf compatibility: Most of the hooks
990     interface is hidden for now, because it's not finalized.  I have
991     exposed only `defaultMainWithHooks` and `defaultUserHooks`.  This
992     allows you to use a ./configure script to preprocess
993     `foo.buildinfo`, which gets merged with `foo.cabal`.  In future
994     releases, we'll expose UserHooks, but we're definitely going to
995     change the interface to those.  The interface to the two functions
996     I've exposed should stay the same, though.
998     * ./setup haddock is a baby feature which pre-processes the
999     source code with hscpp and runs haddock on it.  This is brand new
1000     and hardly tested, so you get to knock it around and see what you
1001     think.
1003     * Some commands now actually implement verbosity.
1005     * The preprocessors have been tested a bit more, and seem to work
1006     OK.  Please give feedback if you use these.
1008 ----
1010 # 0.3  [Isaac Jones](mailto:ijones@syntaxpolice.org) Sun Jan 16 2005
1012   * Unstable snapshot release
1013   * From now on, stable releases are even.
1015 ----
1017 # 0.2  [Isaac Jones](mailto:ijones@syntaxpolice.org)
1019   * Adds more HUGS support and preprocessor support.