summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2010-08-16 00:19:20 -0700
committerZac Medico <zmedico@gentoo.org>2010-08-16 00:19:20 -0700
commit223c1e5ceac64391160ed5cd4f01adc808d4cc50 (patch)
tree5b6eb42e4f5d58bf896ea82ebe3dad9302209480
parent13a1d0e6247bd227afd0c9738093e663a989ac30 (diff)
downloadportage-223c1e5ceac64391160ed5cd4f01adc808d4cc50.tar.gz
portage-223c1e5ceac64391160ed5cd4f01adc808d4cc50.tar.bz2
portage-223c1e5ceac64391160ed5cd4f01adc808d4cc50.zip
Bug #273626 - Add PMS docs for USE Dependency Defaults.
-rw-r--r--doc/package/ebuild/eapi/4.docbook27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/package/ebuild/eapi/4.docbook b/doc/package/ebuild/eapi/4.docbook
index 9181aa881..b2c558d55 100644
--- a/doc/package/ebuild/eapi/4.docbook
+++ b/doc/package/ebuild/eapi/4.docbook
@@ -17,6 +17,33 @@ The dodoc helper now has a -r option which enables recursion.
</section>
<section id='package-ebuild-eapi-4_pre1-metadata'>
<title>Metadata</title>
+ <section id='package-ebuild-eapi-4_pre1-metadata-dependencies'>
+ <title>Dependencies</title>
+ <section id='package-ebuild-eapi-4_pre1-metadata-dependencies-use-defaults'>
+ <title>USE Dependency Defaults</title>
+ <para>
+ In a 3-style use dependency, the flag name may immediately be followed by a
+ default specified by either (+) or (-). The former indicates that, when
+ applying the use dependency to a package that does not have the flag in
+ question in IUSE_REFERENCEABLE, the package manager shall behave as if the flag
+ were present and enabled; the latter, present and disabled.
+ </para>
+ <para>
+ Unless a 3-style default is specified, it is an error for a use dependency to
+ be applied to an ebuild which does not have the flag in question in
+ IUSE_REFERENCEABLE.
+ </para>
+ <para>
+ Note: By extension of the above, a default that could reference an ebuild using
+ an EAPI not supporting profile IUSE injections cannot rely upon any particular
+ behaviour for flags that would not have to be part of IUSE.
+ </para>
+ <para>
+ It is an error for an ebuild to use a conditional use dependency when that
+ ebuild does not have the flag in IUSE_EFFECTIVE.
+ </para>
+ </section>
+ </section>
<section id='package-ebuild-eapi-4_pre1-metadata-required-use'>
<title>REQUIRED_USE</title>
<para>