From a2a4a6c05713afe17d8e66c3903c0da750e7aec5 Mon Sep 17 00:00:00 2001 From: Sam James Date: Thu, 4 Sep 2025 23:48:38 +0100 Subject: doc: update incremental link vs binutils information GNU Binutils now supports linking LTO and non-LTO objects into a single mixed object file as of 2.44. Update the text to reflect this and fix some minor grammar issues while at it. gcc/ChangeLog: PR ipa/116410 * doc/invoke.texi (Link Options): Update -flinker-output= text to reflect GNU Binutils changes. Fix grammar. --- gcc/doc/invoke.texi | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) (limited to 'gcc') diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index c0b7aab..9712398 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -19450,13 +19450,12 @@ link-time optimizations disabled (for example, cross-module inlining happens), but most of benefits of whole program optimizations are lost. During the incremental link (by @option{-r}) the linker plugin defaults to -@option{rel}. With current interfaces to GNU Binutils it is however not -possible to incrementally link LTO objects and non-LTO objects into a single -mixed object file. If any of object files in incremental link cannot -be used for link-time optimization, the linker plugin issues a warning and -uses @samp{nolto-rel}. To maintain whole program optimization, it is -recommended to link such objects into static library instead. Alternatively it -is possible to use H.J. Lu's binutils with support for mixed objects. +@option{rel}. GNU Binutils 2.44 or later is needed to incrementally link +LTO objects and non-LTO objects into a single mixed object file. If any +of the object files in an incremental link cannot be used for link-time +optimization, the linker plugin issues a warning and uses @samp{nolto-rel}. +To maintain whole program optimization, link such objects into a static +library instead. @opindex fuse-ld=bfd @item -fuse-ld=bfd -- cgit v1.1