[PATCH][doc][ARM] Deprecate -mapcs and -mapcs-frame

[PATCH][doc][ARM] Deprecate -mapcs and -mapcs-frame

[Kyrill Tkachov]

[-- Attachment #1: Type: text/plain, Size: 379 bytes --]

Hi all,

-mapcs-frame (and its' alias -mapcs) are somewhat bitrotten and the ABI 
they represent is deprecated anyway so this is a patch to deprecate the 
option. It's not being removed here, just documented as deprecated.

Kyrill

2015-01-14  Kyrylo Tkachov  <kyrylo.tkachov@arm.com>

     * doc/invoke.texi (mapcs): Mention deprecation.
     (mapcs-frame): Likewise.

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: arm-mapcs-deprecated.patch --]
[-- Type: text/x-patch; name=arm-mapcs-deprecated.patch, Size: 659 bytes --]

diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
index d2f3c79..7a72120 100644
--- a/gcc/doc/invoke.texi
+++ b/gcc/doc/invoke.texi
@@ -12683,10 +12683,11 @@ Standard for all functions, even if this is not strictly necessary for
 correct execution of the code.  Specifying @option{-fomit-frame-pointer}
 with this option causes the stack frames not to be generated for
 leaf functions.  The default is @option{-mno-apcs-frame}.
+This option is deprecated.
 
 @item -mapcs
 @opindex mapcs
-This is a synonym for @option{-mapcs-frame}.
+This is a synonym for @option{-mapcs-frame} and is deprecated.
 
 @ignore
 @c not currently implemented

Re: [PATCH][doc][ARM] Deprecate -mapcs and -mapcs-frame

[Richard Earnshaw]

On 14/01/15 10:38, Kyrill Tkachov wrote:
> Hi all,
> 
> -mapcs-frame (and its' alias -mapcs) are somewhat bitrotten and the ABI 
> they represent is deprecated anyway so this is a patch to deprecate the 
> option. It's not being removed here, just documented as deprecated.
> 
> Kyrill
> 
> 2015-01-14  Kyrylo Tkachov  <kyrylo.tkachov@arm.com>
> 
>      * doc/invoke.texi (mapcs): Mention deprecation.
>      (mapcs-frame): Likewise.
> 
> 
> arm-mapcs-deprecated.patch
> 
> 
> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
> index d2f3c79..7a72120 100644
> --- a/gcc/doc/invoke.texi
> +++ b/gcc/doc/invoke.texi
> @@ -12683,10 +12683,11 @@ Standard for all functions, even if this is not strictly necessary for
>  correct execution of the code.  Specifying @option{-fomit-frame-pointer}
>  with this option causes the stack frames not to be generated for
>  leaf functions.  The default is @option{-mno-apcs-frame}.
> +This option is deprecated.
>  
>  @item -mapcs
>  @opindex mapcs
> -This is a synonym for @option{-mapcs-frame}.
> +This is a synonym for @option{-mapcs-frame} and is deprecated.
>  
>  @ignore
>  @c not currently implemented
> 

OK.

I think this needs a mention in the release notes as well.

R.

Re: [PATCH][doc][ARM] Deprecate -mapcs and -mapcs-frame

[Kyrill Tkachov]

On 14/01/15 11:13, Richard Earnshaw wrote:
> On 14/01/15 10:38, Kyrill Tkachov wrote:
>> Hi all,
>>
>> -mapcs-frame (and its' alias -mapcs) are somewhat bitrotten and the ABI
>> they represent is deprecated anyway so this is a patch to deprecate the
>> option. It's not being removed here, just documented as deprecated.
>>
>> Kyrill
>>
>> 2015-01-14  Kyrylo Tkachov  <kyrylo.tkachov@arm.com>
>>
>>       * doc/invoke.texi (mapcs): Mention deprecation.
>>       (mapcs-frame): Likewise.
>>
>>
>> arm-mapcs-deprecated.patch
>>
>>
>> diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi
>> index d2f3c79..7a72120 100644
>> --- a/gcc/doc/invoke.texi
>> +++ b/gcc/doc/invoke.texi
>> @@ -12683,10 +12683,11 @@ Standard for all functions, even if this is not strictly necessary for
>>   correct execution of the code.  Specifying @option{-fomit-frame-pointer}
>>   with this option causes the stack frames not to be generated for
>>   leaf functions.  The default is @option{-mno-apcs-frame}.
>> +This option is deprecated.
>>   
>>   @item -mapcs
>>   @opindex mapcs
>> -This is a synonym for @option{-mapcs-frame}.
>> +This is a synonym for @option{-mapcs-frame} and is deprecated.
>>   
>>   @ignore
>>   @c not currently implemented
>>
> OK.
>
> I think this needs a mention in the release notes as well.
Thanks,
the wwdocs patch is https://gcc.gnu.org/ml/gcc-patches/2015-01/msg01003.html

Kyrill

>
> R.