diff mbox series

Clearly document behaviour of multiple -g options

Message ID 20190410111807.GA16682@redhat.com
State New
Headers show
Series Clearly document behaviour of multiple -g options | expand

Commit Message

Jonathan Wakely April 10, 2019, 11:18 a.m. UTC
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 <jwakely@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.

Comments

Sandra Loosemore April 10, 2019, 2:03 p.m. UTC | #1
On 4/10/19 5:18 AM, Jonathan Wakely wrote:
> 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?

Looks fine to me, assuming the behavior you're documenting is indeed 
what happens.  Thanks.

-Sandra
diff mbox series

Patch

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