From 8dca5dceefb9e3604ba9af5442bae27b630b38bb Mon Sep 17 00:00:00 2001 From: Phil de Joux Date: Fri, 9 Oct 2026 07:44:29 -0400 Subject: [PATCH] Add GHCJS deprecation notice --- release-notes/Cabal-3.18.2.0.md | 13 +++++++++++++ release-notes/cabal-install-3.18.2.0.md | 11 +++++++++++ 2 files changed, 24 insertions(+) diff --git a/release-notes/Cabal-3.18.2.0.md b/release-notes/Cabal-3.18.2.0.md index 858e8a6735a..3f79db14357 100644 --- a/release-notes/Cabal-3.18.2.0.md +++ b/release-notes/Cabal-3.18.2.0.md @@ -1,6 +1,19 @@ Cabal and Cabal-syntax 3.18.2.0 changelog and release notes --- +### Notice + +- GHCJS support is deprecated [#11609](https://github.com/haskell/cabal/issues/11609) [#12396](https://github.com/haskell/cabal/pull/12396) + + This is the last release series that knows about the GHCJS compiler. + The next major release removes the `Distribution.Simple.GHCJS` module, + the `--ghcjs` flag, the `ghcjs` and `ghcjs-pkg` programs and the GHCJS + build paths. The `ghcjs-options` family of fields in package + descriptions will still parse but have no effect. + + Use the JavaScript backend of GHC instead, for example + `--with-compiler=javascript-unknown-ghcjs-ghc`. + ### Significant changes - Mark `CabalSpecV3_18` as the latest supported specification [#12271](https://github.com/haskell/cabal/issues/12271) [#12273](https://github.com/haskell/cabal/pull/12273) diff --git a/release-notes/cabal-install-3.18.2.0.md b/release-notes/cabal-install-3.18.2.0.md index 61806a4eba8..2088e57ff4b 100644 --- a/release-notes/cabal-install-3.18.2.0.md +++ b/release-notes/cabal-install-3.18.2.0.md @@ -46,6 +46,17 @@ cabal-install 3.18.2.0 changelog and release notes flags: -pkg-config +bundled-c-zlib ``` +- GHCJS support is deprecated [#11609](https://github.com/haskell/cabal/issues/11609) [#12396](https://github.com/haskell/cabal/pull/12396) + + This is the last release series that knows about the GHCJS compiler. + The next major release removes the `--ghcjs` flag, the `ghcjs` and + `ghcjs-pkg` programs and the GHCJS build paths, and selecting + `compiler: ghcjs` will fail with an error. The `ghcjs-options` family + of fields in package descriptions will still parse but have no effect. + + Use the JavaScript backend of GHC instead, for example + `--with-compiler=javascript-unknown-ghcjs-ghc`. + ### Important changes - Fix `renameFileWithRetry` leaving temporary files after copying [#12244](https://github.com/haskell/cabal/issues/12244) [#12246](https://github.com/haskell/cabal/pull/12246)