Author: adrian
Date: Mon Jul 11 12:03:16 2016
New Revision: 275076
URL: http://llvm.org/viewvc/llvm-project?rev=275076&view=rev
Log:
[man page] Document -gline-tables-only in the clang man page.
Modified:
cfe/trunk/docs/CommandGuide/clang.rst
Modified: cfe/trunk/docs/CommandGuide/clang.rst
URL:
http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/CommandGuide/clang.rst?rev=275076&r1=275075&r2=275076&view=diff
==============================================================================
--- cfe/trunk/docs/CommandGuide/clang.rst (original)
+++ cfe/trunk/docs/CommandGuide/clang.rst Mon Jul 11 12:03:16 2016
@@ -253,22 +253,32 @@ Code Generation Options
Currently equivalent to :option:`-O3`
-.. option:: -g
+.. option:: -g, -gline-tables-only, -gmodules
- Generate debug information. Note that Clang debug information works best at
-O0.
+ Control debug information output. Note that Clang debug information works
+ best at :option:`-O0`. When more than one option starting with `-g` is
+ specified, the last one wins:
+
+ :option:`-g` Generate debug information.
+
+ :option:`-gline-tables-only` Generate only line table debug information.
This
+ allows for symbolicated backtraces with inlining information, but does not
+ include any information about variables, their locations or types.
+
+ :option:`-gmodules` Generate debug information that contains external
+ references to types defined in Clang modules or precompiled headers instead
+ of emitting redundant debug type information into every object file. This
+ option transparently switches the Clang module format to object file
+ containers that hold the Clang module together with the debug information.
+ When compiling a program that uses Clang modules or precompiled headers,
+ this option produces complete debug information with faster compile
+ times and much smaller object files.
+
+ This option should not be used when building static libraries for
+ distribution to other machines because the debug info will contain
+ references to the module cache on the machine the object files in the
+ library were built on.
-.. option:: -gmodules
-
- Generate debug information that contains external references to
- types defined in clang modules or precompiled headers instead of
- emitting redundant debug type information into every object file.
- This option implies :option:`-fmodule-format=obj`.
-
- This option should not be used when building static libraries for
- distribution to other machines because the debug info will contain
- references to the module cache on the machine the object files in
- the library were built on.
-
.. option:: -fstandalone-debug -fno-standalone-debug
Clang supports a number of optimizations to reduce the size of debug
_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
