diff options
| author | Ben Gamari <ben@smart-cactus.org> | 2020-03-18 15:54:35 -0400 |
|---|---|---|
| committer | Ben Gamari <ben@smart-cactus.org> | 2020-11-09 20:59:15 -0500 |
| commit | 151f6f6f7bafa30a9e0f768d5ab187c6cbe35520 (patch) | |
| tree | 6d6b1f6ea249b64c8d53e185ca253141a267c3bd /docs/users_guide | |
| parent | 90e5fbf24d504d6a7b1f4fb1831662eb5f9cba43 (diff) | |
| download | haskell-wip/local-symbols-2.tar.gz | |
Enable -fexpose-internal-symbols when debug level >=2wip/local-symbols-2
This seems like a reasonable default as the object file size increases
by around 5%.
Diffstat (limited to 'docs/users_guide')
| -rw-r--r-- | docs/users_guide/debug-info.rst | 1 | ||||
| -rw-r--r-- | docs/users_guide/phases.rst | 7 |
2 files changed, 5 insertions, 3 deletions
diff --git a/docs/users_guide/debug-info.rst b/docs/users_guide/debug-info.rst index 351446fa58..b1636bb81f 100644 --- a/docs/users_guide/debug-info.rst +++ b/docs/users_guide/debug-info.rst @@ -14,6 +14,7 @@ useable by most UNIX debugging tools. :category: debugging :since: 7.10, numeric levels since 8.0 + :implies: :ghc-flag:`-fexpose-internal-symbols` when ⟨n⟩ >= 2. Emit debug information in object code. Currently only DWARF debug information is supported on x86-64 and i386. Currently debug levels 0 diff --git a/docs/users_guide/phases.rst b/docs/users_guide/phases.rst index 88b6659a05..2b156d7328 100644 --- a/docs/users_guide/phases.rst +++ b/docs/users_guide/phases.rst @@ -728,10 +728,11 @@ Options affecting code generation Request that GHC emits verbose symbol tables which include local symbols for module-internal functions. These can be useful for tools like :ref:`perf <https://perf.wiki.kernel.org/>` but increase object file sizes. + This is implied by :ghc-flag:`-g2 <-g>` and above. - :ghc-flag:`-fno-expose-internal-symbols` suppresses all non-global symbol - table entries, resulting in smaller object file sizes at the expense of - debuggability. + :ghc-flag:`-fno-expose-internal-symbols <-fexpose-internal-symbols>` + suppresses all non-global symbol table entries, resulting in smaller object + file sizes at the expense of debuggability. .. _options-linker: |