diff options
author | Diego Novillo <dnovillo@google.com> | 2014-06-24 17:02:17 +0000 |
---|---|---|
committer | Diego Novillo <dnovillo@google.com> | 2014-06-24 17:02:17 +0000 |
commit | e8e398049c5cb9d8ee10a8fcee11cb5df2f8999f (patch) | |
tree | fdafeadaf109eaad92efcd14121d244e8d85c2d1 /docs/UsersManual.rst | |
parent | 709135b01b238ef34d701ec67219c7e410b265de (diff) | |
download | clang-e8e398049c5cb9d8ee10a8fcee11cb5df2f8999f.tar.gz clang-e8e398049c5cb9d8ee10a8fcee11cb5df2f8999f.tar.bz2 clang-e8e398049c5cb9d8ee10a8fcee11cb5df2f8999f.tar.xz |
Add new debug kind LocTrackingOnly.
Summary:
This new debug emission kind supports emitting line location
information in all instructions, but stops code generation
from emitting debug info to the final output.
This mode is useful when the backend wants to track source
locations during code generation, but it does not want to
produce debug info. This is currently used by optimization
remarks (-Rpass, -Rpass-missed and -Rpass-analysis).
When one of the -Rpass flags is used, the front end will enable
location tracking, only if no other debug option is enabled.
To prevent debug information from being generated, a new debug
info kind LocTrackingOnly causes DIBuilder::createCompileUnit() to
not emit the llvm.dbg.cu annotation. This blocks final code generation
from generating debug info in the back end.
Depends on D4234.
Reviewers: echristo, dblaikie
Subscribers: cfe-commits
Differential Revision: http://reviews.llvm.org/D4235
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@211610 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/UsersManual.rst')
-rw-r--r-- | docs/UsersManual.rst | 10 |
1 files changed, 4 insertions, 6 deletions
diff --git a/docs/UsersManual.rst b/docs/UsersManual.rst index 2460e94664..90a0e53b50 100644 --- a/docs/UsersManual.rst +++ b/docs/UsersManual.rst @@ -577,12 +577,10 @@ feature. Current limitations ^^^^^^^^^^^^^^^^^^^ -1. For :option:`-Rpass` to provide source location information, you - need to enable debug line tables and column information. That is, - you need to add :option:`-gmlt` (or any of the debug-generating - flags) and :option:`-gcolumn-info`. If you omit these options, - every remark will be accompanied by a note stating that line number - information is missing. +1. For :option:`-Rpass` to provide column information, you + need to enable it explicitly. That is, you need to add + :option:`-gcolumn-info`. If you omit this, remarks will only show + line information. 2. Optimization remarks that refer to function names will display the mangled name of the function. Since these remarks are emitted by the |