Changes since v2.7.5:

Behavior changes:

• stack build --coverage will generate a unified coverage report, even if
  there is only one *.tix file, in case a package has tested the library of
  another package that has not tested its own library. See
  #5713
• stack --verbose no longer includes the lengthy raw snapshot layer (rsl) in
  the debug output by default. The new stack --[no-]rsl-in-log flag enables or
  disables the inclusion of the rsl in the debug output.

Other enhancements:

• Bump to Hpack 0.35.0.
• On Windows, the installer now sets DisplayVersion in the registry, enabling
  tools like winget to properly read the version number.
• Adds flag --script-no-run-compile (disabled by default) that uses the
  --no-run option with stack script (and forces the --compile option).
  This enables a command like stack --script-no-run-compile Script.hs to
  behave like stack script --no-run --compile -- Script.hs but
  without having to list all the in the Stack interpreter options
  comment in Script.hs on the command line. That may help test that scripts
  compile in CI (continuous integration). See
  #5755
• Fuller help is provided at the command line if a subcommand is missing (for
  example, stack ls now yields the equivalent of stack ls --help). See
  #809
• Add build option --cabal-verbosity=VERBOSITY to specify the Cabal verbosity
  level (the option accepts Cabal's numerical and extended syntax).
  See #1369
• Add the possibility of a sh script to customise fully GHC installation. See
  #5585
• tools subcommand added to stack ls, to list stack's installed tools.
• stack uninstall shows how to uninstall Stack.
• --ghc-variant accepts int-native as a variant.

Bug fixes:

• Fix stack clean --full, so that the files to be deleted are not in use. See
  #5714
• Fix an inconsistency in the pretty formatting of the output of
  stack build --coverage
• Fix repeated warning about missing parameters when using stack new
• Include pantry-0.5.6: Remove operational and mirror keys from bootstrap key
  set #53
• Pass any CPP options specified via cpp-options: in the Cabal file to GHCi
  using GHC's -optP flag. See
  #5608
• On Unix-like operating systems, respect the with-gcc option when installing
  GHC. See #5609
• Fixed logic in get_isa() in get-stack.sh to exclude systems that don't
  have x86 in their uname -m output. See
  5792.
• Fixed output of stack ls snapshots local on Windows, to behave like that on
  Unix-like operating systems.
• Fix non-deterministic test failures when executing a test suite for a
  multi-project repository with parallelism enabled. See
  #5024

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

Changes since v2.7.3:

Behavior changes:

• Cloning git repositories isn't per sub-directory anymore, see
  #5411

Other enhancements:

• stack setup supports installing GHC for macOS aarch64 (M1)

• stack upload supports authentication with a Hackage API key (via
  HACKAGE_KEY environment variable).

Bug fixes:

• Ensure that extra-path works for case-insensitive PATHs on Windows.
  See rio#237
• Fix handling of overwritten ghc and ghc-pkg locations.
  #5597
• Fix failure to find package when a dependency is shared between projects.
  #5680
• stack ghci now uses package flags in stack.yaml
  #5434

Thanks to all our contributors for this release:

• Emanuel Borsboom
• HaskellMouse
• Julian Ospald
• kocielnik
• Matt Audesse
• Michael Snoyman
• MikaelUrankar
• Muhammed Zakir
• Natan Lao
• Patryk Kocielnik
• tkaaad97

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

Changes since v2.7.1:

Other enhancements:

• stack upgrade will download from haskellstack.org before trying
  github.com. See
  #5288
• stack upgrade makes less assumptions about archive format. See
  #5288
• Add a --no-run flag to the script command when compiling.

Bug fixes:

• GHC source builds work properly for recent GHC versions again. See
  #5528
• stack setup always looks for the unpacked directory name to support
  different tar file naming conventions. See
  #5545
• Bump pantry version for better OS support. See
  pantry#33
• When building the sanity check for a new GHC install, make sure to clear
  GHC_PACKAGE_PATH.
• Specifying GHC RTS flags in the stack.yaml no longer fails with an error.
  #5568
• stack setup will look in sandboxed directories for executables, not
  relying on `findExecutables. See
  GHC issue 20074
• Track changes to setup-config properly to avoid reconfiguring on every
  change. See #5578

Thanks to all our contributors for this release:

• Andreas Källberg
• Artur Gajowy
• Felix Yan
• fwcd
• Ketzacoatl
• Matt Audesse
• Michael Snoyman
• milesfrain
• parsonsmatt
• skforg

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

Changes since v2.5.1.1:

Behavior changes:

• stack repl now always warns about GHCi problems with loading multiple
  packages. It also sets now proper working directory when invoked with
  one package. See
  #5421

• custom-setup dependencies are now properly initialized for stack dist.
  This makes explicit-setup-deps no longer required and that option was
  removed. See
  #4006

Other enhancements:

• Nix integration now passes ghcVersion (in addition to existing ghc) to
  shell-file as an identifier that can be looked up in a compiler attribute set.

• Nix integration now allows Nix integration if the user is ready in nix-shell.
  This gets rid of "In Nix shell but reExecL is False" error.

• stack list is a new command to list package versions in a snapshot.
  See #5431

• Consider GHC 9.0 a tested compiler and remove warnings.

• custom-preprocessor-extensions is a new configuration option for allowing
  stack to be aware of any custom preprocessors you have added to Setup.hs.
  See #3491

• Added --candidate flag to upload command to upload a package candidate
  rather than publishing the package.

• Error output using --no-interleaved-output no longer prepends indentating
  whitespace. This allows emacs compilation-mode and vim quickfix to locate
  and track errors. See
  #5523

Bug fixes:

• stack new now suppports branches other than master as default for
  GitHub repositories. See
  #5422

• Ignore all errors from hi-file-parser. See
  #5445 and
  #5486.

• Support basic auth in package-indices. See
  #5509.

• Add support for parsing .hi. files from GHC 8.10 and 9.0. See
  hi-file-parser#2.

Thanks to all our contributors for this release:

• Aaron Allen
• Alexey Kuleshevich
• Andreas Källberg
• Domen Kožar
• Emanuel Borsboom
• Felix Yan
• Jens Petersen
• Kirill Zaborsky
• Marcin Tolysz
• Matt Audesse
• Matthew Wraith
• Michael Snoyman
• Mike Pilgrem
• Simon Michael

Release notes:

• Stack's bindists are now built with GHC 8.10.4, and our stack.yaml has
  moved to lts-17.10. This means Stack can now be built on macOS 11.0 (Big
  Sur) without ugly workarounds. GHC 8.8 is now the minimum GHC version
  supported for building Stack itself (but this does not effect users of
  Stack, which still supports using much older GHC versions).

Changes since v2.7.0.1:

(no changes)

Changes since v2.5.1.1:

Behavior changes:

• stack repl now always warns about GHCi problems with loading multiple
  packages. It also sets now proper working directory when invoked with
  one package. See
  #5421

• custom-setup dependencies are now properly initialized for stack dist.
  This makes explicit-setup-deps no longer required and that option was
  removed. See
  #4006

Other enhancements:

• Nix integration now passes ghcVersion (in addition to existing ghc) to
  shell-file as an identifier that can be looked up in a compiler attribute set.

• Nix integration now allows Nix integration if the user is ready in nix-shell.
  This gets rid of "In Nix shell but reExecL is False" error.

• stack list is a new command to list package versions in a snapshot.
  See #5431

• Consider GHC 9.0 a tested compiler and remove warnings.

• custom-preprocessor-extensions is a new configuration option for allowing
  stack to be aware of any custom preprocessors you have added to Setup.hs.
  See #3491

• Added --candidate flag to upload command to upload a package candidate
  rather than publishing the package.

• Error output using --no-interleaved-output no longer prepends indentating
  whitespace. This allows emacs compilation-mode and vim quickfix to locate
  and track errors. See
  #5523

Bug fixes:

• stack new now suppports branches other than master as default for
  GitHub repositories. See
  #5422

• Ignore all errors from hi-file-parser. See
  #5445 and
  #5486.

• Support basic auth in package-indices. See
  #5509.

• Add support for parsing .hi. files from GHC 8.10 and 9.0. See
  hi-file-parser#2.

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

Changes since v2.3.3

Major changes:

• Add the snapshot-location-base yaml configuration option, which allows to
  override the default location of snapshot configuration files. This option
  affects how snapshot synonyms (LTS/Nightly) are expanded to URLs by the
  pantry library.
• docker-network configuration key added to override docker --net arg

Behavior changes:

• File watching now takes into account specified targets, old behavior could
  be restored using the new flag --watch-all
  #5310

Other enhancements:

• stack ls dependencies json now includes fields sha256 and size for
  dependencies of type archive in location.
  #5280
• Build failures now show a hint to scroll up to the corresponding section
  #5279
• Customisable output styles (see stack --help and the --stack-colors
  option, and stack ls stack-colors --help) now include info, debug,
  other-level, secondary and highlight, used with verbose output.

Bug fixes:

• Fix stack test --coverage when using Cabal 3
• stack new now generates PascalCase'd module name correctly.
  #5376
• Connection issues to Casa server no longer cause builds to failure. Casa acts
  only as an optimizing cache layer, not a critical piece of infrastructure.
• Fix modified time busting caches by always calculating sha256 digest during
  the build process.
  #5125

Thanks to all our contributors for this release:

• Andrea Condoluci
• Andreas Herrmann
• Andres Schmois
• Ariel D. Moya Sequeira
• Brandon Chinn
• Cheah Jer Fei
• DerpyCrabs
• Emanuel Borsboom
• Felix Yan
• Jannik Theiß
• Jens Petersen
• Junji Hashimoto
• Kirill Zaborsky
• Michael Snoyman
• Mihai Maruseac
• Mike Pilgrem
• Niklas Hambüchen
• Ondřej Slámečka
• Piper McCorkle
• Thomas Lopatic
• tomjaguarpaw

Changes since v2.3.3

Major changes:

• Add the snapshot-location-base yaml configuration option, which allows to
  override the default location of snapshot configuration files. This option
  affects how snapshot synonyms (LTS/Nightly) are expanded to URLs by the
  pantry library.
• docker-network configuration key added to overwrite docker --net arg

Behavior changes:

• File watching now takes into account specified targets, old behavior could
  be restored using the new flag --watch-all
  #5310

Other enhancements:

• stack ls dependencies json now includes fields sha256 and size for
  dependencies of type archive in location.
  #5280
• Build failures now show a hint to scroll up to the corresponding section
  #5279
• Customisable output styles (see stack --help and the --stack-colors
  option, and stack ls stack-colors --help) now include info, debug,
  other-level, secondary and highlight, used with verbose output.

Bug fixes:

• Fix stack test --coverage when using Cabal 3
• stack new now generates PascalCase'd module name correctly.
  #5376
• Connection issues to Casa server no longer cause builds to failure. Casa acts
  only as an optimizing cache layer, not a critical piece of infrastructure.
• Fix modified time busting caches by always calculating sha256 digest during
  the build process.
  #5125

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

Changes since v2.3.1

Other enhancements:

• Add the stack-developer-mode flag

Bug fixes:

• When using the STACK_YAML env var with Docker, make the path absolute.
• Fix the problem of stack repl foo:test:bar failing without a project
  build before that. See
  #5213
• Fix stack sdist introducing unneded sublibrary syntax when using
  pvp-bounds. See
  #5289

Thanks to all our contributors for this release:

• coord.e
• Dmitry Dzhus
• Emanuel Borsboom
• Kirill Zaborsky
• Michael Snoyman

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

Release notes:

• We have reduced the number of platforms that we support with binary releases.
  The reason behind this is that we've been slowed down in our release process
  until now with issues trying to build binaries for less common platforms. In
  order to make sure we can address issues more quickly (like supporting new
  GHC versions), we're limiting support from the Stack team to:

  • Linux 64-bit (static)
  • macOS
  • Windows 64-bit

  If others want to provide additional binaries, we will definitely be happy
  for the support. But since our CI system is currently able to produce these
  three bindists only, that's what we will be providing with the next release.

• Since we no longer have dynamically linked Linux binaries, we are removing
  removing the -static suffix from the static Linux binaries. If you have
  scripts to download the latest stable Linux binary, update them to use
  linux-x86_64 instead of linux-x86_64-static (if you are already using the
  former, nothing needs to change). For this release, both are supported, but
  the next release will no longer have the -static variant.

• We are also deprecating the download links at https://stackage.org/stack.
  See this page for the current installation instructions:
  https://docs.haskellstack.org/en/stable/install_and_upgrade/.

• These are the canonical locations to download the latest stable binaries
  from, and will continue to be supported going forward:

  • Linux 64-bit (static): https://get.haskellstack.org/stable/linux-x86_64.tar.gz
  • macOS: https://get.haskellstack.org/stable/osx-x86_64.tar.gz
  • Windows 64-bit: https://get.haskellstack.org/stable/windows-x86_64.zip

  As always, binaries for specific versions are available from the Github
  releases: https://github.com/commercialhaskell/stack/releases.

Changes since v2.1.3.1

Major changes:

• setup-info-locations yaml configuration now allows overwriting the default locations of stack-setup-2.yaml.
  #5031
  #2983
  #2913

• The setup-info configuration key now allows overwriting parts of the default setup-info

• The --setup-info-yaml command line flag now may be used in all stack commands such as stack build, and not only in stack setup

• The --setup-info-yaml may specify multiple locations for stack-setup.yaml files.

• The stack upload can read first reads environment Variable $HACKAGE_USERNAME and $HACKAGE_PASSWORD if they are missing only then asks for username or password

• Fully remove GHCJS support.

• Remove the freeze command. It has been replaced by lock files.

Behavior changes:

• Remove the deprecated --stack-setup-yaml command line argument in favor of --setup-info-yaml
  #2647

• We now recommend checking in generated cabal files for repos. When generating lock files for
  extra-deps that only include package.yaml files, a deprecation warning will be generated.
  Also, those packages will no longer be included in the generated lock files.
  See #5210.

Other enhancements:

• Add build-output-timestamps flag in yaml. Setting it to true
  prefixes each build log output line with a timestamp.

• Show warning about local-programs-path with spaces on windows
  when running scripts. See
  #5013

• Add ls dependencies json which will print dependencies as JSON.
  ls dependencies --tree is now ls dependencies tree. See
  #4424

• Remove warning for using Stack with GHC 8.8-8.10, and Cabal 3.0-3.2.

• Allow relative paths in --setup-info-yaml and tool paths
  #3394

• Added the --only-locals flag. See
  #5272

Bug fixes:

• Upgrade pantry: module mapping insertions into the database are now atomic.
  Previously, if you SIGTERMed at the wrong time while running a script, you
  could end up with an inconsistent database state.

• --resolver global doesn't retrieve snapshots list from the internet
  beause doesn't need it. See #5103

• Fix using relative links in haddocks output. See
  #4971.

• Do not include generated cabal file information in lock files. See
  #5045.

• Use proper Hoogle executable path when installed automatically. See
  #4905

• Fix GHC version for batched package unregistration. See
  #4951

• Use Hoogle from the snapshot used and not the latest version. See
  #4905

• Resolve "'stty' is not recognized". See
  #4901

• Fix missing reconfigure check causing errors when a package gets
  used in multiple projects. See
  #5147

Thanks to all our contributors for this release:

• Adam McCullough
• Akshay Mankar
• Brian Wignall
• Cheah Jer Fei
• Chris Done
• David Baynard
• davit nalchevanidze
• Dino Morelli
• Emanuel Borsboom
• Felix Yan
• flip111
• Flowers Safety
• Fred Miller
• Fyrbll
• gdziadkiewicz
• Good boy
• Hypnoes.Liu
• Iisus
• Iustin Pop
• ivanbakel
• Javier Neira
• Jeff Happily
• jeffhappily
• jneira
• Justin Le
• Kirill Zaborsky
• Leif Metcalf
• Leonhard Markert
• Lokesh Mohanty
• Matt Audesse
• Michael Snoyman
• Mihai Maruseac
• NightRa
• Phil Ruffwind
• qinzhenlong
• Robert Hensing
• Sasha Bogicevic
• Sibi
• Sibi Prabakaran
• Simon Michael
• Steve Mao
• Vlad Ki
• Xia Li-yao