[commit: ghc] ghc-8.2: users-guide: Document -g flag (b29a9f0)

[git at git.haskell.org]

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

On branch  : ghc-8.2
Link       : http://ghc.haskell.org/trac/ghc/changeset/b29a9f0ea8c25fbf84d3afe0bab43a2d82bb1324/ghc

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

commit b29a9f0ea8c25fbf84d3afe0bab43a2d82bb1324
Author: Ben Gamari <ben at smart-cactus.org>
Date:   Mon May 15 14:21:38 2017 -0400

    users-guide: Document -g flag
    
    (cherry picked from commit bc066558e83bfa741a58ec1797ac8fccc507266e)


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

b29a9f0ea8c25fbf84d3afe0bab43a2d82bb1324
 docs/users_guide/debug-info.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/users_guide/debug-info.rst b/docs/users_guide/debug-info.rst
index 613936d..2f192f2 100644
--- a/docs/users_guide/debug-info.rst
+++ b/docs/users_guide/debug-info.rst
@@ -5,13 +5,14 @@ Since the 7.10 release GHC can emit a debugging information to help debugging
 tools understand the code that GHC produces. This debugging information is
 useable by most UNIX debugging tools.
 
-.. warning::
+.. ghc-flag:: -g, -g<n>
 
-   This feature is still in technology preview state. There are known cases
-   where requesting a stack-trace can cause your program to segmentation fault
-   (e.g. :ghc-ticket:`11353`, :ghc-ticket:`11338`, and :ghc-ticket:`11337`).
-   Consequently, we can not recommend that stack trace support be used in
-   production code.
+    :since: 7.10, numeric levels since 8.0
+
+    Emit debug information in object code. Currently only DWARF debug
+    information is supported on x86-64 and i386. Currently debug levels 0
+    through 3 are accepted, with 0 disabling debug information production.
+    Levels 1 through 3 are functionally equivalent.
 
 
 Tutorial