diff options
author | Zac Medico <zmedico@gentoo.org> | 2010-08-16 00:19:20 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2010-08-16 00:19:20 -0700 |
commit | 223c1e5ceac64391160ed5cd4f01adc808d4cc50 (patch) | |
tree | 5b6eb42e4f5d58bf896ea82ebe3dad9302209480 | |
parent | 13a1d0e6247bd227afd0c9738093e663a989ac30 (diff) | |
download | portage-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.docbook | 27 |
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> |