v2.1.3

See https://haskellstack.org/ for installation and upgrade instructions.

Changes since v2.1.1

Behavior changes:

• Disable WAL mode for SQLite3 databases, to improve compatibility with
  some platforms and filesystems. See
  #4876.

• By default, do not perform expiry checks in Hackage Security. See
  #4928.

Other enhancements:

• Do not rerun expected test failures. This is mostly a change that
  will only affect the Stackage Curator use case, but there is now an
  additional message letting the user know when a previously-failed
  test case is being rerun.

• Move configure information for local packages back to .stack-work to
  improve caching. See
  #4893.

Bug fixes:

• Fix to allow dependencies on specific versions of local git repositories. See
  #4862

• Allow Stack commands to be run in Nix mode without having a project file
  available. See
  #4854.

• Removes dependency on gnu-tar for OSX and Linux environment. The
  --force-local option was required only for windows environment.

• Properly wait for the tar subprocess to complete before returning, thereby
  avoiding a SIGTERM screwing up GHC installation. See
  #4888.

• Use package complete locations from lock files when resolving dependencies
  in extra-deps. See
  #4887.

• Set the HASKELL_DIST_DIR environment to a proper package dist
  directory so doctest is able to load modules autogenerated by Cabal.

• Expose package library when running tests.

• Fix support for non-ASCII module names. See
  4938

Other changes:

• Rename pantry-tmp package back to pantry, now that we have gained
  maintainership (which had been used by someone else for a candidate-only test
  that made it look like the name was free but prevented uploading a real
  package).

Thanks to all our contributors for this release:

• Alan Malloy
• Alexander
• Emanuel Borsboom
• Kirill Zaborsky
• Matt Audesse
• Michael Snoyman
• Mihai Maruseac
• Sibi Prabakaran

v2.1.1

The Stack 2 release represents a series of significant changes to how Stack works internally. For the vast majority of cases, these changes are backwards compatible, in that existing projects will continue to build in the same way with Stack 2 as they did with Stack 1. The large version bump is due to the fundamental internal changes to cache handling, database storage (using SQLite in place of binary files), implicit snapshots (which greatly improve the precompiled cache), and moving to Pantry. We have also removed some less used features, as listed in the release notes below.

See https://haskellstack.org/ for installation and upgrade instructions.

Changes since v1.9.3

Major changes:

