summaryrefslogtreecommitdiff
path: root/docs/users_guide
diff options
context:
space:
mode:
authorAndreas Abel <andreas.abel@ifi.lmu.de>2022-01-27 15:14:11 +0100
committerMatthew Pickering <matthewtpickering@gmail.com>2022-02-10 13:55:37 +0000
commit4a7de7df450df18a8495f8ff6f20827e7725d5ae (patch)
tree561f2216031234c8c72eddf30167a1cce59537a9 /docs/users_guide
parentc7c890dc2384d255e80f849a5fdad9653ebc0bf4 (diff)
downloadhaskell-4a7de7df450df18a8495f8ff6f20827e7725d5ae.tar.gz
Re #18087 user's guide: add a note that -Wxxx used to be -fwarn-xxx
The warning option syntax -W was introduced in GHC 8. The note should clarify what e.g. "since 7.6" means in connection with "-Wxxx": That "-fwarn-xxx" was introduced in 7.6.1. [ci skip] (cherry picked from commit f75411e84d09998f80a3a37869b2eff28864349a)
Diffstat (limited to 'docs/users_guide')
-rw-r--r--docs/users_guide/using-warnings.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/users_guide/using-warnings.rst b/docs/users_guide/using-warnings.rst
index 4f8879bcdf..7d686d3ac2 100644
--- a/docs/users_guide/using-warnings.rst
+++ b/docs/users_guide/using-warnings.rst
@@ -14,6 +14,13 @@ of warnings.
To turn off an individual warning ``-W<wflag>``, use ``-Wno-<wflag>``.
To reverse ``-Werror``, which makes all warnings into errors, use ``-Wwarn``.
+.. note::
+ In GHC < 8 the syntax for ``-W<wflag>`` was ``-fwarn-<wflag>``
+ (e.g. ``-fwarn-incomplete-patterns``).
+ This spelling is deprecated, but still accepted for backwards compatibility.
+ Likewise, ``-Wno-<wflag>`` used to be ``fno-warn-<wflag>``
+ (e.g. ``-fno-warn-incomplete-patterns``).
+
.. ghc-flag:: -Wdefault
:shortdesc: enable default flags