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.
OK for trunk?
commit 9d950d2398b0a01358520a1c0a69bbe46ba7d997
Author: Jonathan Wakely <jwak...@redhat.com>
Date: Wed Apr 10 12:15:29 2019 +0100
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.
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index cfc3063929b..73a7789d879 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