• Switch over to pantry for managing packages. This is a major change
  to Stack's internals, and affects user-visible behavior in a few
  places. Some highlights:
  • Drop support for multiple package indices and legacy
    00-index.tar style indices. See
    #4137.
  • Support for archives and repos in the packages section has
    been removed. Instead, you must use extra-deps for such
    dependencies. packages now only supports local filepaths.
  • Add support for Git repositories containing (recursive) submodules.
  • Addition of new configuration options for specifying a "pantry
    tree" key, which provides more reproducibility around builds,
    and (in the future) will be used for more efficient package
    content downloads. You can also specify package name and version
    for more efficient config parsing.
    * NOTE The new stack freeze command provides support
    for automatically generating this additional
    information.
  • Package contents and metadata are stored in an SQLite database
    in place of files on the filesystem. The pantry library can be
    used for interacting with these contents.
  • Internally, Stack has changed many datatypes, including moving
    to Cabal's definition of many data types. As a result of such
    changes, existing cache files will in general be invalidated,
    resulting in Stack needing to rebuild many previously cached
    builds in the new version. Sorry :(.
  • A new command, stack freeze has been added which outputs
    project and snapshot definitions with dependencies pinned to
    their exact versions.
  • The ignore-revision-mismatch setting is no longer needed, and
    has been removed.
  • Overriding GHC boot packages results in any other GHC boot
    packages depending on it being no longer available as a dependency,
    such packages need to be added explicitly when needed. See
    [#4510] (#4510).
  • Cabal solver integration was not updated to support newer
    cabal-install versions so stack solver command was removed as
    well as a related option --solver from stack new and
    stack init.
• Upgrade to Cabal 2.4
  • Note that, in this process, the behavior of file globbing has
    been modified to match that of Cabal. In particular, this means
    that for Cabal spec versions less than 2.4, *.txt will
    match foo.txt, but not foo.2.txt.
• Remove the stack image command. With the advent of Docker multistage
  builds, this functionality is no longer useful. For an example, please see
  Building Haskell Apps with
  Docker.
• Support building GHC from source (experimental)
  • Stack now supports building and installing GHC from source. The built GHC
    is uniquely identified by a commit id and an Hadrian "flavour" (Hadrian is
    the newer GHC build system), hence compiler can be set to use a GHC
    built from source with ghc-git-COMMIT-FLAVOUR
• stack.yaml now supports a configure-options, which are passed directly to
  the configure step in the Cabal build process. See
  #1438
• Remove support for building GHCJS itself. Future releases of Stack
  may remove GHCJS support entirely.
• Support for lock files for pinning exact project dependency versions

Behavior changes:

• stack.yaml now supports snapshot: a synonym for resolver. See
  #4256
• stack script now passes -i -idir in to the ghc
  invocation. This makes it so that the script can import local
  modules, and fixes an issue where .hs files in the current
  directory could affect interpretation of the script. See
  #4538
• When using stack script, custom snapshot files will be resolved
  relative to the directory containing the script.
• Remove the deprecated --upgrade-cabal flag to stack setup.
• Support the drop-packages field in stack.yaml
• Remove the GPG signing code during uploads. The GPG signatures have
  never been used yet, and there are no plans to implement signature
  verification.
• Remove the --plain option for the exec family of commands
• Always use the --exact-configuration Cabal configuration option when
  building (should mostly be a non-user-visible enhancement).
• No longer supports Cabal versions older than 1.19.2. This means
  projects using snapshots earlier than lts-3.0 or
  nightly-2015-05-05 will no longer build.
• Remove the stack docker cleanup command. Docker itself now has
  docker image prune
  and
  docker container prune,
  which you can use instead.
• Interleaved output is now turned on by default, see
  #4702. In
  addition, the packagename> prefix is no longer included in
  interelaved mode when only building a single target.
• The -fhide-source-paths GHC option is now enabled by default and
  can be disabled via the hide-source-paths configuration option in
  stack.yaml. See #3784
• Stack will reconfigure a package if you modify your PATH environment
  variable. See
  #3138.
• For GHC 8.4 and later, disable the "shadowed dependencies" workaround. This
  means that Stack will no longer have to force reconfigures as often. See
  #3554.
• When building a package, Stack takes a lock on the dist directory in
  use to avoid multiple runs of Stack from trampling each others'
  files. See
  #2730.
• Stack will check occassionally if there is a new version available and prompt
  the user to upgrade. This will not incur any additional network traffic, as
  it will piggy-back on the existing Hackage index updates. You can set
  recommend-stack-upgrade: false to bypass this. See
  #1681.
• stack list-dependencies has been removed in favour of stack ls dependencies.
• The new default for --docker-auto-pull is enabled. See
  #3332.

Other enhancements:

• Support MX Linux in get-stack.sh. Fixes
  #4769.
• Defer loading up of files for local packages. This allows us to get
  plan construction errors much faster, and avoid some unnecessary
  work when only building a subset of packages. This is especially
  useful for the curator use case.
• Existing global option --color=WHEN is now also available as a
  non-project-specific yaml configuration parameter color:.
• Adopt the standard proposed at http://no-color.org/, that color should not be
  added by default if the NO_COLOR environment variable is present.
• New command stack ls stack-colors lists the styles and the associated 'ANSI'
  control character sequences that stack uses to color some of its output. See
  stack ls stack-colors --help for more information.
• New global option --stack-colors=STYLES, also available as a
  non-project-specific yaml configuration parameter, allows a stack user to
  redefine the default styles that stack uses to color some of its output. See
  stack --help for more information.
• British English spelling of 'color' (colour) accepted as an alias for
  --color, --stack-colors, stack ls stack-colors at the command line and
  for color: and stack-colors: in yaml configuration files.
• New build option --ddump-dir. (See
  #4225)
• Stack parses and respects the preferred-versions information from
  Hackage for choosing latest version of a package in some cases,
  e.g. stack unpack packagename.
• The components output in the The main module to load is ambiguous message
  now include package names so they can be more easily copy-pasted.
• Git repos are shared across multiple projects. See
  #3551
• Use en_US.UTF-8 locale by default in pure Nix mode so programs won't
  crash because of Unicode in their output
  #4095
• Add --tree to ls dependencies to list dependencies as tree.
  #4101
• Add --pedantic to ghci to run with -Wall and -Werror
  #4463
• Add --cabal-files flag to stack ide targets command.
• Add --stdout flag to all stack ide sub...

v2.1.0.3 (release candidate)

This is the second release candidate for v2.1

Changes since v2.1.0.1 (first release candidate)

Other enhancements:

• Add --docker-mount-mode option to set the Docker volume mount mode
  for performance tuning on macOS.

Bug fixes:

• Fix regression where stack --docker would quit after 20 seconds on
  macOS.

2.1.0.1 (release candidate)

First release candidate for v2.1

Changes since v1.9.3

Major changes:

• Switch over to pantry for managing packages. This is a major change
  to Stack's internals, and affects user-visible behavior in a few
  places. Some highlights:

  • Drop support for multiple package indices and legacy
    00-index.tar style indices. See
    #4137.
  • Support for archives and repos in the packages section has
    been removed. Instead, you must use extra-deps for such
    dependencies. packages now only supports local filepaths.
  • Add support for Git repositories containing (recursive) submodules.
  • Addition of new configuration options for specifying a "pantry
    tree" key, which provides more reproducibility around builds,
    and (in the future) will be used for more efficient package
    content downloads. You can also specify package name and version
    for more efficient config parsing.
    * NOTE The new stack freeze command provides support
    for automatically generating this additional
    information.
  • Package contents and metadata are stored in an SQLite database
    in place of files on the filesystem. The pantry library can be
    used for interacting with these contents.
  • Internally, Stack has changed many datatypes, including moving
    to Cabal's definition of many data types. As a result of such
    changes, existing cache files will in general be invalidated,
    resulting in Stack needing to rebuild many previously cached
    builds in the new version. Sorry :(.
  • A new command, stack freeze has been added which outputs
    project and snapshot definitions with dependencies pinned to
    their exact versions.
  • The ignore-revision-mismatch setting is no longer needed, and
    has been removed.
  • Overriding GHC boot packages results in any other GHC boot
    packages depending on it being no longer available as a dependency,
    such packages need to be added explicitly when needed. See
    [#4510] (#4510).
  • Cabal solver integration was not updated to support newer
    cabal-install versions so stack solver command was removed as
    well as a related option --solver from stack new and
    stack init.

• Upgrade to Cabal 2.4

  • Note that, in this process, the behavior of file globbing has
    been modified to match that of Cabal. In particular, this means
    that for Cabal spec versions less than 2.4, *.txt will
    match foo.txt, but not foo.2.txt.

• Remove the stack image command. With the advent of Docker multistage
  builds, this functionality is no longer useful. For an example, please see
  Building Haskell Apps with
  Docker.

• Support building GHC from source (experimental)

  • Stack now supports building and installing GHC from source. The built GHC
    is uniquely identified by a commit id and an Hadrian "flavour" (Hadrian is
    the newer GHC build system), hence compiler can be set to use a GHC
    built from source with ghc-git-COMMIT-FLAVOUR

• stack.yaml now supports a configure-options, which are passed directly to
  the configure step in the Cabal build process. See
  #1438

• Remove support for building GHCJS itself. Future releases of Stack
  may remove GHCJS support entirely.

• Support for lock files for pinning exact project dependency versions

Behavior changes:

• stack.yaml now supports snapshot: a synonym for resolver. See #4256

• stack script now passes -i -idir in to the ghc
  invocation. This makes it so that the script can import local
  modules, and fixes an issue where .hs files in the current
  directory could affect interpretation of the script. See
  #4538

• When using stack script, custom snapshot files will be resolved
  relative to the directory containing the script.

• Remove the deprecated --upgrade-cabal flag to stack setup.

• Support the drop-packages field in stack.yaml

• Remove the GPG signing code during uploads. The GPG signatures have
  never been used yet, and there are no plans to implement signature
  verification.

• Remove the --plain option for the exec family of commands

• Always use the --exact-configuration Cabal configuration option when
  building (should mostly be a non-user-visible enhancement).

• No longer supports Cabal versions older than 1.19.2. This means
  projects using snapshots earlier than lts-3.0 or
  nightly-2015-05-05 will no longer build.

• Remove the stack docker cleanup command. Docker itself now has
  docker image prune
  and
  docker container prune,
  which you can use instead.

• Interleaved output is now turned on by default, see
  #4702. In
  addition, the packagename> prefix is no longer included in
  interelaved mode when only building a single target.

• The -fhide-source-paths GHC option is now enabled by default and
  can be disabled via the hide-source-paths configuration option in
  stack.yaml. See #3784

• Stack will reconfigure a package if you modify your PATH environment
  variable. See
  #3138.

• For GHC 8.4 and later, disable the "shadowed dependencies" workaround. This
  means that Stack will no longer have to force reconfigures as often. See
  #3554.

• When building a package, Stack takes a lock on the dist directory in
  use to avoid multiple runs of Stack from trampling each others'
  files. See
  #2730.

• Stack will check occassionally if there is a new version available and prompt
  the user to upgrade. This will not incur any additional network traffic, as
  it will piggy-back on the existing Hackage index updates. You can set
  recommend-stack-upgrade: false to bypass this. See
  #1681.

• stack list-dependencies has been removed in favour of stack ls dependencies.

• The new default for --docker-auto-pull is enabled. See
  #3332.

Other enhancements:

• Support MX Linux in get-stack.sh. Fixes
  #4769.
• Defer loading up of files for local packages. This allows us to get
  plan construction errors much faster, and avoid some unnecessary
  work when only building a subset of packages. This is especially
  useful for the curator use case.
• Existing global option --color=WHEN is now also available as a
  non-project-specific yaml configuration parameter color:.
• Adopt the standard proposed at http://no-color.org/, that color should not be
  added by default if the NO_COLOR environment variable is present.
• New command stack ls stack-colors lists the styles and the associated 'ANSI'
  control character sequences that stack uses to color some of its output. See
  stack ls stack-colors --help for more information.
• New global option --stack-colors=STYLES, also available as a
  non-project-specific yaml configuration parameter, allows a stack user to
  redefine the default styles that stack uses to color some of its output. See
  stack --help for more information.
• British English spelling of 'color' (colour) accepted as an alias for
  --color, --stack-colors, stack ls stack-colors at the command line and
  for color: and stack-colors: in yaml configuration files.
• New build option --ddump-dir. (See #4225)
• Stack parses and respects the preferred-versions information from
  Hackage for choosing latest version of a package in some cases,
  e.g. stack unpack packagename.
• The components output in the The main module to load is ambiguous message
  now include package names so they can be more easily copy-pasted.
• Git repos are shared across multiple projects. See
  #3551
• Use en_US.UTF-8 locale by default in pure Nix mode so programs won't
  crash because of Unicode in their output
  #4095
• Add --tree to ls dependencies to list dependencies as tree.
  #4101
• Add --pedantic to ghci to run with -Wall and -Werror
  #4463
• Add --cabal-files flag to stack ide targets command.
• Add --stdout flag to all stack ide subcommands.
• Use batches when unregistering packages with ghc-pkg.
  (See #2662)
• get-stack script now works on Windows CI machines of Appveyor,
  Travis and Azure Pipelines. See
  #4535/
• Show snapshot being used when stack ghci is invoked outside of a project directory. See
  #3651
• The script interpreter now accepts a --extra-dep flag for adding
  packages not present in the snapshot. Currently, th...

v1.9.3

See https://haskellstack.org for installation and upgrade instructions.

Changes since v1.9.1:

Bug fixes:

• Stack can now be compiled again inside a directory that does not
  contain a .git directory, see
  #4364
• Handle a change in GHC's hi-dump format around addDependentFile,
  which now includes a hash. See
  yesodweb/yesod#1551
• Allow variables to appear in template file names.

Thanks to all our contributors for this release:

• Damian
• dbaynard
• Emanuel Borsboom
• Fangyi Zhou
• Flo Edelmann
• Matt Audesse
• Michael Snoyman
• Mihai Maruseac
• Phil de Joux
• Shinya Yamaguchi
• shiyuge
• 欧阳泽

v1.9.1

See https://haskellstack.org for installation and upgrade instructions.

Changes since v1.7.1:

Release notes:

• Statically linked Linux bindists are back again, thanks to @nh2.
• We will be deleting the Ubuntu, Debian, CentOS, Fedora, and Arch package repos from download.fpcomplete.com soon. These have been deprecated for over a year and have not received new releases, but were left in place for compatibility with older scripts.

Major changes:

• Upgrade to Cabal 2.4
  • Note that, in this process, the behavior of file globbing has
    been modified to match that of Cabal. In particular, this means
    that for Cabal spec versions less than 2.4, *.txt will
    match foo.txt, but not foo.2.txt.
• GHCJS support is being downgraded to 'experimental'. A warning notifying the user of the experimental status of GHCJS will be displayed.

Behavior changes:

• ghc-options from stack.yaml are now appended to ghc-options from
  config.yaml, whereas before they would be replaced.
• stack build will now announce when sublibraries of a package are being
  build, in the same way executables, tests, benchmarks and libraries are
  announced
• stack sdist will now announce the destination of the generated tarball,
  regardless of whether or not it passed the sanity checks
• The --upgrade-cabal option to stack setup has been
  deprecated. This feature no longer works with GHC 8.2 and
  later. Furthermore, the reason for this flag originally being
  implemented was drastically lessened once Stack started using the
  snapshot's Cabal library for custom setups. See:
  #4070.
• With the new namespaced template feature, stack templates is no
  longer able to meaningfully display a list of all templates
  available. Instead, the command will download and display a
  help file
  with more information on how to discover templates. See:
  #4039
• Build tools are now handled in a similar way to cabal-install. In
  particular, for legacy build-tools fields, we use a hard-coded
  list of build tools in place of looking up build tool packages in a
  tool map. This both brings Stack's behavior closer into line with
  cabal-install, avoids some bugs, and opens up some possible
  optimizations/laziness. See:
  #4125.
• Mustache templating is not applied to large files (over 50kb) to
  avoid performance degredation. See:
  #4133.
• stack upload signs the package by default, as documented. --no-signature
  turns the signing off.
  #3739
• In case there is a network connectivity issue while trying to
  download a template, stack will check whether that template had
  been downloaded before. In that case, the cached version will be
  used. See #3850.

Other enhancements:

• On Windows before Windows 10, --color=never is the default on terminals that
  can support ANSI color codes in output only by emulation
• On Windows, recognise a 'mintty' (false) terminal as a terminal, by default
• stack build issues a warning when base is explicitly listed in
  extra-deps of stack.yaml
• stack build suggests trying another GHC version should the build
  plan end up requiring unattainable base version.
• A new sub command run has been introduced to build and run a specified executable
  similar to cabal run. If no executable is provided as the first argument, it
  defaults to the first available executable in the project.
• stack build missing dependency suggestions (on failure to construct a valid
  build plan because of missing deps) are now printed with their latest
  cabal file revision hash. See
  #4068.
• Added new --tar-dir option to stack sdist, that allows to copy
  the resulting tarball to the specified directory.
• Introduced the --interleaved-output command line option and
  build.interleaved-output config value which causes multiple concurrent
  builds to dump to stderr at the same time with a packagename> prefix. See
  #3225.
• The default retry strategy has changed to exponential backoff.
  This should help with
  #3510.
• stack new now allows template names of the form username/foo to
  download from a user other than commercialstack on Github, and can be prefixed
  with the service github:, gitlab:, or bitbucket:. #4039
• Switch to githash to include some unmerged bugfixes in gitrev
  Suggestion to add 'allow-newer': true now shows path to user config
  file where this flag should be put into #3685
• stack ghci now asks which main target to load before doing the build,
  rather than after
• Bump to hpack 0.29.0
• With GHC 8.4 and later, Haddock is given the --quickjump flag.
• It is possible to specify the Hackage base URL to upload packages to, instead
  of the default of https://hackage.haskell.org/, by using hackage-base-url
  configuration option.
• When using Nix, if a specific minor version of GHC is not requested, the
  latest minor version in the given major branch will be used automatically.

Bug fixes:

• stack ghci now does not invalidate .o files on repeated runs,
  meaning any modules compiled with -fobject-code will be cached
  between ghci runs. See
  #4038.
• ~/.stack/config.yaml and stack.yaml terminating by newline
• The previous released caused a regression where some stderr from the
  ghc-pkg command showed up in the terminal. This output is now silenced.
• A regression in recompilation checking introduced in v1.7.1 has been fixed.
  See #4001
• stack ghci on a package with internal libraries was erroneously looking
  for a wrong package corresponding to the internal library and failing to
  load any module. This has been fixed now and changes to the code in the
  library and the sublibrary are properly tracked. See
  #3926.
• For packages with internal libraries not depended upon, stack build used
  to fail the build process since the internal library was not built but it
  was tried to be registered. This is now fixed by always building internal
  libraries. See
  #3996.
• --no-nix was not respected under NixOS
• Fix a regression which might use a lot of RAM. See
  #4027.
• Order of commandline arguments does not matter anymore.
  See #3959
• When prompting users about saving their Hackage credentials on upload,
  flush to stdout before waiting for the response so the prompt actually
  displays. Also fixes a similar issue with ghci target selection prompt.
• If cabal is not on PATH, running stack solver now prompts the user
  to run stack install cabal-install
• stack build now succeeds in building packages which contain sublibraries
  which are dependencies of executables, tests or benchmarks but not of the
  main library. See
  #3787.
• Sublibraries are now properly considered for coverage reports when the test
  suite depends on the internal library. Before, stack was erroring when
  trying to generate the coverage report, see
  #4105.
• Sublibraries are now added to the precompiled cache and recovered from there
  when the snapshot gets updated. Previously, updating the snapshot when there
  was a package with a sublibrary in the snapshot resulted in broken builds.
  This is now fixed, see
  #4071.
• [#4114] Stack pretty prints error messages with proper error logging
  level instead of warning now. This also fixes self-executing scripts
  not piping plan construction errors from runhaskell to terminal (issue
  #3942).
• Fix invalid "While building Setup.hs" when Cabal calls fail. See:
  #3934
• stack upload signs the package by default, as documented. --no-signature
  turns the signing off.
  #3739

Thanks to all our contributors for this release:

• Adrian Wong
• Alexey Kotlyarov
• Andrea Bessi
• Asalle
• Asalle Mirzaieva
• Attila Domokos
• braulio
• Buck Evan
• Chris Allen
• Chris Done
• chromezh
• Darryl Abbate
• David Baynard
• David Jarvis
• dbaynard
• Emanuel Borsboom
• Francis De Brabandere
• Guy Sheffer
• Ivan Kasatenko
• John Mendonca
• Jonathan Boulle
• Kirill Zaborsky
• Kostiantyn Rybnikov
• Lyle Kopnicky
• Markus Hauck
• Matchwood
• Matt Audesse
• Michael Sloan
• Michael Snoyman
• Mihai Maruseac
• Mike Pilgrem
• ncaq
• Paolo G. Giarrusso
• Pavel Krajcevski
• Pratik Chaudhary
• pythonissam
• Reuben D'Netto
• Richard Szibele
• RoelofWobben
• rszibele
• Sandy Maguire
• Sibi Prabakaran
• Simon Hengel
• tdietert
• The Gitter Badger
• Thomas Tuegel
• Tom Sydney Kerckhove
• Tom Welsh
• Trevor Rothaus
• t...

v1.9.0.1 (RELEASE CANDIDATE)

First release candidate for v1.9

Changes since v1.7.1

Release notes:

• Statically linked Linux bindists are back again, thanks to @nh2.
  Please try the stack-1.9.0.1-linux-x86_64-static.tar.gz distribution if using Linux, since it will be the default installed version once v1.9.1 is released.
• We will be deleting the Ubuntu, Debian, CentOS, Fedora, and Arch package repos from download.fpcomplete.com soon. These have been deprecated for over a year and have not received new releases, but were left in place for compatibility with older scripts.

Major changes:

• GHCJS support is being downgraded to 'experimental'. A warning notifying the user of the experimental status of GHCJS will be displayed.

Behavior changes:

• ghc-options from stack.yaml are now appended to ghc-options from
  config.yaml, whereas before they would be replaced.
• stack build will now announce when sublibraries of a package are being
  build, in the same way executables, tests, benchmarks and libraries are
  announced
• stack sdist will now announce the destination of the generated tarball,
  regardless of whether or not it passed the sanity checks
• The --upgrade-cabal option to stack setup has been
  deprecated. This feature no longer works with GHC 8.2 and
  later. Furthermore, the reason for this flag originally being
  implemented was drastically lessened once Stack started using the
  snapshot's Cabal library for custom setups. See:
  #4070.
• With the new namespaced template feature, stack templates is no
  longer able to meaningfully display a list of all templates
  available. Instead, the command will download and display a
  help file
  with more information on how to discover templates. See:
  #4039
• Build tools are now handled in a similar way to cabal-install. In
  particular, for legacy build-tools fields, we use a hard-coded
  list of build tools in place of looking up build tool packages in a
  tool map. This both brings Stack's behavior closer into line with
  cabal-install, avoids some bugs, and opens up some possible
  optimizations/laziness. See:
  #4125.
• Mustache templating is not applied to large files (over 50kb) to
  avoid performance degredation. See:
  #4133.
• stack upload signs the package by default, as documented. --no-signature
  turns the signing off.
  #3739
• In case there is a network connectivity issue while trying to
  download a template, stack will check whether that template had
  been downloaded before. In that case, the cached version will be
  used. See #3850.

Other enhancements:

• On Windows before Windows 10, --color=never is the default on terminals that
  can support ANSI color codes in output only by emulation
• On Windows, recognise a 'mintty' (false) terminal as a terminal, by default
• stack build issues a warning when base is explicitly listed in
  extra-deps of stack.yaml
• stack build suggests trying another GHC version should the build
  plan end up requiring unattainable base version.
• A new sub command run has been introduced to build and run a specified executable
  similar to cabal run. If no executable is provided as the first argument, it
  defaults to the first available executable in the project.
• stack build missing dependency suggestions (on failure to construct a valid
  build plan because of missing deps) are now printed with their latest
  cabal file revision hash. See
  #4068.
• Added new --tar-dir option to stack sdist, that allows to copy
  the resulting tarball to the specified directory.
• Introduced the --interleaved-output command line option and
  build.interleaved-output config value which causes multiple concurrent
  builds to dump to stderr at the same time with a packagename> prefix. See
  #3225.
• The default retry strategy has changed to exponential backoff.
  This should help with
  #3510.
• stack new now allows template names of the form username/foo to
  download from a user other than commercialstack on Github, and can be prefixed
  with the service github:, gitlab:, or bitbucket:. #4039
• Switch to githash to include some unmerged bugfixes in gitrev
  Suggestion to add 'allow-newer': true now shows path to user config
  file where this flag should be put into #3685
• stack ghci now asks which main target to load before doing the build,
  rather than after
• Bump to hpack 0.29.0
• With GHC 8.4 and later, Haddock is given the --quickjump flag.
• It is possible to specify the Hackage base URL to upload packages to, instead
  of the default of https://hackage.haskell.org/, by using hackage-base-url
  configuration option.
• When using Nix, if a specific minor version of GHC is not requested, the
  latest minor version in the given major branch will be used automatically.

Bug fixes:

• stack ghci now does not invalidate .o files on repeated runs,
  meaning any modules compiled with -fobject-code will be cached
  between ghci runs. See
  #4038.
• ~/.stack/config.yaml and stack.yaml terminating by newline
• The previous released caused a regression where some stderr from the
  ghc-pkg command showed up in the terminal. This output is now silenced.
• A regression in recompilation checking introduced in v1.7.1 has been fixed.
  See #4001
• stack ghci on a package with internal libraries was erroneously looking
  for a wrong package corresponding to the internal library and failing to
  load any module. This has been fixed now and changes to the code in the
  library and the sublibrary are properly tracked. See
  #3926.
• For packages with internal libraries not depended upon, stack build used
  to fail the build process since the internal library was not built but it
  was tried to be registered. This is now fixed by always building internal
  libraries. See
  #3996.
• --no-nix was not respected under NixOS
• Fix a regression which might use a lot of RAM. See
  #4027.
• Order of commandline arguments does not matter anymore.
  See #3959
• When prompting users about saving their Hackage credentials on upload,
  flush to stdout before waiting for the response so the prompt actually
  displays. Also fixes a similar issue with ghci target selection prompt.
• If cabal is not on PATH, running stack solver now prompts the user
  to run stack install cabal-install
• stack build now succeeds in building packages which contain sublibraries
  which are dependencies of executables, tests or benchmarks but not of the
  main library. See
  #3787.
• Sublibraries are now properly considered for coverage reports when the test
  suite depends on the internal library. Before, stack was erroring when
  trying to generate the coverage report, see
  #4105.
• Sublibraries are now added to the precompiled cache and recovered from there
  when the snapshot gets updated. Previously, updating the snapshot when there
  was a package with a sublibrary in the snapshot resulted in broken builds.
  This is now fixed, see
  #4071.
• [#4114] Stack pretty prints error messages with proper error logging
  level instead of warning now. This also fixes self-executing scripts
  not piping plan construction errors from runhaskell to terminal (issue
  #3942).
• Fix invalid "While building Setup.hs" when Cabal calls fail. See:
  #3934
• stack upload signs the package by default, as documented. --no-signature
  turns the signing off.
  #3739

v1.7.1

See https://haskellstack.org for installation and upgrade instructions.

Changes since v1.6.5:

Release notes:

• aarch64 (64-bit ARM) bindists are now available for the first time.
• Statically linked Linux bindists are no longer available, due to difficulty with GHC 8.2.2 on Alpine Linux.
• 32-bit Linux GMP4 bindists for CentOS 6 are no longer available, since GHC 8.2.2 is no longer being built for that platform.

Major changes:

• Upgrade from Cabal 2.0 to Cabal 2.2

Behavior changes:

• stack setup no longer uses different GHC configure options on Linux
  distributions that use GCC with PIE enabled by default. GHC detects
  this itself since ghc-8.0.2, and Stack's attempted workaround for older
  versions caused more problems than it solved.
• stack new no longer initializes a project if the project template contains
  a stack.yaml file.

Other enhancements:

• A new sub command ls has been introduced to stack to view
  local and remote snapshots present in the system. Use stack ls snapshots --help to get more details about it.
• list-dependencies has been deprecated. The functionality has
  to accessed through the new ls dependencies interface. See
  #3669
  for details.
• Specify User-Agent HTTP request header on every HTTP request.
  See #3628 for details.
• stack setup looks for GHC bindists and installations by any OS key
  that is compatible (rather than only checking a single one). This is
  relevant on Linux where different distributions may have different
  combinations of libtinfo 5/6, ncurses 5/6, and gmp 4/5, and will allow
  simpifying the setup-info metadata YAML for future GHC releases.
• The build progress bar reports names of packages currently building.
• stack setup --verbose causes verbose output of GHC configure process.
  See #3716
• Improve the error message when an extra-dep from a path or git reference can't be found
  See #3808
• Nix integration is now disabled on windows even if explicitly enabled,
  since it isn't supported. See
  #3600
• stack build now supports a new flag --keep-tmp-files to retain intermediate
  files and directories for the purpose of debugging.
  It is best used with ghc's equivalent flag,
  i.e. stack build --keep-tmp-files --ghc-options=-keep-tmp-files.
  See #3857
• Improved error messages for snapshot parse exceptions
• stack unpack now supports a --to /target/directory option to
  specify where to unpack the package into
• stack hoogle now supports a new flag --server that launches local
  Hoogle server on port 8080. See
  #2310

Bug fixes:

• The script interpreter's implicit file arguments are now passed before other
  arguments. See #3658.
  In particular, this makes it possible to pass -- +RTS ... -RTS to specify
  RTS arguments used when running the script.
• Don't ignore the template year parameter in config files, and clarify the
  surrounding documentation. See
  #2275.
• Benchmarks used to be run concurrently with other benchmarks
  and build steps. This is non-ideal because CPU usage of other processes
  may interfere with benchmarks. It also prevented benchmark output from
  being displayed by default. This is now fixed. See
  #3663.
• stack ghci now allows loading multiple packages with the same
  module name, as long as they have the same filepath. See
  #3776.
• stack ghci no longer always adds a dependency on base. It is
  now only added when there are no local targets. This allows it to
  be to load code that uses replacements for base. See
  #3589
• stack ghci now uses correct paths for autogen files with
  #3791
• When a package contained sublibraries, stack was always recompiling the
  package. This has been fixed now, no recompilation is being done because of
  sublibraries. See #3899.
• The get-stack.sh install script now matches manual instructions
  when it comes to Debian/Fedora/CentOS install dependencies.
• Compile Cabal-simple with gmp when using Nix.
  See #2944
• stack ghci now replaces the stack process with ghci. This improves
  signal handling behavior. In particular, handling of Ctrl-C. To make
  this possible, the generated files are now left behind after exit.
  The paths are based on hashing file contents, and it's stored in the
  system temporary directory, so this shouldn't result in too much
  garbage. See
  #3821.

Thanks to all our contributors for this release:

• Alexey Kuleshevich
• Andrei Dziahel
• Andrew Cowie
• Daniel Bergey
• David Baynard
• Domen Kožar
• Don Waldhalm
• Emanuel Borsboom
• Geoffrey Noel
• Ivan Kasatenko
• Jan von Loewenstein
• Joshua Simmons
• Kirill Elagin
• Krishnan Parthasarathi
• Luke Murphy
• Matt Spaulding
• Matthias Braun
• Maximilian Tagher
• Michael Sloan
• Michael Snoyman
• Mihai Maruseac
• Mike Pilgrem
• Mitchell Rosen
• Nicolas Mattia
• Niklas Hambüchen
• Oleg Grenrus
• Reuben D'Netto
• Robert J. Macomber
• Sibi Prabakaran
• silky
• Simon Hengel
• Tero Laxström
• tswelsh
• Yuji Yamamoto

v1.7.0.3 (release candidate)

Second release candidate for v1.7

Changes since previous release candidate (v1.7.0.1)

Other enhancements:

• stack unpack now supports a --to /target/directory option to
  specify where to unpack the package into
• stack hoogle now supports a new flag --server that launches local
  Hoogle server on port 8080. See
  #2310

Bug fixes:

• When a package contained sublibraries, stack was always recompiling the
  package. This has been fixed now, no recompilation is being done because of
  sublibraries. See #3899.
• The get-stack.sh install script now matches manual instructions
  when it comes to Debian/Fedora/CentOS install dependencies.
• Compile Cabal-simple with gmp when using Nix.
  See #2944
• stack ghci now replaces the stack process with ghci. This improves
  signal handling behavior. In particular, handling of Ctrl-C. To make
  this possible, the generated files are now left behind after exit.
  The paths are based on hashing file contents, and it's stored in the
  system temporary directory, so this shouldn't result in too much
  garbage. See
  #3821.

v1.7.0.1 (release candidate)

First release candidate for v1.7.1

Release notes:

• aarch64 (64-bit ARM) bindists are now available for the first time.
• Statically linked Linux bindists are no longer available, due to difficulty with GHC 8.2.2 on Alpine Linux.
• 32-bit Linux GMP4 bindists for CentOS 6 are no longer available, since GHC 8.2.2 is no longer being built for that platform.

Major changes:

• Upgrade from Cabal 2.0 to Cabal 2.2

Behavior changes:

• stack setup no longer uses different GHC configure options on Linux
  distributions that use GCC with PIE enabled by default. GHC detects
  this itself since ghc-8.0.2, and Stack's attempted workaround for older
  versions caused more problems than it solved.

• stack new no longer initializes a project if the project template contains
  a stack.yaml file.

Other enhancements:

• A new sub command ls has been introduced to stack to view
  local and remote snapshots present in the system. Use stack ls snapshots --help to get more details about it.
• list-dependencies has been deprecated. The functionality has
  to accessed through the new ls dependencies interface. See
  #3669
  for details.
• Specify User-Agent HTTP request header on every HTTP request.
  See #3628 for details.
• stack setup looks for GHC bindists and installations by any OS key
  that is compatible (rather than only checking a single one). This is
  relevant on Linux where different distributions may have different
  combinations of libtinfo 5/6, ncurses 5/6, and gmp 4/5, and will allow
  simpifying the setup-info metadata YAML for future GHC releases.
• The build progress bar reports names of packages currently building.
• stack setup --verbose causes verbose output of GHC configure process.
  See #3716
• Improve the error message when an extra-dep from a path or git reference can't be found
  See #3808
• Nix integration is now disabled on windows even if explicitly enabled,
  since it isn't supported. See
  #3600
• stack build now supports a new flag --keep-tmp-files to retain intermediate
  files and directories for the purpose of debugging.
  It is best used with ghc's equivalent flag,
  i.e. stack build --keep-tmp-files --ghc-options=-keep-tmp-files.
  See #3857
• Improved error messages for snapshot parse exceptions

Bug fixes:

• The script interpreter's implicit file arguments are now passed before other
  arguments. See #3658.
  In particular, this makes it possible to pass -- +RTS ... -RTS to specify
  RTS arguments used when running the script.
• Don't ignore the template year parameter in config files, and clarify the
  surrounding documentation. See
  #2275.
• Benchmarks used to be run concurrently with other benchmarks
  and build steps. This is non-ideal because CPU usage of other processes
  may interfere with benchmarks. It also prevented benchmark output from
  being displayed by default. This is now fixed. See
  #3663.
• stack ghci now allows loading multiple packages with the same
  module name, as long as they have the same filepath. See
  #3776.
• stack ghci no longer always adds a dependency on base. It is
  now only added when there are no local targets. This allows it to
  be to load code that uses replacements for base. See
  #3589
• stack ghci now uses correct paths for autogen files with
  #3791