Release note for debugger tuning

git-svn-id: https://llvm.org/svn/llvm-project/cfe/branches/release_38@257654 91177308-0d34-0410-b5e6-96231b3b80d8

diff --git a/docs/ReleaseNotes.rst b/docs/ReleaseNotes.rst
index 779d45c2928b3a85a0127e90d0dd2683a17a7852..9bdbcdbc1250f78ffa851364523fae47c67e77cb 100644 (file)
--- a/docs/ReleaseNotes.rst
+++ b/docs/ReleaseNotes.rst
@@ -61,7 +61,22 @@ about them. The improvements since the 3.7 release include:
 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