summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Abel <andreas.abel@ifi.lmu.de>2022-01-27 15:14:11 +0100
committerMarge Bot <ben+marge-bot@smart-cactus.org>2022-01-27 18:34:54 -0500
commitf75411e84d09998f80a3a37869b2eff28864349a (patch)
tree5e8996d310bb41ffa61475240746daf2e7d4be8b
parent7a8547432505dbf080b0f7b57c5e660f50810cf1 (diff)
downloadhaskell-f75411e84d09998f80a3a37869b2eff28864349a.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]
-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 7f72b3eb20..3a2b4d5c84 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