From: Paul Robinson Date: Wed, 13 Jan 2016 19:24:51 +0000 (+0000) Subject: Release note for debugger tuning X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=289912a5def6c6fe40ceaa86bd86a94bce267eea;p=clang 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 779d45c292..9bdbcdbc12 100644 --- 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