[man page] Document -gline-tables-only in the clang man page.
llvm-svn: 275076
diff --git a/clang/docs/CommandGuide/clang.rst b/clang/docs/CommandGuide/clang.rst
index 3143626..0546304 100644
--- a/clang/docs/CommandGuide/clang.rst
+++ b/clang/docs/CommandGuide/clang.rst
@@ -253,22 +253,32 @@
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:: -gmodules
+ :option:`-g` Generate debug information.
- 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`.
+ :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.
- 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 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:: -fstandalone-debug -fno-standalone-debug
Clang supports a number of optimizations to reduce the size of debug