diff options
| author | Ben Gamari <ben@smart-cactus.org> | 2019-12-26 23:41:04 -0500 |
|---|---|---|
| committer | Marge Bot <ben+marge-bot@smart-cactus.org> | 2020-11-15 03:35:45 -0500 |
| commit | 1e19183d08a3312ac2331b8284d17bc17170a51e (patch) | |
| tree | a823cc90a072513d725b1f237b87d5451fe89023 /docs/users_guide/debug-info.rst | |
| parent | 0a7e592cb1883824a14639372ba284766849ff3a (diff) | |
| download | haskell-1e19183d08a3312ac2331b8284d17bc17170a51e.tar.gz | |
nativeGen/dwarf: Only produce DW_AT_source_note DIEs in -g3
Standard debugging tools don't know how to understand these so let's not
produce them unless asked.
Diffstat (limited to 'docs/users_guide/debug-info.rst')
| -rw-r--r-- | docs/users_guide/debug-info.rst | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/users_guide/debug-info.rst b/docs/users_guide/debug-info.rst index b1636bb81f..42afa9078f 100644 --- a/docs/users_guide/debug-info.rst +++ b/docs/users_guide/debug-info.rst @@ -24,7 +24,9 @@ useable by most UNIX debugging tools. * ``-g1``: produces stack unwinding records for top-level functions (sufficient for basic backtraces) * ``-g2``: produces stack unwinding records for top-level functions as well as inner blocks (allowing more precise backtraces than with ``-g1``). - * ``-g3``: same as ``-g2``. + * ``-g3``: produces GHC-specific DWARF information for use by more + sophisticated Haskell-aware debugging tools (see :ref:`dwarf-dies` for + details) If ⟨n⟩ is omitted, level 2 is assumed. @@ -266,6 +268,7 @@ In particular GHC produces the following DWARF sections, ``.debug_arange`` Address range information necessary for efficient lookup in debug information. +.. _dwarf_dies: Debugging information entities ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |