[Git][ghc/ghc][master] Document -Wderiving-typeable

[Marge Bot]

 Marge Bot pushed to branch master at Glasgow Haskell Compiler / GHC


Commits:
d360f343 by MaxGabriel at 2020-10-09T08:43:11-04:00
Document -Wderiving-typeable

Tracking: #18641

- - - - -


2 changed files:

- docs/users_guide/expected-undocumented-flags.txt
- docs/users_guide/using-warnings.rst


Changes:

=====================================
docs/users_guide/expected-undocumented-flags.txt
=====================================
@@ -4,7 +4,6 @@
 --show-packages
 -Onot
 -Walternative-layout-rule-transitional
--Wderiving-typeable
 -XAlternativeLayoutRule
 -XAlternativeLayoutRuleTransitional
 -XAutoDeriveTypeable


=====================================
docs/users_guide/using-warnings.rst
=====================================
@@ -1881,6 +1881,20 @@ of ``-W(no-)*``.
 
     Does nothing.
 
+.. ghc-flag:: -Wderiving-typeable
+    :shortdesc: warn when Typeable is derived
+    :type: dynamic
+    :reverse: -Wno-deriving-typeable
+    :category:
+
+    :since: 7.10
+
+    This flag warns when ``Typeable`` is listed in a deriving clause
+    or derived with :extension:`StandaloneDeriving`.
+
+    Since GHC 7.10, ``Typeable`` is automatically derived for all types.
+    Thus, deriving ``Typeable`` yourself is redundant.
+
 If you're feeling really paranoid, the :ghc-flag:`-dcore-lint` option is a good choice.
 It turns on heavyweight intra-pass sanity-checking within GHC. (It checks GHC's
 sanity, not yours.)



View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/d360f3438da7f6eb51e217c6697db6fb338c6fd7

-- 
View it on GitLab: https://gitlab.haskell.org/ghc/ghc/-/commit/d360f3438da7f6eb51e217c6697db6fb338c6fd7
You're receiving this email because of your account on gitlab.haskell.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.haskell.org/pipermail/ghc-commits/attachments/20201009/a1a1d4c0/attachment.html>