See https://haskellstack.org for installation and upgrade instructions.
Note: we are releasing a bit earlier than planned due to #3624. As such, not all the binaries have been built yet, but the commonly used 64-bit binaries of Linux static, macOS, and Windows are available.
In addition, the Windows installer and binary has not been codesigned (we are awaiting validation of a new codesign certificate), and you may see a “Windows Defender SmartScreen prevented an unrecognized app from starting” warning when you try to run them. If so, click on More info, and then click on the Run anyway button that appears.
extra-depsfields, and a number of related items. For full details, please see the writeup on these changes. PR #3249, see the PR description for a number of related issues.
--install-ghcflag is now on by default. For example, if you run
stack buildin a directory requiring a GHC that you do not currently have, Stack will automatically download and install that GHC. You can explicitly set
install-ghc: falseor pass the flag
--no-install-ghcto regain the previous behavior.
stack ghcino longer loads modules grouped by package. This is always an improvement for plain ghci - it makes loading faster and less noisy. For intero, this has the side-effect that it will no longer load multiple packages that depend on TH loading relative paths. TH relative paths will still work when loading a single package into intero. See #3309
stack.yamlwill promote it to a local package, providing for more consistency with flags and better reproducibility. See: #849
package-indicessetting with Hackage no longer works with the
00-index.tar.gztarball, but must use the
01-index.tar.gzfile to allow revised packages to be found.
--ghci-optionsare now passed to the end of the invocation of ghci, instead of the middle. This allows using
+RTSwithout an accompanying
tinfo6is now preferred over
standardif both versions of libtinfo are installed
stack build --copy-compiler-tool, to allow tools like intero to be installed globally for a particular compiler. #2643
save-hackage-credssetting. Please see #2159.
GHCRTSenvironment variable will no longer be passed through to every program stack runs. Instead, it will only be passed through commands like
ghci, etc. See #3444.
ghc-options:for specific packages will now come after the options specified for all packages / particular sets of packages. See #3573.
pvp-boundsfeature is no longer fully functional, due to some issues with the Cabal library's printer. See #3550.
with-hpackconfiguration option specifies an Hpack executable to use instead of the Hpack bundled with Stack. Please see #3179.
StaticSHA256and is implemented using the
StaticSize 64 ByteStringfor improved performance. See #3006
stack upgradefrom a file which is different from the default executable path (e.g., on POSIX systems,
~/.local/bin/stack), it will now additionally copy the new executable over the currently running
stackexecutable. If permission is denied (such as in
/usr/local/bin/stack), the user will be prompted to try again using
sudo. This is intended to assist with the user experience when the
PATHenvironment variable has not been properly configured, see #3232.
stack setupfor ghcjs will now install
happyif they are not present. See #3109.
stack ghci --only-mainflag, to skip loading / importing all but main modules. See the ghci documentation page for further info.
stack ghci, but this override's GHC's heuristics when they're broken by our collecting and processing GHC's output.
ghc-optionsfield to support
$everything. See: #3329
stack ghcifile targets are combined with invalid package targets. See: #3342
-fprof-auto -fprof-cafsinstead of the deprecated
-auto-all -caf-all. See: #3360
stack upgrade --help. See: #3070
--cwd DIRcan now be passed to
stack execin order to execute the program in a different directory. See: #3264
stack scriptto pass options directly to GHC. See: #3454
package.yamlto build Stack itself
ignore-revision-mismatchsetting. See: #3520.
--file-watchby not watching files for executable, test and benchmark components that aren't a target. See: #3483.
--terminal-widthcommand-line option (this works even on non-POSIX).
stack ghciwill now cause them to be used as
-packageargs along with package hiding.
autoreconf -ias necessary when a
configurescript is missing. See #3534
stack hooglecorrectly generates Hoogle databases. See: #3362
stack --docker-helpis now clearer about –docker implying system-ghc: true, rather than both –docker and –no-docker.
stack haddocknow includes package names for all modules in the Haddock index page. See: #2886
-doption. See #3366.
stack scriptcan now handle relative paths to source files. See #3372.
stack --dockerin parallel now correctly locks the sqlite database. See #3400.
stack cleannow works with nix. See #3468.
stack build --only-dependenciesno longer builds local project packages that are depended on. See #3476.
--pvp-boundsis enabled for sdist or upload, internal dependencies could cause errors when uploaded to hackage. This is fixed, see #3290
stack setup --upgrade-cabalwould say that Cabal is already the latest version, when it wasn't.
extra-depfrom a local directory is not treated as a
$localsfor GHC options purposes. See #3574.
Thanks to all our contributors for this release: