* doc/invoke.texi: Document -gdwarf{,-2} vs debug level.

From-SVN: r52769

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 01b2e442e7fb22dbf77ff0f2f92f28f7d3b22f4b..17b63f45377c57272b548faf5173d9f07cbc1b0c 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,7 @@
+2002-04-25  Richard Henderson  <rth@redhat.com>
+
+       * doc/invoke.texi: Document -gdwarf{,-2} vs debug level.
+
 2002-04-25  Ulrich Weigand  <uweigand@de.ibm.com>
 
        * config/s390/s390.c (s390_emit_epilogue): Always restore registers

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index cd2eb14aa17c033f7c325f93c481a2f8d2e9467c..be361e598016ec53ef8eeff9b3bd8e7805e78168 100644 (file)
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -2722,8 +2722,6 @@ supported).  This is the format used by DEBUG on VMS systems.
 @itemx -gstabs@var{level}
 @itemx -gcoff@var{level}
 @itemx -gxcoff@var{level}
-@itemx -gdwarf@var{level}
-@itemx -gdwarf-2@var{level}
 @itemx -gvms@var{level}
 Request debugging information and also use @var{level} to specify how
 much information.  The default level is 2.
@@ -2737,6 +2735,11 @@ Level 3 includes extra information, such as all the macro definitions
 present in the program.  Some debuggers support macro expansion when
 you use @option{-g3}.
 
+Note that in order to avoid confusion between DWARF1 debug level 2,
+and DWARF2, neither @option{-gdwarf} nor @option{-gdwarf-2} accept
+a concatenated debug level.  Instead use an additional @option{-g@var{level}}
+option to change the debug level for DWARF1 or DWARF2.
+
 @cindex @code{prof}
 @item -p
 @opindex p