aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2021-08-01 03:28:43 +0100
committerSam James <sam@gentoo.org>2021-08-14 02:42:58 +0100
commitd0bced7586bcab1a00a8db11baae895bd4f0a646 (patch)
treeb6e664eebe762c7d2beaaa5d70ca90aa0c4bc879 /ebuild-writing
parentprofiles/categories: consult gentoo-dev ML before adding a new category (diff)
downloaddevmanual-d0bced7586bcab1a00a8db11baae895bd4f0a646.tar.gz
devmanual-d0bced7586bcab1a00a8db11baae895bd4f0a646.tar.bz2
devmanual-d0bced7586bcab1a00a8db11baae895bd4f0a646.zip
ebuild-writing/functions/src_compile/building: don't call CC directly
Bug: https://bugs.gentoo.org/243502 Bug: https://bugs.gentoo.org/726034 Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/243 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/functions/src_compile/building/text.xml9
1 files changed, 9 insertions, 0 deletions
diff --git a/ebuild-writing/functions/src_compile/building/text.xml b/ebuild-writing/functions/src_compile/building/text.xml
index f78c482..e1887ab 100644
--- a/ebuild-writing/functions/src_compile/building/text.xml
+++ b/ebuild-writing/functions/src_compile/building/text.xml
@@ -39,6 +39,15 @@ Other similar functions are available <d/> these are documented in
<c>man toolchain-funcs.eclass</c>.
</p>
+<p>
+Note that packages should always respect the user's <c>CC</c> preference
+and must not rely on convenience symlinks such as <c>/usr/bin/cc</c>
+or <c>/usr/bin/gcc</c>. A tracker <uri link="https://bugs.gentoo.org/243502">
+bug</uri> exists to document such issues. Additional documentation exists on the
+<uri link="https://wiki.gentoo.org/wiki/Project:Toolchain/use_native_symlinks">
+wiki</uri>.
+</p>
+
<note>
It is <e>not</e> correct to use the <c>${CC}</c> variable for this purpose.
</note>