diff options
author | 2020-01-08 09:47:43 +0100 | |
---|---|---|
committer | 2020-01-08 10:41:06 +0100 | |
commit | 0be5e7a4005354e985f7659f328f1aa7855add1a (patch) | |
tree | 5d73bc3e019bc2178902b2e2b25d3dbfe58bbabc /dependencies.rst | |
parent | Initial version (diff) | |
download | policy-guide-0be5e7a4005354e985f7659f328f1aa7855add1a.tar.gz policy-guide-0be5e7a4005354e985f7659f328f1aa7855add1a.tar.bz2 policy-guide-0be5e7a4005354e985f7659f328f1aa7855add1a.zip |
Optional RDEPEND policy
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'dependencies.rst')
-rw-r--r-- | dependencies.rst | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/dependencies.rst b/dependencies.rst new file mode 100644 index 0000000..2b63f7f --- /dev/null +++ b/dependencies.rst @@ -0,0 +1,33 @@ +Dependencies +============ + +.. index:: RDEPEND; optional +.. index:: USE flags; for optional RDEPEND + +Optional runtime dependencies +----------------------------- +:Source: QA +:Reference: https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&oldid=104017#USE-Controlled_Optional_RDEPENDS +:Reported: no + +Using USE flags to control optional runtime dependencies is not +acceptable except under very specific circumstances, such as a package +being nonfunctional unless at least one of a set of optional runtime +dependencies is installed. + +There is no specific preference as to how user should be informed +of optional runtime dependencies. The two possible options include +using ``elog`` messages and ``readme.gentoo-r1`` eclass. + +*Rationale*: toggling USE flags in order to enable or disable optional +runtime dependencies causes needless rebuilds of packages in question. +This is especially important for packages that take long time to build. + +.. Note:: + + `GLEP 62`_ proposes a solution permitting flipping USE flags without + rebuilding package in question. It has been tentatively approved + by the Council but no reference implementation has been written. + + +.. _GLEP 62: https://www.gentoo.org/glep/glep-0062.html |