commit: d0bced7586bcab1a00a8db11baae895bd4f0a646 Author: Sam James <sam <AT> gentoo <DOT> org> AuthorDate: Sun Aug 1 02:28:43 2021 +0000 Commit: Sam James <sam <AT> gentoo <DOT> org> CommitDate: Sat Aug 14 01:42:58 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d0bced75
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 <AT> gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/243 Signed-off-by: Sam James <sam <AT> gentoo.org> ebuild-writing/functions/src_compile/building/text.xml | 9 +++++++++ 1 file changed, 9 insertions(+) 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>
