summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2022-11-21 04:13:01 +0000
committerSam James <sam@gentoo.org>2024-08-16 18:21:20 +0100
commit65060aed1078b800684e8d39f2dcfac6acd7cf99 (patch)
treeaae7bceac1ab911751023510ebe73e1666b7dc55 /eclass/toolchain-funcs.eclass
parenttoolchain-funcs.eclass: refine tc-ld-force-bfd description (diff)
downloadgentoo-65060aed1078b800684e8d39f2dcfac6acd7cf99.tar.gz
gentoo-65060aed1078b800684e8d39f2dcfac6acd7cf99.tar.bz2
gentoo-65060aed1078b800684e8d39f2dcfac6acd7cf99.zip
toolchain-funcs.eclass: mark tc-ld-disable-gold as deprecated
I don't think this function makes sense in a world with lld and mold. If there's a bug causing someone to reach for tc-ld-disable-gold, it falls into one of the following: 1. there's bfdisms (like wine where there's no hope) => tc-ld-force-bfd is the correct solution 2. it's a generic problem like underlinking => patch the package please, but in extremis or as a temporary workaround, tc-ld-force-bfd could be used (but discouraged in this situation) 3. it's a gold bug (i.e. the package is definitely only broken with gold) => report the issue upstream or force bfd if the package is truly doing something a bit unusual ("the wine case"), but really, given gold seems to be rotting away, it doesn't appear likely any bugs would get fixed & users shouldn't be enabling it. I also think tc-ld-disable-gold has been used hastily in the past for cases like 2, so let's discourage that in deprecating this as well. Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'eclass/toolchain-funcs.eclass')
-rw-r--r--eclass/toolchain-funcs.eclass1
1 files changed, 1 insertions, 0 deletions
diff --git a/eclass/toolchain-funcs.eclass b/eclass/toolchain-funcs.eclass
index 61170de616d7..2d65c3fdc146 100644
--- a/eclass/toolchain-funcs.eclass
+++ b/eclass/toolchain-funcs.eclass
@@ -584,6 +584,7 @@ tc-ld-is-mold() {
# @FUNCTION: tc-ld-disable-gold
# @USAGE: [toolchain prefix]
+# @DEPRECATED: tc-ld-force-bfd
# @DESCRIPTION:
# If the gold linker is currently selected, configure the compilation
# settings so that we use the older bfd linker instead.