From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2119) id 69941399C007; Wed, 9 Jun 2021 16:28:13 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 69941399C007 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Jeff Law To: gcc-cvs@gcc.gnu.org Subject: [gcc r12-1342] Document that -fno-trampolines is for Ada only [PR100735] X-Act-Checkin: gcc X-Git-Author: Paul Eggert X-Git-Refname: refs/heads/master X-Git-Oldrev: db042e1603db5057314c404eded73c45f60ad2d6 X-Git-Newrev: 4a0c4eaea320a418400afc4d63359ed6c4af5548 Message-Id: <20210609162813.69941399C007@sourceware.org> Date: Wed, 9 Jun 2021 16:28:13 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Jun 2021 16:28:13 -0000 https://gcc.gnu.org/g:4a0c4eaea320a418400afc4d63359ed6c4af5548 commit r12-1342-g4a0c4eaea320a418400afc4d63359ed6c4af5548 Author: Paul Eggert Date: Wed Jun 9 12:25:26 2021 -0400 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. Diff: --- 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 443252a83f1..20d91be607b 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 0a6ae0b683e..fc7eb7735b0 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 d9fbbe20e6f..20501607716 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