release-notes/Cabal-3.10.2.0.md

   1 Cabal and Cabal-syntax 3.10.2.0 changelog and release notes
   2 ---
   3
   4 ## Release 3.10.2.0 is strictly a bug-fix release, with the fixes listed below
   5
   6 - Shorten script-builds paths [#8841](https://github.com/haskell/cabal/issues/8841) [#8898](https://github.com/haskell/cabal/pull/8898)
   7
   8   - Use Base64 hash truncated to 26 chars for script-build cache directories.
   9   - Use the cache directory as the dist directory.
  10   - Use script-<your-sanitized-script-name> as the component name instead of cabal-script-<...>.
  11   - Use cabal-script-<your-actual-script-name> for the executable name.
  12   - This change is incompatible with previous cabal versions in terms of cache location,
  13     you should manually remove your old caches once you no longer need them.
  14
  15 - Do not always pass --quickjump to haddock #9049 [#9060](https://github.com/haskell/cabal/issues/9060) [#9049](https://github.com/haskell/cabal/pull/9049)
  16
  17   6d8adf13101 caused `cabal` to always pass the `--quickjump` flag to Haddock.
  18   Not only does this waste memory for a service that user hasn't asked for,
  19   but also leads to a failure with Haddocks shipped with GHC 9.0 and 9.2,
  20   which had a separate bug (fixed in later versions but not backported) when
  21   Haddock does not pass `--quickjump` recursively to the package dependencies.
  22
  23 - Regenerate Lexer.hs to avoid out-of-bound array access due to a bug in Alex [#8892](https://github.com/haskell/cabal/issues/8892) [#8896](https://github.com/haskell/cabal/pull/8896)
  24
  25   - Regenerate Cabal-syntax's Lexer.hs with Alex 3.2.7.3 which includes a fix for
  26     an out-of-bound array access (only noticeable with GHC's JavaScript backend).