[htdocs] gcc-14: document -ftrampoline-impl

Message ID a6de39465c3b9a31e365c86a3cb07fd3bfa46481.1739172500.git.sam@gentoo.org
State New
Headers
Series [htdocs] gcc-14: document -ftrampoline-impl |

Checks

Context Check Description
linaro-tcwg-bot/tcwg_simplebootstrap_build--master-arm-bootstrap fail Patch failed to apply
linaro-tcwg-bot/tcwg_gcc_build--master-arm fail Patch failed to apply
linaro-tcwg-bot/tcwg_gcc_build--master-aarch64 fail Patch failed to apply
linaro-tcwg-bot/tcwg_simplebootstrap_build--master-aarch64-bootstrap fail Patch failed to apply

Commit Message

Sam James Feb. 10, 2025, 7:28 a.m. UTC
  ---
Iain, does this look OK?

 htdocs/gcc-14/changes.html | 7 +++++++
 1 file changed, 7 insertions(+)
  

Comments

Iain Sandoe Feb. 10, 2025, 7:45 a.m. UTC | #1
> On 10 Feb 2025, at 08:28, Sam James <sam@gentoo.org> wrote:
> 
> ---
> Iain, does this look OK?
> 
> htdocs/gcc-14/changes.html | 7 +++++++
> 1 file changed, 7 insertions(+)
> 
> diff --git a/htdocs/gcc-14/changes.html b/htdocs/gcc-14/changes.html
> index ba4780ca..2db442b2 100644
> --- a/htdocs/gcc-14/changes.html
> +++ b/htdocs/gcc-14/changes.html
> @@ -123,6 +123,13 @@ You may also want to check out our
>     not an optimization, to avoid relying on library
>     implementations.
>   </li>
> +  <li>
> +   New option
> +   <a href="https://gcc.gnu.org/onlinedocs/gcc-14.1.0/gcc/Code-Gen-Options.html#index-ftrampoline-impl"><code>-ftrampoline-impl=</code></a>,
> +   to choose the position of generated trampolines.

maybe “placement” instead of “position” - but not a show-stopper for me
otherwise LGTM.
Iain

> The default remains the stack
> +   for almost all targets. To override the default,
> +   <code>-ftrampoline-impl=heap</code> can be passed on supported ABIs
> +   (x86_64 Darwin, x86_64 and aarch64 Linux).
>   <li>
>     <!-- commit r14-4958-gcd7dadcd2759d1 -->
>     New function attribute
> -- 
> 2.48.1
>
  
Sam James Feb. 10, 2025, 8:33 a.m. UTC | #2
Iain Sandoe <iain@sandoe.co.uk> writes:

>> On 10 Feb 2025, at 08:28, Sam James <sam@gentoo.org> wrote:
>> 
>> ---
>> Iain, does this look OK?
>> 
>> htdocs/gcc-14/changes.html | 7 +++++++
>> 1 file changed, 7 insertions(+)
>> 
>> diff --git a/htdocs/gcc-14/changes.html b/htdocs/gcc-14/changes.html
>> index ba4780ca..2db442b2 100644
>> --- a/htdocs/gcc-14/changes.html
>> +++ b/htdocs/gcc-14/changes.html
>> @@ -123,6 +123,13 @@ You may also want to check out our
>>     not an optimization, to avoid relying on library
>>     implementations.
>>   </li>
>> +  <li>
>> +   New option
>> +   <a href="https://gcc.gnu.org/onlinedocs/gcc-14.1.0/gcc/Code-Gen-Options.html#index-ftrampoline-impl"><code>-ftrampoline-impl=</code></a>,
>> +   to choose the position of generated trampolines.
>
> maybe “placement” instead of “position” - but not a show-stopper for me
> otherwise LGTM.

Thanks! Pushed with that change.

> Iain
>
>> The default remains the stack
>> +   for almost all targets. To override the default,
>> +   <code>-ftrampoline-impl=heap</code> can be passed on supported ABIs
>> +   (x86_64 Darwin, x86_64 and aarch64 Linux).
>>   <li>
>>     <!-- commit r14-4958-gcd7dadcd2759d1 -->
>>     New function attribute
>> -- 
>> 2.48.1
>>
  

Patch

diff --git a/htdocs/gcc-14/changes.html b/htdocs/gcc-14/changes.html
index ba4780ca..2db442b2 100644
--- a/htdocs/gcc-14/changes.html
+++ b/htdocs/gcc-14/changes.html
@@ -123,6 +123,13 @@  You may also want to check out our
     not an optimization, to avoid relying on library
     implementations.
   </li>
+  <li>
+   New option
+   <a href="https://gcc.gnu.org/onlinedocs/gcc-14.1.0/gcc/Code-Gen-Options.html#index-ftrampoline-impl"><code>-ftrampoline-impl=</code></a>,
+   to choose the position of generated trampolines. The default remains the stack
+   for almost all targets. To override the default,
+   <code>-ftrampoline-impl=heap</code> can be passed on supported ABIs
+   (x86_64 Darwin, x86_64 and aarch64 Linux).
   <li>
     <!-- commit r14-4958-gcd7dadcd2759d1 -->
     New function attribute