aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Wakely <jwakely@redhat.com>2019-04-10 15:39:59 +0100
committerJonathan Wakely <redi@gcc.gnu.org>2019-04-10 15:39:59 +0100
commit07c2fa4665510267112030d500d7b1b7c0f4364e (patch)
tree8273fea4e8f11098397660ebde49b4f3cccddc36
parent620626daa52bb69df06c3ece4d3f0ef65c7f6d9d (diff)
downloadgcc-07c2fa4665510267112030d500d7b1b7c0f4364e.zip
gcc-07c2fa4665510267112030d500d7b1b7c0f4364e.tar.gz
gcc-07c2fa4665510267112030d500d7b1b7c0f4364e.tar.bz2
Clearly document behaviour of multiple -g options
This copies the wording from the -O options to clearly state what happens if more than one -g option is used. * doc/invoke.texi (Debugging Options): Explicitly state the semantics of using multiple -g options. From-SVN: r270257
-rw-r--r--gcc/ChangeLog5
-rw-r--r--gcc/doc/invoke.texi3
2 files changed, 8 insertions, 0 deletions
diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 522538c..6249828 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2019-04-10 Jonathan Wakely <jwakely@redhat.com>
+
+ * doc/invoke.texi (Debugging Options): Explicitly state the semantics
+ of using multiple -g options.
+
2019-04-10 Martin Liska <mliska@suse.cz>
PR gcov-profile/89959
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index cfc3063..73a7789 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -7818,6 +7818,9 @@ 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}.
+If you use multiple @option{-g} options, with or without level numbers,
+the last such option is the one that is effective.
+
@option{-gdwarf} does not accept a concatenated debug level, to avoid
confusion with @option{-gdwarf-@var{level}}.
Instead use an additional @option{-g@var{level}} option to change the