diff options
| author | Zubin Duggal <zubin.duggal@gmail.com> | 2021-11-19 14:21:58 +0530 |
|---|---|---|
| committer | Marge Bot <ben+marge-bot@smart-cactus.org> | 2022-04-06 13:02:04 -0400 |
| commit | babb47d263e0df0fa4e16da6bf86164a2a3e07ea (patch) | |
| tree | 63f9ea3a73ca093e10d14e8a368d6adfadc0f895 /docs/users_guide/using-warnings.rst | |
| parent | d2ae0a3a1a8e31e5d769f1aea95e85793043cb3a (diff) | |
| download | haskell-babb47d263e0df0fa4e16da6bf86164a2a3e07ea.tar.gz | |
Add warnings for file header pragmas that appear in the body of a module (#20385)
Once we are done parsing the header of a module to obtain the options, we
look through the rest of the tokens in order to determine if they contain any
misplaced file header pragmas that would usually be ignored, potentially
resulting in bad error messages.
The warnings are reported immediately so that later errors don't shadow
over potentially helpful warnings.
Metric Increase:
T13719
Diffstat (limited to 'docs/users_guide/using-warnings.rst')
| -rw-r--r-- | docs/users_guide/using-warnings.rst | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/users_guide/using-warnings.rst b/docs/users_guide/using-warnings.rst index 13c04f7d98..60598eb623 100644 --- a/docs/users_guide/using-warnings.rst +++ b/docs/users_guide/using-warnings.rst @@ -456,6 +456,20 @@ of ``-W(no-)*``. recognises pragmas known to be used by other tools, e.g. ``OPTIONS_HUGS`` and ``DERIVE``. +.. ghc-flag:: -Wmisplaced-pragmas + :shortdesc: warn about uses of file header pragmas in the module body + :type: dynamic + :reverse: -Wno-misplaced-pragmas + :category: + + :since: 9.4 + + :default: on + + Warn when a pragma that should only appear in the header of a module, + such as a `LANGUAGE` or `OPTIONS_GHC` pragma, appears in the body of + the module instead. + .. ghc-flag:: -Wmissed-specialisations :shortdesc: warn when specialisation of an imported, overloaded function fails. |