]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
doc: update incremental link vs binutils information
authorSam James <sam@gentoo.org>
Thu, 4 Sep 2025 22:48:38 +0000 (23:48 +0100)
committerSam James <sam@gentoo.org>
Sat, 6 Sep 2025 18:41:03 +0000 (19:41 +0100)
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

index c0b7aab116965b6e4a3ff38596ef1abf23b3e64d..971239882bf6c1f2c26565f1989ca6bbc3a8acdb 100644 (file)
@@ -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