Default to DWARF5
authorMark Wielaard <mark@klomp.org>
Tue, 29 Sep 2020 13:52:44 +0000 (15:52 +0200)
committerMark Wielaard <mark@klomp.org>
Sun, 17 Jan 2021 00:36:39 +0000 (01:36 +0100)
gcc/ChangeLog:

* common.opt (gdwarf-): Init(5).
* doc/invoke.texi (-gdwarf): Document default to 5.

gcc/common.opt
gcc/doc/invoke.texi

index 9edcb5f190d0bcb43df95161000ca2b8b41f9f52..bde1711870def29e44cb62c8c3510eee300a9056 100644 (file)
@@ -3179,7 +3179,7 @@ Common Driver JoinedOrMissing Negative(gdwarf-)
 Generate debug information in default version of DWARF format.
 
 gdwarf-
-Common Driver Joined UInteger Var(dwarf_version) Init(4) Negative(gstabs)
+Common Driver Joined UInteger Var(dwarf_version) Init(5) Negative(gstabs)
 Generate debug information in DWARF v2 (or later) format.
 
 gdwarf32
index 3f30230b0c244245e23e29ea409277528cfc390c..c290b6f4938f45e8d491d76d4940060e7b59be36 100644 (file)
@@ -9606,14 +9606,15 @@ possible.
 @itemx -gdwarf-@var{version}
 @opindex gdwarf
 Produce debugging information in DWARF format (if that is supported).
-The value of @var{version} may be either 2, 3, 4 or 5; the default version
-for most targets is 4.  DWARF Version 5 is only experimental.
+The value of @var{version} may be either 2, 3, 4 or 5; the default
+version for most targets is 5 (with the exception of VxWorks and
+Darwin/Mac OS X which default to version 2).
 
 Note that with DWARF Version 2, some ports require and always
 use some non-conflicting DWARF 3 extensions in the unwind tables.
 
 Version 4 may require GDB 7.0 and @option{-fvar-tracking-assignments}
-for maximum benefit.
+for maximum benefit. Version 5 requires GDB 8.0 or higher.
 
 GCC no longer supports DWARF Version 1, which is substantially
 different than Version 2 and later.  For historical reasons, some