[llvm-branch-commits] [cfe-branch] r257654 - Release note for debugger tuning

[Paul Robinson via llvm-branch-commits]

Author: probinson
Date: Wed Jan 13 13:24:51 2016
New Revision: 257654

URL: http://llvm.org/viewvc/llvm-project?rev=257654&view=rev
Log:
Release note for debugger tuning

Modified:
    cfe/branches/release_38/docs/ReleaseNotes.rst

Modified: cfe/branches/release_38/docs/ReleaseNotes.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/branches/release_38/docs/ReleaseNotes.rst?rev=257654&r1=257653&r2=257654&view=diff
==============================================================================
--- cfe/branches/release_38/docs/ReleaseNotes.rst (original)
+++ cfe/branches/release_38/docs/ReleaseNotes.rst Wed Jan 13 13:24:51 2016
@@ -61,7 +61,22 @@ about them. The improvements since the 3
 New Compiler Flags
 ------------------
 
-The option ....
+Clang can "tune" DWARF debugging information to suit one of several different
+debuggers. This fine-tuning can mean omitting DWARF features that the
+debugger does not need or use, or including DWARF extensions specific to the
+debugger. Clang supports tuning for three debuggers, as follows.
+
+- ``-ggdb`` is equivalent to ``-g`` plus tuning for the GDB debugger. For
+  compatibility with GCC, Clang allows this option to be followed by a
+  single digit from 0 to 3 indicating the debugging information "level."
+  For example, ``-ggdb1`` is equivalent to ``-ggdb -g1``.
+
+- ``-glldb`` is equivalent to ``-g`` plus tuning for the LLDB debugger.
+
+- ``-gsce`` is equivalent to ``-g`` plus tuning for the Sony Computer
+  Entertainment debugger.
+
+Specifying ``-g`` without a tuning option will use a target-dependent default.
 
 
 New Pragmas in Clang