[commit: ghc] ghc-8.0: user-guide: Reformat warning lists (1a0e993)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : ghc-8.0
Link       : http://ghc.haskell.org/trac/ghc/changeset/1a0e9933aefe668b4552b290d97c3b4aaff2939c/ghc

>---------------------------------------------------------------

commit 1a0e9933aefe668b4552b290d97c3b4aaff2939c
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Sat Jan 23 19:17:45 2016 +0100

    user-guide: Reformat warning lists
    
    (cherry picked from commit 6f96109b283dd5e4364062c5f71e0b11a9dfb9cd)


>---------------------------------------------------------------

1a0e9933aefe668b4552b290d97c3b4aaff2939c
 docs/users_guide/using-warnings.rst | 43 ++++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/docs/users_guide/using-warnings.rst b/docs/users_guide/using-warnings.rst
index 15a2525..fb9c913 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