[commit: ghc] master: users-guide: Document multi-line DEPRECATED pragmas (8f72608)

[git at git.haskell.org]

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

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/8f72608953fee7ff77a6d89b00f25749261b8820/ghc

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

commit 8f72608953fee7ff77a6d89b00f25749261b8820
Author: Ben Gamari <bgamari.foss at gmail.com>
Date:   Mon Jun 12 17:00:55 2017 -0400

    users-guide: Document multi-line DEPRECATED pragmas
    
    Fixes #13791.
    
    [skip ci]
    
    Test Plan: Read it
    
    Reviewers: austin
    
    Subscribers: rwbarton, thomie
    
    GHC Trac Issues: #13791
    
    Differential Revision: https://phabricator.haskell.org/D3639


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

8f72608953fee7ff77a6d89b00f25749261b8820
 docs/users_guide/glasgow_exts.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/users_guide/glasgow_exts.rst b/docs/users_guide/glasgow_exts.rst
index 20312eb..e4da54e 100644
--- a/docs/users_guide/glasgow_exts.rst
+++ b/docs/users_guide/glasgow_exts.rst
@@ -12598,6 +12598,12 @@ are two ways of using these pragmas.
    both are in scope. If both are in scope, there is currently no way to
    specify one without the other (c.f. fixities :ref:`infix-tycons`).
 
+Also note that the argument to ``DEPRECATED`` and ``WARNING`` can also be a list
+of strings, in which case the strings will be presented on separate lines in the
+resulting warning message, ::
+
+    {-# DEPRECATED foo, bar ["Don't use these", "Use gar instead"] #-}
+
 Warnings and deprecations are not reported for (a) uses within the
 defining module, (b) defining a method in a class instance, and (c) uses
 in an export list. The latter reduces spurious complaints within a