Re: undocumented optimization options

[Kenneth Zadeck <zadeck@naturalbridge.com>]

Richard Guenther wrote:
> On 11/5/07, Kenneth Zadeck <zadeck@naturalbridge.com> wrote:
>   
>> Janis Johnson wrote:
>>     
>>> Several options reported by --help=optimize are not documented in the
>>> GCC Manual (via invoke.texi) but are still reported with
>>> --help=optimize,^undocumented.  Here are the options along with the
>>> people who checked in the entries to common.opt:
>>>
>>>   -fipa-cp               steven
>>>   -fipa-matrix-reorg     razya
>>>   -fipa-pure-const       zadeck  (enabled with -O)
>>>   -fipa-reference        zadeck  (enabled with -O)
>>>   -fipa-type-escape      zadeck
>>>   -fvar-tracking-uninit  ctice
>>>
>>> Is there a policy about whether an experimental option can be left
>>> undocumented, or should it be documented with a statement that it is
>>> experimental?
>>>
>>> If an option is left undocumented on purpose then its entry in common.opt
>>> should include "Undocumented".
>>>
>>> Janis
>>>
>>>
>>>
>>>       
>> This patch gets me off of janis's bad list (or at least the one
>> associated with undocumented options).  As directed by diego, I sorted
>> the option lists for -O, -Os and -O2 since this had rotted.
>>
>> 2007-11-05  Kenneth Zadeck <zadeck@naturalbridge.com>
>>
>>     * common.opt: Add pointer to doc/options.texi.
>>     * doc/invoke.texi (-fdse, -fdce, -fauto-inc-dec, -fipa-pure-const,
>>     -fipa-reference): Add or correct doc.  Sorted options list for -Os
>>     -O, -O2.
>>
>> Ok to commit?
>>     
>
> Ok, thanks.
> Richard.
>
>   
>> Kenny
>>
>>
>>
>>     
committed as revision 130000

kenny