diff options
| author | Michael Walker <mike@barrucadu.co.uk> | 2016-02-25 17:34:07 +0100 |
|---|---|---|
| committer | Ben Gamari <ben@smart-cactus.org> | 2016-02-25 17:44:33 +0100 |
| commit | 736c2fe705f083fe42bd5fe9318f0636b6b2fca6 (patch) | |
| tree | d55e5e571c21850cbabec1c9f8387d56033b0edc /docs/users_guide/using-warnings.rst | |
| parent | e38c07bf5ceb8f50fa5110b70b3b83f0ce1358ba (diff) | |
| download | haskell-wip/warning-origins.tar.gz | |
Print which warning-flag controls an emitted warning.wip/warning-origins
Both gcc and clang tell which warning flag a reported warning can be
controlled with, this patch makes ghc do the same. More generally, this
allows for annotated compiler output, where an optional annotation is
displayed in brackets after the severity.
Display which group enables a warning.
Add flag to show which group a warning belongs to
``-f(no-)show-warning-groups``, used to show/hide the group an emitted
warning belongs to. On by default.
Fix compilation error in ghc-api test
Reviewers: goldfire, hvr, quchen, austin, bgamari
Reviewed By: quchen, bgamari
Subscribers: goldfire, thomie
Differential Revision: https://phabricator.haskell.org/D1943
GHC Trac Issues: #10752
Diffstat (limited to 'docs/users_guide/using-warnings.rst')
| -rw-r--r-- | docs/users_guide/using-warnings.rst | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/users_guide/using-warnings.rst b/docs/users_guide/using-warnings.rst index 24f8039451..3f24f6a6dc 100644 --- a/docs/users_guide/using-warnings.rst +++ b/docs/users_guide/using-warnings.rst @@ -102,6 +102,15 @@ The following flags are simple ways to select standard "packages" of warnings: Warnings are treated only as warnings, not as errors. This is the default, but can be useful to negate a :ghc-flag:`-Werror` flag. +When a warning is emitted, the specific warning flag which controls +it, as well as the group it belongs to, are shown. + +.. ghc-flag:: -fshow-warning-groups + + Name the group a warning flag belongs to. + + This is enabled by default. Disable with ``-fno-show-warning-groups``. + The full set of warning options is described below. To turn off any warning, simply give the corresponding ``-Wno-...`` option on the command line. For backwards compatibility with GHC versions prior to 8.0, |