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