aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2020-01-18 11:12:05 +0100
committerUlrich Müller <ulm@gentoo.org>2020-01-23 01:01:00 +0100
commit0273488109121d751e8ea3c60034dcb91280f54f (patch)
treeafba52766c2886651ef276ef5009cc167877ffee /general-concepts/use-flags
parentdevmanual.css: Indent <dd> in definition lists. (diff)
downloaddevmanual-0273488109121d751e8ea3c60034dcb91280f54f.tar.gz
devmanual-0273488109121d751e8ea3c60034dcb91280f54f.tar.bz2
devmanual-0273488109121d751e8ea3c60034dcb91280f54f.zip
ebuild-writing/eapi: Move EAPI=1 information to other sections.
- Default src_compile: already in ebuild-writing/functions/src_compile - SLOT dependencies: already in general-concepts/dependencies - IUSE defaults moved to general-concepts/use-flags Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'general-concepts/use-flags')
-rw-r--r--general-concepts/use-flags/text.xml28
1 files changed, 28 insertions, 0 deletions
diff --git a/general-concepts/use-flags/text.xml b/general-concepts/use-flags/text.xml
index 772791f..30b19f7 100644
--- a/general-concepts/use-flags/text.xml
+++ b/general-concepts/use-flags/text.xml
@@ -195,6 +195,34 @@ To get a flag added to <c>use.mask</c>, ask the relevant arch team.
</section>
<section>
+<title>IUSE defaults</title>
+<body>
+
+<p>
+Add <c>+</c> or <c>-</c> before the name of the use flag in <c>IUSE</c> to turn
+it on or off by default.
+</p>
+
+<important>
+Adding <c>-</c> before a flag in <c>IUSE</c> is pretty much useless, as it will
+neither override the user configuration (<c>make.conf</c>) nor the profile
+default (<c>make.defaults</c> and <c>package.use</c>). See make.conf(5) for
+details on USE-ordering in Portage.
+</important>
+
+<codesample lang="ebuild">
+# Copyright 1999-2020 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=7
+
+IUSE="foo +bar"
+</codesample>
+
+</body>
+</section>
+
+<section>
<title>Local and Global USE Flags</title>
<body>