From 4a0c4eaea320a418400afc4d63359ed6c4af5548 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Wed, 9 Jun 2021 12:25:26 -0400 Subject: [PATCH] Document that -fno-trampolines is for Ada only [PR100735] gcc/ PR other/100735 * doc/invoke.texi (Code Gen Options); Document that -fno-trampolines and -ftrampolines work only with Ada. * doc/tm.texi.in (Trampolines): Likewise. * doc/tm.texi: Regenerated. --- gcc/doc/invoke.texi | 5 +++++ gcc/doc/tm.texi | 5 +++++ gcc/doc/tm.texi.in | 4 ++++ 3 files changed, 14 insertions(+) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 443252a..20d91be 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -16648,6 +16648,11 @@ Moreover, code compiled with @option{-ftrampolines} and code compiled with present. This option must therefore be used on a program-wide basis and be manipulated with extreme care. +For languages other than Ada, the @code{-ftrampolines} and +@code{-fno-trampolines} options currently have no effect, and +trampolines are always generated on platforms that need them +for nested functions. + @item -fvisibility=@r{[}default@r{|}internal@r{|}hidden@r{|}protected@r{]} @opindex fvisibility Set the default ELF image symbol visibility to the specified option---all diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index 0a6ae0b..fc7eb77 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -5489,6 +5489,11 @@ not ABI-compliant, this option is typically used only on a per-language basis (notably by Ada) or when it can otherwise be applied to the whole program. +For languages other than Ada, the @code{-ftrampolines} and +@code{-fno-trampolines} options currently have no effect, and +trampolines are always generated on platforms that need them +for nested functions. + Define the following hook if your backend either implements ABI-specified descriptor support, or can use GCC's generic descriptor implementation for nested functions. diff --git a/gcc/doc/tm.texi.in b/gcc/doc/tm.texi.in index d9fbbe2..2050160 100644 --- a/gcc/doc/tm.texi.in +++ b/gcc/doc/tm.texi.in @@ -3828,6 +3828,10 @@ addresses. Since GCC's generic function descriptors are not ABI-compliant, this option is typically used only on a per-language basis (notably by Ada) or when it can otherwise be applied to the whole program. +For languages other than Ada, the @code{-ftrampolines} and +@code{-fno-trampolines} options currently have no effect, and +trampolines are always generated on platforms that need them +for nested functions. Define the following hook if your backend either implements ABI-specified descriptor support, or can use GCC's generic descriptor implementation -- 2.7.4