doc/invoke.texi: clarify default setting of VTA

Hello,

Recently on gcc-help@ one of the users asked whether they need to set
-fvar-tracking-assignments on the command line by hand.  The documentation may
be clearer in that this flag has a useful value by default, like -fvar-tracking
(i.e. GCC's behavior is to take the value of flag_var_tracking, unless there's
an override on the command line).

OK to commit?

I also see that introductory text says that the option list mentions negated
forms when they are supposed to be usually used on the command line, which
means that var-tracking paragraphs should in fact use
-fno-var-tracking[-assignments], because normally users will only need the
negative forms?

2015-01-30  Alexander Monakov  <amonakov@ispras.ru>

	* doc/invoke.texi (-fvar-tracking-assignments): Clarify that VTA is
	enabled by default together with var-tracking.

Ping?

On Fri, 30 Jan 2015, Alexander Monakov wrote:

> Hello,
> 
> Recently on gcc-help@ one of the users asked whether they need to set
> -fvar-tracking-assignments on the command line by hand.  The documentation may
> be clearer in that this flag has a useful value by default, like -fvar-tracking
> (i.e. GCC's behavior is to take the value of flag_var_tracking, unless there's
> an override on the command line).
> 
> OK to commit?
> 
> I also see that introductory text says that the option list mentions negated
> forms when they are supposed to be usually used on the command line, which
> means that var-tracking paragraphs should in fact use
> -fno-var-tracking[-assignments], because normally users will only need the
> negative forms?
> 
> 2015-01-30  Alexander Monakov  <amonakov@ispras.ru>
> 
> 	* doc/invoke.texi (-fvar-tracking-assignments): Clarify that VTA is
> 	enabled by default together with var-tracking.
> 
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index 2d3c4f7..3ffba2e 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -7093,6 +7093,8 @@ optimizing.  Use of @option{-gdwarf-4} is recommended along with it.
>  
>  It can be enabled even if var-tracking is disabled, in which case
>  annotations are created and maintained, but discarded at the end.
> +By default, this flag is enabled together with @option{-fvar-tracking},
> +except when selective scheduling is enabled.
>  
>  @item -fvar-tracking-assignments-toggle
>  @opindex fvar-tracking-assignments-toggle
> 
>

On 02/06/15 05:12, Alexander Monakov wrote:
> Ping?
>
> On Fri, 30 Jan 2015, Alexander Monakov wrote:
>
>> Hello,
>>
>> Recently on gcc-help@ one of the users asked whether they need to set
>> -fvar-tracking-assignments on the command line by hand.  The documentation may
>> be clearer in that this flag has a useful value by default, like -fvar-tracking
>> (i.e. GCC's behavior is to take the value of flag_var_tracking, unless there's
>> an override on the command line).
>>
>> OK to commit?
>>
>> I also see that introductory text says that the option list mentions negated
>> forms when they are supposed to be usually used on the command line, which
>> means that var-tracking paragraphs should in fact use
>> -fno-var-tracking[-assignments], because normally users will only need the
>> negative forms?
>>
>> 2015-01-30  Alexander Monakov  <amonakov@ispras.ru>
>>
>> 	* doc/invoke.texi (-fvar-tracking-assignments): Clarify that VTA is
>> 	enabled by default together with var-tracking.
This is fine.

Jeff