diff options
| author | Ben Gamari <ben@smart-cactus.org> | 2021-04-15 13:26:54 -0400 |
|---|---|---|
| committer | Ben Gamari <ben@smart-cactus.org> | 2021-05-12 20:27:10 -0400 |
| commit | d53e28155879516847f44722150ca2b099c2bef9 (patch) | |
| tree | 18b9fb44a70f0beedd64dbd025a10968e6d95863 /docs/users_guide | |
| parent | 0f6e91c6e7d8b78a6c31b7ac646632d329e50f6a (diff) | |
| download | haskell-d53e28155879516847f44722150ca2b099c2bef9.tar.gz | |
users-guide: Clarify GHC2021 documentation
Point out that GHC2021 doesn't offer the same degree of stability that
Haskell2010 does, as noted by @phadej.
(cherry picked from commit 78288b97f3486d79581343a40732804d96b3b57c)
Diffstat (limited to 'docs/users_guide')
| -rw-r--r-- | docs/users_guide/exts/control.rst | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/docs/users_guide/exts/control.rst b/docs/users_guide/exts/control.rst index bbb0db80f8..84c2aa1208 100644 --- a/docs/users_guide/exts/control.rst +++ b/docs/users_guide/exts/control.rst @@ -18,7 +18,7 @@ Language extensions can be controlled (i.e. allowed or not) in two ways: ``{-# LANGUAGE TemplateHaskell #-}`` (see :ref:`language-pragma`). .. extension:: GHC2021 - :shortdesc: Use GHC’s set of default extensions from 2021 + :shortdesc: Use GHC’s set of default language extensions from 2021 GHC blesses a number of extensions, beyond Haskell 2010, to be suitable to turned on by default. These extensions are considered to be stable and @@ -29,6 +29,12 @@ Language extensions can be controlled (i.e. allowed or not) in two ways: ``GHC20xx`` by default, users are advised to declare the language set explicitly with ``-XGHC2021``. + Note that, because GHC2021 includes a number of non-standardized + extensions, the stability guarantees it provides are not quite as strong as + those provided by, e.g., :extension:`Haskell2010`. While GHC does take + pains to avoid changing the semantics of these extensions, changes may + still happen (e.g. the simplified subsumption change introduced in GHC 9.0 + which caused GHC to reject some programs using :extension:`RankNTypes`). The ``GHC2021`` language set comprises the following extensions: |