See https://haskellstack.org/ for installation and upgrade instructions.
Changes since v2.9.3:
- Add flag
upgradecommand for a binary upgrade. If the Stack executable is
my-stack, the default is
my-stack upgrade --only-local-binwhere previously it was, effectively,
my-stack upgrade --no-only-local-bin. If the Stack executable is
stack, the default is
stack upgrade --no-only-local-bin, the same behaviour as previously.
$XDG_CACHE_HOME/stack/ghci-script, rather than
<temp>is the directory yielded by the
System.IO.Temp.getCanonicalTemporaryDirectory), as the base location for GHCi script files generated by
stack repl. See #5203
- Drop support for
Cabalversions before 1.22 and, consequently, GHC versions before 7.10.
stack replnow take into account the values of
default-languagekeys in Cabal files, like they take into account the values of
stack path, deprecated in Stack 1.1.0 in favour of
- On Windows,
stack upgradealways renames the file of the running Stack executable (adding extension
.old) before attempting to write to the original file name.
- On Windows,
stack upgradedoes not offer
sudocommand alternatives if attempting to write to the original file name of the running Stack exectuable results in a ‘Permission’ error.
- Add options of the form
stack build, where
PROGis a program recognised by the Cabal library and one of
tar. If Cabal uses the program during the configuration step, the argument is passed to it.
- By default all
--PROG-optionoptions are applied to all local packages. This behaviour can be changed with new configuration option
- Add flag
stack script(default disabled). Used with
--optimize, when enabled all compilation outputs (including the executable) are written to a script-specific location in the
scriptsdirectory of the Stack root rather than the script’s directory, avoiding clutter of the latter directory.
- Better error message if the value of the
STACK_WORKenvironment variable or
--work-diroption is not a valid relative path.
- Stack will use the value of the
GITHUB_TOKEN, environment variable as credentials to authenticate its GitHub REST API requests.
stack uninstallalso shows how to uninstall Stack-supplied tools.
- Fix incorrect warning if
allow-newer-depsare specified but
false. See #6068.
--file-watch-polloutputs ‘pretty’ error messages, as intended. See #5978.
stack buildunregisters any local packages for the sub libraries of a local package that is to be unregistered. See #6046.
- The warning that sublibrary dependency is not supported is no longer triggered by internal libraries.
Thanks to all our contributors for this release:
- Chris Wendt
- Illia Bobyr
- Jens Petersen
- Max Taldykin
- Mike Pilgrem
- Phil de Joux