This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[DOC] Update -feliminate-unused-debug-types description
- From: <Paul_Koning at Dell dot com>
- To: <gcc-patches at gcc dot gnu dot org>
- Date: Mon, 17 Sep 2012 15:59:06 +0000
- Subject: [DOC] Update -feliminate-unused-debug-types description
Currently the description of -feliminate-unused-debug-types says that it is off by default. In fact, it is on by default. The attached patch corrects the documentation to reflect that.
Ok to commit?
paul
2012-09-17 Paul Koning <ni1d@arrl.net>
* doc/invoke.text (-feliminate-unused-debug-types): Update to
reflect that this is enabled by default.
Index: invoke.texi
===================================================================
--- invoke.texi (revision 191393)
+++ invoke.texi (working copy)
@@ -324,7 +324,7 @@
-fdump-tree-storeccp@r{[}-@var{n}@r{]} @gol
-fdump-final-insns=@var{file} @gol
-fcompare-debug@r{[}=@var{opts}@r{]} -fcompare-debug-second @gol
--feliminate-dwarf2-dups -feliminate-unused-debug-types @gol
+-feliminate-dwarf2-dups -fno-eliminate-unused-debug-types @gol
-feliminate-unused-debug-symbols -femit-class-debug-always @gol
-fenable-@var{kind}-@var{pass} @gol
-fenable-@var{kind}-@var{pass}=@var{range-list} @gol
@@ -6192,17 +6192,18 @@
Print the compiler's built-in specs---and don't do anything else. (This
is used when GCC itself is being built.) @xref{Spec Files}.
-@item -feliminate-unused-debug-types
+@item -fno-eliminate-unused-debug-types
@opindex feliminate-unused-debug-types
-Normally, when producing DWARF 2 output, GCC emits debugging
+@opindex fno-eliminate-unused-debug-types
+Normally, when producing DWARF 2 output, GCC avoids producing debug symbol
+output for types that are nowhere used in the source file being compiled.
+Sometimes it is useful to have GCC emit debugging
information for all types declared in a compilation
unit, regardless of whether or not they are actually used
-in that compilation unit. Sometimes this is useful, such as
+in that compilation unit, for example
if, in the debugger, you want to cast a value to a type that is
not actually used in your program (but is declared). More often,
however, this results in a significant amount of wasted space.
-With this option, GCC avoids producing debug symbol output
-for types that are nowhere used in the source file being compiled.
@end table
@node Optimize Options