diff options
| author | Ben Gamari <ben@smart-cactus.org> | 2016-01-23 19:17:45 +0100 |
|---|---|---|
| committer | Ben Gamari <ben@smart-cactus.org> | 2016-01-23 21:13:40 +0100 |
| commit | 6f96109b283dd5e4364062c5f71e0b11a9dfb9cd (patch) | |
| tree | 70a001eba20dabae9633d9e02051666b57f0559e | |
| parent | 1be8491b0c3b07be2ec91feb557502ca06d1e078 (diff) | |
| download | haskell-6f96109b283dd5e4364062c5f71e0b11a9dfb9cd.tar.gz | |
user-guide: Reformat warning lists
| -rw-r--r-- | docs/users_guide/using-warnings.rst | 43 |
1 files changed, 31 insertions, 12 deletions
diff --git a/docs/users_guide/using-warnings.rst b/docs/users_guide/using-warnings.rst index 0ba36aa409..07ddbb12d5 100644 --- a/docs/users_guide/using-warnings.rst +++ b/docs/users_guide/using-warnings.rst @@ -37,21 +37,34 @@ The following flags are simple ways to select standard "packages" of warnings: .. ghc-flag:: -W - Provides the standard warnings plus :ghc-flag:`-Wunused-binds`, - :ghc-flag:`-Wunused-matches`, :ghc-flag:`-Wunused-imports`, - :ghc-flag:`-Wincomplete-patterns`, :ghc-flag:`-Wdodgy-exports`, and - :ghc-flag:`-Wdodgy-imports`. + Provides the standard warnings plus + + .. hlist:: + :columns: 3 + + * :ghc-flag:`-Wunused-binds` + * :ghc-flag:`-Wunused-matches` + * :ghc-flag:`-Wunused-imports` + * :ghc-flag:`-Wincomplete-patterns` + * :ghc-flag:`-Wdodgy-exports` + * :ghc-flag:`-Wdodgy-imports` .. ghc-flag:: -Wall Turns on all warning options that indicate potentially suspicious code. The warnings that are *not* enabled by :ghc-flag:`-Wall` are - :ghc-flag:`-Wincomplete-uni-patterns`, - :ghc-flag:`-Wincomplete-record-updates`, - :ghc-flag:`-Wmonomorphism-restriction`, - :ghc-flag:`-Wimplicit-prelude`, :ghc-flag:`-Wmissing-local-sigs`, - :ghc-flag:`-Wmissing-exported-sigs`, :ghc-flag:`-Wmissing-import-lists` - and :ghc-flag:`-Widentities`. + + .. hlist:: + :columns: 3 + + * :ghc-flag:`-Wincomplete-uni-patterns` + * :ghc-flag:`-Wincomplete-record-updates` + * :ghc-flag:`-Wmonomorphism-restriction` + * :ghc-flag:`-Wimplicit-prelude` + * :ghc-flag:`-Wmissing-local-sigs` + * :ghc-flag:`-Wmissing-exported-sigs` + * :ghc-flag:`-Wmissing-import-lists` + * :ghc-flag:`-Widentities` .. ghc-flag:: -Wcompat @@ -60,8 +73,14 @@ The following flags are simple ways to select standard "packages" of warnings: eager to make their code future compatible to adapt to new features before they even generate warnings. - This currently enables :ghc-flag:`-Wmissing-monadfail-instance`, - :ghc-flag:`-Wsemigroup`, and :ghc-flag:`-Wnoncanonical-monoid-instances`. + This currently enables + + .. hlist:: + :columns: 3 + + * :ghc-flag:`-Wmissing-monadfail-instance` + * :ghc-flag:`-Wsemigroup` + * :ghc-flag:`-Wnoncanonical-monoid-instances` .. ghc-flag:: -Wno-compat |