commit: e4f5d4ed397a21497d8ed12a39c3d4ca41f2f560 Author: zendet <hozztie <AT> gmail <DOT> com> AuthorDate: Tue Sep 9 21:24:38 2025 +0000 Commit: Sam James <sam <AT> gentoo <DOT> org> CommitDate: Sat Sep 20 13:24:43 2025 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e4f5d4ed
devmanual: clarify IUSE wording Closes: https://bugs.gentoo.org/962488 Signed-off-by: zendet <hozztie <AT> gmail.com> Signed-off-by: Sam James <sam <AT> gentoo.org> ebuild-writing/variables/text.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml index 7f94a47..b1f6755 100644 --- a/ebuild-writing/variables/text.xml +++ b/ebuild-writing/variables/text.xml @@ -619,15 +619,15 @@ See <uri link="::keywording/concepts/"/> for how to handle this variable. <body> <p> -Note that the <c>IUSE</c> variable is cumulative, so there is no need to specify -USE flags used only within inherited eclasses within the ebuild's IUSE. +<c>IUSE</c> is cumulative: if a flag is declared in an inherited eclass, +do not list it in the ebuild's IUSE. </p> <note> -You need not assign the IUSE variable in your ebuild if it is empty. +You should omit the IUSE variable if it is empty. </note> <p> -Arch USE flags (<c>sparc</c>, <c>mips</c>, <c>x64-macos</c> and so on) should +Arch USE flags (<c>sparc</c>, <c>mips</c>, <c>x64-macos</c>, etc.) must not be listed. </p>
